Ana içeriğe atla

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ı


Ö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:
ParameterDescription
subscription.emailAbonenin email adresi
subscription.external_idKullanıcının harici kimliği
app.idOneSignal App ID
message.idEmail bildiriminin kimliği
subscription.languageTercih edilen dil (yerelleştirme için)
subscription.unsubscribe_tokenAPI 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:
ProviderAttribute
OneSignaldata-disable-tracking="true"
Mailgundisable-tracking=true
SendGridclicktracking=off
Mandrillmc: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.

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