Skip to content

Rokt Calendar

Rokt Calendar は、ブランドがカレンダーイベントや通知の形式で1:1イベントやプロモーションコミュニケーションをプッシュできるようにするダイナミックなカレンダーマーケティングテクノロジーです。

Braze と Rokt Calendar の統合により、Rokt Calendar のサブスクライバーとそのデータを Braze Webhook 経由で Braze にプッシュできます。その後、Braze キャンバスでこのデータを使用して、以下のカスタム Rokt Calendar 属性を使用したジャーニーターゲティングとオーディエンスセグメンテーションを行うことができます。

前提条件

必要条件 説明
Rokt Calendar アカウント このパートナーシップを利用するには、クライアント専用のRokt Calendarアカウントが必要である。sales-calendar@rokt.comに連絡して、アカウント・マネージャーと話す。
Rokt Calendar の設定 Roktカレンダーのアカウントマネージャーが、あなたのニーズに合わせて、以下のような設定を含む、最適なカレンダーを設定する:
- マージフラグ
- 加入者IDフォールバックフラグ
- 必要であれば、電子メールのキャプチャ
Rokt Calendar OAuth認証情報 Roktカレンダーのアカウントマネージャーから提供されるこのキーで、BrazeとRoktカレンダーのアカウントを接続することができる。

これは、Brazeダッシュボードの「設定」>「接続コンテンツ」で作成できる。
Braze REST API キー users.track 権限を持つ Braze REST API キー。このキーを Rokt Calendar アカウントマネージャーに提供する必要があります。

これは、Brazeダッシュボードの「設定」>「APIキー」から作成できる。
Braze REST エンドポイント RESTエンドポイントのURL。エンドポイントは、インスタンスのBraze URLに依存する。
外部サブスクライバー ID これは、Rokt Calendar サブスクリプションプロセスがカレンダーサブスクライバーと Braze ユーザーを照合するために使用する ID です。これを Rokt Calendar に渡します。

オーディエンスセグメンテーション

Rokt Calendar での新規ユーザーの作成時、またはサブスクライバーと Braze ユーザーの照合時に、Rokt Calendar から、Braze 内でフィルタリングできる次のカスタムサブスクリプション属性が送信されます。

カスタム属性 定義
rokt:account_code Rokt Calendar アカウントのコード brazetest/f5733866ade2brazetest/ff10919f1078
rokt:account_id Rokt Calendar アカウントの ID d0ce4299-7d6c-4888-bfd8-c7e867a0fa6c/f5733866ade2
rokt:account_name Rokt Calendar アカウントの名前 Braze Test/f5733866ade2
rokt:calendar_code Rokt Calendar カレンダーのコード test-calendar-1/f5733866ade2
rokt:calendar_id Rokt Calendar カレンダーの ID 9a9007c7-f5a4-e811-b13c-06424c4f2724/f5733866ade2
rokt:calendar_title Rokt Calendar カレンダーのタイトル 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 作成されたサブスクリプションに関連する、一意な識別子としてのサブスクリプションID。 06423672-b6ba-4536-aa36-70788a7a0a36
rokt:subscription_method 作成されたサブスクリプションに関連するサブスクリプションメソッド(webcal/Google)。 WebCal/f5733866ade2
rokt:tags 作成された購読に関連して使用されたカレンダータグ。 Test Calendar 1/All Teams/f5733866ade2 and Test Calendar 1/TeamI//f5733866ade2

また、Rokt Calendar は、ユーザーが Rokt Calendar をサブスクライブするとすぐに subscribe カスタムイベントをトリガーします。このカレンダーは、Braze セグメンテーションで使用することも、キャンペーンまたはキャンバスコンポーネントのトリガーとして使用することもできます。

統合

ステップ1:カレンダーサブスクライバーのオーディエンスを作成する

キャンバスからカレンダーイベントを送信するには、まずすでにサブスクライブしているユーザーを使用して Rokt Calendar を設定する必要があります。そのためには、カレンダーをサブスクライブする場所と方法をユーザーに通知します。Rokt Calendar では以下のことが推奨されています。

サブスクリプションの統合ポイントを提供する

カレンダーサブスクライバーのオーディエンスを作成するには、ユーザーが移動してサブスクライブできる場所を提供する必要があります。サブスクリプション統合ポイントの例としては、以下のようなものがある:

  • ウェブサイトにカレンダーボタンを追加する
  • メールやSMSにカレンダーリンクを追加する
  • カレンダーボタンをアプリに追加する
  • ソーシャルメディアにカレンダーのリンクを追加する

