Her kampanyanın alıcıları bir yere yönlendirmesi gerekir. Bu yer bir e-posta hedefidir — bir kez kurduğunuz ve kampanyalar genelinde yeniden kullandığınız, kaydedilmiş bir ad, URL ve türden oluşur.

Bir kampanya tam olarak bir hedefe işaret eder ve e-postalarının her tıklanabilir öğesi oraya yönlendirir: CTA düğmesi, logo ve hero görseli. Bunlar analizlerde ayrı ayrı kaydedilir, ancak aynı adresi paylaşırlar.

Hedef türleri

Kampanyanızın amacı, hedef türünü belirler. Hedef türünü oluşturduktan sonra değiştiremezsiniz.

Tür	Uyumlu kampanyalar	Alıcıyı nereye götürür	URL nereden gelir
Web Paywall	Her pazarlama kampanyası ve çift onay	Tarayıcıda bir ödeme sayfası; buradaki satın almalar App Store veya Google Play işlemleri değil, web ödemeleridir.	Adapty Mail tarafından oluşturulur ya da kendi barındırdığınız bir paywall’dan yapıştırılır. Ödeme kurulumu her iki yöntemi de kapsar.
Deep Link	Uygulama aktivasyonu	Seçtiğiniz bir ekranda uygulamanız. Uygulama yüklü değilse mağaza listeniz.	OneLink, Branch veya Firebase gibi bağlantı sağlayıcınızdan yapıştırılır.
Cancellation Page	İptal sayfası kampanyası	Kendi hesap sayfanız ya da faturalandırma sağlayıcınızın portalı; aboneler burada aboneliğini inceleyebilir, değiştirebilir veya iptal edebilir.	Kendi sitenizden veya faturalandırma sağlayıcınızdan yapıştırılır.

İşlemsel kampanyalar için hedefler

Adapty Mail’in üç işlemsel kampanyası vardır:

• Double opt-in — giriş noktanızdan yeni bir profil geldiğinde tetiklenir. Düğmesi, Adapty Mail’in onay sayfasını açar. Alıcı onayladıktan sonra web paywall’unuza yönlendirilir; bu nedenle bu kampanyanın bir web paywall’una ihtiyacı vardır.
• App activation — bir satın alma işleminin ardından tetiklenir ve alıcıyı uygulamanıza yönlendirir.
• Cancellation page — bir satın alma işleminin ardından tetiklenir ve alıcıya abonelik kontrollerini sunar.

Bir kampanya oluşturduğunuzda, boş bir Email Destination açılır menüsü, henüz bu türde bir destination’ınız olmadığı anlamına gelir. Create bağlantısı, ilgili formu açar.

Bir destination oluşturma

1. Email Destinations bölümüne gidin ve kampanyanızın ihtiyaç duyduğu türü seçin.
2. Create düğmesine tıklayın.
3. Destination’a bir Name verin — bunu bir kampanyaya eklerken bu adla seçeceksiniz.
4. URL alanını doldurun. HTTPS kullanması zorunludur.
5. Alıcıya göre değişen değerler için yer tutucular ekleyin.
6. URL’de {response.<key>} yer tutucusu kullanılıyorsa Advanced bölümünün altına bir Hook URL ekleyin.
7. Save düğmesine tıklayın.

Bir destination’ı kampanyaya eklediğinizde —taslak kampanya olsa bile— destination ayarları salt okunur hale gelir. Kampanyayı başka bir yere göndermek için ikinci bir destination oluşturun.

Placeholder’lar

Placeholder’lar, hedef URL’nizi her kullanıcı için kişiselleştirir. Bunlar olmadan sayfanız kimin geldiğini anlayamaz. Adapty Mail, placeholder’ları alıcılara özgü değerlerle değiştirir.

Placeholder	Neye karşılık gelir
{email}	Alıcının e-posta adresi.
{adapty.external_profile_id}	Adapty entegrasyonundan gelen verilere ait profil kimliği.
{funnelfox.external_profile_id}	FunnelFox entegrasyonundan gelen verilere ait profil kimliği.
{custom.external_profile_id}	Adapty Mail API üzerinden gönderdiğiniz kullanıcı kimliği.
{scheduled_email_id}	Bağlantıyı içeren e-postanın kimliği.
{custom_attribute.<key>}	Alıcının profilindeki herhangi bir özel özellik. Anahtarı kendiniz belirleyin — {custom_attribute.plan}.
{response.<key>}	Tıklama anında kendi endpoint’inizin döndürdüğü bir değer. Ayrıntılar için Hook’lar bölümüne bakın.

