メインコンテンツまでスキップ

RoktカレンダーをBrazeと統合する

セットアップ

Roktカレンダーは、パートナーが独自のネットワークを介してサブスクライバーカレンダーに対してカレンダーイベントと通知の形で1対1のイベントとプロモーションコミュニケーションを送信できるダイナミックなカレンダーマーケティングテクノロジーです。Brazeのウェブフックを介してRoktカレンダーのサービスにアクセスし、エンドユーザーにメッセージを送信することができます。

Brazeウェブフック

この統合により、Roktカレンダーサブスクライバーと関連するサブスクリプションデータがBrazeにプッシュされ、この情報が既存のユーザープロファイルにカスタム属性として追加されます。カレンダーサブスクライバーとBrazeユーザーの間に一致がない場合、Brazeに新しいユーザーが作成されます。

Brazeキャンバスを使用して、対象のセグメントをターゲットにするジャーニーを定義することができます。カレンダーイベントは、SMS、メール、プッシュ通知と同じようにコミュニケーション手段として使用されます。オーディエンスセグメンテーションは、標準のBrazeユーザー属性およびカレンダーサブスクリプションを介して生成されたカスタム属性のいずれかを基に行うことができます。

カレンダーイベントのコンテンツを定義するには、Brazeウェブフックテンプレートを作成する必要があります。テンプレートは、カレンダーイベントの作成に使用できます。

以下のガイダンスを参照してください:

  • 一般的な要件
  • 統合のセットアップ
  • ウェブフックのセットアップ
  • カレンダーサブスクライバーの生成
  • ウェブフックテンプレートの使用(イベントの作成または定義)

セットアップ要件

要件担当者説明
Rokt Calendar OAuth 資格情報Rokt CalendarRokt Calendar アカウントマネージャーこれらの資格情報を使用して、Braze と Rokt Calendar のアカウントを接続します。新しい Braze クライアントごとに設定され、Braze の Connected Content に追加されます。以下の手順で追加できます:。

Manage App Group > Connected Content > Add Credential
Rokt Calendar アカウントRokt CalendarRokt Calendar アカウントマネージャーアカウントマネージャーによって、パートナー固有の Rokt Calendar アカウントが設定されます。
カレンダーのセットアップRokt CalendarRokt Calendar アカウントマネージャービジネスのコンテキストと設定を反映するために、カレンダーが設定されます:

- マージフラグ
- subscriberId のフォールバックフラグ
- 必要な場合はメールアドレスの取得
Webhook のセットアップRokt CalendarRokt Calendar アカウントマネージャー管理センターに Braze webhook タイプを追加します。以下の手順を使用します:

- Braze エンドポイント—https://rest.iad-01.braze.com
- REST API キー
外部の subscriberIdパートナーパートナーRokt Calendar の購読プロセスで使用される識別子で、カレンダーの購読者を Braze のユーザーと一致させるために使用されます。これはパートナーから Rokt Calendar に渡されるものです。メールアドレスも使用できます。
REST API キーと権限BrazeパートナーBraze で新しい API キーを作成し、アカウントマネージャーに提供します。Braze で新しい API キーを作成するには、以下の手順に従います:

Developer Console > API Settings > Create New API Key で、User Data の下にある users.track, users.alias.new および users.identify の権限を設定します。

統合

RoktカレンダーとBrazeアカウントの両方を使用して、Roktカレンダーの統合を設定します。2種類のテンプレートを設定する必要があります:

  • 新しいパーソナライズされたイベントを送信—サブスクライバーのカレンダーのセグメントに新しいイベントを追加するためのもの
  • パーソナライズされたイベントを更新—すでにサブスクライバーのカレンダーに追加されているイベントを更新するためのもの

テンプレートの設定: 新しいパーソナライズされたイベントを送信

  1. Brazeでウェブフックテンプレートを作成します。これはテンプレート&メディアセクションから作成するか、Brazeで新しいウェブフックキャンペーンを作成します。空のテンプレートを選択します。

ウェブフックテンプレート

  1. テンプレートを入力します。テンプレートの設定を完了するために、以下を設定します:
  • 設定
  • 作成

