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.
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:
İçe aktarmadan önce CSV’nizi kontrol etmek için AI kullanın
CSV biçimlendirmenizle ilgili hatalar veya sorularınız varsa, tekrar içe aktarmadan önce dosyanızı otomatik olarak temizlemek veya yeniden oluşturmak için CSV sorununuzu bir AI aracına (Claude, ChatGPT veya benzeri) açıklayabilirsiniz.- Etiketleri silme
- Etiket biçimlendirme
- Geçersiz biçimleri tanımlama
- Telefon numarası biçimlendirme
- Başka bir platformdan veri
İstenmeyen etiketleri silmek için AI istemi örneği
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
İ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
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.
Hala sorun mu yaşıyorsunuz?
[email protected] 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!Yaygın sorun giderme ipuçları
Aşağıdakiler CSV içe aktarmalarda gördüğümüz yaygın sorunlardır. Sorun yaşıyorsanız yukarıdaki İçe aktarmadan önce CSV’nizi kontrol etmek için AI kullanın bölümünü denemenizi de öneririz.Etiket sınırları
- Etiket plan sınırınız kullanıcı başınadır. Uygulama başına sınırsız sayıda etikete sahip olabilirsiniz, ancak her kullanıcı plan sınırına tabidir.
- Örnek: Plan sınırınız kullanıcı başına 20 etikettir.
- Kullanıcının zaten 19 etiketi varsa, o kullanıcıya yalnızca 1 etiket daha ekleyebilirsiniz.
- Uygulamanızda 1000 farklı etiket kombinasyonu olabilir, ancak her kullanıcı bir seferde yalnızca 20’ye sahip olabilir.
- Öneri:
- Kullanıcılarınızın Harici Kimliğini, Etiketlerini, E-postasını ve/veya Telefon Numarasını dışa aktarmak için kontrol paneli CSV Dışa Aktarımını kullanın.
- Silmek istediğiniz etiketlerle CSV başlıklarını ayarlayın ve önce bunları içe aktarın.
- Tutmak istediğiniz etiketlerle ikinci bir CSV ayarlayın ve bunları ikinci olarak içe aktarın.
- Daha fazla ayrıntı için yukarıdaki Tek bir sütundan etiketleri içe aktarma bölümüne bakın.
Etiket üzerine yazma ve silme işlemleri
CSV içe aktarma sırasında:- CSV’nizde bulunan etiketler sağlanan değerle üzerine yazılır.
- CSV’nizde bulunmayan etiketler kullanıcı kaydında değişmeden kalır.
- başlık sütunu etiket anahtarını içeriyor.
- satır herhangi bir değer içermiyor.
- İnceleme ekranında “Boş değerleri olan etiketleri sil” seçeneğini seçtiniz.
Etiketlerin eklendiği diğer kaynaklar
Silinen etiketler içe aktarma sonrasında yeniden görünüyorsa, bir entegrasyon bunları otomatik olarak geri yazıyor olabilir. Yaygın kaynaklar şunlardır:- Segment
- HubSpot
- Journeys
- SDK Etiketleme yöntemleri
- Özel API’ler veya ETL ardışık düzenleri
Yardıma mı ihtiyacınız var?
- Yukarıdaki İçe aktarmadan önce CSV’nizi kontrol etmek için AI kullanın bölümünü deneyin.
[email protected]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!
Manuel giriş
OneSignal kontrol panelinden Kitle > Kullanıcılar > Kullanıcıları Güncelle/İçe Aktar > Manuel Olarak Kullanıcı Ekle’ye giderek kullanıcının e-posta ve telefon numarası aboneliklerini manuel olarak ekleyebilirsiniz.
Manuel olarak kullanıcı ekleme ekranı