• Alıcının değer atanmamış olduğu bir yer tutucu boş dizeye dönüşür, dolayısıyla sayfanıza hiçbir zaman ham metin olarak ulaşmaz.
• Özel özellik ve hook değerleri yüzde kodlamalı (percent-encoded) olduğundan, & içeren bir değer URL’yi ikiye bölmez.
• Adapty Mail’in tanımadığı bir yer tutucu kaydetme işlemini engeller ve hata mesajı hem reddedilen değeri hem de kabul edilenleri belirtir. {emial} gibi bir yazım hatası, alıcının tarayıcısına ulaşmak yerine burada yakalanır.

FunnelFox hunilisine bağlantı

Bir hedef FunnelFox hunilisine — bir paywall, geri kazanma teklifi veya ödeme ekranına — yönlendiğinde, alıcının profil ID’sini fpid parametresiyle iletebilirsiniz:

https://your-funnel.example.com/offer?fpid={funnelfox.external_profile_id}&utm_source=adapty_mail&utm_medium=email&utm_content={scheduled_email_id}

fpid sayesinde, hunili yeni bir tane oluşturmak yerine alıcının mevcut FunnelFox profilini kullanmaya devam eder. Hunideki bir satın alma işlemi aynı Adapty Mail profiline ulaşır ve alıcının tıkladığı e-postaya sayılır.

Uygulamanızda erişim izni verin

Eğer funnel’ınız, uygulamanızda erişim vermek için FunnelFox’un Adapty entegrasyonunu kullanıyorsa, kullanıcıyı her iki sistemde de ilişkilendiren tanımlayıcı olan customer user ID’yi de geçirin. Profili FunnelFox’tan gelmeyen alıcılar için bunu adapty_profile_id parametresinde geçirin. FunnelFox bu sayede Adapty’deki satın almayı ilgili customer user ID’ye atar ve uygulamanızda kilit açılır:

https://your-funnel.example.com/offer?fpid={funnelfox.external_profile_id}&adapty_profile_id={custom.external_profile_id}

Hook’lar

{response.<key>} yer tutucusu, kendi endpoint’inizden gelen bir değer için alan ayırır. Yaygın kullanım senaryoları arasında tek kullanımlık bir oturum açma token’ı veya bir oturum imzası yer alır. Bu yer tutucuyu yapılandırmak için Advanced altında yeni bir Hook URL oluşturun — aksi takdirde URL kaydedilemez.

Nasıl çalışır:

1. Alıcı e-postadaki bir bağlantıya tıklar.
2. Adapty Mail, Hook URL’nize alıcıya ait yer tutucuları doldurulmuş şekilde bir GET isteği gönderir. Beş saniye bekler ve yalnızca bir deneme yapar.
3. Endpoint’iniz imzayı doğrular ve düz bir JSON nesnesiyle yanıt verir.
4. Adapty Mail, her {response.<key>} alanını aynı addaki anahtarla doldurur. Döndürmediğiniz anahtarlar yer tutucusu olarak kalır.
5. Hook yanıt verip vermediğinden bağımsız olarak alıcı sayfanıza ulaşır.

İstek

Hook URL’si, geri kalan yer tutucularınızı endpoint’inize iletir. Kullanıcıyı tanımlamak için bu yer tutucuları kullanın. İki başlık çağrıyı doğrular:

Başlık	Değer
X-Adapty-Mail-Timestamp	İsteğin yapıldığı zamandaki Unix zamanı (saniye cinsinden).
X-Adapty-Mail-Signature	Settings > Project bölümündeki Secret key ile anahtarlanmış <timestamp>.<url> ifadesinin Hex HMAC-SHA256’sı.

Yanıt vermeden önce her ikisini de doğrulayın. İmzasız bir endpoint, yetkisiz kullanıcılara hassas bilgiler verebilir. Gerçek bir tıklama olamayacak kadar eski olan zaman damgasını reddedin:

expected = hmac_sha256(
    key=project_secret_key,
    message=f"{timestamp}.{full_request_url}",
).hexdigest()

Yanıt

Düz bir JSON nesnesi. Her anahtar, aynı isimli {response.<key>} alanını doldurur:

{ "checkout_token": "ct_9f2a…", "plan": "annual" }

Dizeler, sayılar ve boolean değerlerin hepsi string’e dönüştürülür. İç içe nesneler ve diziler ise bir URL’ye yerleştirilemeyeceğinden atılır.

Tıklamadan sonra ne olur

Adapty Mail değerleri doldurur, varsa hook’u çağırır, tıklamayı kaydeder ve alıcıyı sayfanıza yönlendirir.

Sizin göreviniz ziyaretçiyi tanımlamak, ödemeyi almak ve satın almayı Adapty’e bildirmektir. Paywall kurulumu için Ödeme sayfası kurulumu bölümüne, satın alma attribution’ı için ise Kampanya analitiği bölümüne bakın.