Özel email abonelikten çıkma sayfası oluşturma

Genel Bakış

OneSignal, email şablonlarınıza bir bağlantı ekleyen varsayılan email uyumlu abonelikten çıkma deneyimi sağlar, böylece kullanıcılar kolayca abonelikten çıkabilir ve abonelik durumları gerçek zamanlı olarak güncellenir. Marka, metin ve alanlar (kategori çıkışları gibi) üzerinde tam kontrol istiyorsanız, varsayılan bağlantıyı kendi özel sayfanızla değiştirebilir ve kullanıcı tercihlerini abonelikten çıkarmak veya güncellemek için OneSignal API’sini kullanabilirsiniz. Bu kılavuz, emaillere kendi özel abonelikten çıkma sayfanızı nasıl ekleyeceğinizi (varsayılan OneSignal bağlantısını kaldırarak) ve kullanıcının email Aboneliğinden çıkmak için API’lerimizden hangilerini kullanacağınızı açıklar. Özel abonelikten çıkma sayfanıza daha fazla işlevsellik eklemek isterseniz (tümü yerine belirli email kategorilerinden çıkmak gibi), bu Preference Center eğitimimizde ayrıntılı olarak açıklanmıştır.

OneSignal’ın varsayılan abonelikten çıkma bağlantısını kaldırma

OneSignal, email şablonlarınıza otomatik olarak [unsubscribe_url] formatında özel bir bağlantı ekler. Bu URL, kullanıcıyı OneSignal’daki tüm emaillerden abonelikten çıkarır. Ayrıntılar için Email Unsubscribe Links’e bakın. Kendi sayfanızı kullanmak için, şablonunuzda varsayılan bağlantıyı bulun ve kaldırın.

Sürükle ve Bırak Editörü
HTML Editörü

Sürükle ve bırak editöründe, varsayılan bağlantı şu şekilde iç içe görünebilir:

Drag-and-Drop editor unsubscribe link — Sürükle ve Bırak editörü abonelikten çıkma bağlantısı

<a href="[unsubscribe_url]">Unsubscribe</a>

Özel abonelikten çıkma bağlantınızı ekleme

Artık özel bağlantımızı kaldırdığınıza göre, onu kendi URL’nizle değiştirebilirsiniz. Çoğu zaman, bu bağlantılar sayfanıza aktarılması gereken bazı ek veriler gerektirir. OneSignal verilerini sayfanıza aktarmak için Liquid variables kullanın. Yaygın parametreler:

Parameter	Description
`subscription.email`	Abonenin email adresi
`subscription.external_id`	Kullanıcının harici kimliği
`app.id`	OneSignal App ID
`message.id`	Email bildiriminin kimliği
`subscription.language`	Tercih edilen dil (yerelleştirme için)
`subscription.unsubscribe_token`	API doğrulaması için güvenlik token’ı

Örnek URL:

https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}

HTML

  <div style="text-align: center;">
    <a
      href="https://examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
      data-disable-tracking="true"
      style="display: inline; text-decoration: none;"
    >
      Unsubscribe
    </a>
    <p style="display: inline;"> from our emails</p>
  </div>

Add custom unsubscribe link — Özel abonelikten çıkma bağlantısı ekleme

Tıklama izlemeyi devre dışı bırakma

Abonelikten çıkma tıklamaları genellikle etkileşim metrikleri için kullanılmaz. Bağlantı izlemeyi devre dışı bırakmak isterseniz, bağlantınıza data-disable-tracking="true" özniteliğini şu şekilde ekleyebilirsiniz:

HTML

  <a
    href="https://www.examplesite.com/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{subscription.language}}&token={{subscription.unsubscribe_token}}"
    data-disable-tracking="true"
  >
    Unsubscribe
  </a>

Sağlayıcıya özel öznitelikler:

Provider	Attribute
OneSignal	`data-disable-tracking="true"`
Mailgun	`disable-tracking=true`
SendGrid	`clicktracking=off`
Mandrill	`mc:disable-tracking`

