Ana içeriğe geç

Kampanyalar

Kampanyalar panelde oluşturulan kampanyaları listeler ve yenilerini oluşturan sihirbazı barındırır. API'den gönderilen anlık bildirimlerin kendi menüsü vardır, API gönderimleri: her biri içeriği, geldiği istek (hedef, data, TTL, öncelik) ve cihaz bazında ne olduğunu gösteren tabloyla açılır — gönderildi, ulaştı, açıldı ya da sağlayıcının hata kodu.

Kampanya listesi

Sütunlar: ad, durum rozeti, Zamanlama, Gönderildi, Açılma. Raporu için satıra tıklayın. Taslak ve zamanlanmış kampanyalarda İptal et düğmesi vardır; başka hiçbiri iptal edilemez, çünkü fan-out başladığında işler zaten kuyruklara dağılmıştır.

RozetDurumAnlamı
taslakdraftSihirbaz başladı; her şey dolu değil. Devam etmek için açın.
zamanlandıscheduledRedis'te gecikmeli iş olarak saatini bekliyor. İptal edilebilir.
gönderiliyorsendingFan-out / push'lar uçuşta. Rapor kendini yeniler.
gönderildisentFan-out bitti; her push denendi.
iptal edildicancelledFan-out'tan önce iptal edildi.
başarısızfailedFan-out'un kendisi başarısız oldu (örn. kitlede kimlik bilgisi olmayan bir platform).
tekrarlayan · aktifactiveTakvimi canlı olan tekrarlayan kampanya. Kendisi asla göndermez; her tetiklenme rapor sayfasında listelenen bir gönderim üretir.

Sihirbaz​

+ Yeni kampanya'ya tıklayın. Dört adım, her biri URL'de (?step=segment|content|preview|schedule), böylece tarayıcının geri düğmesi sihirbazda gezer ve yeniden yüklenen sekme kaldığınız yere düşer.

Taslaklar kendini kaydeder

İlk değişiklik taslak durumunda bir kampanya satırı oluşturur ve kimliğini URL'e koyar (?draft=…). Her adım değişimi kaydeder; yazarken durduktan 1,5 sn sonra kaydeder. Sekmeyi kapatın; listede olacaktır.

1 Kitle​

1. adım: kitle

  • Ad — kampanyanın adı. İçseldir; kullanıcıya gösterilmez.
  • Segment oluşturucu. Bir grup Tümü doğruysa (AND) ya da Herhangi biri (OR)'dur. + Koşul koşul ekler, + Grup iç içe grup açar. Her koşul bir alan, bir operatör ve bir değerdir; DEĞİL tersine çevirir.
  • Sunulan alanlar: platform, ülke, dil, saat dilimi, abonelik durumu, Son görülme, Son oturum / Oturum sayısı, Son bildirim açma, Son bildirim, Kayıt tarihi, uygulama / OS sürümü, cihaz modeli, tarayıcı — ve kitlede gerçekten olan her tag anahtarı (tag: plan, tag: streak…), gerçek değerlerden önerilerle.
  • + Etkileşim davranışsal koşul ekler: X kampanyası açıldı / butona basıldı / teslim edildi / gönderildi (isteğe bağlı -30d içinde); DEĞİL "yapmadı"ya çevirir. Yalnızca gönderilmiş kampanyalar sunulur.
  • Kayıtlı segment… bir kayıtlı segmenti yükler; Segment olarak kaydet mevcut ağacı bir adla saklar. Yüklenmiş segmenti düzenlemek bağı koparır — kampanya kendi kopyasını tutar.
  • Tarihler mutlak (2026-08-01) ya da göreli (-7d, -12h) değer alır.
  • Sağdaki Eşleşen abone, bildirime açık ve token'ı geçerli cihazların platforma göre canlı sayısıdır. Siz düzenledikçe yeniden sorgular.
  • Üretilen DSL saklanacak JSON'u açar — API'nin kabul ettiği segment DSL'in aynısı; POST /v1/campaigns gövdesine kopyalayabilirsiniz.

Üretilen DSL

Herkesi hedeflemek için oluşturucuyu boş bırakın.

2 İçerik​

2. adım: içerik

İçerik dil başınadır. Üstte sekmeler: en ★, tr, + Dil ekle. Yıldızlı olan _default — dili hiçbir sürümle eşleşmeyen abonenin aldığı.

