セグメントメタデータの取得 retrieving-segment-metadata

Audience Manager がセグメント情報をデータパートナーに送信すると、これらのオブジェクトが数値 ID で識別されます。この情報をデータパートナーが顧客と共有する(または自分で操作する)場合、実際の名前や説明を使用すると、レポートやダッシュボードなどのユーザーインターフェイス(UI)での顧客のエクスペリエンスが向上します。データパートナーは、これらのわかりやすい名前を、手動または自動化された方法(この節で説明)のどちらかで顧客に提供できます。

手動方式 manual-method

データパートナーは通常、オーディエンスのメタデータを手動プロセスにより顧客から取得しています。これには、電子メールにファイルを添付したり、専用に作成および維持されている UI からユーザーがデータを追加する作業が含まれます。これらのプロセスも使用できますが、複雑で時間がかかることが多く、手動でのデータ入力が必要となる場合もあります。通常、この方法は迅速な統合のために使用されますが、長期的に最善のユーザーエクスペリエンスをもたらすものではありません。その代わりに、Audience ManagerAPI を使用して、セグメントメタデータを自動的に取得することができます。

自動方式 automated-method

Audience Manager には、セグメントメタデータを自動的に取得できる REST API が用意されています。API を使用すると、スケジュール設定された間隔ごと、または Audience Manager のデータを処理して新しいセグメント ID が見つかった時点で自動的にセグメントメタデータを取得するジョブを作成することができます。詳しくは後述の手順を参照してください。

手順 1:Audience Manager API を確認する

REST API の概要の節では、一般的な要件、認証、使用可能な方式などについて説明しています。まだ Audience ManagerAPI を使用したことがない場合は、ここから始めます。

手順 2:OAuth2 アクセス資格情報をリクエストする

API 呼び出しをおこなうには、クライアント ID と暗号鍵が必要です。クライアント ID と暗号鍵は、統合設定処理時に統合のスペシャリストから入手できます。また、電子メールリクエストを Audience Manager Customer Care(amsupport@adobe.com)に送信することもできます。

手順 3:統合された各顧客から顧客特有の情報を収集する

統合された各顧客に、次の情報を求めます。

  • ユーザー名:特定の統合に関連付けられた宛先について読み取り専用権限を持つ制限付きユーザーが対象です。
  • パスワード:ユーザーのパスワード。
  • 宛先 ID:特定のサーバー間統合について作成された宛先に関連付けられた ID(整数)です。

手順 4:API 呼び出しを使用してセグメントメタデータを取得する

上述の手順を完了した後、GET メソッドを使用してセグメントメタデータを取得できます。リクエストと応答のサンプルについては、宛先マッピングを返すを参照してください。この呼び出しにより、JSON オブジェクトのキーと値のペアとして書式設定されたセグメントデータが返されます。レスポンスで返される重要なセグメント属性の一部を次の表で紹介しています。

パラメーター
説明
destinationMappingId
Audience Manager セグメント ID。
elementName
セグメント名。
elementDescription
セグメントの内容を示す短いテキスト。
elementStatus

セグメントマッピングの現在のステータス。返されるステータスオプションは次のとおりです。

  • active
  • inactive
  • deleted
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695