> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# オーディエンス
export const Button = ({href, children}) => {
return
;
};
## カスタムオーディエンス
### 概要
パートナーが [カスタムオーディエンス](https://business.x.com/en/targeting/tailored-audiences.html) を作成する方法はいくつかあります。
* [Audience API (CRM)](#crm)
* [Web](#web)
* [Mobile](#mobile)
* [Flexible](#flexible)
類似カスタムオーディエンスをターゲティングから除外することはできません。さらに、同じ広告ラインアイテム (広告グループ) 内で、カスタムオーディエンスとカスタムオーディエンス類似を同時にターゲティングすることはできません。
**オーディエンス管理**
オーディエンスは、オーディエンスパートナーおよび Ads API パートナー経由で管理できます。API では、カスタムオーディエンスにアクセスして管理するための一連のエンドポイントを提供しています。
カスタムオーディエンス情報については、次の 2 つのエンドポイントを提供しています。
* [GET accounts/:account\_id/custom\_audiences](/ja/x-ads-api/audiences)
* [GET accounts/:account\_id/custom\_audiences/:custom\_audience\_id](/ja/x-ads-api/audiences)
オーディエンスのアップロードと管理方法の詳細については、[Audience API ガイド](/ja/x-ads-api/audiences)を参照してください。
**処理時間**
一般的に、オーディエンスの変更は 6～8 時間ごとに実行されるバッチで処理されます。オーディエンスの変更が処理中であっても、更新対象となる既存のオーディエンス自体には影響しません。この時間枠内では、1 つのオーディエンスにつき、追加に関する更新は 1 回、削除に関する更新も 1 回を超えて実行しないことを推奨します。
**ターゲティング**
オーディエンスは、過去 90 日以内に X が所有・運営するクライアント上でアクティブだったユーザーが少なくとも 100 人一致している場合にのみターゲティングできます。[GET accounts/:account\_id/custom\_audiences/:custom\_audience\_id](/ja/x-ads-api/audiences) は、一致するユーザー数が少なすぎるためにオーディエンスをターゲティングできない場合、その旨を示します。
**Audience API (CRM)**
オーディエンスまたは API パートナーがハッシュ化された識別子のリストを提供し、X が照合を実行して、X 上でのメディアバイイングに利用可能なセグメントを生成します。パートナーはこれらのオーディエンスを [Audience API](/ja/x-ads-api/audiences) を使って作成できます。
**仕組み**
**Web**
X 上でのメディアバイイングに対してターゲティングするセグメントを特定するため、MPP オーディエンスパートナーとの連携時には標準的なクッキーマッチングプロセスを提供しています。加えて、広告主は [X Web Event Tag](/ja/x-ads-api/measurement/web-conversions#web-event-tags) を設定してウェブサイトのユーザーデータを収集し、対応するカスタムオーディエンスを作成できます。
**セットアップ手順**
![]()
**仕組み**
**Mobile**
詳細については、[Custom Audiences from Mobile Apps に関するブログ記事](https://blog.x.com/2014/introducing-tailored-audiences-from-mobile-apps)を参照してください。
**Flexible**
[Flexible audiences](/ja/x-ads-api/audiences) により、広告主は既存のカスタムオーディエンス、または既存のカスタムオーディエンスのサブセットに基づいて、オーディエンスの組み合わせを作成および保存できます。カスタムオーディエンスのメンバーのサブセットは、インタラクションの直近度と頻度に基づいてターゲティングできます。
**カスタムオーディエンスの利用制限があるユースケース**
[制限事項の詳細はこちら](https://developer.x.com/en/developer-terms/more-on-restricted-use-cases "制限事項の詳細を読む")
### Audiences FAQ[](#real-time-tailored-audiences "Permalink to this headline")
**Q: 非常に大量のデータを送信しましたが、オーディエンスサイズが TOO\_SMALL と表示されるのはなぜですか？**
A: 現在、データはリアルタイムでオーディエンスに追加されていますが、オーディエンスサイズを算出する処理ジョブは一定時間経過後にのみ実行されます。数時間後には、UI 上に正しいオーディエンスサイズが表示されるはずです。
**Q: オーディエンスデータの送信を完了し、24時間以上待ちましたが、まだそのオーディエンスをターゲティングできません。次に何をすればよいですか？**
A: 以下の点を確認してください。
* 渡しているユーザー ID が正しく、形式に問題がないこと。
* 渡しているオーディエンス名が正しく、これまでのメンバーシップ更新時の名称と一致していること。
* POST コマンドからのレスポンスを確認してください。
* ID Sync pixel が正しく実装されていること、および ID Sync プロセスの説明どおり、該当サイトに十分な数のユーザーが訪問してユーザーのマッピングが行われていることを確認してください。メンバーシップ更新に含まれていてもマッピングされていないユーザーは、ターゲティング可能なユーザーには変換されません。
上記すべてに問題がなく、正常に動作している場合は、可能な限り詳細な情報を添えて X のプロダクト担当窓口にご連絡ください (望ましい情報の例として、[Guide to Partner Inbounds](/ja/x-ads-api/introduction) を参照してください) 。
**Q: エンドポイントは何回まで、どのような方法で呼び出せますか？**
A: オーディエンスメンバーシップ全件を再送しないようにし、増分データのみを送信する形でシステムを呼び出すことを強く推奨します。本システムは、世界最大級のウェブサイトの増分データ更新を処理できるだけのスループットでテストされています。オーディエンスの初回アップロードは慎重にスロットリングを行う必要があり、完了までに相応の時間がかかることが想定されます。
**Q: ターゲティングに利用できるオーディエンスの最小サイズはどれくらいですか？**
* ターゲティングに利用できるオーディエンスの最小サイズは 100 ユーザー (照合後) です。500 ユーザー未満しかマッチしなかったオーディエンスは、X Ads の UI 上ではターゲティングに利用できません。
**Q: オーディエンスファイルの処理にはどのくらい時間がかかりますか？また、X のユーザーインターフェイスでオーディエンスファイルが利用可能になるまでにはどのくらいかかりますか？**
* 通常、オーディエンスファイルの処理には 4〜6 時間かかりますが、処理時間はファイルサイズに依存します。ファイルの処理が完了すると、X Ads の UI 上でオーディエンスが利用可能になります。
**Q: マッチ率はどのように計算されますか？**
* マッチ率 = 過去 90 日間のアクティブな X ユーザー数 / 提供されたユーザー数
**Q: オーディエンスファイルが正しく機能しているかどうかをテストするにはどうすればよいですか？**
* テスト用のオーディエンスファイルを用意し、広告主ハンドルとして「keltonlynn」を使用してください。その後、そのファイルが正しく取り込まれ、X の UI に読み込まれることを X 側で検証できます。
**Q: partner user identifier (`p_user_id`) とは何ですか？**
* これは、御社が各顧客を一意に識別するために使用している識別子です。
**Q: standard ID とは何ですか？**
* これは、メールアドレス、デバイス ID、X の @handle、または ID のいずれかです。
**Q: HMAC Key はどのように取得すればよいですか？**
* HMAC Key は暗号化されたメールで提供されます。お客様の公開 PGP キーを [mpp-inquiry@x.com](mailto:mpp-inquiry%x.com) に送付していただければ、まずは動作確認のためのテストメールをお送りします。検証が完了したら、HMAC Key をお送りします。
**Q: 付与された HMAC Key を使ってハッシュ処理が正しく行われたことは、どのように検証できますか？**
* X から、テスト用ファイル (サンプルのメールアドレス、デバイス ID などを含む) と、それに対応するハッシュ結果ファイルを提供します。これを用いて、お客様の処理結果を照合できます。
**Q: full data match ファイルにサイズ制限はありますか？**
* いいえ、full data match ファイルのサイズに制限はありません。
**Q: full data match ファイルの処理にはどのくらい時間がかかりますか？**
* ファイルが X によって受信されてから、処理が完了するまでにはおおよそ 1 日かかります。
### CRM
本ドキュメントでは、Custom Audiences の CRM パートナー向けの連携仕様 (ファイル形式およびデータ交換プロセス) について説明します。
**概要**
Company は、顧客に代わって、共通ユーザー識別子 (例: メールアドレス) のハッシュ化リスト、またはパートナーのユーザー ID のリストを X に送信し、ブラインド マッチングを実行してターゲティング用の X ユーザー ID のリストを生成します。ターゲティング用セグメントは、ads.x.com のキャンペーン設定においてファイル名で指定された、広告主固有の @handle で利用可能になります。
Company からのすべてのファイルは、X が Company に付与した専用アカウントを通じて、IronBox ([www.golockbox.com](http://www.golockbox.com)) 上のセキュアなパッケージ経由で X に提供されます。X は IronBox へのアクセス権を付与します。IronBox API に関するドキュメントは [https://secure.goironcloud.com/Docs/Help/](https://secure.goironcloud.com/Docs/Help/) で参照できます。
#### パートナー ID マッチング要件
企業がユーザーを追跡するために独自の標準 ID システムを使用している場合 (つまり、メールアドレス、デバイス id、X ユーザー ID などの一般的なユーザー識別子ではない場合) 、以下のプロセスを推奨します。
**1. フルデータマッチ**
最初に、企業はすべてのユーザーレコードについて、X と共有する一意の共通ユーザー識別子を含む包括的なリストを 1 つのファイルで提供し、フルデータマッチを実行して、パートナー ID (`p_user_id`) と X ID (`tw_id`) のマッピングを X 側で保持します。これは適切なメンテナンスを行うため、2～3 か月ごとに定期的に実施されます。マッチングが完了すると、X はこのファイルに基づくベースラインのマッチ率をメールで企業と共有します。
このファイルのフォーマットは次のとおりです:
命名規則: FullDataMatch.\[CompanyName].txt
ハッシュアルゴリズム: HMAC\_SHA-256
フォーマット:
列 1: 共通識別子を HMAC でハッシュ化した値
列 2: パートナーユーザー ID (ユーザーごとに一意、ファイル内では重複可)
列区切り文字 (CSV) : 共通ユーザー識別子のハッシュ値とパートナー ID の区切りにはカンマを使用
値は行区切り
* 例: ユーザーレコード A のパートナーユーザー ID が 1 で、共通識別子が 1、2、3 の場合:
| | |
| :----------------------- | :--------- |
| common user identifier 1 | p\_user\_1 |
| common user identifier 2 | p\_user\_1 |
| common user identifier 3 | p\_user\_1 |
\*共通ユーザー識別子については、以下の「ハッシュ化手順」セクションを参照してください
**2. カスタムセグメントリスト**
企業は、X 上でのターゲティング用に顧客向けカスタムオーディエンスを作成するため、`p_user_id` 形式のユーザーリストを提供します。
* 値は行区切り
* `p_user_id`
* * (上記 1. フルデータマッチのセクションで提供されたものと同一です。フルデータマッチで提供された値がハッシュ化されている場合、企業はオーディエンスファイルにも同じハッシュ化された値を提供します。提供された値がハッシュ化されていない場合、企業はハッシュ化されていない値を提供します。)
#### 標準マッチング要件
企業が、すべての顧客ユーザー識別子のマッピングに標準 ID を使用していない場合には、次のプロセスを推奨します。
**カスタムセグメントリスト**
企業は、顧客に代わり、ハッシュ化された共通ユーザー識別子のリストを X に直接提供し、カスタムオーディエンスを作成します。
このファイルの形式は次のとおりです。
* 行区切りの値
* ハッシュ化された共通ユーザー識別子 (例：メールアドレス)
* 以下に記載のファイル命名規則に従うこと
* メールアドレスについては、以下の「ハッシュ化の手順」に従うこと
デバイス ID のハッシュ化についても、データパートナーに提供する共通のソルトと SHA-256 ハッシュアルゴリズムを使用するという同一の要件が適用されます。メールアドレスの場合と同様にスペースは削除しますが、IDFA/Android ID については小文字への正規化は行わず、IDFA/Android ID の元のフォーマットをそのまま使用してください。
以下は、ハッシュ化前の iOS および Android のデバイス ID の生のフォーマット例です。
iOS IDFA: DD99CFF7-6186-4602-9DF2-ED3FD0B2D431
Android ID: b5bf2122961b3595
ハッシュ化された iOS IDFA: 134fb8cd95c7fd42e2793f469a447198ca5f990968db2dbadad70e723ed9750b
ハッシュ化された Android ID: 130dddff1939f229476f50bc8adab8fcb7e3525b0e9604fe8effc15e68cee4a4
#### X ユーザー ID の正規化
X ID は、たとえそれが PII ではなくても、データのグルーピング (例：@handle のカスタマーリスト) が広告主にとって非公開であるため、引き続きハッシュ化されます。データパートナーに提供する共通のソルトと SHA-256 ハッシュアルゴリズムを用いて X ID をハッシュ化する、という同じ要件が適用されます。X ID と `@`username の両方からは、スペースをすべて取り除く必要がありますが、User ID については正規化は不要です。正規化のため、@username は小文字に変換してください。また、@ 記号は username の一部として含めないでください。
生の ID の形式は次のとおりです:
* User ID: 27674040
* @username: testusername
ハッシュ化された User ID: bf6b57d4e861e83bea8bbed2b800b251a64c95468ee6e8cb07c3368c9ed45e85
ハッシュ化された @username: 12201ae78ad1afa907c7112d17f498154ffb0bf9ea523f5390e072a06d7d9812
### ID Sync 連携
`p_id` を用いてデータを送信するパートナーは、広告主またはパートナーのユーザー ID と X ユーザー ID をマッピングするために、ID Sync プロセスを実行する必要があります。これにより、広告主は自社のユーザーセグメントを X 上で直接ターゲティングできるようになります。パートナーは、メンバーシップ更新情報を送信する際に、パラメータ `user_identifier_type` の値を `TALIST_PARTNER_USER_ID` または `TAWEB_PARTNER_USER_ID` のいずれかに設定する必要があります。
* **Web のみ**: 以下のとおり、広告主のサイトにピクセルを設置することで実行できます。
* **リスト**: [CRM](/ja/x-ads-api/audiences#crm) ページで説明しているいずれかの方法を使用して実行できます。
#### GET accounts/:account\_id/tailored\_audiences/:tailored\_audience\_id/permissions[](#get-accounts-account-id-tailored-audiences-tailored-audience-id-permissions "Permalink to this headline")
指定されたテイラードオーディエンスに関連付けられている一部またはすべての権限の詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/5/accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 利用するアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで、一般的に必須パラメーターです。指定されたアカウントは認証済みユーザーに関連付けられている必要があります。
#### POST accounts/:account\_id/tailored\_audiences/:tailored\_audience\_id/permissions[](#post-accounts-account-id-tailored-audiences-tailored-audience-id-permissions "Permalink to this headline")
指定されたオーディエンスを、指定したアカウントと共有できるようにする新しい権限オブジェクトを作成します。
**Note**: テイラードオーディエンスの権限を作成または変更するには、そのオーディエンスが、権限を変更しようとしているアカウントに所有されている必要があります。特定のオーディエンスのレスポンスに含まれる `is_owner` レスポンス属性を確認することで、テイラードオーディエンスの所有者を判別できます。
**Note**: オーディエンスを共有できるのは、同一ビジネス内の広告アカウント間、またはオーディエンスを所有している広告アカウントが `SHARE_AUDIENCE_OUTSIDE_BUSINESS` アカウント機能を有している場合のみです。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/5/accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :--------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 利用するアカウントの識別子です。リソースパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで原則として必須パラメータです。指定したアカウントは、認証済みユーザーに関連付けられている必要があります。
#### DELETE accounts/:account\_id/tailored\_audiences/:tailored\_audience\_id/permissions/:tailored\_audience\_permission\_id[](#delete-accounts-account-id-tailored-audiences-tailored-audience-id-permissions-tailored-audience-permission-id "Permalink to this headline")
指定された Tailored Audience の共有権限を取り消します。
**注記**: Tailored Audience の権限を作成または変更するには、そのオーディエンスが権限を変更しようとしているアカウントに所有されている必要があります。特定のオーディエンスに対するレスポンス内の `is_owner` レスポンス属性を確認することで、Tailored Audience の所有権を確認できます。
権限が取り消されると、付与されたアカウント (`granted_account_id`) が今後のキャンペーンでそのオーディエンスをターゲットにできないことを当社として保証します。既存のキャンペーンは共有されたオーディエンスを使って引き続き配信されます。キャンペーンは停止されず、オーディエンスもキャンペーンから削除されません。オーディエンス共有権限が取り消された後に、このキャンペーンをコピーすることはできません。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/5/accounts/:account_id/tailored_audiences/:tailored_audience_id/permissions/:tailored_audience_permission_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :--------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id *required* | 対象アカウントの識別子。リソースのパス内に現れ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストにおいて、一般的に必須パラメータです。指定されたアカウントは、認証済みユーザーに紐づいている必要があります。
#### GET accounts/:account\_id/custom\_audiences/:custom\_audience\_id/targeted[](#get-accounts-account-id-custom-audiences-custom-audience-id-targeted "この見出しへのパーマリンク")
#### POST accounts/:account\_id/custom\_audiences/:custom\_audience\_id/users[](#post-accounts-account-id-custom-audiences-custom-audience-id-users "この見出しへのパーマリンク")
#### GET accounts/:account\_id/custom\_audiences/:custom\_audience\_id/permissions[](#get-accounts-account-id-custom-audiences-custom-audience-id-permissions "Permalink to this headline")
指定されたカスタムオーディエンスに関連付けられている一部またはすべての権限の詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/custom_audiences/:custom_audience_id/permissions`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 利用するアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで一般的に必須パラメータです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。
#### POST accounts/:account\_id/custom\_audiences/:custom\_audience\_id/permissions[](#post-accounts-account-id-custom-audiences-custom-audience-id-permissions "この見出しへのパーマリンク")
#### DELETE accounts/:account\_id/custom\_audiences/:custom\_audience\_id/permissions/:custom\_audience\_permission\_id[](#delete-accounts-account-id-custom-audiences-custom-audience-id-permissions-custom-audience-permission-id "Permalink to this headline")
指定されたカスタムオーディエンスの共有権限を取り消します。
**Note**: カスタムオーディエンスの権限を作成または変更するには、そのオーディエンスが権限の変更を行おうとしているアカウントによって所有されている必要があります。特定のオーディエンスのレスポンスに含まれる `is_owner` レスポンス属性を確認することで、そのカスタムオーディエンスの所有権を確認できます。
権限が取り消されると、付与されていたアカウント (`granted_account_id`) は今後のキャンペーンでそのオーディエンスをターゲットにできなくなることが保証されます。既存のキャンペーンは共有オーディエンスを利用して引き続き配信されます。キャンペーンは停止されず、オーディエンスもキャンペーンから削除されません。オーディエンス共有権限が取り消された後は、そのキャンペーンをコピーすることはできません。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/custom_audiences/:custom_audience_id/permissions/:custom_audience_permission_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 利用するアカウントの識別子です。リソースのパスの一部として現れ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで、一般的に必須パラメータです。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。
#### DELETE accounts/:account\_id/custom\_audiences/:custom\_audience\_id[](#delete-accounts-account-id-custom-audiences-custom-audience-id "Permalink to this headline")
現在のアカウントに属する、指定された Custom Audience を削除します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/custom_audiences/:custom_audience_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 利用するアカウントの識別子です。リソースのパス内に現れ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで一般的に必須となるパラメータです。指定されたアカウントは認証済みユーザーに関連付けられている必要があります。
#### POST accounts/:account\_id/do\_not\_reach\_lists[](#post-accounts-account-id-do-not-reach-lists "Permalink to this headline")
現在のアカウントに関連付けられた新しい Do Not Reach リストを作成します。
**注**: `account_id` ごとに作成できる Do Not Reach リストは最大 1 つです
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/do_not_reach_lists`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 対象のアカウントの識別子です。リソースのパス内に含まれ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで通常必須のパラメータです。指定されたアカウントは認証済みユーザーに関連付けられている必要があります。
Example: `A list of users to exclude` |
**Example Request[](#example-request "Permalink to this headline")**
`POST https://ads-api.x.com/12/accounts/18ce54bgxky/do_not_reach_lists?description=A list of users to exclude`
**Example Response[](#example-response "Permalink to this headline")**
```
{
"request": {
"params": {
"description": "除外するユーザーのリスト",
"account_id": "18ce54bgxky"
}
},
"data": {
"targetable": false,
"name": "Do Not Reach リスト",
"description": "除外するユーザーのリスト",
"id": "4ofrq",
"reasons_not_targetable": [
"PROCESSING",
"TOO_SMALL"
],
"created_at": "2022-02-08T23:02:48Z",
"list_size": null,
"updated_at": "2022-02-08T23:02:48Z",
"deleted": false
}
}
```
#### POST batch/accounts/:account\_id/do\_not\_reach\_lists/:do\_not\_reach\_list\_id/users[](#post-batch-accounts-account-id-do-not-reach-lists-do-not-reach-list-id-users "Permalink to this headline")
このエンドポイントを使用すると、指定された `do_not_reach_list_id` に対してユーザーを追加・更新・削除できます。このエンドポイントでは、有効なユーザー識別子としてメールアドレスのみを受け付けます。
リクエストの `emails` フィールドで提供されるすべてのデータは、`SHA256` でハッシュ化し、[正規化](/ja/x-ads-api/audiences#e-mail-normalization)されていなければなりません。
**注意事項**
* 1 つの `account_id` が持てる Do Not Reach List は最大 1 つです
* このリストに追加されるユーザーには、現在のタイムスタンプから 13 か月未満となる `expires_at` タイムスタンプを **必ず** 設定する必要があります
* Do Not Reach List API は `effective_at` タイムスタンプを受け付けず、現在のタイムスタンプをデフォルトとして使用します
* Do Not Reach List は、そのアカウント内のいずれかまたはすべてのカスタムオーディエンスからユーザーを削除するものではなく、そのアカウントで配信されるすべてのキャンペーンに対する除外ターゲティングとして機能します
**バッチリクエスト**
* 現在の最大バッチサイズは**このエンドポイントに対して** `2500` です。バッチサイズは、リクエストごとの操作数 (`Update` / `Delete`) によって決まります。たとえば、1 つの配列内に 2500 を超える操作オブジェクト (`{"operation_type": "Update/Delete", [..] }`) が含まれているとエラーになります。
* このエンドポイントが受け付けるリクエスト POST ボディの最大サイズは `5,000,000` バイトです。
* このエンドポイントのレート制限は、1 分あたり 1500 件です。
* すべてのパラメータはリクエストボディで送信され、`Content-Type` は `application/json` である必要があります。
* バッチリクエストはグループとして一括で成功または失敗し、エラーと成功の両方について、すべての API レスポンスは初回リクエストのアイテム順序を保持します。
**バッチレスポンス**
Ads API から返されるレスポンスには、`success_count` と `total_count` の 2 つのフィールドが含まれます。これらの値は常に等しくなければならず、バックエンドによって処理された、リクエスト内のレコード数を表します。リクエストボディで送信されたレコード数が `success_count` および `total_count` と等しく**ない**場合は、再試行が必要なエラー状態として扱う必要があります。
**バッチエラー**
* リクエストレベルのエラー (例: 最大バッチサイズ超過) は、レスポンスの `errors` オブジェクトに表示されます。
* アイテムレベルのエラー (例: 必須パラメータの欠如) は、レスポンスの `operation_errors` オブジェクトに表示されます。
* `operation_errors` 内のエラーのインデックスは、入力アイテム内のインデックスに対応しており、それぞれに対応するエラーメッセージが含まれます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/batch/accounts/:account_id/do_not_reach_lists/:do_not_reach_list_id/users`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id *required* | 対象とするアカウントの識別子です。リソースのパス内に現れ、[GET accounts](/ja/x-ads-api/campaign-management#accounts) を除くすべての Advertiser API リクエストで一般的に必須パラメータとなります。指定されたアカウントは、認証済みユーザーに関連付けられている必要があります。
Type: string
Example: `18ce54d4x5t` |
| do\_not\_reach\_list\_id *required* | リクエストで操作対象となる Do Not Reach List を参照します。
オーディエンスまたは API パートナーがハッシュ化された識別子のリストを提供し、X が照合を実行して、X 上でのメディアバイイングに利用可能なセグメントを生成します。パートナーはこれらのオーディエンスを [Audience API](/ja/x-ads-api/audiences) を使って作成できます。
**仕組み**
**Web**
X 上でのメディアバイイングに対してターゲティングするセグメントを特定するため、MPP オーディエンスパートナーとの連携時には標準的なクッキーマッチングプロセスを提供しています。加えて、広告主は [X Web Event Tag](/ja/x-ads-api/measurement/web-conversions#web-event-tags) を設定してウェブサイトのユーザーデータを収集し、対応するカスタムオーディエンスを作成できます。
**セットアップ手順**
![]()
**仕組み**
**Mobile**
詳細については、[Custom Audiences from Mobile Apps に関するブログ記事](https://blog.x.com/2014/introducing-tailored-audiences-from-mobile-apps)を参照してください。
**Flexible**
[Flexible audiences](/ja/x-ads-api/audiences) により、広告主は既存のカスタムオーディエンス、または既存のカスタムオーディエンスのサブセットに基づいて、オーディエンスの組み合わせを作成および保存できます。カスタムオーディエンスのメンバーのサブセットは、インタラクションの直近度と頻度に基づいてターゲティングできます。
**カスタムオーディエンスの利用制限があるユースケース**
[制限事項の詳細はこちら](https://developer.x.com/en/developer-terms/more-on-restricted-use-cases "制限事項の詳細を読む")
**情報**
パートナーは、広告主に代わってターゲティングするための ID (`p_user_ids`) のリストを送信します。これは、`p_user_ids` と X ユーザー ID の間にマッピングを構築する ID Sync プロセスによって実行されます。このマッピングは、その後ターゲティングに使用できる X ユーザー ID のリストを生成するために使用されます。これらのカスタムオーディエンスは、ads.x.com の Custom Audiences Web キャンペーン設定におけるラベルで指定される、広告主固有の @handle 上で利用可能になります。
X は、パートナーのタグおよびサイトに埋め込むことで、ID (`p_user_ids`) を X ユーザー ID にマッチさせるために使用できるセキュアピクセルを提供します。ID Sync プロセスが完了すると、パートナーによってターゲティングファイルが作成され、HTTPS エンドポイントを通じて X が取得できるようにされます。これらのターゲティングファイルは、X によって定期的に取り込まれ、その後 X の UI で利用可能になります。
**X セキュアピクセル**
X セキュアピクセルは次のとおりです。
[https://analytics.x.com/i/adsct?p\_user\_id=xyz\&p\_id=123](https://analytics.x.com/i/adsct?p\_user\_id=xyz\&p\_id=123)
**`p_user_id`** - xyz は、パートナーによって提供されるパートナーユーザー ID を表します
**`p_id`** - 123 は、パートナーに対して一意の ID (X によって提供) を表します
**パートナー HTTPS エンドポイント & ターゲティングユーザーファイル**
パートナーは、ターゲティングファイルを定期的に取り込むために使用できる HTTPS エンドポイントと認証情報 (ユーザー名/パスワード) を X に提供する必要があります。HTTPS エンドポイントの例は次のようになります:
```
https://