Genel Bakış
Bu kılavuz, OneSignal’e kullanıcı verilerini içe aktarmanın farklı yollarını size gösterir. Başka bir platformdan geçiş yapıyor veya yeni aboneler ekliyor olun, aşağıdakileri kullanarak Kullanıcıları ve Aboneliklerini içe aktarabilir veya güncelleyebilirsiniz:- SDK’lar — yeni kullanıcıları ve push aboneliklerini otomatik olarak eklemek için önerilir.
- CSV İçe Aktarıcı — toplu içe aktarma ve kullanıcıları güncelleme için en iyisi.
- REST API — programatik veya otomatik güncellemeler için harika.
- Manuel Giriş — bireysel kullanıcıları eklemek veya düzenlemek için idealdir.
Kitle bölümündeki sayfa
CSV içe aktarma
Etiketleri, dil, saat dilimi, ülke, abonelik durumu (E-posta/SMS) ve bastırma durumu (Yalnızca e-posta) ile birlikte e-posta ve telefon numarası aboneliklerini içe aktarın veya güncelleyin.
CSV İçe Aktarma ekranı
CSV’nizi hazırlayın
Dosyanızın aşağıdaki standartları karşıladığından emin olun:- UTF-8 kodlaması (BOM olmadan)
- Yazdırılamayan karakter yok
- Temiz, benzersiz sütun başlıkları
- 150MB’ın altında dosya boyutu
Dosyanızı VS Code veya Sublime gibi düz metin editöründe açın. UTF-8 kodlamasıyla yeniden açın ve doğru karakter görüntülemeyi doğrulayın.
external_id— Önerilir. Tüm Abonelikler genelinde Kullanıcıları tanımlar.email— E-posta abonelikleri için gereklidir.phone_number— SMS abonelikleri için gereklidir.subscription_id— Yalnızca mevcut bir aboneliğe Harici Kimlik eklerken kullanım için önerilir.
subscription_id, eski durumlar için veya arka ucunuzun bu benzersiz Abonelik Kimliğini takip ettiği yerlerde bir tanımlayıcı olarak kullanılabilir. Özellikler eklemek veya güncellemek için tanımlayıcı olarak kullanılması önerilmez.
external_id’yi paylaşan ayrı satırlar kullanın.
external_id’nin dahil edilmesi kullanıcıların tekrarının önlenmesine yardımcı olur, kanallar arası güncellemeleri destekler ve gelecekteki içe aktarmaları etkinleştirir.external_id’nin her kullanıcı için benzersiz olduğundan ve SDKloginyöntemiyle ayarlanan kimlikle aynı olduğundan emin olun. Aksi takdirde kullanıcı uygulamayı açtığında sıfırlanır.
Kullanılabilir CSV sütunları
Daha fazla bilgi için harici kimlik’e bakın.
Bir E-posta aboneliği oluşturur. Zaten mevcutsa yinelenenleri kaldırır.
+15555551234 gibi E.164 formatını kullanın. Bir SMS aboneliği oluşturur.Yalnızca eski kullanım içindir. OneSignal abonelik kimliklerini takip ederken kullanın.
email, phone_number ve subscription_id için abonelik durumunu ayarlar.false, e-postayı bastırma listelerinden kaldırır.ISO 3166-2’ye bakın.
1.000 etikete kadar. Sütun başlıklarını anahtar olarak kullanın. Etiketler’e bakın.
Tek bir sütundan etiketleri içe aktarma
Her etiket anahtarı için ayrı sütun başlıkları kullanmak yerine, her kullanıcı satırının tırnak işaretleri içinde tüm anahtar-değer çiftlerinin JSON haritasını içerdiği tek birtags başlığı ayarlayabilirsiniz. Bu, özellikle daha önce etiketlerle bir CSV dışa aktardıysanız ve bunu yeniden biçimlendirmeden yeniden içe aktarmak istiyorsanız kullanışlıdır.
Örnek başlık:
CSV içe aktarıcıya erişim
- Kitle > İçe Aktar’a gidin
- CSV İçe Aktarıcıyı Başlat’a tıklayın
- CSV’nizi yükleyin (sürükle ve bırak veya dosya seçiciyi kullanın)
Alanları eşleme
Yüklemeden sonra:- OneSignal, başlıkları bilinen özelliklere otomatik olarak eşler.
- Onaylamadan önce eşlemeleri gözden geçirin.
Özellikleri güncelleme
Güncellediğiniz kullanıcıyı tanımlamak içinexternal_id, email, phone_number veya subscription_id kullanın.
Mevcut bir kullanıcıya yeni bir e-posta veya telefon numarası eklemek için external_id kullanmalısınız. subscription_id kullanmayın — abonelikleri bağlamaz veya birleştirmez.
Uyarıları işleme
OneSignal format sorunları tespit ederse:- CSV’yi düzeltin ve yeniden yükleyin (önerilir)
- Veya etkilenen sütunun işaretini kaldırarak içe aktarmayı atlayın
Yanlış biçimlendirilmiş telefon numaraları için hata mesajını gösterir
İnceleme
İnceleme ekranında:- İsteğe bağlı olarak, bu içe aktarma için bir segment oluşturun
- İsteğe bağlı olarak, boş değerleri olan etiketleri silin:
Segment oluşturmak, bu kullanıcılara hemen bir mesaj göndermeyi hızlı ve kolay hale getirir. Ancak, CSV’niz zaten benzersiz bir etiket içeriyorsa, burada bir segment oluşturmanıza gerek yoktur. Segmentinizi oluşturmak için zaten ayarladığınız etiketi kullanmanız yeterlidir.
Segment oluşturma ve boş etiket değerlerini silme seçenekleri
Durum ve kayıt sayılarıyla içe aktarma onayı
İçe aktarma süresi dosya boyutuna bağlıdır. Tamamlama e-postalarını aldığınızdan emin olmak için
contact@onesignal.com adresini e-posta kişilerinize ekleyin. E-posta onayı ve sorun giderme
CSV yükleme tamamlandığında, aşağıdaki verilerle birlikte bir onay e-postası alacaksınız:-
Eklenen abonelik kayıt(lar)ı
- CSV yüklemesi yoluyla oluşturulan yeni e-posta ve/veya SMS abonelikleri sayısı.
0, listenin abonelikleri oluşturmak için benzersizemailve/veyaphone_numbertanımlayıcıları içermediği anlamına gelir.
-
Değiştirilen abonelik kayıt(lar)ı
- Ayarlanan etiketler veya diğer özellikler gibi bazı verilerin değiştiği Abonelikler sayısı.
- Kullanıcıların birden fazla Aboneliği olabileceğini unutmayın. Örneğin, 10 Harici Kimlik listesi yüklediyseniz ve her biri 20 abonelikle ilişkilendirildiyse,
200abonelik kaydının değiştirildiğini göreceksiniz.
-
Atlanan abonelik güncellemeleri
- Belirtilen nedene göre atlanan Abonelikler sayısı.
emailve/veyaphone_numberiçeren bir CSV yüklediyseniz, bu Abonelikler muhtemelen oluşturulmuştur.- Neden “uygulamanızın etiket sınırını aştığı için” ise, etiketleri kaldırmanız ve tekrar yüklemeniz gerekir. Veya planınızı yükseltin.
-
İçe aktarılmadı
- Güncellenmemiş veya içe aktarılmamış satır sayısı.
- Genellikle şu durumlarda oluşur:
- CSV’de ayarladığınız
external_id, OneSignal uygulamasındaki herhangi bir abonelikte bulunmuyor emailve/veyaphone_numberabonelikleri OneSignal uygulamasında zaten mevcut.
-
Oluşturulan yeni segment
- Varsa oluşturduğunuz segmentin adı.
Örnek e-posta onayı.
emailve/veyaphone_numbersütunları, OneSignal uygulamasında şu anda mevcut olmayan benzersiz e-posta adresleri ve/veya telefon numaraları içerdiği için100abonelik oluşturuldu.37814abonelik güncellendi. Bu, Kullanıcı sayısı değildir. Kullanıcıların birden fazla Aboneliği olabileceğini unutmayın.- CSV’nin
621852satırı içe aktarılmadı. Bunun nedeni, OneSignal uygulamasındaki kullanıcılarla eşleşen Harici Kimliklere sahip olmamaları veya e-postaların ve/veya telefon numaralarının ayarlanacak benzersiz veri olmadan zaten mevcut olmasıdır.
Şu anda Segmentler yalnızca abone olan Aboneliklerin sayısını sayar. Verileri güncellense de aboneliği iptal edilen abonelikleri saymaz.Segment sayınız CSV ile eşleşmiyorsa, bunun nedeni segmentin şu anda aboneliği iptal edilen abonelikleri saymamasıdır.Bu konuda şu anda çalışılmaktadır. Yeni ve geliştirilmiş segmentasyon 2025’in sonlarında kullanılabilir olacaktır.
Hala sorun mu yaşıyorsunuz?
support@onesignal.com ile iletişime geçin ve yüklediğiniz CSV dosyasını onay e-postasının ekran görüntüsüyle birlikte paylaşın. İncelemekten mutluluk duyarız!CSV içe aktarma geçmişi
İçe aktarma geçmişini Kitle > İçe Aktar > CSV > Önceki içe aktarmaları görüntüle’de görebilirsiniz (önceki tek kanallı CSV içe aktarma sürecimizi kullanarak yapılan içe aktarmaların bu listede yer almayacağını lütfen unutmayın).REST API
REST API’miz aracılığıyla kullanıcıları ve abonelikleri içe aktarma ve güncelleme için:Kullanıcı oluştur
Önerilir. Kullanıcıları ve abonelikleri oluşturmak ve/veya güncellemek için kullanılabilir.
Takma ad ile abonelik oluştur
Yalnızca kullanıcılara abonelik eklemek için kullanın.
Manuel giriş
- E-postaları manuel olarak ekle
- Telefon numaralarını manuel olarak ekle
Bireysel bir kullanıcının e-postasını ve o kullanıcıyla ilişkilendirmek istediğiniz veri etiketlerini ekleyebileceğiniz yeni bir modal açmak için Kitle > Abonelikler > Kullanıcıları Güncelle/İçe Aktar’ın yanındaki Ok > E-postaları Manuel Olarak Ekle’ye gidin.
E-postaları Manuel Olarak Ekle seçeneğinin vurgulandığı düğme açılır menüsü