カレンダーを宣伝する

サブスクライバーからなるオーディエンスを作成するには、サブスクライブ方法がわかるように、オーディエンスにカレンダーをプロモーションする必要があります。カレンダープロモーションの例としては、以下のようなものがある:

  • ソーシャルメディアへの投稿
  • Eメールニュースレターと最新情報
  • ブログ記事
  • アプリ内通知

ステップ2:BrazeでRokt CalendarのWebhookを作成する

Braze では、次のいずれかを行うために Webhook キャンペーンまたはキャンバス内の Webhook を設定できます。

  • 新しいパーソナライズされたイベントを送信する:サブスクライバーのカレンダーのセグメントに新しいイベントを追加できるようにします。
  • パーソナライズされたイベントを更新する:サブスクライバーのカレンダーにある既存のイベントを更新できるようにします。

今後のキャンペーンやCanvasで使用するRokt Calendarウェブフックテンプレートを作成するには、Brazeプラットフォームの「テンプレート」>「ウェブフックテンプレート」に移動する。

単発のRokt Calendar Webhookキャンペーンを作成したい場合、または既存のテンプレートを使用したい場合は、新しいキャンペーンを作成する際にBrazeのWebhookを選択する。

Rokt Calendarウェブフック・テンプレートを選択すると、以下のように表示される:

  • Webhook URL: {% assign accountCode = {{custom_attribute.${rokt:account_code}}}[0] | split: '/' | first %}https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}
  • リクエスト本文:Raw Text

Rokt Calendarウェブフック・テンプレートを選択すると、以下のように表示される:

  • Webhook URL: {% assign accountCode = {{custom_attribute.${rokt:account_code}}}[0] | split: '/' | first %}https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}/update
  • リクエスト本文:Raw Text

リクエストヘッダと方法

Rokt Calendar では、認証のために Rokt Calendar コネクテッドコンテンツの認証情報名を含む HTTP Header が必要です。以下はすでにキーと値のペアとしてテンプレート内に含まれているが、「設定」タブでは、<Rokt-Calendar-API>Manage Settings > Connected Content > Credential にあるクレデンシャル名に置き換える必要がある。

  • HTTPメソッド:POST
  • リクエストヘッダー:
    • Authorization:ベアラー {% 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

Request body

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{% 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 %}

{
  "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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{% 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 %}

{
  "event": {
    "eventId": "{{eventId}}_{{${user_id}}}",
    "title": "{{eventTitle}}",
    "description": "{{eventDescr}}",
    "location": "{{eventLocation}}",
    "start": "{{eventStart}}",
    "end": "{{eventEnd}}",
    "timezone": "{{eventTZ}}",
    "notifyBefore": "{{notifyBefore}}"
  }
}

以下のフィールドには、イベント・レベルでカスタマイズできる情報が含まれている。

フィールド 定義
eventId
*必須
追加または更新されるイベントの一意な識別子。 Event_00001
eventTitle
*必須
カレンダーに表示されるイベントのタイトル Summer Sale 2019
eventDescr カレンダーに表示されるイベントの説明文 セール期間は3日間で、このリンク(www.mybusiness.com/sale )をクリックするとオファーが表示される。
eventLocation カレンダーに表示されるイベントの場所。これはしばしば、eventTitleを補完する2番目の行動喚起として使用されることに注意。 50%オフのイベントを開く
eventStart
*必須
カレンダーに表示されるイベントの開始日時 2019-02-21T15:00:00
eventEnd
*必須
カレンダーに表示されるイベントの開始日時 2019-02-21T16:00:00
eventTz
*必須
カレンダーに表示されるイベントのタイムゾーン。適用可能なタイムゾーンのリストはこちらで確認できます。 Eastern Standard Time
notifyBefore
*必須
カレンダーに表示されるイベントのリマインダー時刻。これは分単位で表されます。 15

ステップ3:リクエストをプレビューする

Previewパネルでリクエストをプレビューするか、Testタブに移動して、ランダムなユーザー、既存のユーザーを選択するか、ウェブフックをテストするために自分でカスタマイズする。

「このページはどの程度役に立ちましたか?」
New Stuff!