Movable Ink Customer Data API への接続

BrazeとMovable InkのCustomer Data API統合により、マーケターはBrazeに保存されている顧客イベントデータをアクティブ化して、Movable Ink内でパーソナライズされたコンテンツを生成できます。

Movable Inkは、Customer Data APIを介してBrazeから行動イベントを取り込むことができます。イベントは、Movable Inkに渡されるユニークユーザーID (UUID) に基づいてユーザープロファイルに保存されます。

ストーリー、Movable Ink Customer Data API、およびMovable Inkが行動データをどのように活用するかの詳細については、以下のサポートセンターの記事を参照してください。

• 行動データでコンテンツを強化する
• Customer Data API の概要およびガイド
• FAQ: Customer Data API

前提条件

統合

ステップ1: BrazeでWebhook キャンペーンを作成する

ステップ1a: 新しいキャンペーンを作成する

1. Brazeで、Webhook キャンペーンを作成します。
2. キャンペーンに名前と任意の説明を付けます。
3. テンプレートとしてBlank Templateを選択します。

ステップ1b: Customer Data API認証情報を追加する

1. Webhook URLフィールドに、Movable InkのエンドポイントURLを入力します。

2. Settingsタブを選択します。
3. 以下のリクエストヘッダーをキーと値のペアとして追加します。

ステップ1c: ペイロードを設定する

1. Composeタブに戻ります。
2. Request Bodyとして、JSONキーと値のペアを使用して独自のリクエストボディを作成するか、イベントペイロードを生のテキストとして入力します。標準的なeコマースイベントの例については、サンプルペイロードを参照してください。

ステップ1d: Webhookをテストする

サンプルペイロードをMovable Inkクライアントエクスペリエンスチームと共有する必要があります。このペイロードは、作成したペイロードに基づいてTestタブで生成できます。

重要

Movable Inkは、Movable Inkクライアントエクスペリエンスチームがマッピングを完了し、テストを受ける準備ができたことを確認するまで、BrazeでのWebhookテストを待つことを推奨しています。このマッピングが完了していない場合、テスト時にエラーが発生する可能性が高くなります。

Webhookをテストするには、以下の手順を実行します。

1. Testタブを選択します。
2. ユーザーとしてメッセージをプレビューし、そのユーザーのサンプルイベントペイロードを表示します。ランダムユーザー、特定のユーザー、またはカスタムユーザーとしてのプレビューを選択できます。
3. 問題がなければ、Send testをクリックしてテストリクエストを送信します。

ステップ2: キャンペーン設定を確定する

ステップ2a: キャンペーンをスケジュールする

Webhookの作成とテストが完了したら、キャンペーンをスケジュールします。

Brazeでは、スケジュール配信、アクションベースの配信、およびAPIトリガー配信がサポートされています。アクションベースの配信は、通常ほとんどの行動イベントのユースケースに最適です。ユースケースに最適な方法についてのご質問は、BrazeおよびMovable Inkのカスタマーサクセスマネージャーにお問い合わせください。

アクションベースの配信の場合:

1. トリガーアクションを指定します。これは、Movable InkへのWebhookをトリガーするイベントです。
2. Schedule DelayがImmediatelyに設定されていることを確認します。イベント発生直後にイベントデータが遅延なくMovable Inkに送信される必要があります。
3. 開始時間を指定してキャンペーン期間を設定します。終了時刻は適用されない可能性がありますが、ユースケースに必要な場合は設定できます。

注

データがMovable Inkにリアルタイムでストリーミングされるようにするには、Send campaign to users in their local time zoneを選択しないでください。

ステップ2b: オーディエンスを指定する

次に、このキャンペーンでターゲットにするユーザーを決定します。詳細については、「ユーザーをターゲットにする」を参照してください。

Control Groupのチェックボックスをオフにして、キャンペーンでABテストを使用しないようにしてください。コントロールグループが含まれている場合、一定の割合のユーザーのデータがMovable Inkに送信されません。オーディエンス全体を、コントロールグループではなくバリアントに移動する必要があります。

ステップ2c: コンバージョンイベントを選択する（オプション）

