Ömür Boyu kampanyaları kullanın

Bu sayfa size ne yardımcı olur

Sisteminizdeki etkinliklere hazır kalan bir Ömür Boyu kampanya oluşturun. Her geçerli tetikleyici en fazla bir yürütme oluşturur ve yükündeki kişiye bir uyarı gönderir.

Bu neden önemlidir

Kampanyaları sürekli olarak oluşturup başlatmadan zamanında, alakalı e-posta gönderebilirsiniz. Bir etkinliğin ne zaman gerçekleşeceğini arka ucunuz kontrol ederken, Nudgen e-posta içeriğini, teslimatı, takibi ve iletişim tercihlerini tek bir yerde tutar.

Ömür Boyu bir kampanya ne zaman kullanılmalı

Olay odaklı e-posta için Ömür Boyu bir kampanya kullanın, örneğin:

Sipariş onayları
Ödeme hatırlatıcıları
Etkinliğe dayalı katılım
Hesap veya abonelik güncellemeleri

Tek seferlik ve damla kampanyalardan farklı olarak Ömür Boyu kampanya şunları yapar: kayıtlı bir hedef kitleye hemen göndermeyin. Hedef kitlesi her zaman Tetikleyici’dir.

Bir kampanya oluşturun ve etkinleştirin

Create a Lifetime campaign

Kampanyalar’a gidin, Yeni kampanya’yı tıklayın ve ardından Ömür Boyu’nu seçin. Kampanya adını, hedefi, marka yapılandırmasını ve isteğe bağlı CTA bağlantısını ekleyin.

Define runtime parameters

Sisteminizin gönderme sırasında sağlayacağı her değeri ekleyin. Bir parametre bir data.* değişkeni oluşturur: örneğin, order_id, e-postada {{data.order_id}} olur.

Create the email

Konuyu ve HTML’yi oluşturun veya yazın, ardından çalışma zamanı değişkenlerinizi ait oldukları yere ekleyin. E-postayı önizleyin ve etkinleştirmeden önce bir test gönderin.

Activate the campaign

Taslak olarak kaydedin ve Etkinleştir’i tıklayın. Nudgen, gerekli parametrelerin e-postada sunulduğunu ve parametre sözleşmesinin oluşturulduğundan bu yana değişmediğini kontrol eder.

Create a trigger key

Ayarlar → API Anahtarları’na gidin ve bir Takım tetikleyici API anahtarı oluşturun. ndg_team_* sırrını arka uçta veya gizli yöneticinizde saklayın; asla tarayıcıya veya mobil uygulama koduna yerleştirmeyin.

Çalışma zamanı parametreleri ve şablon değişkenleri

variableManifest’niz, e-posta şablonu ile her tetikleyicinin data nesnesi arasındaki sözleşmedir. Bir kampanya en fazla 100 değişken tanımlayabilir.

Alan	Tür	Gerekli	Açıklama
`path`	`data.<name>`	Evet	Değişken yol. `data.order.total` gibi iç içe geçmiş yollar desteklenir.
`type`	`string`, `number`, `boolean`, `date` veya `url`	Evet	Tetikleyicinin sağlaması gereken türü yazın. `date` geçerli bir tarih dizesi olmalı ve `url`, HTTP(S) olmalıdır.
`required`	boole	Evet	Eksik değerler, bir varsayılan ayarlanmadıkça `422` değerini döndürür.
`defaultValue`	dize, sayı veya boole	Hayır	Değişken türüyle eşleşmesi gereken geri dönüş değeri.
`description`	dize	Hayır	Değeri açıklayın ki siz ve Nudgen AI bunu doğru şekilde kullanabilsin.

Örneğin, bir şablonda {{data.order_id}}, {{data.total}} ve {{data.order_url}} kullanın. Ayrıca contact.*, event.*, brand.*’nin yanı sıra {{firstName}} ve {{brandName}} gibi eski değişkenleri de kullanabilirsiniz. Ndgen, HTML’ye eklenen değişken değerlerden kaçar. Şablonlar JavaScript’i, ifadeleri veya döngüleri desteklemez. href’de kullanılan herhangi bir değişken, url türüyle bildirilen bir data.* değişkeni olmalıdır.

Yaşam döngüsünü yönetin

Durum	Ne anlama geliyor
Taslak	Kampanyayı yapılandırın ve e-postasını test edin.
Aktif	Nudgen, kimliği doğrulanmış tetikleyicileri kabul eder.
Duraklatıldı	Nudgen yeni tetikleyicileri kabul etmiyor. Devam ettirebilirsiniz.
Arşivlendi	Kampanya kalıcı olarak kapatılmıştır ve tekrar etkinleştirilemez.

Geçerli geçişler draft → active → paused → active ve active|paused → archived’dir.

Duraklatma veya arşivleme, hâlâ beklemede veya sıraya alınmış olan yürütmeleri iptal eder. Halihazırda işlenmekte olan bir yürütme hâlâ gönderilebilir.

