Skip to content

ロクト・カレンダー

Rokt Calendarは、1:1イベントやプロモーション・コミュニケーションをカレンダーイベントや通知の形でプッシュすることを可能にするダイナミック・カレンダー・マーケティング・テクノロジーである。

BrazeとRokt Calendarの統合により、Rokt Calendarの購読者とそのデータは、Brazeのウェブフックを介してBrazeにプッシュされる。そして、このデータをBraze Canvasesのジャーニーターゲティングとオーディエンスセグメンテーションに使用することができる。

前提条件

必要条件 説明
六連カレンダーのアカウント このパートナーシップを利用するには、クライアント専用のRokt Calendarアカウントが必要である。[email protected]に連絡して、アカウント・マネージャーと話す。
ロクト・カレンダーの設定 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カレンダーの購読プロセスで、カレンダーの購読者とBrazeユーザーを照合するために使用される識別子である。これは六連カレンダーに渡すものだ。

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

Rokt Calendarが新規ユーザーを作成するとき、または既存の購読者とBrazeユーザーをマッチさせるとき、Rokt Calendarは、Braze内でフィルタリングできる以下のカスタム購読属性を送信する:

カスタム属性 定義
rokt:account_code 六連カレンダーのアカウントコード brazetest/f5733866ade2 そして brazetest/ff10919f1078
rokt:account_id 六連カレンダーのアカウントID d0ce4299-7d6c-4888-bfd8-c7e867a0fa6c/f5733866ade2
rokt:account_name ロクト・カレンダーのアカウント名 Braze Test/f5733866ade2
rokt:calendar_code ロクト・カレンダー・カレンダーのコード test-calendar-1/f5733866ade2
rokt:calendar_id 六連カレンダーのカレンダーID 9a9007c7-f5a4-e811-b13c-06424c4f2724/f5733866ade2
rokt:calendar_title 六連カレンダーのカレンダータイトル 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 購読手続き中にユーザーが入力したEメールアドレス [email protected]/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カレンダーはまた、ユーザーがRoktカレンダーに登録するとすぐに、subscribe カスタムイベントをトリガーする。

統合

ステップ1:カレンダー購読者のオーディエンスを構築する

Canvasからカレンダー・イベントを送信するには、まずRoktカレンダーを設定し、ユーザーを登録する必要がある。そのためには、カレンダーを購読する場所と方法をユーザーに知らせる必要がある。ロクト・カレンダーでは、以下のことを推奨している:

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

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

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

カレンダーを宣伝する

購読者のオーディエンスを作るには、購読方法を知ってもらうために、オーディエンスにカレンダーを宣伝する必要がある。カレンダープロモーションの例としては、以下のようなものがある:

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

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

Brazeでは、WebhookキャンペーンやCanvas内のWebhookを設定することができる:

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

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

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

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

  • ウェブフックのURL{% assign accountCode = {{custom_attribute.${rokt:account_code}}}[0] | split: '/' | first %}https://api.roktcalendar.com/v1/subscriptionevent/{{accountCode}}
  • リクエスト・ボディRaw Text

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

  • ウェブフックの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 Connected Contentクレデンシャル名を含むHTTP Header 。以下はすでにキーと値のペアとしてテンプレート内に含まれているが、「設定」タブでは、<Rokt-Calendar-API>Manage Settings > Connected Content > Credential にあるクレデンシャル名に置き換える必要がある。

  • HTTPメソッド:POST
  • ヘッダーをリクエストする
    • 認可する:ベアラー {% 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
*必須
カレンダーに表示されるイベントのタイトル サマーセール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!