Ana içeriğe atla

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.
Dosyanız aşağıdakilerden en az birini içermelidir:
  • 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.
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.
  • 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 SDK login yö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ı

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 eski kullanım içindir. OneSignal abonelik kimliklerini takip ederken kullanın.
subscribed
`yes`, `no`
email, phone_number ve subscription_id için abonelik durumunu ayarlar.
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.

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,[email protected],"{""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.

İç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
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]

Binlerce kaydı içe aktarmadan önce her zaman küçük bir örnekle (5-10 satır) test edin.

CSV içe aktarıcıya erişim

  1. Kitle > İçe Aktar’a gidin
  2. CSV İçe Aktarıcıyı Başlat’a tıklayın
  3. 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çin external_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:
external_id,tag1,tag2
2349-wefh-h34a,,"tag 2 value"
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

Onayla ve İçe Aktar’a tıkladıktan sonra, bir durum ekranı ilerlemeyi gösterir. İçe aktarma tamamlandığında bir e-posta alacaksınız.
İçe aktarma süresi dosya boyutuna bağlıdır. Tamamlama e-postalarını aldığınızdan emin olmak için [email protected] 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 benzersiz email ve/veya phone_number tanı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, 200 abonelik kaydının değiştirildiğini göreceksiniz.
  • Atlanan abonelik güncellemeleri
    • Belirtilen nedene göre atlanan Abonelikler sayısı.
    • email ve/veya phone_number iç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:
    1. CSV’de ayarladığınız external_id, OneSignal uygulamasındaki herhangi bir abonelikte bulunmuyor
    2. email ve/veya phone_number abonelikleri OneSignal uygulamasında zaten mevcut.
  • Oluşturulan yeni segment
    • Varsa oluşturduğunuz segmentin adı.

Örnek e-posta onayı.

Örnekte:
  • email ve/veya phone_number sütunları, OneSignal uygulamasında şu anda mevcut olmayan benzersiz e-posta adresleri ve/veya telefon numaraları içerdiği için 100 abonelik oluşturuldu.
  • 37814 abonelik güncellendi. Bu, Kullanıcı sayısı değildir. Kullanıcıların birden fazla Aboneliği olabileceğini unutmayın.
  • CSV’nin 621852 satı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?[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.
İçe aktarma sonrasında bir etiket hala mevcutsa, şunları doğrulayın:
  • 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
CSV değişikliklerinizin üzerine yazmadıklarından emin olmak için entegrasyon eşlemelerini ve olay tetikleyicilerini gözden geçirin.
Yardıma mı ihtiyacınız var?

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ı

Yeni Kullanıcı ekranında, istediğiniz verileri ekleyin ve Kullanıcı Oluştur’u seçin.