AlanNotlar
Başlık / GövdeBaşlık (≤ 200) ve gövde (≤ 1000). `{{firstName
Görsel URLBüyük görsel. Android ve web gösterir; iOS Notification Service Extension ile gösterir; iOS kilit ekranında görünmez.
Tıklama hedefiDokununca açılan derin bağlantı ya da URL. Yer tutucu kullanılabilir.
ButonlarEn çok üç aksiyon butonu: id, başlık, isteğe bağlı URL (boşsa bildiriminki). Chrome ikisini, Android üçünü, iOS dördüne kadar gösterir.
Bayt ölçerWeb push yükü 4 KB ile sınırlıdır; çubuk seçili dilin şifreli boyutunu gösterir.

Metnin üstünde bir şerit: Sessiz push (arka plan push'u — hiçbir şey çizilmez, uygulama Veri yükünü alır; web atlanır; metin alanları soluklaşır), Şablondan yükle… ve Şablon olarak kaydet (bkz. Şablonlar).

Sessiz push açıkken içerik adımı

Metnin altında:

  • Veri — push ile giden data anahtar/değer çiftleri (SDK'larda message.data). Sessiz push için mesajın tamamı budur.
  • Görünüm — ses (Varsayılan / Sessiz / özel dosya adı), rozet sayısı, grup (iOS thread-id, Android grup anahtarı), web simge URL'i, iOS kesinti düzeyi (passive / active / time-sensitive / critical), iOS ilgililik puanı, Android kanalı (uygulamanın kanallarından biri). Desteklemeyen platform yok sayar.
  • Değişkenler — yerleşikler ({{externalId}}, {{country}}, {{language}}, {{platform}}) ve kitlede görülen her tag anahtarı için çipler. Tıklayınca imlecin olduğu yere eklenir.
  • A/B testi — içeriği 2–4 varyantlı bir deneye çevirir; bkz. A/B testi.

A/B testi açık içerik adımı

3 Önizleme​

3. adım: önizleme

iOS, Android ve tarayıcı için cihaz maketleri, dil başına (Önizleme dili). Metin worker'ın kullandığı yer tutucu fonksiyonunun aynısından (core/personalize.ts) geçer; gördüğünüz, cihazın alacağıyla bayt bayt aynıdır. Örnek değerler yalnızca önizleme için örnek tag değerleri yazmanızı sağlar; gönderimde her abonenin kendi tag'leri kullanılır. Eksik diller ve boş başlıklar devam edemeden burada işaretlenir.

4 Zamanlama​

4. adım: zamanlama

SeçenekDavranış
Şimdi gönderOnaylar onaylamaz kuyruğa girer.
Belirli tarih ve saatSizin (tarayıcı) saat diliminizde yorumlanır, UTC saklanır, Redis'te gecikmeli iş olarak tutulur.
Kullanıcının yerel saatiBir duvar saati girin (19:30). Her abone kendi saat diliminde 19:30'da alır; saat dilimi olmayanlar uygulamanın varsayılanını, o da yoksa UTC'yi kullanır. Fan-out'ta push başına çözülür; saat dilimi başına kampanya kopyası yok. Bkz. Zamanlama.
TekrarlayanHer gün ya da seçili günlerde, tek bir saat diliminde (tarayıcınızınkiyle başlar), isteğe bağlı bir tarihe kadar. Başlat kampanyayı aktif yapar; her tetiklenme o anda eşleşenlere bir gönderim yollar. Listeden ya da rapor sayfasından durdurulur. Bkz. Tekrarlayan.

Tekrarlayan zamanlama

Gelişmiş açılır:

Gelişmiş seçenekler

  • TTL — cihaz çevrimdışıyken push servisinin ne kadar deneyeceği (varsayılan 3 gün; 1 saatten 4 haftaya hazır değerler).
  • Teslimat kuralları — bu kampanya için uygulamanın frekans sınırını ve/veya sessiz saatlerini atlamak için işaretleyin (şifre sıfırlama sabahı beklememeli).
  • collapseId — aynı kimlikli yeni push, teslim edilmemiş eskisini değiştirir (apns-collapse-id, FCM collapse_key, web tag).

Test gönder mevcut taslağı tek bir externalId'nin — sizinkinin — her cihazına, kampanyanın durumuna ya da sayaçlarına dokunmadan yollar. Test ayrı bir transactional gönderimdir ve API gönderimleri altında test gönderimi etiketiyle görünür.

Sağdaki özet kartı her şeyi toparlar. Gönder / Zamanla taslağı katı içerik şemasıyla doğrular (tüm diller tam, URL'ler düzgün), nihai content'i yazar ve kuyruğa atar ya da zamanlar. Bundan sonra taslak düzenlenemez.

Düzenleme ve kopyalama​

Taslak gönderilene kadar listeden yeniden açılabilir. Gönderilmiş kampanyalar değişmezdir — raporlarını güvenilir kılan budur. Yeniden göndermek için metni şablon olarak kaydedip ondan yeni kampanya açın ya da DSL'i / metni rapor sayfasından yapıştırın.