必要であれば、Braze内でこのキャンペーンにコンバージョンイベントを割り当てることができます。

ただし、Webhookがデータのストリーミングのみを目的としている場合、このレベルでのアトリビューションは、Brazeの行動データを使用してコンテンツをパーソナライズした後にキャンペーンレベルでアトリビューションを確認するよりも有用性が低い可能性があります。

ステップ3: キャンペーンを起動する

Webhookの設定を確認し、キャンペーンを起動します。

考慮事項

一意のユーザー識別子の整合

mi_u として使用しているユニークユーザー識別子 (UUID) 値がBraze内で利用可能であり、Movable Inkに送信されるイベントペイロードに含めることができることを確認してください。

これにより、画像を生成する際にMovable Inkが参照する行動イベントが、その行動イベントを受信した同一の顧客に関連付けられます。UUID値がBrazeの external_id と同じでない場合、UUIDをキャプチャして属性としてBrazeに渡すか、この識別子を利用するためにBrazeイベントのイベントプロパティに含めて渡す必要があります。

Brazeは複数のプラットフォーム（Webやモバイルアプリなど）にわたってユーザーの行動を追跡するため、1人のユーザーが複数の異なる匿名IDを持つことがあります。identify イベントに匿名IDと既知の単一IDの両方が含まれている限り、identify イベントがMovable Inkに送信される時点で、これらのIDを単一の既知のストーリーズユーザープロファイルにマージできます。

Movable Inkが単一ユーザーの user_id を受信したら、そのユーザーの今後のすべてのイベントには同じ user_id が含まれている必要があります。

Movable Inkとのイベントペイロードの共有

Movable InkのCustomer Data APIへのコネクターを設定する前に、イベントペイロードをMovable Inkクライアントエクスペリエンスチームと共有してください。これにより、Movable InkがイベントをMovable Inkのイベントスキーマにマッピングでき、API呼び出しの拒否や失敗を防ぐことができます。

任意のイベントプロパティを使用して、Braze内でイベントペイロードを生成できます。ランダムなユーザー、または特定のユーザーIDを検索してサンプルペイロードを生成します。詳細については上記の「ステップ1d」を参照してください。

このサンプルペイロードをMovable Inkクライアントエクスペリエンスチームと共有してください。サンプルペイロードに、機密性の高い個人識別情報（メールアドレス、電話番号、誕生日全体など）が含まれていないことを確認してください。

カスタムイベントプロパティと、プロパティに含まれるデータの想定形式について詳しくは、「カスタムイベントプロパティ」を参照してください。

既知のユーザーと匿名のユーザー

Brazeでは、匿名のユーザープロファイルでイベントを記録できます。イベントロギング中にどの識別子がユーザープロファイルにリンクされるかは、ユーザーがどのように作成されたか（Braze SDKまたはAPIを通じて）と、ユーザーライフサイクルの現在の段階に依存します。

既知のユーザーのBrazeイベントのみを転送する

Webhook キャンペーンで External User ID フィルターを使用して、フィルター External User ID is not blank に一致する external_id を持つユーザーのみをターゲットにします。

匿名ユーザーと既知ユーザーのBrazeイベントを転送する

匿名ユーザー（プロファイルに external_id が割り当てられる前のユーザー）からのBrazeイベントを転送したい場合、external_id が利用可能になるまでMovable Inkの anonymous_id として使用する識別子を決定する必要があります。Brazeユーザープロファイルで一定に保たれる anonymous_id を選択してください。Webhook本文でLiquidロジックを使用して、anonymous_id または user_id を渡すかどうかを決定できます。

詳細については、サンプルペイロードにあるWebhookの例を参照してください。

ペイロードの例

商品閲覧イベント

