Ana içeriğe atla
OneSignal kontrol panelinde bir CSV dosyası veya manuel giriş kullanarak kullanıcıları toplu olarak içe aktarın veya güncelleyin. Yaygın kullanım durumları arasında başka bir platformdan kullanıcı geçişi, kullanıcı ayrıntılarını güncelleme ve Etiketler ve Segmentler ile kullanıcıları düzenleme yer alır.
REST API aracılığıyla da kullanıcıları güncelleyebilir veya oluşturabilirsiniz.

​
CSV içe aktarma

E-posta adresleri, telefon numaraları, harici kimlikler, Etiketler, dil, saat dilimi, ülke ve daha fazlasını içe aktarmak veya güncellemek için bir CSV dosyası kullanın.

​
CSV gereksinimleri

.csv dosyanızın aşağıdaki gereksinimleri karşıladığından emin olun:
  • UTF-8 kodlaması (BOM olmadan)
  • Yazdırılamayan karakter yok (özel karakter veya ASCII dışı karakter yok)
  • Temiz, benzersiz sütun başlıkları
  • 150MB’ın altında dosya boyutu (yaklaşık 2 milyon satır)
  • Aşağıdakilerden en az bir tanımlayıcı:
    • external_id — Önerilir. Tüm Abonelikler genelinde Kullanıcıları tanımlar.
    • email — Yeni e-posta abonelikleri oluşturmak için gereklidir. Daha fazla bilgi için E-posta adresi doğrulama sayfasına bakın.
    • phone_number — Yeni SMS abonelikleri oluşturmak için gereklidir.
    • subscription_id — Yalnızca arka ucunuzda OneSignal Abonelik Kimliklerini zaten takip ettiğiniz durumlar için önerilir.
Her satırda her türden yalnızca bir tanımlayıcıya izin verilir. Birden fazla e-postayı veya numarayı aynı kullanıcıyla ilişkilendirmek için aynı external_id’yi paylaşan ayrı satırlar kullanın.
  • Kullanıcıları tekrarlamaktan kaçınmak için external_id ekleyin. SDK login yönteminde kullanılan kimlikle eşleştiğinden emin olun — aksi takdirde kullanıcı uygulamayı açtığında sıfırlanır.
  • Abonelik durumunu değiştirmek için satır email, phone_number veya subscription_id içermelidir. Tek başına external_id yeterli değildir.
  • subscription_id Abonelikleri bağlamaz veya birleştirmez. Mevcut bir kullanıcıya yeni e-posta veya telefon numarası eklemek için external_id kullanın.

​
Kullanılabilir CSV sütunları

​
external_id
Herhangi bir benzersiz alfasayısal değer
Daha fazla bilgi için harici kimlik’e bakın.
​
email
Geçerli e-posta adresleri
Bir E-posta aboneliği oluşturur. Zaten mevcutsa yinelenenleri kaldırır.
​
phone_number
Geçerli telefon numaraları
+15555551234 gibi E.164 formatını kullanın. Bir SMS aboneliği oluşturur.
​
subscription_id
OneSignal tarafından atanan UUID v4
Yalnızca arka ucunuzda OneSignal Abonelik Kimliklerini zaten takip ettiğiniz durumlar için önerilir.
​
subscribed
`yes`, `no`
Abonelik durumunu ayarlar. Aynı satırda email, phone_number veya subscription_id gerektirir — yalnızca external_id ile kullanılamaz.
​
suppressed
`true`, `false`
false, e-postayı bastırma listelerinden kaldırır.
​
timezone_id
IANA TZ formatında saat dilimleri
IANA TZ’ye bakın.
​
country
2 karakterli ISO 3166-2 kodları
ISO 3166-2’ye bakın.
​
language
2 karakterli ISO 639-1 kodları
ISO 639-1’e bakın.
​
data tags
Alfasayısal değerler
1.000 etikete kadar. Sütun başlıklarını anahtar olarak kullanın. Etiketler’e bakın.

​
Etiket sınırları ve kısıtlamaları

