メインコンテンツへスキップ

​
概要

OneSignalは、ユーザーが簡単に購読解除でき、サブスクリプションステータスがリアルタイムで更新されるように、メールテンプレートにリンクを挿入するデフォルトのメール準拠購読解除エクスペリエンスを提供します。ブランディング、コピー、フィールド（カテゴリオプトアウトなど）を完全に制御したい場合は、デフォルトのリンクを独自のカスタムページに置き換え、OneSignal APIを使用してユーザー設定を購読解除または更新できます。 このガイドでは、メールに独自のカスタム購読解除ページを追加する方法（デフォルトのOneSignalリンクを削除）と、ユーザーのメールサブスクリプションを購読解除するために使用するAPIについて説明します。 カスタム購読解除ページにさらに機能を追加したい場合（すべてではなく特定のメールカテゴリからオプトアウトするなど）、これはPreference Centerチュートリアルで詳しく説明されています。

​
OneSignalのデフォルト購読解除リンクを削除

OneSignalは、[unsubscribe_url]形式の特別なリンクをメールテンプレートに自動的に挿入します。このURLは、OneSignalのすべてのメールからユーザーを購読解除します。詳細については、Email Unsubscribe Linksを参照してください。 独自のページを使用するには、テンプレート内のデフォルトのリンクを見つけて削除します。
  • ドラッグアンドドロップエディター
  • HTMLエディター
ドラッグアンドドロップエディターでは、デフォルトのリンクが次のようにネストされて表示される場合があります：
ドラッグアンドドロップエディターの購読解除リンク

ドラッグアンドドロップエディターの購読解除リンク

​
カスタム購読解除リンクを追加

特別なリンクを削除したので、独自のURLに置き換えることができます。 多くの場合、これらのリンクはページに渡すための追加データが必要です。Liquid変数を使用してOneSignalデータをページに渡します。 一般的なパラメータ：
パラメータ説明
subscription.emailサブスクライバーのメールアドレス
subscription.external_idユーザーの外部ID
app.idOneSignal App ID
message.idメール通知のID
subscription.language優先言語（ローカリゼーション用）
subscription.unsubscribe_tokenAPI検証用のセキュリティトークン
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>
カスタム購読解除リンクを追加

カスタム購読解除リンクを追加

​
クリックトラッキングを無効にする

購読解除のクリックは通常、エンゲージメント指標には使用されません。リンクトラッキングを無効にしたい場合は、次のようにリンクにdata-disable-tracking="true"属性を追加できます：
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>
プロバイダー固有の属性：
プロバイダー属性
OneSignaldata-disable-tracking="true"
Mailgundisable-tracking=true
SendGridclicktracking=off
Mandrillmc:disable-tracking

​
カスタム購読解除ページのホスティング

次の機能を持つWebページをデプロイします：
  • 購読解除リンクからクエリパラメータを読み取ります。
  • ユーザーフレンドリーなオプトアウトまたは設定オプションを表示します。
  • APIを介してOneSignalに購読解除または更新リクエストを送信します。
フォークしてデプロイできる実用的なGitHubサンプルプロジェクトを提供しています。
サンプル購読解除ページ

サンプル購読解除ページUI

​
OneSignal APIの呼び出し

ユースケースに応じて、以下のAPIを使用してユーザー設定を購読解除または更新できます：
  • Update Subscription by Token
  • Unsubscribe Email with Token
  • Update User
このAPIは、ユーザーのメールアドレスがあり、すべてのメールから購読または購読解除したい場合に最も一般的に使用されます。必須クエリパラメータ：
  • app_id
  • token
認証が必要
  • このAPIはサーバーから呼び出してください。
これで、カスタム購読解除ページの作成について知っておく必要があるすべてが揃いました。