概要
クリーンルームまたは自己管理オーディエンスセグメントを持つ小売業者は、顧客データとセグメントデータを同期して、主要広告主と一般オーディエンス向けにカスタムオーディエンス配信を有効にできます。この統合には、CDPを使用して顧客/セグメント情報をEpsilonに提供することが含まれます。APIまたはファイルで提供できます。
統合の要件
- 標準的なオンサイト統合には、関連するすべてのタッチポイント（利用可能な場合）にわたる顧客IDが含まれている必要があります。
- APIまたはファイルフィードによる顧客IDフィード。
- APIまたはファイルフィードによるセグメントフィード。
仕組み
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>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
広告リクエストには、ファイル経由とAPI経由のどちらで統合するかにかかわらず
customerIdを含める必要があります。
フィードファイル同期統合（推奨）
顧客とセグメントをファイルごとに同期する場合、以下の2つのファイルが必要です。
- セグメントファイル
- 顧客ファイル
セグメントファイル
セグメントファイルは、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"] |
セグメントリファレンスガイドはこちらをご覧ください。
顧客ファイル
顧客ファイルは単一の顧客を作成し、セグメントにリンクするために使用されます。次を提供します。 customer_id と segment_ids
| customer_id | セグメント |
|---|---|
| cust_12345 | ["general-segment-3", "general-segment-4"] |
| cust_67890 | ["general-segment-3"] |
顧客リファレンスガイドはこちらをご覧ください。
API同期統合
APIで顧客とセグメントを同期する際には、3つの操作を完了する必要があります。
- セグメントを作成する
- オプション：セグメントアクセスを管理する
- 顧客を作成する
- 顧客セグメントのリンクを管理する
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"
}
}
セグメントを作成するエンドポイントの参考資料はこちらをご覧ください。
オプション：セグメントアクセスを管理する
アクセス管理機能を使用すると、選択した広告主にセグメントを表示するためのアクセス権を付与し、特定の広告主のセグメントをキュレーションすることができます。
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"
]
}
特定のセグメントへのアクセスを管理するエンドポイントの参考資料はこちらをご覧ください。
API経由での顧客の作成
顧客APIは、統合APIで使用される基本認証を使用します。
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customers": [
{
"id": "cust_12345"
},
{
"id": "cust_67890"
}
}
]
}
完了したら、顧客をリンクするセグメントも作成する必要があります。1回のリクエストで最大100人の顧客を作成できます。
顧客を作成または更新するAPIの仕様はこちらでご覧ください。
API経由で顧客をセグメントにリンクする
セグメントを作成したら、/customers/manage-segments APIを使用して顧客をセグメントにリンクします。
POST $BASE_URL/v1/customers/manage-segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "cust_12345",
"teamId":"13c84def-41cb-4f99-a3fc-6788264f79fe",
"segments": {
"segmentIds":[
"general-segment-4","general-segment-3"
]
}
}
このリクエストのteamIdは小売業者のチームIDです。
セグメントと顧客を管理するAPIの仕様はこちらでご覧ください。