Etiket plan sınırları uygulama başına değil, kullanıcı başına uygulanır. Örneğin, planınız kullanıcı başına 20 etikete izin veriyorsa ve bir kullanıcının zaten 19 etiketi varsa, uygulamanın sınırsız etiket anahtarına sahip olmasına rağmen yalnızca 1 tane daha ekleyebilirsiniz.
  • Toplu etiket güncellemeleri iş akışını kullanarak kullanıcıları dışa aktarın, istenmeyen etiket değerlerini temizleyin ve silme seçeneği etkin olarak yeniden içe aktarın.
  • Etiket anahtarlarında boşluk kullanmaktan kaçının — bunun yerine alt çizgi kullanın.
Ayrılmış ve kısıtlı etiket anahtarları Aşağıdaki etiket anahtarları ayrılmıştır ve kullanılmamalıdır:
  • “user”
  • “subscription”
  • “message”
  • “template”
  • “app”
  • “org”
  • “custom_data”
  • “dynamic_content”
Bu anahtarlardan birini yanlışlıkla etiket anahtarı olarak ayarlarsanız, Kullanıcı Güncelleme API’si aracılığıyla kaldırın. Etiket üzerine yazma ve silme CSV içe aktarma sırasında:
  • CSV’nize dahil edilen etiketler, sağlanan değerle üzerine yazılır.
  • CSV’nize dahil edilmeyen etiketler kullanıcı kaydında değişmeden kalır.
İçe aktarma sonrasında bir etiket hâlâ mevcutsa şunları doğrulayın:
  • Başlık sütunu etiket anahtarını içeriyor.
  • Satır hiçbir değer içermiyor.
  • İnceleme ekranında “Boş değerli etiketleri sil” seçeneğini seçtiniz.
Etiket eklemenin diğer kaynakları Silinen etiketler içe aktarmadan sonra yeniden görünürse, 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
CSV değişikliklerinizin üzerine yazılmadığından emin olmak için entegrasyon eşlemelerini ve olay tetikleyicilerini gözden geçirin.

​
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 bir tags 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: 
external_id,email,tags
Örnek satırlar: Etiketler, tırnak işaretleri içine alınmış bir JSON nesnesi olarak biçimlendirilmelidir. 
userA,example@email.com,"{""level"":""30"",""Color"":""teal""}"
İçe aktarıldığında, OneSignal her anahtar-değer çiftini abonelik kaydı için ayrı etiketlere otomatik olarak dönüştürür. Örnek: Etiketleri toplu silme Etiketleri toplu olarak kaldırmak için mevcut verilerinizi dışa aktarın, etiket değerlerini silin ve silme seçeneği etkinleştirilmiş olarak CSV’yi yeniden içe aktarın.
1

Verilerinizi dışa aktarın

  • OneSignal kontrol panelinde Audience > Subscriptions bölümüne gidin. Yalnızca External ID, Subscription ID ve Tags sütunlarını etkinleştirin (isteğe bağlı olarak Email veya Phone Number da dahil).
  • CSV’yi dışa aktarmak için Export seçeneğine tıklayın.
Dışa aktarma için görüntülenebilir sütunları seçin
2

Silmek istediğiniz etiket değerlerini temizleyin

Dışa aktarılan CSV’yi bir metin düzenleyicide açın ve silmek istediğiniz her etiketin değerini boş bir dize olarak ayarlayın.Örneğin, düzenlemeden önce etiket değerleri içeren bir satır:
Düzenlemeden önceki satır
userA,example@email.com,"{""level"":""30"",""color"":""teal""}"
Etiket değerleri temizlendikten sonra aynı satır:
Etiket değerleri temizlendikten sonra satır
userA,example@email.com,"{""level"":"""",""color"":""""}"
Bu, kullanıcıdan level ve color etiketlerini silecektir.
3

Silme seçeneğiyle CSV'yi yeniden içe aktarın

  • Düzenlenen CSV’yi alın ve içe aktarın.
  • Gözden Geçirme ekranında, Boş değerli etiketleri sil için Evet’i seçin. OneSignal, içe aktarma sırasında boş değerli etiketleri siler.