Nudgen tetikleyiciyi aldığında her yürütme, kampanya içeriğinin anlık görüntüsünü alır ve ayarları gönderir. Etkin bir kampanyayı düzenlemek, halihazırda mevcut olan yürütmeleri değil, yalnızca sonraki tetikleyicileri etkiler.

Arka ucunuzdan tetikleyin

Kaynak etkinliğini doğruladıktan sonra güvenilir bir sunucudan tetikleyici uç noktasını arayın. Kişisel Erişim Simgesini (PAT) değil, Ekip tetikleyici API anahtarını kullanın.

curl -X POST "$NUDGEN_APP_URL/api/v1/campaigns/$CAMPAIGN_ID/triggers" \
  -H "Authorization: Bearer $NUDGEN_TEAM_API_KEY" \
  -H "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "eventId": "order_123",
  "eventName": "order.created",
  "occurredAt": "2026-08-23T10:00:00Z",
  "contact": {
    "email": "an@example.com",
    "externalId": "customer_456",
    "name": "An Nguyen",
    "metadata": { "company": "Nudgen" }
  },
  "data": {
    "order_id": "order_123",
    "total": 490000,
    "order_url": "https://example.com/orders/order_123"
  }
}
JSON

Bir etkinliği yeniden denediğinizde aynı eventId’yi koruyun. Ndgen, başka bir dürtme göndermek yerine 200 ve duplicate: true ile mevcut yürütmeyi döndürür. Yeni bir yürütme, 201 değerini döndürür.

Güvenli bir şekilde entegre edin

Bir web kancası tüketicisinden veya arka uçtan tetikleyin ve Nudgen’i çağırmadan önce gelen web kancasını doğrulayın.
Üstel geri çekilme ile ağ hatalarını, 429 ve 503’yi yeniden deneyin ve aynısı eventId.
Authorization başlıklarını veya hassas iletişim verileri içeren yükleri günlüğe kaydetmeyin.
Tetikleyici anahtarları düzenli olarak döndürün ve açığa çıktığından şüpheleniyorsanız bir anahtarı hemen iptal edin.
Şablonların ve yürütme denetimlerinin net kalması için etkinlik türü ve değişken sözleşme başına bir kampanya oluşturun.

Yürütmeleri izleyin

En son yürütmeleri ve durumlarını görmek için kontrol panelinde kampanyayı açın. Bir yürütme pending, queued, processing, sent, skipped, cancelled, failed veya failed olabilir veya delivery_unknown. skipped, kişinin aboneliğinin iptal edildiği veya geri döndüğü anlamına gelir; dolayısıyla Nudgen olayı kaydeder ancak göndermez veya kotayı tüketmez. delivery_unknown, sağlayıcının e-postayı kabul etmiş olabileceği ancak nihai teslimat sonucunun belirsiz olduğu anlamına gelir; Ndgen, yinelenen gönderimi önlemek için otomatik olarak yeniden denemez. Programatik kurulum, tetikleme ve yürütme sorguları için Geliştirici API’sine bakın.

Başlangıç

Kişiler

Kampanyalar

Marka

Panel

Ayarlar

Faturalandırma

Satış ortaklığı

Agents

E-posta Bulucu (Uzantı)

İmza Oluşturucu

Spam Kontrolü

E-posta Teslimat Denetimi

Kavramlar

Sorun Giderme

Güvenlik ve Gizlilik

Ömür Boyu kampanyaları kullanın

Bu sayfa size ne yardımcı olur

Bu neden önemlidir

Ömür Boyu bir kampanya ne zaman kullanılmalı

Bir kampanya oluşturun ve etkinleştirin

Çalışma zamanı parametreleri ve şablon değişkenleri

Yaşam döngüsünü yönetin

Arka ucunuzdan tetikleyin

Güvenli bir şekilde entegre edin

Yürütmeleri izleyin

İlgili belgeler

Campaigns overview

Developer API

​Bu sayfa size ne yardımcı olur

​Bu neden önemlidir

​Ömür Boyu bir kampanya ne zaman kullanılmalı

​Bir kampanya oluşturun ve etkinleştirin

​Çalışma zamanı parametreleri ve şablon değişkenleri

​Yaşam döngüsünü yönetin

​Arka ucunuzdan tetikleyin

​Güvenli bir şekilde entegre edin

​Yürütmeleri izleyin

​İlgili belgeler

Campaigns overview

Developer API

Bu sayfa size ne yardımcı olur

Bu neden önemlidir

Ömür Boyu bir kampanya ne zaman kullanılmalı

Bir kampanya oluşturun ve etkinleştirin

Çalışma zamanı parametreleri ve şablon değişkenleri

Yaşam döngüsünü yönetin

Arka ucunuzdan tetikleyin

Güvenli bir şekilde entegre edin

Yürütmeleri izleyin

İlgili belgeler