​

はじめに

​

ユースケース

​

統合

​

ステップ 1: Seen にデータを送信する

1. Engage → Flows に移動し、MoEngage で新しい空の Flow を作成します。
2. Flow に名前を付け、キャンバスに Connector ステップを追加して、次のように設定します。

   フィールド	値
   Webhook URL	https://next.seen.io/v1/projects/{project_id}/data — プロジェクトのエンドポイントは、Seen プロジェクトの Run タブで確認できます。
   HTTP Method	POST
   Body type	JSON

3. 以下のペイロードを出発点として使用します。Seen プロジェクトのパーソナライゼーションに合わせてフィールドを調整してください。
   {
     "user_id": "{{UserAttribute['ID']|default('MOE_NOT_SEND')}}",
     "first_name": "{{UserAttribute['First Name']|default('MOE_NOT_SEND')}}"
   }
   
4. 次のリクエストヘッダーを追加します。

   ヘッダー	値
   Authorization	Bearer {token}
   Content-Type	application/json
   API トークンは、Seen プラットフォームアカウントの Settings → API → OAuth2 で作成できます。

5. Connector ステップの下部にある Test セクションを使用して、特定のユーザーで Connector をテストします。
6. すべてが意図したとおりに機能したら、Flow を有効化します。

​

ステップ 2: Seen プラットフォームで Webhook を設定する

1. Seen プラットフォームでプロジェクトに移動します。
2. Run タブを開き、Add Webhook をクリックします。
3. 結果を MoEngage に送り返すように Webhook を設定します（完全な設定についてはステップ 3 を参照してください）。

​

ステップ 3: Seen からデータを受け取る

1. MoEngage で、Settings → Advanced Settings → Authorization Configuration に移動します。
2. + Add Auth Config をクリックし、次のフィールドに入力します。

   フィールド	値
   Name	Seen API
   Token type	JWT
   API URL	https://next.seen.io/oauth2/token
   Method	POST
   Body type	FORM
   grant_type	client_credentials
   client_id	<YOUR_SEEN_CLIENT_ID>
   client_secret	<YOUR_SEEN_CLIENT_SECRET>
   Client ID と Client Secret は、Seen ワークスペースの Settings → API → OAuth2 で確認できます。

3. Send test & continue をクリックします。
4. Access token フィールドで、access_token を選択します。
5. Decode Access Token をクリックします。表示される有効期限フィールドに、access_token.exp（Unix Epoch）と入力します。
6. Preferred prefix を Bearer に設定します。
7. Save をクリックします。

1. 以下のペイロードを Seen の Webhook 本文の出発点として使用します。Player link と Email thumbnail link を、Seen の Webhook エディターで利用可能な動的出力参照に置き換えます。
   JSON

   {
     "type": "event",
     "customer_id": "user_id",
     "actions": [
       {
         "action": "seen_video_generated",
         "attributes": {
           "seen_campaign": "onboarding",
           "seen_player_link": "Player link",
           "seen_email_thumbnail_link": "Email thumbnail link"
         }
       }
     ]
   }
   
2. Create をクリックして Webhook を保存します。

​

ステップ 4: 統合を確認する

1. MoEngage で、Segment → Search Users に移動し、テストユーザーの Event Activity を開きます。
2. 次の属性が入力された seen_video_generated イベントが表示されることを確認します。

   属性	説明
   seen_player_link	ユーザーのパーソナライズされた Seen 動画へのリンクです。
   seen_email_thumbnail_link	メールで使用するパーソナライズされた動画サムネイルです。

{{EventAttribute['seen_player_link']|default('MOE_NOT_SEND')}}
{{EventAttribute['seen_email_thumbnail_link']|default('MOE_NOT_SEND')}}