Boş değerli etiket kaldırma seçeneğinin bulunduğu gözden geçirme ekranı
Yalnızca belirli etiketleri kaldırmak için bu etiketlerin değerlerini temizleyin ve diğerlerini değiştirmeden bırakın. Silme seçeneği etkinleştirildiğinde yalnızca boş değerler silinir.
Yardıma mı ihtiyacınız var?

​
Email adresi doğrulama

Email adresi doğrulama, email’ler kitlenize ulaşmadan önce email adreslerindeki yaygın sorunları tespit eder. Geri dönüş oranınızı artırabilecek veya gönderen itibarınıza zarar verebilecek yazım hatalarını, geçersiz alan adlarını, rol tabanlı adresleri ve tek kullanımlık email hizmetlerini işaretler.

Email adresi doğrulama

Geri dönüşleri azaltmak ve gönderen itibarınızı korumak için CSV içe aktarma sırasında ve toplu olarak email adreslerini doğrulayın.

​
İç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.
Binlerce kaydı içe aktarmadan önce her zaman küçük bir örnekle (5-10 satır) test edin.
İstenmeyen etiketleri silmek için AI istemi örneği
Bu CSV'den "user_name" dışındaki tüm etiketleri kaldırmak istiyorum.

Lütfen:
1. Yalnızca "user_name" etiket sütununu koruyun.
2. Diğer tüm etiket sütunlarını kaldırın.
3. CSV'yi bu belgedeki OneSignal içe aktarma gereksinimlerine uyacak şekilde biçimlendirin:
   https://documentation.onesignal.com/docs/en/import

İşte CSV'im:
[CSV YAPIŞTIR]

​
İçe aktarma adımları

Kitle > İçe Aktar’a gidin ve CSV İçe Aktarıcıyı Başlat’a tıklayın.
1

CSV'nizi yükleyin

Hazırladığınız CSV dosyasını seçin.
OneSignal kontrol panelindeki CSV dosyası yükleme ekranı
2

Alanları eşleyin

OneSignal, CSV başlıklarını bilinen özelliklere otomatik olarak eşler. Onaylamadan önce eşlemeleri gözden geçirin — external_id, email, phone_number ve/veya subscription_id’yi etiket olarak değil tanımlayıcı olarak 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.
OneSignal özelliklerine eşlenen sütun başlıklarını gösteren alan eşleme ekranı
OneSignal format sorunları tespit ederse, CSV’yi düzeltin ve yeniden yükleyin (önerilir) veya etkilenen sütunun işaretini kaldırarak atlamayı seçin.
3

İnceleyin ve onaylayın

İnceleme ekranı şunları yapmanıza olanak tanır:
  • Otomatik olarak Segment oluştur — İçe aktarılan her kullanıcıya bir etiket ekler ve eşleşen bir Segment oluşturur. Plan sınırlarınıza dikkat edin.
  • Boş değerleri olan etiketleri sil — CSV’de değeri boş olan tüm etiketleri kaldırır. İstenmeyen etiketleri temizlemek ve plan sınırlarınız dahilinde kalmak için kullanışlıdır.
  • E-posta adresi doğrulamasını yapılandırın — Geri dönüşleri azaltmak ve gönderen itibarınızı korumak için e-posta adresi doğrulama ayarlarını yapılandırın.
Örneğin, aşağıdaki CSV’ye göre:
external_id,tag1,tag2
UserA,,"tag2value"
UserB,"tag1value",
“Boş değerleri olan etiketleri sil” etkinleştirildiğinde, UserA’dan tag1 ve UserB’den tag2 silinir.
Segment oluşturma ve boş etiket değerlerini silme seçeneklerini gösteren inceleme ekranı
Onayla ve İçe Aktar’a tıklayın. Bir durum ekranı ilerlemeyi gösterir.
İçe aktarma başlatıldı. Tamamlandığında contact@onesignal.com adresinden bir onay e-postası alacaksınız.

​
E-posta onayı