ウェブフックの設定

リクエストヘッダーHTTPメソッドを設定します。

ウェブフックの設定

リクエストヘッダー

Authorizationには、以下を入力します:

Bearer {% connected_content https://api.roktcalendar.com/oauth2/token :method post :basic_auth Rokt-Calendar-API :body grant_type=client_credentials :save token :retry %}{{token.access_token}}
注記

これはアプリグループの管理 > 接続コンテンツ > 資格情報での資格情報名です。

リクエストヘッダー

Content-Typeには、"application/json"を入力します。

HTTPメソッド

HTTPメソッドには、Postを選択します。

ウェブフックの作成 {#webhook-compose}

作成タブで、ウェブフックのURLリクエストボディの内容を定義して、設定を完了します。

ウェブフックの作成

ウェブフックのURL

ウェブフックのURLには、以下を入力します:

{% assign accountCode = {{custom_attribute.${rokt:account_code}}}[0] | split: '/' | first %}https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}

リクエストボディ

リクエストボディのドロップダウンから、Raw Textを選択します。

リクエストボディテキストボックスには、以下を入力します:

{% capture eventId %}Event_0001{% endcapture %}
{% capture eventTitle %}Event Title{% endcapture %}
{% capture eventDescr %}Event Description{% endcapture %}
{% capture eventLocation %}Event Location{% endcapture %}
{% capture eventStart %}2019-02-21T15:00:00{% endcapture %}
{% capture eventEnd %}2019-02-21T15:00:00{% endcapture %}
{% capture notifyBefore %}15{% endcapture %}
{% capture eventTZ %}Eastern Standard Time{% endcapture %}
{% comment %} 有効なタイムゾーンのリストについては、以下を参照してください: https://roktcalendar-api.readme.io/docs/timezones {% endcomment %}
{
"event": {
"eventId": "{{eventId}}_{{${user_id}}}",
"title": "{{eventTitle}}",
"description": "{{eventDescr}}",
"location": "{{eventLocation}}",
"start": "{{eventStart}}",
"end": "{{eventEnd}}",
"timezone": "{{eventTZ}}",
"notifyBefore": "{{notifyBefore}}"
},
"subscriptionIds": ["{{custom_attribute.${rokt:subscription_id}| join: '","' }}"]
}

テンプレートのセットアップ:パーソナライズされたイベントの更新

  1. Brazeでウェブフックのテンプレートを作成します。これは、テンプレート&メディアセクションから作成するか、Brazeで新しいウェブフックキャンペーンを作成します。空のテンプレートを選択します。

テンプレートパーソナライズイベント

  1. テンプレートを記入します。テンプレートのセットアップを完了するには、以下を設定します:
  • 設定
  • 作成

ウェブフック設定

リクエストヘッダHTTPメソッドを設定します。

ウェブフック設定

リクエストヘッダ

Authorizationには、次のように入力します:

Bearer {% connected_content https://api.roktcalendar.com/oauth2/token :method post :basic_auth Rokt-Calendar-API :body grant_type=client_credentials :save token :retry %}{{token.access_token}}
注記

これは、アプリグループの管理 > 接続コンテンツ > 資格情報での資格情報名です。

ウェブフック設定

Content-Typeには、"application/json"と入力します。

HTTPメソッド

HTTPメソッドには、Postを選択します。

ウェブフック作成

Composeタブで、ウェブフックURLリクエストボディの内容を定義して、セットアップを完了します。

ウェブフック設定

ウェブフックURL

ウェブフックURLには、次のように入力します:

{% assign accountCode = {{custom_attribute.${rokt:account_code}}}[0] | split: '/' | first %}https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}/update
リクエストボディ

リクエストボディのドロップダウンから、Raw Textを選択します。

リクエストボディのテキストボックスに以下を入力します:

{% capture eventId %}Event_0001{% endcapture %}
{% capture eventTitle %}イベントタイトル{% endcapture %}
{% capture eventDescr %}イベントの説明{% endcapture %}
{% capture eventLocation %}イベントの場所{% endcapture %}
{% capture eventStart %}2019-02-21T15:00:00{% endcapture %}
{% capture eventEnd %}2019-02-21T15:00:00{% endcapture %}
{% capture notifyBefore %}15{% endcapture %}
{% capture eventTZ %}東部標準時{% endcapture %}
{% comment %} 有効なタイムゾーンのリストについては、次を参照してください: https://roktcalendar-api.readme.io/docs/timezones {% endcomment %}
{
"event": {
"eventId": "{{eventId}}_{{${user_id}}}",
"title": "{{eventTitle}}",
"description": "{{eventDescr}}",
"location": "{{eventLocation}}",
"start": "{{eventStart}}",
"end": "{{eventEnd}}",
"timezone": "{{eventTZ}}",
"notifyBefore": "{{notifyBefore}}"
}

Webhookの使用

Webhookテンプレートからイベントを作成する

Webhookテンプレートを作成したら、カレンダーイベントとメッセージを送信する準備がほぼ整いました。以下のフィールドでは、イベントレベルでカスタマイズできる内容が詳細に説明されています。

フィールド定義
eventId
(必須)
追加または更新されるイベントの一意の識別子Event_00001
eventTitle
(必須)
カレンダーに表示されるイベントのタイトルSummer Sale 2020
eventDescrカレンダーに表示されるイベントの説明The sale is on for 3 days, click this link www.mybusiness.com/sale to see the offers.
eventLocationカレンダーに表示されるイベントの場所。これは通常、eventTitle に補完的なアクションのために使用されますOpen the event to get 50% off
eventStart
(必須)
カレンダーに表示されるイベントの開始日時2020-02-21T15:00:00
eventEnd
(必須)
カレンダーに表示されるイベントの終了日時2020-02-21T16:00:00
eventTz
(必須)
カレンダーに表示されるイベントのタイムゾーン。適用可能なタイムゾーンのリストはこちらで確認できますEastern Standard Time
notifyBefore
(必須)
カレンダーに表示されるイベントのリマインダーの時間(分単位)15

カスタム属性にRoktカレンダーサブスクリプションのレコードが保存されているBrazeユーザーにのみカレンダーイベントを送信できます。これらは以下の表に示されており、オーディエンスをセグメント化するために使用できます。

カスタム属性定義例の値
rokt:account_codeRoktカレンダーアカウントのコードbrazetest/f5733866ade2およびbrazetest/ff10919f1078
rokt:account_idRoktカレンダーアカウントのIDd0ce4299-7d6c-4888-bfd8- c7e867a0fa6c/f5733866ade2
rokt:account_nameRoktカレンダーアカウントの名前Braze Test/f5733866ade2
rokt:calendar_codeRoktカレンダーカレンダーのコードtest-calendar-1/f5733866ade2
rokt:calendar_idRoktカレンダーカレンダーのID9a9007c7-f5a4-e811-b13c- 06424c4f2724/f5733866ade2
rokt:calendar_titleRoktカレンダーカレンダーのタイトルTest Calendar 1/f5733866ade2
rokt:country_code作成されたサブスクリプションに関連する国コードAU/f5733866ade2
rokt:device_name作成されたサブスクリプションに関連するデバイスの種類Desktop/f5733866ade2
rokt:geo_country作成されたサブスクリプションに関連する起源の国Australia/f5733866ade2
rokt:optIn1作成されたサブスクリプションに関連する2つのオプトインのうち、ユーザーが最初のオプトインに同意したかどうかTrue/f5733866ade2
rokt:optIn2作成されたサブスクリプションに関連する2つのオプトインのうち、ユーザーが2番目のオプトインに同意したかどうかTrue/f5733866ade2
rokt:source作成されたサブスクリプションのソースbrazetest.Rokt Calendarapp.com/f5733866ade2
rokt:subscriber_emailサブスクリプションプロセス中にユーザーが入力したメールアドレスtest@email.com/f5733866ade2
rokt:subscription_id作成されたサブスクリプションに関連する一意の識別子であるサブスクリプションID06423672-b6ba-4536-aa36- 70788a7a0a36
rokt:subscription_method作成されたサブスクリプションに関連するサブスクリプション方法(例:webcalまたはGoogle)WebCal/f5733866ade2
rokt:tags作成されたサブスクリプションに関連するカレンダータグTest Calendar 1/All Teams/f5733866ade2およびTest Calendar 1/TeamI//f5733866ade2

カレンダーのサブスクリプションの使用

Roktカレンダーを使用してカレンダーの購読者のオーディエンスを構築する

Braze Canvasを使用してRoktカレンダーの統合を介してカレンダーイベントを送信するには、カレンダーを設定し、ユーザーがカレンダーに購読する必要があります。これを行うには、ユーザーにカレンダーに購読する場所と方法を通知する必要があります。

要件オリジン説明
Roktカレンダーアカウントの設定RoktカレンダーRoktカレンダーアカウントマネージャー特定のクライアントのRoktカレンダーアカウントを設定する必要があります。アカウントマネージャーに連絡するには、sales-calendar@rokt.comに連絡してください。
カレンダーの設定RoktカレンダーRoktカレンダーアカウントマネージャーRoktのアカウントマネージャーと協力して、ビジネスのニーズに合ったカレンダーを設定します。
購読統合ポイントの提供クライアントクライアントカレンダーの購読者のオーディエンスを構築するには、ユーザーがカレンダーに購読できる場所からナビゲートできる宛先を提供する必要があります。

一般的な購読統合ポイントの例:
- ウェブサイトのカレンダーボタンに追加
- アプリのカレンダーボタンに追加
- メールやSMSのカレンダーリンクに追加
- ソーシャルメディアのカレンダーリンクに追加

詳細を見る
カレンダーのプロモーションクライアントクライアント購読方法を知ってもらうために、カレンダーをオーディエンスに宣伝することを検討してください。

カレンダープロモーションの例:
- ソーシャルメディアの投稿
- メールニュースレターや更新情報
- ブログ記事
- アプリ内通知

詳細を見る

RoktカレンダーとBrazeの実装ガイド

このドキュメントは、RoktカレンダーとBrazeの相互作用について説明し、特にRoktからBrazeへのデータフローに焦点を当てています。

RoktからBrazeへのフローダイアグラム

1. カレンダーの購読者を生成およびオンボードする

カレンダーの購読者の生成/オンボード

Braze内でコミュニケーションチャネルとしてカレンダーを使用するには、既存のカレンダーの購読者オーディエンスが必要です。Brazeキャンペーンを使用して、既存のオーディエンスからカレンダーの購読者を生成することができます。これは、電子メール、SMS、プッシュ通知、または別のチャネルを介して行われます。メッセージには、カレンダーの利点と購読方法が含まれていることを確認してください。

以下の表には、利用可能なキャンペーンコミュニケーション方法がリストされています:

方法オリジン説明
電子メールBrazeカレンダーの購読について説明するメールを送信し、ユーザーをカレンダーの購読ページにリダイレクトするリンクを含めます。
SMSBrazeカレンダーの購読について説明するSMSを送信し、ユーザーをカレンダーの購読ページにリダイレクトするリンクを含めます。
プッシュ通知Brazeカレンダーの購読について説明するプッシュ通知を送信し、ユーザーをカレンダーの購読ページにリダイレクトするリンクを含めます。

その後、オーディエンスが存在すると、カレンダーをコミュニケーションチャネルとして使用できます。

カレンダーコミュニケーションチャネル

購読する場所と方法

既存のオーディエンスメンバーは、関連するカレンダーに購読する場所に誘導される必要があります。BrazeとRokt Calendarのアカウントマネージャーは、ビジネスの文脈を評価し、最適な購読統合方法を決定するために協力することができます。

購読統合方法

以下の表に、オーディエンスメンバーがカレンダーに購読するためのさまざまな方法がリストされています。

統合方法システム連絡先説明
Rokt Calendar SmartCal ページRokt CalendarRokt Calendar アカウントマネージャー- Roktによってホストされ、セットアップは不要
- ウェブサイトのページに埋め込まれ、最小限のセットアップが必要
Rokt プレースメントRoktRokt アカウントマネージャープレースメントはカレンダーへの追加機能を提供し、ユーザーが関連するカレンダーに購読することができます。Roktプレースメントは以下のように表示されます:

- トランザクション前
- トランザクション後
- トランザクションとは独立して単独のオプションとして(つまり、製品ページ上で)

これには、Roktタグをウェブサイトに追加し、関連するデータが渡されることが必要です。
Rokt Calendar APIBrazeBraze アカウントマネージャーこれには開発チームからの統合作業が必要です。

Brazeユーザーへのカレンダーの購読者のマッチング

選択した統合を介して新しいカレンダーの購読者が生成されると、購読データがBrazeに送信されます。Rokt CalendarとBrazeの統合の重要な要素は、ユーザーが存在する場合に購読データをBrazeユーザーに割り当てる能力です。マッチングは、カレンダーの購読に共通の一意の識別子に基づいて行われます。この識別子は、購読プロセス中に追加され、Brazeでユーザーを識別する方法に基づいて決定されます。カレンダーの購読者とBrazeユーザーの間にマッチングがない場合、Brazeで新しいユーザーが作成されます。

カレンダーからBrazeユーザーへのマッチング

統合シナリオ

以下に可能なシナリオについて説明します。

コンテキストサブスクライバー vs ユーザー要件
既存のRokt CalendarおよびBrazeのクライアントです。具体的には、カレンダーにはサブスクライバーがあり、BrazeアカウントにはBrazeの統合の使用より前から存在するユーザーがいます(つまり、クライアントはRokt CalendarとBrazeの両方と独立した既存の関係を持っています)。- カレンダーサブスクライバーが存在する
- Brazeユーザーが存在する
- サブスクリプションレベルでの識別子(例:メール)のBrazeユーザー識別子との一致。
- ゴーライブ前にRokt CalendarからBrazeユーザープロファイルへのサブスクリプションデータの転送。
既存のBrazeの顧客です。具体的には、Rokt Calendarを使用せず、Brazeアカウントに既存のユーザーが存在します(つまり、クライアントはBrazeのみとの既存の関係を持っています)。- カレンダーサブスクライバーはいません
- Brazeユーザーが存在する
サブスクライバーが新規のため、Brazeユーザーと共通の識別子が使用されます。
Rokt CalendarまたはBrazeのクライアントではありません。具体的には、カレンダーにはサブスクライバーがなく、BrazeアカウントにはBrazeの統合の使用より前から存在するユーザーがありません(つまり、クライアントはBrazeまたはRokt Calendarとの既存の関係を持っていません)。- カレンダーサブスクライバーはいません
- Brazeユーザーはいません
カレンダーサブスクリプションとBrazeユーザーの両方が新規のため、共通の識別子が割り当てられます。

ユニークな購読者識別子の選択

購読者IDは、購読者が作成され、その後Brazeなどの他のシステムに流れる際に、購読者を一意に識別するために使用されます。購読者IDは、購読プロセス中にカレンダーURLに購読者IDを追加することで渡すことができます。例えば、mycal.calreplyapp.com/calendar1?subscriberid=1938d736のようになります。

購読者IDは、クライアントがユーザーが既知である場合に、カレンダーページを独自の資産で起動する場合に簡単にカレンダーURLに追加することができます。通常、ログイン済みまたは既知のユーザーエクスペリエンスを介してユーザーが既知である場合です。ユーザーがログインしていない場合、つまりユーザーが不明の場合は、カレンダーのメールキャプチャ機能を使用して、購読プロセスの一部としてメールを入力することができます。これが購読者IDとなり、他のシステムのレコードに購読者を一致させるために使用されます。

データマッチングの結果

結果詳細
マッチが存在するカレンダーの購読者とBrazeユーザープロファイルの間にマッチが存在します。購読データはBrazeユーザープロファイルに追加されます。
マッチが存在しないカレンダーの購読者とBrazeの連絡先の間にマッチが存在しません。新しいBrazeユーザープロファイルが作成され、購読データが追加されます。

2. Brazeにおけるオーディエンスセグメンテーション

Brazeキャンペーンの設定時に、フィルターツールを使用してオーディエンスをセグメント化します。セグメンテーションには、標準のプロファイル属性や購読関連データのカスタム属性が含まれることがあります。

Brazeにおけるオーディエンスセグメンテーション

3. カレンダーイベントを通信手段として送信する

カレンダーイベントを通信手段として送信する

新しいイベントの作成

Brazeでは、以下の手順に従ってカレンダーイベントを通信手段として送信することができます:

  1. 新しいキャンバスを作成します。
  2. ジャーニーのステップを定義します。
  3. メッセージチャネルをWebhookに設定します。
  4. 新しいイベントを作成するためのRokt CalendarのWebhookテンプレートを選択します。
  5. ウェブフックを編集して、以下を定義します:
    1. イベントID(各イベントごとに一意である必要があります)
    2. イベントのタイトル
    3. イベントの場所
    4. イベントの説明
    5. イベントの開始/終了日時
    6. イベントのリマインダーの分数
  6. キャンバスを開始します。

Brazeがジャーニーのステップに到達し、カレンダーイベントが送信される段階になると、BrazeのウェブフックがRokt Calendarと通信し、対象のユーザーのカレンダーにイベントが追加されます。

カレンダーイベントの更新

すでに購読者に送信された既存のカレンダーイベントを更新したい場合があります。

  1. 新しいキャンバスを作成します。
  2. ジャーニーのステップを定義します。
  3. メッセージチャネルを Webhook に設定します。
  4. イベントの更新には Rokt Calendar のウェブフックテンプレートを選択します。
  5. ウェブフックを編集して、以下を定義します:
    1. イベントのID(更新したいイベントのID)
    2. イベントのタイトル
    3. イベントの場所
    4. イベントの説明
    5. イベントの開始/終了日時
    6. イベントのリマインダーの分数
  6. キャンバスを起動します。

Brazeがジャーニーのステップに到達すると、カレンダーイベントが送信され、BrazeウェブフックがRokt Calendarと通信し、セグメンテーションで定義された対象者のカレンダーを更新します。

4. カレンダーリマインダーとロック画面の最適化

Roktカレンダーテクノロジーは、既存のカレンダープロダクト(GoogleとApple)の上に構築されており、ユーザーのカレンダーへの完全なアクセスを購読時に提供します。プッシュ通知とは異なり、カレンダーリマインダーはデフォルトでデバイス全体でオンになっており、常にロック画面で100%表示されます。

リマインダーの目的は、イベントが始まることをユーザーに知らせると同時に、ユーザーに何らかの追加のアクションを促すことです。リマインダーのスタイリングはデバイスによって異なります。イベントのタイトルと場所の組み合わせで構成されるリマインダーの内容は、ユーザーエンゲージメントの効果を決定します。以下はユーザーエクスペリエンスの例です:

カレンダーリマインダーとロック画面の最適化

5. パフォーマンス測定

パフォーマンス測定を通じて、カレンダーのコミュニケーションの成果を理解することができます。パフォーマンス測定では、2つのデータタイプが考慮されます。サブスクリプションデータはRokt Calendarに存在し、エンゲージメントデータはさまざまな場所に存在します。報告要件とスケジュールを詳細に定義するために、アカウントマネージャーに連絡することができます。

データタイプソース詳細
サブスクリプションデータRokt Calendar- サブスクリプションの作成
- 個別のイベントの追加 (近日公開)
- 個別のイベントの削除 (近日公開)
- 個別のイベントの更新 (近日公開)
- サブスクリプションの解除 (カレンダー全体)
エンゲージメントデータRokt Calendar、クライアントの分析- Rokt Calendarのエンゲージメント計算
- 追跡可能なリンク (クライアント定義)
ジャーニーパフォーマンスBrazeBrazeのジャーニーアナリティクス

サポート

質問がある場合は、以下にお問い合わせください:

この記事は役に立ちましたか?