概要
顧客IDを共有できない組織の場合、セグメントフィードを同期し、広告リクエストでセグメントIDを渡すことで、オーディエンスのアクティベーションを実現できます。このプライバシー重視のアプローチにより、顧客レベルのデータを公開することなく、カスタムオーディエンスと一般オーディエンスの両方のターゲティングが可能になります。広告リクエストには、ターゲットを絞ったアクティベーションを支援するセグメント識別子を含める必要があります。
統合の要件
- セグメントフィードでは、指定された広告主チームが利用できるオーディエンスセグメントを指定する必要があります。
- 広告リクエストには、各顧客に関連するセグメントIDを含める必要があります。
仕組み
CDPまたはオーディエンスプラットフォームは、ファイルのアップロードまたはAPIを通じてEpsilonにセグメントフィードを提供します。広告リクエストに含まれるセグメントIDは、オーディエンスとキャンペーンをマッチングするために使用されます。顧客とセグメント間のマッピングは、小売業者のバックエンドシステム内で内部的に維持されます。
統合の例
広告リクエストの例：セグメントIDを含む広告リクエスト：
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"audience": {
"segments": [
{
"segmentIds": [
"segment-1"
]
},
{
"sourceId": "RETAILER_SOURCE_2",
"segmentIds": [
"general-segment-4","general-segment-3"
]
}
]
},
"sessionId": "ec9-4e07-881d-3e9",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
複数のソースからセグメントを同期していますか？
その場合は、セグメントオブジェクト内に
sourceIdセグメントオブジェクトで。この値は、セグメントのソースを参照するために、Epsilonとの間で合意されています。例えばcustomer-cdp-1.1つのソース／CDPからのみ同期する場合は、次を送信する必要があります：
segmentIdsと同じ (segment配列。
フィードファイル同期統合（推奨）
セグメントを同期する際に必要なファイルは1つだけです。
セグメントファイル
セグメントファイルは、UIに表示されるセグメントID、名前、説明を提供するために使用されます。また、セグメントを表示できる特定のteam_idsを指定して、特定の広告主向けにセグメントをキュレーションすることもできます。
| segment_id | name | description | team_ids |
|---|---|---|---|
| general-segment-1 | 高額支出の買い物客 | 週平均購入額が上位15%に入る買い物客。 | |
| general-segment-2 | 価値重視の買い物客 | 価値重視の商品のバスケットの割合が高い買い物客。 | |
| 一般セグメント-3 | 定期的な買い物客 | 平均して毎週購入する買い物客。 | |
| カスタムセグメント1 | カスタム：購入頻度高BrandCo | 過去30日以内にBrandCoを購入した顧客。 | ["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
セグメントリファレンスガイドはこちらをご覧ください
API同期統合
APIで顧客とセグメントを同期する際には、1つか2つの操作を完了する必要があります。
- セグメントを作成する
- オプション：セグメントアクセスを管理する
API経由でのセグメントの作成
広告リクエストの前に顧客セグメントの関係を管理しているため、セグメントを送信するだけで済みます。
UIに表示されるセグメントID、名前、説明、小売業者チームを指定する必要があります。
セグメントAPIは、パートナーAPIで使用されるベアラー認証を使用します。ベアラートークンを生成して使用する必要があります。詳細は認証リクエストをご覧ください。
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
"segment":{
"segmentId": "general-segment-4",
"sourceId": "DEFAULT_SOURCE_ID",
"name": "Value Shoppers",
"description": "Shoppers that have a higher basket % of value driven products.",
"retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe"
}
}
セグメントを作成するエンドポイントの参考資料はこちらをご覧ください。
API経由でセグメントを同期する場合。この sourceId は広告リクエストに一致しています。
広告リクエストあたり最大100セグメント。
If you are syncing more than 100 segments, please contact Epsilon. If you exceed 100 segments per customers, ad requests may have reduced segment pooling and truncate segments in the request.
データが切り捨てられた場合、広告レスポンスに
metadata.warningsフィールドが表示され、以下のように入力されます。"metadata": { "warnings": [ "Audience Segment IDs exceeded the limit of 100 and were truncated" ] }
オプション：セグメントアクセスを管理する
アクセス管理機能を使用すると、選択した広告主にセグメントを表示するためのアクセス権を付与し、特定の広告主のセグメントをキュレーションすることができます。
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
特定のセグメントへのアクセスを管理するエンドポイントの参考資料はこちらをご覧ください。