İçe aktarma tamamlandığında, contact@onesignal.com adresinden bir onay e-postası alacaksınız. Tek bir Kullanıcı birden fazla Aboneliğe sahip olabileceğinden (örn. e-posta + push), abonelik sayıları satır sayınızdan yüksek olabilir. Eklenen abonelik kayıt(lar)ı — Oluşturulan yeni e-posta veya SMS Abonelikleri. 0, benzersiz email veya phone_number tanımlayıcısı bulunmadığı anlamına gelir. Değiştirilen abonelik kayıt(lar)ı — Verileri değişen Abonelikler (etiketler, özellikler vb.). Örnek: 10 Harici Kimliğin her biri 20 abonelikle ilişkilendirilmişse = 200 kayıt değiştirildi. Atlanan abonelik güncellemeleri — Belirtilen nedenle atlanan Abonelikler. Neden “uygulamanızın etiket sınırını aştığı için” ise, etiketleri kaldırıp yeniden içe aktarın veya planınızı yükseltin. İçe aktarılmadı — Güncellenmemiş veya içe aktarılmamış satırlar. Yaygın nedenler: external_id mevcut aboneliklerle eşleşmiyor veya email/phone_number zaten mevcut ve ayarlanacak yeni veri yok. Oluşturulan yeni segment — Segment adı (bu seçeneği seçtiyseniz).
Eklenen, değiştirilen, atlanan ve içe aktarılmayan abonelik sayılarını gösteren e-posta onayı
Yukarıdaki örnekte:
  • Uygulamada mevcut olmayan benzersiz e-posta adresleri veya telefon numaralarından 100 abonelik oluşturuldu.
  • 37,814 abonelik güncellendi (Kullanıcı sayısı değil — her kullanıcının birden fazla aboneliği olabilir).
  • 621,852 satır içe aktarılmadı. Harici Kimlikleri mevcut kullanıcılarla eşleşmedi veya e-posta/telefon numaraları zaten mevcuttu ve yeni veri yoktu.
Segmentler yalnızca abone olan Abonelikleri sayar. Aboneliği iptal edilmiş abonelikler içe aktarma ile güncellenir ancak segment sayılarına yansımaz. Segmentasyon iyileştirmeleri devam etmektedir.

​
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.
Yeni Kullanıcı ekranında, istediğiniz verileri ekleyin ve Kullanıcı Oluştur’u seçin.

​
Sık sorulan sorular

​
CSV içe aktarma ne kadar sürer?

Süre dosya boyutuna bağlıdır. Çoğu içe aktarma birkaç dakika içinde tamamlanır. İçe aktarma tamamlandığında contact@onesignal.com adresinden bir e-posta alırsınız — teslimatı sağlamak için bu adresi kişilerinize ekleyin.

​
Bir CSV içe aktarma işlemini geri alabilir miyim?

Hayır. CSV içe aktarmaları için yerleşik bir geri alma özelliği yoktur. Değişiklikleri geri almanız gerekiyorsa, doğru değerlerle yeni bir CSV hazırlayın ve yeniden içe aktarın. Etiket silme işlemleri için Etiketleri toplu silme iş akışını kullanın.

​
Segment sayılarım neden CSV’mdeki satır sayısıyla eşleşmiyor?

Segmentler yalnızca abone olunan Abonelikleri sayar. Aboneliği iptal edilmiş abonelikler içe aktarma ile güncellenir ancak segment sayılarına yansımaz.

​
Bazı satırlar için içe aktarmam neden “içe aktarılmadı” gösteriyor?

external_id uygulamadaki mevcut aboneliklerle eşleşmediğinde veya email ya da phone_number ayarlanacak yeni veri olmadan zaten mevcut olduğunda satırlar atlanır. Her durum için ayrıntılar için E-posta onayı bölümüne bakın.

​
Silinen etiketler neden geri geliyor?

İçe aktarma işleminden sonra bir entegrasyon veya SDK çağrısı etiketleri yeniden ekliyor olabilir. Yaygın kaynaklar arasında Segment, HubSpot, Journeys, SDK etiketleme yöntemleri ve özel API’ler bulunur. Entegrasyon eşlemelerinizi ve olay tetikleyicilerini gözden geçirin.