> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/ja/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md).
# オプション3: オーディエンスのみの同期
### 概要
顧客識別子を共有できない組織の場合、セグメントフィードを同期し、広告リクエストでセグメントIDを渡すことで、オーディエンスのアクティベーションを実現できます。このプライバシーファーストのアプローチにより、顧客レベルのデータを公開することなく、カスタムおよび一般的なオーディエンスのターゲティングが可能になります。ターゲット絞り込みのアクティベーションをサポートするには、広告リクエストにセグメント識別子を含める必要があります。
### 連携要件
* セグメントフィードでは、指定された広告主チームが利用できるオーディエンスセグメントを指定する必要があります。
* 広告リクエストには、各顧客の関連するセグメントIDを含める必要があります。
### 仕組み
CDPまたはオーディエンスプラットフォームは以下を提供します Epsilon ファイルアップロードまたはAPIを介したセグメントフィード。広告リクエストに含まれるセグメントIDは、オーディエンスとキャンペーンを一致させるために使用されます。顧客とセグメントのマッピングは、リテール企業のバックエンドシステム内で内部的に維持されます。
### 連携の例
**広告リクエストの例**: セグメントIDを含む広告リクエスト:
```http
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic
{
"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
}
```
{% hint style="info" %}
複数のソースからセグメントを同期していますか？
同期している場合は、セグメントオブジェクトで `sourceId` も提供する必要があります。この値は、セグメントのソースを参照するためにあなたと Epsilon の間で合意されます。例として `customer-cdp-1`が挙げられます。
1つのソース/CDPからのみ同期する場合は、 `segmentIds` を `segment` 配列内で送信するだけです。
{% endhint %}
### フィードファイルの同期連携（推奨）
セグメントを同期する場合、必要なファイルは1つだけです。
#### セグメントファイル
セグメントファイルは、UIに表示されるセグメントID、名前、および説明を提供するために使用されます。また、セグメントを表示できる特定の team\_ids を指定するためにも使用でき、特定の広告主向けにセグメントをキュレートできます。
| segment\_id | name | description | team\_ids |
| ----------------- | ----------------------- | ------------------------- | -------------------------------------------------------------------------------- |
| general-segment-1 | 高額支出の買い物客 | 平均の週あたりの買い物が上位15%に入る買い物客。 | |
| general-segment-2 | 節約志向の買い物客 | 価値重視商品のバスケット内比率が高い買い物客。 | |
| general-segment-3 | リピート買い物客 | 平均して毎週買い物をする買い物客。 | |
| custom-segment-1 | カスタム: 最近の購入頻度が高いBrandCo | 過去30日以内にBrandCoを購入した顧客。 | \["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"] |
セグメントリファレンスガイドはこちらをご覧ください
### API同期連携
APIで顧客とセグメントを同期する場合、完了する必要のある操作が1つまたは2つあります。
1. セグメントを作成する
2. オプション: マネージャーのセグメントアクセス
#### APIを介したセグメントの作成
広告リクエストの前に顧客とセグメントのリレーションシップを管理しているため、セグメントのみを送信する必要があります。
UIに表示されるセグメントID、名前、説明、およびリテール企業チームを提供する必要があります。
{% hint style="info" %}
セグメントAPIは、Partner APIで使用されるベアラー認証を使用します。ベアラートークンを生成して使用する必要があります。詳細はこちら: [認証リクエスト](https://help.citrusad.com/retail-media-interface/partner/ja/partner-api-authentication/authenticating-requests).
{% endhint %}
```http
POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer
{
"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"
}
}
```
セグメント作成エンドポイントのリファレンスを表示する [こちら](https://help.citrusad.com/retail-media-interface/partner/ja/audience-segment-api/segment/createsegment)。
API経由でセグメントを同期する場合。これは `sourceId` 広告リクエストに適合します。
{% hint style="info" %}
1つの広告リクエストにつき最大100セグメントまで。
100を超えるセグメントを同期する場合は、 Epsilonまでご連絡ください。顧客あたり100セグメントを超えると、広告リクエストのセグメントプーリングが減少させられ、リクエスト内のセグメントが切り捨てられる場合があります。
切り捨てが発生した場合、広告レスポンスに `metadata.warnings`フィールドが表示され、以下のように値が入ります:
```
"metadata": {
"warnings": [
"Audience Segment IDs exceeded the limit of 100 and were truncated"
]
}
```
{% endhint %}
#### オプション: セグメントアクセスの管理
アクセス管理機能を使用すると、選択した広告主にセグメントを表示するアクセス権を付与できるため、特定の広告主向けにセグメントをキュレートできます。
```http
POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer
{
"accessTeamIds":[
"90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
]
}
```
特定セグメントへのアクセス管理エンドポイントのリファレンスを表示する [こちら](https://help.citrusad.com/retail-media-interface/partner/ja/audience-segment-api/segment/manageaccess).
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/integration/ja/data-api/audience-targeting-new/integration-option-3-sync-audiences-only.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.