• brazeトリガーイベントの例
• 想定されるmovable inkリクエストペイロード
• webhookの例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "events": [
    {
      "email": "[email protected]",
      "name": "Product Viewed",
      "time": "2023-12-06T19:20:45+01:00",
      "properties": {
        "categories": [
          {
            "id": "Bathroom",
            "url": "https://example.com/cat/bathroom"
          }
        ],
        "meta": {
          "color": "green"
        },
        "title": "All-Purpose Cleaning Wipes",
        "price": 1.99,
        "id": "56544",
        "url": "https://www.example.com/variants_id/5f08cb918dcc595aa74b0fbc"
      }
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "anonymous_id": "123-abc-678",
  "event": "product_viewed",
  "properties": {
    "categories": [
      {
        "id": "Bathroom",
        "url": "https://example.com/cat/bathroom"
      }
    ],
    "meta": {
      "color": "green"
    },
    "title": "All-Purpose Cleaning Wipes",
    "price": 1.99,
    "id": "56544",
    "url": "https://www.example.com/variants_id/5f08cb918dcc595aa74b0fbc"
  },
  "timestamp": 1257894000000,
  "timezone": "America/New_York",
  "type": "track",
  "user_id": "5c3aa83113dd490100d3d8d7"
}'

// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}

// Example of md5 hashing the email address to use as the anonymous_id
{% assign anon_id = {{${email_address}}} | md5 %}

// Condition logic to determine which identifier to use. If an external_id is available use that, otherwise use the anonymous_id
{% if {{${user_id}}} %}
{% capture user_identifier %}"user_id": "{{${user_id}}}"{% endcapture %}
{% else %}
{% capture user_identifier %}"anonymous_id": "{{anon_id}}"{% endcapture %}
{% endif %}

{
  {{user_identifier}}
  "event": "product_viewed",
  "properties": {
    "categories": [
      {
        "id": "{{event_properties.${categories}[0].id}}",
        "url": "{{event_properties.${categories}[0].url}}"
      }
    ],
    "meta": {
      "color": "{{event_properties.${meta}.color}}"
    },
    "title": "{{event_properties.${title}}}",
    "price": "{{event_properties.${price}}}",
    "id": "{{event_properties.${id}}}",
    "url": "{{event_properties.${url}}}"
  },
  "timestamp": "{{timestamp}}",
  "timezone": "{{${time_zone}}}",
  "type": "track",
}

カテゴリー閲覧イベント

• brazeトリガーイベントの例
• 想定されるmovable inkリクエストペイロード
• webhookの例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "events": [
    {
      "external_id": "123456789",
      "name": "Category Viewed",
      "time": "2023-12-06T19:20:45+01:00",
      "properties": {
        "id": "bathroom-1",
        "title": "Bathroom Stuff",
        "url": "https://www.example.com/categories/bathroom"
      }
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "anonymous_id": "123-abc-678",
  "event": "category_viewed",
  "properties": {
    "id": "bathroom-1",
    "title": "Bathroom Stuff",
    "url": "https://www.example.com/categories/bathroom"
  },
  "timestamp": 1257894000000,
  "timezone": "America/New_York",
  "type": "track",
  "user_id": "5c3aa83113dd490100d3d8d7"
}'

// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}

{
  "event": "category_viewed",
  "properties": {
    "id": "{{event_properties.${id}}}",
    "title": "{{event_properties.${title}}}",
    "url": "{{event_properties.${url}}}"
  },
  "timestamp": "{{timestamp}}",
  "timezone": "{{${time_zone}}}",
  "type": "track",
  "user_id": "{{${user_id}}}"
}

識別イベント

• brazeトリガーイベントの例
• 想定されるmovable inkリクエストペイロード
• webhookの例

1
2
3
4
5
6
7
8
9
{
  "events": [
    {
      "external_id": "123456789",
      "name": "Account Created",
      "time": "2023-12-06T19:20:45+01:00"
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "anonymous_id": "jg0iq5gd30dqpwn8zmx05p06mzjmjir4r8",
  "timestamp": 1257894000000,
  "timezone": "America/New_York",
  "type": "identify",
  "user_id": "mycustomerid123"
}'

// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}

// Example of md5 hashing the email address to use as the anonymous_id
{% assign anon_id = {{${email_address}}} | md5 %}

{
  "anonymous_id": "{{anon_id}}",
  "timestamp": "{{timestamp}}",
  "timezone": "{{${time_zone}}}",
  "type": "identify",
  "user_id": "{{${user_id}}}"
}