Özel abonelikten çıkma sayfanızı barındırma

Şunları yapan bir web sayfası yayınlayın:

Abonelikten çıkma bağlantısından sorgu parametrelerini okur.
Kullanıcı dostu çıkış veya tercih seçeneklerini görüntüler.
Abonelikten çıkma veya güncelleme isteğini API aracılığıyla OneSignal’a gönderir.

Fork edip yayınlayabileceğiniz çalışan bir GitHub örnek projesi sağlıyoruz.

Sample unsubscribe page — Örnek abonelikten çıkma sayfası kullanıcı arayüzü

OneSignal API’sini çağırma

Kullanım senaryonuza bağlı olarak, kullanıcı tercihlerini abonelikten çıkarmak veya güncellemek için aşağıdaki API’leri kullanabilirsiniz:

Token ile Aboneliği Güncelleme
Token ile Email Abonelikten Çıkma
Kullanıcıyı Güncelleme

Bu API, kullanıcının email adresine sahip olduğunuzda ve onları tüm emaillerden abone yapmak veya abonelikten çıkarmak istediğinizde en yaygın kullanılır.Gerekli sorgu parametreleri:

app_id
token

Kimlik doğrulama gerekli

Bu API’yi sunucunuzdan çağırın.

Hangi belirli email’in abonelikten çıkmaya neden olduğunu izlemek istiyorsanız bu API’yi kullanın. Bu, abonelikten çıkmayı izlemek için email mesaj kimliğini kullanır. Daha fazla ayrıntı için Unsubscribe Email with Token API’sine bakın.Gerekli sorgu parametreleri:

app_id
notification_id
token

İsteğe bağlı parametreler:

email
language

Örnek JavaScript:

JavaScript

const unsubscribeURL = (href) => {
  const unsubscribeURL = new URL(href)
  const appID = unsubscribeURL.searchParams.get("app_id")
  const notificationID = unsubscribeURL.searchParams.get("notification_id")
  const unsubscribeToken = unsubscribeURL.searchParams.get("token")
  const language = unsubscribeURL.searchParams.get("language")
  const email = unsubscribeURL.searchParams.get("email")
  return {
    unsubscribeURL: `https://api.onesignal.com/apps/${appID}/notifications/${notificationID}/unsubscribe?token=${unsubscribeToken}`,
    meta: { language, email },
  }
}

Update User API’sini kullanarak kullanıcının tercihlerini güncelleyin.Gerekli sorgu parametreleri:

app_id
alias_id - Kullanıcının harici kimliği önerilir.

Kimlik doğrulama gerekli

Bu API’yi sunucunuzdan çağırın.

Artık özel bir abonelikten çıkma sayfası oluşturmak hakkında bilmeniz gereken her şeyle donatılmış olmalısınız.

İlk adımlar & ayarlar

Mesaj kanalları

Journey'ler

Hedeflenen & özel olaylar

Analitik ve Entegrasyonlar

Gizlilik & Güvenlik

Özel email abonelikten çıkma sayfası oluşturma

Genel Bakış

OneSignal’ın varsayılan abonelikten çıkma bağlantısını kaldırma

Özel abonelikten çıkma bağlantınızı ekleme

Tıklama izlemeyi devre dışı bırakma

Özel abonelikten çıkma sayfanızı barındırma

OneSignal API’sini çağırma

​Genel Bakış

​OneSignal’ın varsayılan abonelikten çıkma bağlantısını kaldırma

​Özel abonelikten çıkma bağlantınızı ekleme

​Tıklama izlemeyi devre dışı bırakma

​Özel abonelikten çıkma sayfanızı barındırma

​OneSignal API’sini çağırma

Genel Bakış

OneSignal’ın varsayılan abonelikten çıkma bağlantısını kaldırma

Özel abonelikten çıkma bağlantınızı ekleme

Tıklama izlemeyi devre dışı bırakma

Özel abonelikten çıkma sayfanızı barındırma

OneSignal API’sini çağırma