ドキュメントAudience ManagerAudience Manager ユーザーガイド

リアルタイム送信データ転送 real-time-outbound-data-transfers

Last update: Wed Oct 19 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

リアルタイムの送信データ転送プロセスでは、ユーザーデータを一連の JSON 形式のメッセージとして宛先プラットフォームに配信します。

推奨事項

この方法を使用するには、宛先プラットフォームが以下の要件を満たしている必要があります。

  • Audience Manager から大量のメッセージを受信するために拡大縮小できるエンドポイント URL を提供する必要があります。
  • JSON 形式（Content-type: application/json）のデータを受け入れる必要があります。
  • 安全な HTTPS データ転送を受け入れる必要があります。Audience Manager では、安全でない HTTP プロトコルを使用してメッセージを送信しません。

頻度

このデータ転送方法は、ユーザーがセグメントの対象となるときにほぼリアルタイムでデータを送信できます。リアルタイムメッセージは、ユーザーがオンラインで、Audience Manager Edge ネットワークに対してアクティブに表示できる場合にみ配信されます。オプションで、この方法では、24 時間ごとに、オフラインまたはオンボード済みデータのバッチを送信することもできます。

バッチ転送

リアルタイム転送およびバッチ転送は、両方とも、同じエンドポイントに送信され、同じメッセージ形式を使用します。バッチ転送が有効な場合、バッチメッセージが配信される際に、宛先プラットフォームでメッセージ量にスパイクが表示されます。リアルタイムメッセージで送信されたセグメント資格の多くは、バッチメッセージで繰り返されます。バッチ転送は、最後のバッチが配信されてから変更されたセグメント資格（または無資格）のみを含みます。

レート制限

配信されたメッセージのスループットに対してレート制限は設定されていません。レート制限を設定すると、データ損失につながる可能性があります。

必要な応答

デフォルトでは、受信サーバーは、正常な受信を示すために 200 OK コードを返す必要があります。他のコードは失敗と解釈されます。この応答は、3000 ミリ秒以内に返されることを想定しています。失敗の場合、Audience Manager は、1 回のみ再試行します。

パラメーター

次のテーブルは、宛先に送信する JSON データファイル内の要素を定義します。

パラメーター
データタイプ
説明
ProcessTime
DateTime
リクエストが実行された時間。
User_DPID
整数

デバイス ID のタイプを示す ID は、メッセージ内の、User.DataPartner_UUID プロパティに含まれます。

  • Android ID（GAID）： 20914
  • iOS ID（IDFA）： 20915
  • Web／Cookie ID：宛先プラットフォームによって異なる
Client_ID
文字列
宛先プラットフォームのターゲットアカウントを表します。この ID は、宛先プラットフォームから生成されます。
AAM_Destination_ID
整数
Audience Manager「宛先」オブジェクトの ID。この ID は、Audience Manager から生成されます。
User_count
整数
POST リクエストのユーザーの合計数。
Users
配列
ユーザーオブジェクトの配列。デフォルトでは、各メッセージは、最適なメッセージサイズを維持するために、1 ～ 10 ユーザーを含みます。
User.AAM_UUID
文字列
Audience Manager UUID。
User.DataPartner_UUID
文字列
宛先プラットフォーム UUID またはグローバルデバイス ID。
User.AAM_Regions
配列
このデバイスが確認された Audience Manager 地域 ID。例えば、デバイスがパリ（ヨーロッパ）であるアクティビティをおこなった場合、地域 ID は 6 になります。DCS 地域 ID、場所、ホスト名を参照してください。
Segments
配列
セグメントオブジェクトの配列。リアルタイムメッセージの場合、配列には、ユーザーが属するすべてのセグメントが含まれます。バッチメッセージの場合、配列には、最後のバッチ以降に変更されるセグメントのみが含まれます。
Segment.Segment_ID
整数
セグメントの識別子。ほとんどの場合、これは、Audience Managerで生成されたセグメント ID です（整数）。場合によっては、宛先プラットフォームが許可している場合、お客様は、Audience Manager ユーザーインターフェイス（テキストフィールドを開く）でセグメント識別子を定義でき、それがこのプロパティに反映されます。
Segment.Status
整数

セグメント内のユーザーのステータスを定義します。以下の値を受け入れます。

  • 1：アクティブ（デフォルト）
  • 0：非アクティブ、オプトアウト済みまたは非セグメント化。

以下の場合、ユーザーはセグメントへの認定を解除されます。

  • セグメントから削除された（セグメントルールに基づいて）。
  • セグメントから削除された（セグメントの有効期間に基づいて）。
  • 過去 120 日の間確認されず、非アクティブ状態に移行した。
  • プライバシー変更リクエスト（例：GDPR）により削除された

Audience Manager ID と同期されたすべてのパートナー ID は、ユーザーが非セグメント化されると、 "Status":"0" フラグを受け取ります。

Segment.DateTime
DateTime
最後にユーザーセグメント資格が検証された時間。

セキュリティ

秘密鍵で HTTP 要求に署名するか、Audience Manager で OAuth 2.0 プロトコルを使用して認証することで、リアルタイム送信データ転送プロセスを保護できます。

リクエスト

リアルタイムリクエストは、以下のようになります。

{
"ProcessTime": "Wed Jul 27 16:17:42 UTC 2016",
"User_DPID": "12345",
"Client_ID": "74323",
"AAM_Destination_Id": "423",
"User_count": "2",
"Users": [{
   "AAM_UUID": "19393572368547369350319949416899715727",
   "DataPartner_UUID": "4250948725049857",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "14356",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         },
         {
            "Segment_ID": "12176",
            "Status": "0",
            "DateTime": "Wed Jul 27 16:17:22 UTC 2016"
         }
      ]
   },
   {
   "AAM_UUID": "0578240750487542456854736923319946899715232",
   "DataPartner_UUID": "848457757347734",
   "AAM_Regions": ["9"],
   "Segments": [{
            "Segment_ID": "10329",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
         },
         {
            "Segment_ID": "23954",
            "Status": "1",
            "DateTime": "Wed Jul 27 16:17:21 UTC 2016"
        }]
    }]
}
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695