> ## 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 ;
};
## Advertiser API
この一連のAPIを利用することで、X上のキャンペーンや広告をプログラムからスケジュールし、管理できます。
## 何をプロモーションできるか
### [Promoted Ads](https://business.x.com/help/what-are-promoted-tweets)
* Promoted Ads (プロモーション広告) は、より幅広いユーザー層にリーチしたい、あるいは既存のフォロワーからのエンゲージメントを喚起したい広告主が購入する通常の広告です。
* Promoted Ads は、広告主が X 上での掲載に対して支払っている場合、「Promoted」として明確にラベル表示されます。それ以外の点では、Promoted Ads は通常の広告と同様に機能し、リポスト、返信、いいねなどが可能です。通常の配信ルールが適用され、[POST statuses/update](/ja/x-api/posts/creation-of-a-post) を使って作成されます。
* **「Promoted-only」ツイート**は、[POST accounts/:account\_id/tweet](/ja/x-ads-api/creatives#post-accounts-account-id-tweet) を使用して作成され、Promoted Tweets キャンペーンで利用できますが、フォロワーには配信されず、公開タイムラインにも表示されません。特定アカウントの Promoted-only ツイートのリストを取得するには、[GET accounts/:account\_id/scoped\_timeline](/ja/x-ads-api/creatives) を使用してください。
### [プロモアカウント](https://business.x.com/help/what-are-promoted-accounts)
* プロモアカウントは「おすすめユーザー」の一部であり、ユーザーが現在フォローしていないが、興味を持つ可能性のあるアカウントをおすすめする機能です。プロモアカウントを利用することで、ユーザーが楽しめる可能性のある、さらに幅広いアカウントを紹介できます。
* タイムライン向けのプロモアカウントでは、プロモツイートをプロモアカウントキャンペーンに紐付けて、ユーザーのタイムラインに表示します。
プロモトレンドは Ads API では利用できません。
## キャンペーンと広告グループ (ラインアイテム)
キャンペーンは、広告の配信スケジュールと予算を定義します。広告主は 1 日あたりの予算と総予算を指定します。キャンペーンは特定の開始時刻と終了時刻に紐づけることも、予算が消化されるまで継続的に配信することもできます。予算は広告アカウントの Funding Instruments のいずれかから支出されます。キャンペーン識別子 (:campaign\_id) は、X Ads UI に表示される 10 進数の値を 36 進数表現にしたものです。
広告アカウントごとに、アクティブなキャンペーンは最大 200 件までに制限されています。この上限は、広告主からの依頼に基づき、担当の X アカウントマネージャーによって手動で 4,000 件まで引き上げることができます。キャンペーンは、終了時刻に達するか削除されるまでアクティブと見なされます。一時停止中のキャンペーンも、指定された終了時刻に達するまではアクティブと見なされます。
ラインアイテムは、キャンペーンで定義された予算を消化します。ラインアイテムは、エンゲージメント単価の入札額、プロモーション対象のツイートまたはアカウント、およびターゲティングルールをまとめて指定します。
## アナリティクス
X Ads API には、広告パフォーマンスを追跡および最適化するための一連のアナリティクス用エンドポイントが用意されています。詳細については、「Analytics」および「Analytics Best Practices」を参照してください。
課金指標については、イベント発生から 3 日後までデータが確定しない場合があります。それまでは、そのデータは暫定値として扱う必要があります。最終的な課金対象の数値は、必ず暫定値以下になります。課金対象の数値は、スパムや関連する低品質トラフィックを補正した結果の値です。時間に関するその他の考慮事項については、「Timezones」を参照してください。
## キャンペーンの作成手順
次の例では、[twurl](https://github.com/twitter/twurl) を使用して App とユーザーのインストール、設定、認可を済ませていることを前提とします。twurl は cURL と同様のコマンドラインツールで、X の OAuth 認証を適切に処理します。twurl は Ads API (および REST API) の機能を迅速にテストおよびデバッグするのに便利なツールです。リクエストとレスポンスのヘッダー全体を確認するには、`-t` を使用して呼び出しをトレースします。これは cURL の `-v` オプションとおおよそ同等です。
**この例では、キーワードでターゲティングされる Promoted Ads キャンペーンを作成します。**
1. **アカウント ID を取得します。**
```
twurl -H ads-api.x.com /9/accounts/
```
```JSON theme={null}
{
"request": {
"params": {
}
},
"data": [
{
"name": "Test account for @AdsAPI",
"timezone": "America/Los_Angeles",
"timezone_switch_at": null,
"id": "xxxxxx",
"created_at": "2014-03-09T00:41:49Z",
"salt": "f9f9d5a5f23075c618da5eb1d1a9df57",
"updated_at": "2015-01-29T00:41:49Z",
"approval_status": "ACCEPTED",
"deleted": false
}
],
"data_type": "account",
"total_count": 1,
"next_cursor": null
}
```
2. **ファンディングインストゥルメントの id を取得します。**
前のコマンドで取得したアカウント id を使用して、[GET accounts/:account\_id/funding\_instruments](/ja/x-ads-api/campaign-management#get-accounts-account-id-funding-instruments) API を呼び出します。
```
twurl -H ads-api.x.com /9/accounts/xxxxxx/funding_instruments
```
```JSON theme={null}
{
"data": [
{
"cancelled": true,
"created_at": "2014-03-09T00:41:49Z",
"credit_limit_local_micro": null,
"currency": "USD",
"deleted": false,
"description": null,
"end_time": null,
"funded_amount_local_micro": null,
"id": "yyyy",
"type": null,
"updated_at": "2014-05-29T00:41:49Z"
}
],
"data_type": "funding_instrument",
"next_cursor": null,
"request": {
"params": {
"account_id": "xxxxxx"
}
},
"total_count": 1
}
```
3. **キャンペーンを作成し、ファンディングインストゥルメントに関連付けます。**
キャンペーンの開始日時と予算を指定します。この例では、予算を500ドル、1日あたりの上限額を50ドルとします。
```
twurl -H ads-api.x.com -d "funding_instrument_id=yyyy&name=My First Campaign&total_budget_amount_local_micro=500000000&daily_budget_amount_local_micro=50000000" /9/accounts/xxxxxx/campaigns
```
```JSON theme={null}
{
"data": {
"created_at": "2015-02-09T00:00:00Z",
"currency": "USD",
"daily_budget_amount_local_micro": 50000000,
"deleted": false,
"end_time": null,
"funding_instrument_id": "yyyy",
"id": "92ph",
"name": "My First Campaign",
"entity_status": "PAUSED",
"standard_delivery": true,
"total_budget_amount_local_micro": 500000000,
"updated_at": "2015-02-09T00:00:00Z"
},
"data_type": "campaign",
"request": {
"params": {
"account_id": "xxxxxx",
"daily_budget_amount_local_micro": 50000000,
"funding_instrument_id": "yyyy",
"name": "My First Campaign",
"total_budget_amount_local_micro": 500000000
}
}
}
```
4. **キャンペーンに関連付けられたラインアイテムを作成します。**
キャンペーン id を取得したので、それに関連付けるラインアイテムを作成できるようになりました。ラインアイテムは、入札価格、ターゲティング、キャンペーンにおける実際のクリエイティブ部分をまとめたものです。このラインアイテムでは、\$1.50 の入札でツイートをプロモーションします。
```
twurl -H ads-api.x.com -d "campaign_id=XXXX&bid_amount_local_micro=1500000&product_type=PROMOTED_TWEETS&placements=ALL_ON_TWITTER&objective=ENGAGEMENTS&entity_status=PAUSED" /9/accounts/xxxxxxx/line_items
```
```JSON theme={null}
{
"data_type": "line_item",
"data": {
"bid_type": "MAX",
"name": "Untitled",
"placements": [
"ALL_ON_TWITTER"
],
"bid_amount_local_micro": 1500000,
"automatically_select_bid": false,
"advertiser_domain": null,
"primary_web_event_tag": null,
"charge_by": "ENGAGEMENT",
"product_type": "PROMOTED_TWEETS",
"bid_unit": "ENGAGEMENT",
"total_budget_amount_local_micro": null,
"objective": "ENGAGEMENTS",
"id": "azjx",
"entity_status": "PAUSED",
"optimization": "DEFAULT",
"categories": [],
"currency": "USD",
"created_at": "2015-02-09T00:00:00Z",
"updated_at": "2015-02-09T00:00:00Z",
"include_sentiment": "POSITIVE_ONLY",
"campaign_id": "92ph",
"deleted": false
},
"request": {
"params": {
"placements": [
"ALL_ON_TWITTER"
],
"bid_amount_local_micro": 1500000,
"product_type": "PROMOTED_TWEETS",
"entity_status": "PAUSED",
"account_id": "xxxxxxx",
"campaign_id": "92ph"
}
}
}
```
5. **ラインアイテムに紐づくターゲティングプロファイルを作成します。**
ラインアイテムを作成したので、ターゲティング条件を割り当てることができます。ここでは、サンフランシスコ・ベイエリアのロケーションにおいて、フレーズキーワード「grumpy cat」をターゲットにします。これには、ロケーション id の取得と、targeting\_criteria への POST リクエストを 2 回行う必要があります。
```
twurl -H ads-api.x.com "/9/targeting_criteria/locations?location_type=CITIES&q=San Francisco"
```
```JSON theme={null}
{
"data": [
{
"name": "San Francisco-Oakland-San Jose CA, US",
"targeting_type": "LOCATION",
"targeting_value": "5122804691e5fecc"
}
],
"data_type": "targeting_criterion",
"request": {
"params": {
"location_type": "CITY",
"q": "San Francisco"
}
}
}
```
```
twurl -H ads-api.x.com -X POST -d "line_item_id=yyyy&targeting_type=LOCATION&targeting_value=5122804691e5fecc" /9/accounts/xxxxxx/targeting_criteria
```
```JSON theme={null}
{
"data": {
"created_at": "2015-02-09T00:00:15Z",
"deleted": false,
"id": "2u3be",
"line_item_id": "yyyy",
"name": "San Francisco-Oakland-San Jose CA, US",
"targeting_type": "LOCATION",
"targeting_value": "5122804691e5fecc",
"updated_at": "2013-05-30T21:01:35Z"
},
"data_type": "targeting_criterion",
"request": {
"params": {
"account_id": "xxxxxx",
"line_item_id": "yyyy",
"targeting_type": "LOCATION",
"targeting_value": "5122804691e5fecc"
}
}
}
```
```
twurl -H ads-api.x.com -X POST -d "line_item_id=yyyy&targeting_type=PHRASE_KEYWORD&targeting_value=grumpy cat" /9/accounts/xxxxxx/targeting_criteria
```
```JSON theme={null}
{
"data": {
"created_at": "2015-02-09T00:00:20Z",
"deleted": false,
"id": "2u3bd",
"line_item_id": "yyyy",
"name": "grumpy cat",
"targeting_type": "PHRASE_KEYWORD",
"targeting_value": "grumpy cat",
"updated_at": "2013-05-30T18:05:35Z"
},
"data_type": "targeting_criterion",
"request": {
"params": {
"account_id": "xxxxxx",
"line_item_id": "yyyy",
"targeting_type": "PHRASE_KEYWORD",
"targeting_value": "grumpy cat"
}
}
}
```
6. **最後に、ラインアイテムの一時停止を解除します。**
```
twurl -H ads-api.x.com -X PUT "/9/accounts/xxxxxx/line_items/yyyy/?entity_status=ACTIVE"
```
```JSON theme={null}
{
"data_type": "line_item",
"data": {
"bid_type": "MAX",
"name": "grumpy cat",
"placements": [],
"bid_amount_local_micro": 1500000,
"automatically_select_bid": false,
"advertiser_domain": null,
"primary_web_event_tag": null,
"charge_by": "ENGAGEMENT",
"product_type": "PROMOTED_TWEETS",
"bid_unit": "ENGAGEMENT",
"total_budget_amount_local_micro": null,
"objective": "ENGAGEMENTS",
"id": "yyyy",
"entity_status": "ACTIVE",
"optimization": "DEFAULT",
"categories": [],
"currency": "USD",
"created_at": "2015-02-09T00:00:20Z",
"updated_at": "2015-02-09T00:00:20Z",
"include_sentiment": "POSITIVE_ONLY",
"campaign_id": "dy1f",
"deleted": false
},
"request": {
"params": {
"line_item_id": "yyyy",
"entity_status": "ACTIVE",
"account_id": "xxxxxx"
}
}
}
```
以上です。これで、タイムラインに配信されるプロモツイートキャンペーンが稼働し、ターゲティングと予算設定も完了しました。
### 目的ベースのキャンペーン
目的ベースのキャンペーンおよび課金モデルでは、広告主は自社のマーケティング目的に合致したアクションに対して支払うことができます。これを実現するには、ラインアイテムで適切な `objective` を設定してください。
ラインアイテムの書き込みエンドポイントで使用され、読み取りエンドポイントで返されるパラメータは `objective` です。このフィールドには、現時点では次の値を指定できます。
* `APP_ENGAGEMENTS`
* `APP_INSTALLS`
* `FOLLOWERS`
* `ENGAGEMENTS`
* `REACH`
* `VIDEO_VIEWS`
* `PREROLL_VIEWS`
* `WEBSITE_CLICKS`
目的によって、オークションにおけるキャンペーンの最適化方法と、そのキャンペーンの課金方法が変わります。`APP_ENGAGEMENTS` には CPAC、`APP_INSTALLS` には CPAC *または* CPI、`WEBSITE_CLICKS` には CPLC、`FOLLOWERS` には CPF、`ENGAGEMENTS` には CPE、`REACH` には CPM など、目的ごとに課金モデルを提供しています。
モバイルアプリプロモーションキャンペーンには、`APP_ENGAGEMENTS` か `APP_INSTALLS` のいずれかの objective を必ず含める必要があります。
**注:** 異なる objective を持つラインアイテムを同一キャンペーン内に含めることはできません。
| Campaign objective | API objective | Media in Tweets | Pricing model |
| :----------------- | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------- |
| App re-engagements | `APP_ENGAGEMENTS` | 画像または動画のアプリダウンロードカードが必須。 | CPAC |
| App installs | `APP_INSTALLS` | 画像または動画のアプリダウンロードカードが必須。 | CPAC または CPI (`charge_by` を使用して設定) |
| Reach | `REACH` | 制限なし。 | CPM |
| Followers | `FOLLOWERS` | ツイートは必須ではありませんが推奨されます。フォロワーキャンペーン向けツイートのメディアに制限はありませんが、テキストのみのツイートを推奨します。 [詳細情報](https://business.x.com/en/help/campaign-setup/create-a-followers-campaign.html#serve) | CPF |
| Engagements | `ENGAGEMENTS` | 制限なし。 | CPE |
| Video Views | `VIDEO_VIEWS` | 動画会話カード、動画、または GIF が必須。 | CPV または 3 秒間/100% 再生あたりのコスト |
| Pre-roll views | `PREROLL_VIEWS` | 動画が必須。 | CPV または 3 秒間/100% 再生あたりのコスト |
| Website Clicks | `WEBSITE_CLICKS` | ウェブサイトカードの使用を推奨しますが必須ではありません。ツイートには、ウェブサイトカードかウェブサイトリンクのいずれか一方 (両方ではない) を含める必要があります。 | CPLC |
### 資金源
資金源は、キャンペーンの予算を拠出する元となるものです。資金源は Ads API 経由で作成することはできず、利用可能にするには、与信枠の場合は X の広告主担当アカウントマネージャー、クレジットカードの場合は ads.x.com を通じて、あらかじめ設定されている必要があります。
アカウントに紐づくすべての `funding_instruments` の一覧を取得するには、[GET accounts/:account\_id/funding\_instruments](/ja/x-ads-api/campaign-management#get-accounts-account-id-funding-instruments) を参照してください。特定の資金源の詳細については、[GET accounts/:account\_id/funding\_instruments/:funding\_instrument\_id](/ja/x-ads-api/campaign-management#get-accounts-account-id-funding-instruments-funding-instrument-id) を参照してください。
#### 資金源の属性
説明: `account_id`、資金源の `id`、資金源の `type`、`description`、および `io_header` (インサーションオーダーのヘッダー ID) 。1 つの `io_header` が複数の資金源に関連付けられる場合がある点に注意してください。
資金提供の可否: `able_to_fund` と `reasons_not_able_to_fund`。
時間: `created_at`、`updated_at`、`start_time`、および `end_time`。いずれも文字列で表され、「%Y-%m-%dT%l:%M:%S%z」という形式でフォーマットされます。
ブール値のステータス: `paused`、`deleted`、および `cancelled` (true または false) 。
財務関連: `currency` ([ISO-4217](http://en.wikipedia.org/wiki/ISO_4217) 形式) 、`credit_limit_local_micro`、`credit_remaining_local_micro`、および `funded_amount_local_micro`。通貨の値はマイクロ単位で表されます。USD の場合、\$5.50 は 5.50\*1e6、つまり 5,500,000 としてエンコードされます。元の金額 (通貨単位での値) を表現するには、すべての通貨について local micro に 1e6 (1\_000\_000) を掛ける必要があります。
#### 属性の詳細
`credit_limit_local_micro` は `CREDIT_CARD` または `CREDIT_LINE` type のファンディングインスツルメントに対してのみ有効で、そのインスツルメントのクレジット上限額を表します。
`funded_amount_local_micro` は `INSERTION_ORDER` type のファンディングインスツルメントに対してのみ有効で、割り当てられた予算を表します。
`credit_remaining_local_micro` は `CREDIT_LINE` および `AGENCY_CREDIT_LINE` type のファンディングインスツルメントに対して有効です。これは、そのインスツルメントに対してすでに支出された金額を `credit_limit_local_micro` から差し引いた残りのクレジット額を表します。これは、`funded_amount_local_micro` と支出額との差額を表すものではありません。クレジット上限額と資金拠出額は、広告主との間で合意している基礎となる資金調達方法および支出契約が異なるため、区別しています。
#### 資金手段の種類
**クレジットカード**
通常、アカウントマネージャーが付かないセルフサーブ広告主によって使用されます。
**クレジットライン**
インサーションオーダー (IO) の形式で提供され、アカウントマネージャーによって設定されます。
**マルチハンドルクレジットライン**
広告主は、この種類のクレジットラインを使って複数のハンドルにまたがるキャンペーンに資金を供給できます。この機能は、X のアカウントマネージャーが複数の @handle を特定のクレジットラインに関連付けて有効化することで利用できるようになります。
たとえば、@NikeSB と @NikeFuel はどちらも @Nike クレジットラインにアクセスできます。この資金手段も他のものと同様に利用可能です。`funding_instrument` エンドポイントに GET リクエストを送信することでデータを取得します。以下はレスポンスのサンプルです (`CREDIT_LINE` タイプに注目してください) 。
```json theme={null}
GET https://ads-api.x.com/5/accounts/a0b1c3/funding_instruments
{
"request": {
"params": {
"account_id": "a0b1c3"
}
},
"data": [
{
"start_time": "2013-05-30T04:00:00Z",
"description": "FakeNike - Credit Line",
"credit_limit_local_micro": 150000000000,
"end_time": null,
"cancelled": false,
"id": "i1234",
"paused": false,
"account_id": "a0b1c3",
"reasons_not_able_to_fund": [],
"io_header": null,
"currency": "USD",
"funded_amount_local_micro": 0,
"created_at": "2013-05-30T18:16:38Z",
"type": "CREDIT_LINE",
"able_to_fund": true,
"updated_at": "2013-05-30T18:16:38Z",
"credit_remaining_local_micro": 123661919751,
"deleted": false,
}
],
"data_type": "funding_instrument",
"total_count": 1,
"next_cursor": null
}
```
このFunding Instrumentについて特筆すべき点は、そのtypeであることと、それに関連付けられているすべてのアカウントで利用可能であるという事実だけです。もちろん、残りのクレジットは、このFunding Instrumentによって資金提供されている、これを共有するすべてのアカウントにまたがるキャンペーンすべての影響を受けます。特定のCredit Lineにどのアカウントが関連付けられているかの詳細は、API経由でも (ads.x.com経由でも) 取得できません。
Funding Instrumentの列挙値に関する詳細は、[こちら](/ja/x-ads-api/introduction)をご参照ください。
### ターゲティング
ターゲティングは Ads API の中核となる概念です。ターゲティングはラインアイテム単位で設定され、プレースメントごとに利用できるオプションが異なります。新しいターゲティング条件を設定するには [POST accounts/:account\_id/targeting\_criteria](/ja/x-ads-api/campaign-management#post-accounts-account-id-targeting-criteria) を使用し、更新するには [PUT accounts/:account\_id/targeting\_criteria](/ja/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria) を使用します。
すべてのラインアイテムの一覧を取得するには [GET accounts/:account\_id/line\_items](/ja/x-ads-api/campaign-management#get-accounts-account-id-line-items) を使用し、特定のラインアイテムを取得するには [GET accounts/:account\_id/line\_items/:line\_item\_id](/ja/x-ads-api/campaign-management#get-accounts-account-id-line-items-line-item-id) を使用します。
#### 配信面ごとのターゲティングオプション
[Promoted Tweets](https://business.x.com/help/what-are-promoted-tweets) と [Promoted Accounts](https://business.x.com/help/what-are-promoted-accounts) の広告プロダクトは、さまざまな配信面で利用可能です。[Promoted Trends (PTr)](https://business.x.com/help/what-are-promoted-trends) は API 経由では利用できません。
利用可能な配信面の組み合わせについては、[GET line\_items/placements](/ja/x-ads-api/campaign-management#get-line-items-placements) エンドポイントを参照してください。各配信面で利用できるターゲティングオプションは異なります。ロケーション、プラットフォーム、性別はすべての配信面で利用可能です。その他のオプションは、配信面の種類に応じて異なります。
* **X Search**: 年齢ターゲティング、デバイス、イベント、性別、キーワードタイプ (すべて) 、言語、ロケーション、ネットワークアクティベーション、通信事業者、プラットフォーム、プラットフォームバージョン、テイラードオーディエンス、WiFi のみ
* **X Timeline**: 年齢ターゲティング、デバイス、イベント、フォロワー (Followers Of) 、類似フォロワー (Similar to Followers Of) 、性別、興味・関心、言語、ロケーション、ネットワークアクティベーション、通信事業者、完全一致以外のキーワードタイプ、パートナーオーディエンスタイプ、プラットフォーム、プラットフォームバージョン、リターゲティングタイプ、テイラードオーディエンス、TV ターゲティングタイプ、WiFi のみ
* **X Profiles & Tweet Details**: 年齢ターゲティング、デバイス、イベント、フォロワー (Followers Of) 、類似フォロワー (Similar to Followers Of) 、性別、興味・関心、言語、ロケーション、ネットワークアクティベーション、通信事業者、完全一致以外のキーワードタイプ、パートナーオーディエンスタイプ、プラットフォーム、プラットフォームバージョン、リターゲティングタイプ、テイラードオーディエンス、TV ターゲティングタイプ、WiFi のみ
#### ターゲティング種別について
**年齢ターゲティング**: 特定の年齢バケットに基づいてユーザーをターゲットにします。年齢バケットの列挙値 (enum) の一覧は [Enumerations](/ja/x-ads-api/introduction) ページにあります。
[イベント](https://business.x.com/help/event-targeting): ターゲティングに使用するイベントを指定します。ターゲティングに使用できるイベントは (ラインアイテムごとに) 1 つのみです。[GET targeting\_criteria/events](/ja/x-ads-api/campaign-management#get-targeting-criteria-events) エンドポイントを使用して、ターゲティングに利用可能なイベントを取得します。
[性別](https://business.x.com/help/geo-gender-and-language-targeting): 男性 (1) または女性 (2) をターゲットにします。すべてをターゲットにする場合は null のままにします。
[Installed App Store Categories](https://business.x.com/help/installed-app-category-targeting): インストール済み、または興味関心を示したアプリのカテゴリに基づいてユーザーをターゲットにする場合に、このターゲティングタイプを使用します。[GET targeting\_criteria/app\_store\_categories](/ja/x-ads-api/campaign-management#get-targeting-criteria-app-store-categories) を参照してください。
[インタレスト](https://business.x.com/help/interest-and-username-targeting): ユーザーをインタレスト (関心) でターゲティングします。[GET targeting\_criteria/interests](/ja/x-ads-api/campaign-management#get-targeting-criteria-interests) からインタレストのリストを取得します。最大 100 個までのインタレストをターゲティングできます。
**Followers Of**: 現在のアカウントにおける、完全にプロモート可能なユーザーのフォロワーをターゲットにします (注: 現時点では、そのアカウントのプライマリアカウントホルダーのみが、そのアカウントの完全にプロモート可能なユーザーです) 。[GET accounts/:account\_id/promotable\_users](/ja/x-ads-api/campaign-management#get-accounts-account-id-promotable-users) を呼び出して、プロモート可能なユーザーの一覧を取得します。
[Similar to Followers Of](https://business.x.com/help/interest-and-username-targeting): 特定ユーザーのフォロワーと同じインタレストを持つユーザーをターゲットにします。最大 100 人までの [Users](/ja/x-api/fundamentals/data-dictionary#user) を使用できます。
[ロケーション](https://business.x.com/help/geo-gender-and-language-targeting): ターゲットにするロケーションを最大 2,000 件まで指定します。[GET targeting\_criteria/locations](/ja/x-ads-api/campaign-management#get-targeting-criteria-locations) からリストを取得します。特定の国をターゲットにする広告には、追加の要件があります。詳細は [Country Targeting and Display Requirements](/ja/x-ads-api/campaign-management#country-targeting-and-display-requirements) を参照してください。
[キーワード](https://business.x.com/help/keyword-targeting): キーワードターゲティングのオプションは、掲載面の種別ごとに異なります。ターゲティングには (ラインアイテムごとに) 最大 1000 個のキーワードを使用できます。オプションについては「Keyword Types」セクションを参照してください。
[Language Targeting](https://business.x.com/help/geo-gender-and-language-targeting): 特定の言語を理解しているユーザーをターゲットにします。
[Mobile Network Operator Targeting](https://business.x.com/help/device-carrier-and-new-mobile-user-targeting): 広告主がモバイルキャリアに基づいてユーザーをターゲットにできるようにします。[GET targeting\_criteria/network\_operators](/ja/x-ads-api/campaign-management#get-targeting-criteria-network-operators) で取得できるターゲティング type `NETWORK_OPERATOR` を使用します。
[New Mobile Device Targeting](https://business.x.com/help/device-carrier-and-new-mobile-user-targeting): ユーザーが自身のデバイスを通じて初めて X にアクセスした日付に基づいてユーザーにリーチします。ターゲティング type `NETWORK_ACTIVATION_DURATION` を使用し、`LT` を「より短い」、`GTE` を「以上」を表す operator\_type として使用します。
[Platforms](/ja/x-ads-api/campaign-management#get-targeting-criteria-platforms)、[Platform Versions](/ja/x-ads-api/campaign-management#get-targeting-criteria-platform-versions)、[Devices](/ja/x-ads-api/campaign-management#get-targeting-criteria-devices)、および Wifi-Only: さまざまな軸でモバイルデバイスをターゲティングできるようにします。Platforms は、広いカテゴリの端末を対象にできる高レベルのターゲティング type です。例としては `iOS` や `Android` などがあります。Devices を使用すると、`iPhone 5s`、`Nexus 4`、`Samsung Galaxy Note` など、特定のモバイルデバイスのユーザーをターゲットにできます。Platform versions を使用すると、特定のモバイル OS のバージョン (ポイントリリースのレベルまで) を利用しているユーザーをターゲットにできます。例としては iOS 7.1 や Android 4.4 などがあります。Wifi-Only を使用すると、WiFi ネットワーク上でデバイスを使用しているユーザーのみをターゲットにできます。これを設定しない場合、キャリア回線と WiFi の両方を利用しているユーザーがターゲットになります。
* ユーザーは、重複がなければ platforms と devices をターゲティングできます。たとえば、platform として Blackberry、device として iPad Air を同時にターゲティングできます。
* ユーザーは devices と OS バージョンを同時にターゲティングできます。たとえば、iPad Air と iOS >= 7.0 をターゲティングできます。
* ユーザーは devices より広い platforms をターゲティングすることはできません。たとえば、iOS と iPad Air を同時にターゲティングすることはできません。
\[Tailored Audiences]/x-ads-api/audiences: 承認済みの広告パートナーを通じてユーザーにリーチし、顧客グループをターゲティングしてX上でつながることができます。
**[TV Targeting](https://support.x.com/articles/20170766-tv-targeting)**
**TV Show Targeting**: 特定のテレビ番組に反応している人々にリーチします。このターゲティング条件は、キャンペーンがアクティブな間、`TV_SHOW` ターゲティングタイプを使用して継続的にターゲティングするように設定できます。利用可能なテレビ番組を確認するには、[GET targeting\_criteria/tv\_markets](/ja/x-ads-api/campaign-management#get-targeting-criteria-tv-markets) エンドポイントおよび [GET targeting\_criteria/tv\_shows](/ja/x-ads-api/campaign-management#get-targeting-criteria-tv-shows) エンドポイントを使用します。
**Tweet Engager Retargeting**
Tweet engager リターゲティングを使用すると、広告主は、これまでに自社のプロモーションまたはオーガニックのツイートに対してX上で表示またはエンゲージしたユーザーを、デバイスをまたいでターゲティングできます。このターゲティングにより、広告主は、自社のコンテンツをX上で閲覧またはエンゲージした人々の中から、その後のメッセージやオファーに対してさらにエンゲージしたりコンバージョンする可能性が高いユーザーをフォローアップできます。ユーザーは、表示またはエンゲージから数分以内にターゲット対象となり、エンゲージメントについてはその後最大90日間、表示については30日間対象となります。
Tweet Engager ターゲティングタイプ:
* `ENGAGEMENT_TYPE`: ターゲティング値として `IMPRESSION` または `ENGAGEMENT` のいずれかを受け取ります。これは、表示されたユーザー (`IMPRESSION`) をターゲティングするか、エンゲージしたユーザー (`ENGAGEMENT`) をターゲティングするかを指定します。
* `CAMPAIGN_ENGAGEMENT`: ターゲティング値としてキャンペーンの ID を使用します。このキャンペーンに対してエンゲージした、または表示されたユーザー (`ENGAGEMENT_TYPE` に応じて) がターゲットとなります。
* `USER_ENGAGEMENT`: ターゲティング値としてプロモーション対象ユーザーの ID を使用し、広告主のオーガニックコンテンツに表示またはエンゲージしたユーザー (`ENGAGEMENT_TYPE` に応じて) をターゲティングします。これは、その広告アカウントに紐づくプロモーション対象ユーザーの ID である必要があります。
*注:* `ENGAGEMENT_TYPE` は、少なくとも1つの有効な `CAMPAIGN_ENGAGEMENT` または `USER_ENGAGEMENT` の値と合わせて指定する必要があります。両方の Tweet engager ターゲティングタイプを同時に指定することもでき、1つのラインアイテムで複数のキャンペーンをターゲティングできます。
**Video Viewer Targeting**: Video viewer ターゲティングは Tweet engager ターゲティングを拡張したもので、これまでにX上の動画を一部または全部視聴したオーディエンスを広告主がターゲティングできるようにします。広告主は、オーガニック動画、プロモーション動画、またはその両方をターゲティングできます。プロモーション動画は、動画再生数を目的としたキャンペーンやラインアイテムに限定されません。
Video Viewer ターゲティングタイプ:
* `VIDEO_VIEW`: 動画を再生するためにクリックした、または自動再生で3秒間視聴したユーザー
* `VIDEO_VIEW_PARTIAL`: 動画の50%を視聴したユーザー
* `VIDEO_VIEW_COMPLETE`: 動画の少なくとも95%を視聴したユーザー
Tweet engager ターゲティングと同様に、`ENGAGEMENT_TYPE` を使用する場合、ラインアイテムのターゲティング条件には次のいずれか、または両方が含まれている必要があります。
* `CAMPAIGN_ENGAGEMENT`: ターゲティング値としてキャンペーンの ID を使用します。このキャンペーン内で動画を視聴したユーザー (`ENGAGEMENT_TYPE` に基づく) がターゲットとなります。
* `USER_ENGAGEMENT`: ターゲティング値としてプロモーション対象ユーザーの ID を使用し、広告主のオーガニックコンテンツ内の動画を視聴したユーザー (`ENGAGEMENT_TYPE` に基づく) をターゲティングします。これは、その広告アカウントに紐づくプロモーション対象ユーザーの ID である必要があります。
**Keyword Types**
概念的な概要については、[キーワードターゲティング](https://business.x.com/en/help/campaign-setup/campaign-targeting/keyword-targeting.html) に関するサポート文書を参照してください。
* **Broad** (デフォルト値) : 単語の順序に関係なく、すべての単語にマッチします。大文字小文字、複数形、時制には依存しません。可能な場合、自動的に拡張されます (例: “car repair” は “automobile fix” にもマッチします) 。拡張なしでターゲティングしたい場合は、「+boat +jet」のように、キーワードの前に + 記号を追加する必要があります。+ を付けずにキーワードを使用すると、Broad Match がデフォルトとして適用されます。
* **Unordered** (非推奨) : 単語の順序に関係なく、すべての単語にマッチします。大文字小文字、複数形、時制には依存しません。
* **Phrase**: キーワード文字列と同じ語句を含むフレーズにマッチし、他のキーワードが含まれていてもかまいません。
* **Exact**: キーワード文字列と完全に一致する場合のみにマッチし、それ以外にはマッチしません。
* **Negative**: クエリ内のどこかに、これらすべてのキーワードが含まれる検索にマッチしないようにします。順序には関係なく、他の単語が含まれていても除外されます。
* **Negative Phrase**: クエリ内のどこかに、このキーワード文字列と同じ語句が含まれる検索にマッチしないようにします。他の単語が含まれていても除外されます。
* **Negative Exact**: これらのキーワードと完全に一致し、他の単語を一切含まない検索にマッチしないようにします。
**Emoji targeting**
絵文字ターゲティングはキーワードターゲティングを通じて利用できます。絵文字ターゲティングを利用するには、その絵文字を表す Unicode コードポイント (たとえば「喜びの涙を浮かべた顔」絵文字 (😂) であれば、*U+1F602* (UTF-8 では *xF0x9Fx98x82*) ) を使ったキーワードターゲティングを作成します。利用可能な絵文字は、[twemoji](https://x.github.io/twemoji/preview.html) のリストで確認できます。特定の絵文字をターゲティングすると、そのすべてのバリエーションが対象になります。
必須／任意などの別や各値の詳細の概要については、[PUT accounts/:account\_id/targeting\_criteria](/ja/x-ads-api/campaign-management#get-accounts-account-id-targeting-criteria) を参照してください。
#### ターゲティング条件の組み合わせ
**新しいキャンペーンワークフロー**
地域、性別、言語、デバイス／プラットフォームなどの条件で、広範なターゲティングを行うキャンペーンを作成できます。広告主は、その広範なターゲティングに加えて、さらに詳細なターゲティング条件 (例: 興味関心、キーワード、フォロワー、テイラードオーディエンス、TV) を組み合わせることができます。**ラインアイテムにターゲティング条件が 1 つも指定されていない場合、そのラインアイテムは全世界のすべてのユーザーを対象とします。**
| | |
| :----------- | :------------ |
| 「プライマリ」タイプ | その他のタイプ |
| フォロワー | 位置情報 |
| テイラードオーディエンス | 性別 |
| 興味関心 | 言語 |
| キーワード | デバイスとプラットフォーム |
| TV | 年齢 |
ターゲティング条件は、広告グループに対して次のように組み合わされます。
* 「プライマリ」ターゲティングタイプは **∪** (論理和) で結合されます。
* その他のターゲティングタイプは **AND** で結合されます。
* 同じタイプ同士は **OR** で結合されます。
**いくつかの例**
概要: \[(**フォロワー**) ∪ (**テイラードオーディエンス**) ∪ (**興味関心**) ∪ (**キーワード**)] AND (**位置情報**) AND (**性別**) AND (**言語**) AND (**デバイスとプラットフォーム**)
地域の例:
あるキャンペーンの広告グループで、次のようなターゲティングを行いたいとします。
* 米国、イングランド、カナダにいる X ユーザー (位置情報)
* かつ女性 (性別)
* テイラードオーディエンスリストに基づく (「プライマリ」)
* かつキーワードによる指定 (「プライマリ」)
この場合のターゲティング条件は次のようになります。
\[**US** OR **GB** OR **CA**] AND \[**Female**] AND \[**Tailored Audiences** ∪ **Keyword**]
### 追加の例
* 性別と地域を選択し、プライマリターゲティングは設定しない場合: (**Male**) AND (**US** OR **GB**)
* 性別、地域、インタレストを選択する場合: (**Female**) AND (**CA**) AND (**Computers** OR **Technology** OR **Startups**)
* 性別、地域、インタレスト、テイラードオーディエンス、キーワードを選択する場合: (**Male**) AND (**GB**) AND (**Cars** ∪ **Tailored Audiences for CRM** ∪ **autocross**)
### 予算ペーシング
広告主は、プロモツイートおよびプロモアカウントキャンペーンにおいて、1 日あたりの予算がどの程度のペースで消化されるかを、これまで以上に細かく制御できるようになりました。デフォルトで有効になっている標準配信を利用すると、1 日を通して均等なペースで予算が消化されます。
標準配信を**オフ**にすると、日別予算を使い切るまで、インプレッションの配信およびエンゲージメントの獲得を可能な限り速く行います。ターゲティングや競合状況によっては、これは 1 日のかなり早い時間帯に発生する場合があります。これを高速配信 (accelerated delivery) と呼びます。
**はじめに**
標準配信はすべてのキャンペーンでデフォルトのオプションであるため、オフにしない限り操作は不要です。キャンペーンで日別予算をできるだけ早く使い切るようにするには、`standard_delivery` パラメータを `false` に設定し、配信ペースを高速配信に変更します ([GET accounts/:account\_id/campaigns](/ja/x-ads-api/campaign-management#get-accounts-account-id-campaigns) を参照) 。
**注意事項**
* 「1 日」は、X の[広告主アカウント](/ja/x-ads-api/campaign-management#accounts)のタイムゾーン (例: America/Los\_Angeles) に基づきます。
* 初期の結果からは、標準配信により 1 日を通してより一貫した配信が行われることで、広告主にとっての eCPE/CPF が改善されることが示唆されています。
予算とペーシングの詳細については、[Bidding and Auctions FAQ](https://business.x.com/en/help/troubleshooting/bidding-and-auctions-faqs.html) を参照してください。
### ターゲット別入札
キャンペーン管理
#### 入札戦略
キャンペーン作成ワークフローを簡素化し、複数パラメータの組み合わせに関する混乱を軽減するために、入札戦略 (Bid Strategy) という概念を導入しました。
以前の (レガシーとしてマークされている) パラメータの組み合わせはすべて、同等の `goal` パラメータを設定することで実現できます。さらに詳しい情報は、[こちらのアナウンス](https://devcommunity.x.com/t/ads-api-version-10/158787/1#changed-default-bid_strategy-values-9)をご覧ください。
例：
| | | |
| :------------- | :---------------------------------------------------------------------------------------------- | :--------------------------------------------------------- |
| **キャンペーン目的** | **レガシー** | **Ads API v10+** |
| App Installs | `bid_type`= `AUTO`
### 国別ターゲティングおよび表示要件
キャンペーン管理
国別のターゲティングおよび表示要件はこのページに掲載されています。これらの要件は、すべてのパートナーが遵守しなければなりません。
#### Russia
[X の広告ポリシー](https://support.x.com/groups/58-advertising/topics/249-advertiser-policies/articles/20171727-illegal-products-and-services) では、ロシアをターゲットとする広告について、ロシア語以外の言語での配信を禁止しています。あなたのユーザーがロシアを明示的にターゲットとして指定する場合、次の警告メッセージをユーザーに表示する必要があります。
ロシアを対象とする広告はロシア語でなければなりません。
### パートナー管理のファンディングインストゥルメント
オンボーディングフローでは、X アカウント用の [ads.x.com](https://ads.x.com) アカウントを設定します。このアカウントはパートナーが Ads API を通じて管理でき、広告出稿にかかる費用はパートナーに請求されます。
#### パートナーの初期セットアップ
新しい PMFI Ads API パートナーの初期セットアップには、必要な情報のやり取り完了から最長で 3 週間かかります。プロセスを開始するには、以下の情報を、X の技術担当窓口およびパートナーとの連携を管理している X 担当者の両方と共有する必要があります。
* **パートナーは自社の PGP/GPG 公開鍵を共有する必要があります。** Ads API パートナーと X 間で共有シークレットキーを交換する必要があります。これはオンボーディングフロー中のデータ検証に使用されます。
* **Ads API アクセスに使用する [X app](/ja/resources/fundamentals/developer-apps) の** `app_id` **または** `consumer_secret` **。** developer.x.com 上で X アカウントにログインしている場合、[app dashboard](https://developer.x.com/content/developer-twitter/en/apps) から既存の X app を表示および編集できます。新しく X app を作成する必要がある場合は、承認済みの[開発者アカウント](/ja/resources/fundamentals/developer-portal)が必要です。X では、本番＋サンドボックス用に 1 つの app と、任意でサンドボックス専用アクセス用に 1 つの app が許可されています。X app は、パートナーが管理する企業アカウントの X ハンドル上で作成する必要があります。
#### 広告主オンボーディングフロー
広告主のオンボーディングフローは、Web ブラウザを介して次のように行われます。
1. ユーザーはパートナーの Web サイト上でオンボーディングフローを開始し、オンボードしたいハンドル (@ユーザー名) を入力します。
2. パートナーは署名付きペイロードを含めたうえで、ユーザーを [ads.x.com](https://ads.x.com) 上の URL にリダイレクトします。このペイロードには、パートナーの API `app_id`、オンボード対象となる X ハンドルの X `user_id`、コールバック URL、および以下で説明するその他のフィールドが含まれます。
3. ユーザーは標準の x.com のログインページを使用して [ads.x.com](http://ads.x.com) にサインインするよう求められます。
4. ユーザーがログインすると、オンボーディングプロセスが開始されます。このステップには、広告審査、アカウントの確認、その他のチェックが含まれます。
5. すべてのオンボーディング作業が完了すると、ユーザーは Ads API パートナーによって指定されたコールバック URL に、成功または失敗を示すペイロードとともにリダイレクトされます。このフローには 3-legged 認可プロセスも含まれます。
#### オンボーディングリダイレクトペイロード
リダイレクト用 URL:
[https://ads.x.com/link\_managed\_account](https://ads.x.com/link\_managed\_account)
リダイレクト URL には、次のパラメータが付与されます:
| | | |
| :------------------- | :-------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Description |
| callback\_url | URL エンコードされた文字列 | アカウントリンクの処理が結果にかかわらず完了した後、この URL にユーザーがリダイレクトされます。プロトコルの詳細については、パートナーリダイレクト URL セクションを参照してください |
| client\_app\_id | integer | 管理パートナーを識別するために使用される X API のクライアント App の id |
| promotable\_user\_id | integer | プロモーションを管理パートナーが運用する対象となる @handle の X の user\_id。ads.x.com にログインしてリンク処理を完了するユーザーと同一であることを確認するために使用されます |
| fi\_description | URL エンコードされた文字列 (最大 255 文字) | 資金提供手段名。この名前は、資金提供手段を取得した際に API の description フィールドに表示されます。funding\_instrument の description が指定された場合、既存の funding\_instrument は一時停止され、新しいマネージドパートナー用の資金提供手段が設定されます (同じ名前のものがすでに存在する場合は何も起こりません)。 |
| timezone | Area/Location 形式の文字列 | 日次予算が適用される日付を決定し、請求額が集計されるタイムゾーンとして使用されます |
| currency | ISO 4217 通貨コード | 入札額の入力および請求額の請求に使用される通貨 |
| country | ISO 3166-1 alpha 2 国コード | アカウントの請求先の国 |
| signature | 下記の説明のとおり、URL エンコードおよび base64 エンコードされたバイナリデータ | 共有シークレットと他のパラメータを組み合わせて、呼び出しの真正性およびパラメータの有効性を検証するための署名。 |
#### コールバック URL ペイロード
ベースとなるリダイレクト URL は、アカウントリンクリクエストの `callback_url` パラメータで指定されます (上記参照) 。[ads.x.com](https://ads.x.com) によって追加されるパラメータは次のとおりです。
| | | |
| :---------------------- | :---------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name | Type | Description |
| status | string | **OK** アカウントが作成されたか、既存の利用可能なアカウントが見つかった場合。
#### リクエストおよびコールバック URL への署名
`/link_managed_account` へのリクエストおよびコールバック URL が有効なものであることを保証するために、リクエストは送信元で署名され、受信側で検証が行われてから受信側が処理を実行する必要があります。X と管理パートナーの間で共有されているシークレットを用いてリクエストに署名することで、双方は認可された相手から送信されたリクエストのみを受け入れることができます。
署名生成アルゴリズムは OAuth で使用されているものとほぼ同じです。
次のように署名用ベース文字列を作成します:
* HTTP メソッドを大文字に変換し、その値をベース文字列とします。
* ベース文字列の末尾に ‘&’ 文字を追加します。
* URL (パラメータなし) をパーセントエンコードし、ベース文字列に追加します。
* ベース文字列の末尾に ‘&’ 文字を追加します。
* 次の手順で構築される、パーセントエンコード済みのクエリ文字列を追加します:
* 署名対象となるすべてのキーと値をパーセントエンコードします。
* パラメータの一覧をキーでアルファベット順にソートします。
* 各キー/値のペアについて (パートナーのリダイレクト URL 用の primary\_promotable\_user\_id を含む) :
* パーセントエンコード済みのキーをクエリ文字列に追加します。
* ‘=’ 文字をベース文字列に追加します。
* パーセントエンコード済みの値をクエリ文字列に追加します。
* パーセントエンコードされた key=value のペア同士を ‘&’ 文字で区切ります。
* 事前に共有されているシークレットをキー、ベース文字列を値として HMAC-SHA1 アルゴリズムを用い、署名を生成します。
* ステップ 2 の出力を Base64 エンコードし、末尾の改行文字を削除してから、ステップ 3 で生成した署名をパーセントエンコードし、それを signature パラメータとして URL に追加します。
#### 署名の例
リンクアカウントリクエストへの署名
GET リクエストであると仮定した場合に署名する URL:
[https://ads.x.com/link\_managed\_account?callback\_url=https%3A%2F%2Fmanagingpartner.com%2Flink\_account\_callback\&client\_app\_id=12345\&fi\_description=some%20name\&promotable\_user\_id=1](https://ads.x.com/link\_managed\_account?callback\_url=https%3A%2F%2Fmanagingpartner.com%2Flink\_account\_callback\&client\_app\_id=12345\&fi\_description=some%20name\&promotable\_user\_id=1)
この URL には次のパラメータがあります:
callback\_url = [https://managingpartner.com/link\_account\_callback\\](https://managingpartner.com/link\_account\_callback\\)
client\_app\_id = 12345\
fi\_description = some name\
promotable\_user\_id = 1
HTTP メソッドとパラメータを除いた URL から成るベース文字列は、手順 a ～ d に従うと次のようになります:
GET [https://ads.x.com/link\_managed\_account](https://ads.x.com/link\_managed\_account)
手順 e のサブステップによって生成されるクエリ文字列は次のとおりです:
callback\_url=[https://managingpartner.com/link\_account\_callback\&client\_app\_id=12345\&fi\_description=some](https://managingpartner.com/link\_account\_callback\&client\_app\_id=12345\&fi\_description=some) name\&promotable\_user\_id=1
キーと値のペアはキー名でソートされている点に注意してください。
パーセントエンコードされたクエリ文字列は次のとおりです:
callback\_url%3Dhttps%253A%252F%252Fmanagingpartner.com%252Flink\_account\_callback%26client\_app\_id%3D12345%26fi\_description%3Dsome%2520name%26promotable\_user\_id%3D1
手順 a ～ d と e を結合した完全なベース文字列は次のようになります:
GET [https://ads.x.com/link\_managed\_account\&callback\_url%3Dhttps%253A%252F%252Fmanagingpartner.com%252Flink\_account\_callback%26client\_app\_id%3D12345%26fi\_description%3Dsome%2520name%26promotable\_user\_id%3D1](https://ads.x.com/link\_managed\_account\&callback\_url%3Dhttps%253A%252F%252Fmanagingpartner.com%252Flink\_account\_callback%26client\_app\_id%3D12345%26fi\_description%3Dsome%2520name%26promotable\_user\_id%3D1)
hmac-sha1 アルゴリズムを使用して、これに「secret」という単語をキーとして署名します。結果は Base64 エンコードされ、末尾の「\n」を取り除いた形で表されます (手順 2 および 3): `KBxQMMSpKRrtg9aw3qxK4fTXvUc=`
この署名は、その後 (パーセントエンコードしたうえで) 元の URL の末尾に `signature` パラメータとして追加されます (手順 4):
[https://ads.x.com/link\_managed\_account?callback\_url=https%3A%2F%2Fmanagingpartner.com%2Flink\_account\_callback\&client\_app\_id=12345\&fi\_description=some%20name\&promotable\_user\_id=1\&signature=KBxQMMSpKRrtg9aw3qxK4fTXvUc%3D](https://ads.x.com/link\_managed\_account?callback\_url=https%3A%2F%2Fmanagingpartner.com%2Flink\_account\_callback\&client\_app\_id=12345\&fi\_description=some%20name\&promotable\_user\_id=1\&signature=KBxQMMSpKRrtg9aw3qxK4fTXvUc%3D)
パートナーリダイレクト URL (アカウントリンクリクエストのコールバック) への署名\
GET リクエストであると仮定した場合に署名する URL:
[https://managingpartner.com/link\_account\_callback?status=OK\&account\_id=ABC\&funding\_instrument\_id=DEF](https://managingpartner.com/link\_account\_callback?status=OK\&account\_id=ABC\&funding\_instrument\_id=DEF)
この URL には次のパラメータがあります:
`account_id` = `ABC`、`funding_instrument_id` = `DEF`、`status` = `OK`
HTTP メソッドとパラメータを除いた URL から成るベース文字列は、手順 a ～ d に従うと次のようになります:
GET https%3A%2F%2Fmanagingpartner.com%2Flink\_account\_callback&\`\`
手順 e のサブステップによって生成されるクエリ文字列は次のとおりです:
account\_id=ABC\&funding\_instrument\_id=DEF\&status=OK
パーセントエンコードされたクエリ文字列は次のとおりです:
account\_id%3DABC%26funding\_instrument\_id%3DDEF%26status%3DOK
手順 a ～ d と e を結合した完全なベース文字列は次のようになります:
GET https%3A%2F%2Fmanagingpartner.com%2Flink\_account\_callback\&account\_id%3DABC%26funding\_instrument\_id%3DDEF%26status%3DOK
hmac-sha1 アルゴリズムを使用して、これに「secret」という単語と、元のリンクリクエストが行われた対象の X ユーザー id である 1 (`promotable_user_id` = 1、上記参照) を組み合わせた「secret&1」をキーとして署名します。
結果は Base64 エンコードされ、末尾の「\n」を取り除いた形で表されます (手順 2 および 3): `jDSHDkHJIFXpPLVxtA3a9d4bPjM=`
このシグネチャは、その後、元の URL の末尾に signature パラメータ (ステップ 4) として、パーセントエンコードされた状態で追加されます:
[https://managingpartner.com/link\_account\_callback?\&status=OK\&account\_id=ABC\&funding\_instrument\_id=DEF\&signature=jDSHDkHJIFXpPLVxtA3a9d4bPjM%3D](https://managingpartner.com/link\_account\_callback?\&status=OK\&account\_id=ABC\&funding\_instrument\_id=DEF\&signature=jDSHDkHJIFXpPLVxtA3a9d4bPjM%3D)
### 共有キーの使用／更新
署名アルゴリズムは、複数のキーに対して繰り返し利用できる必要があります。これにより、複数の共有キーを併用でき、共有キーを定期的にローテーションすることが可能になります。
### partner\_managed\_funding\_instrument の作成
fi\_description パラメータが指定されており、アカウント内に同じ名前の既存の partner\_managed\_funding\_instrument が存在しない場合、新しい partner\_managed\_funding\_instrument が作成され、既存のすべての partner\_managed\_funding\_instrument は一時停止されます。
同じ名前の partner\_managed\_funding\_instrument が存在する場合、新しいものは作成されません。
### オンボーディングフローの再実行 / トークンのリフレッシュ
API の access token が失われた場合、オンボーディングフローを再度実行できます。オンボーディングフローの実装では、ユーザーがログインしている必要があります。ユーザーが `promotable_user_id` と一致し、関連付けられた広告アカウントが見つかり、その他の条件にも問題がなければ、ユーザーは callback URL にリダイレクトされ、パートナーは OAuth フローを開始して [access token](/ja/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow) を取得できます。
### リダイレクトされないエラーフロー
account link の URL が無効なパラメーター付きで呼び出された場合、OAuth フローで無効または期限切れのパラメーターが指定されたときに表示されるページと同様のページがユーザーに表示されます。
#### PMFI の継続的な更新
広告主のオンボーディングが完了すると、その資金手段は、それを管理するパートナーのみが [PUT accounts/:account\_id/funding\_instruments/:funding\_instrument\_id](/ja/x-ads-api/campaign-management#get-accounts-account-id-funding-instruments) エンドポイントを使用して管理できます。
### プレースメント
X 広告が表示される場所はいくつかあります。これは、[ラインアイテム](/ja/x-ads-api/campaign-management#line-items)の `placements` パラメータで設定します。指定可能な値は次のとおりです。
* `ALL_ON_TWITTER`
* `PUBLISHER_NETWORK`
* `TWITTER_PROFILE`
* `TWITTER_SEARCH`
* `TWITTER_TIMELINE`
* `SPOTLIGHT`
* `TREND`
ラインアイテムの `product_type` と `objective` によって、利用可能なプレースメントが決まります。[GET line\_items/placements](/ja/x-ads-api/campaign-management#line-item-placements) エンドポイントを使用して、各 `product_type` ごとの有効なプレースメントオプションを取得できます。
さらに、以下の表は有効なプレースメントと `objective` の組み合わせを示しています。
| Objective | `ALL_ON_TWITTER` | `TWITTER_PROFILE` | `TWITTER_SEARCH` | `TWITTER_TIMELINE` |
| :---------------- | :--------------- | :---------------- | :--------------- | :----------------- |
| `APP_ENGAGEMENTS` | ✔ | ✔ | ✔ | ✔ |
| `APP_INSTALLS` | ✔ | ✔ | ✔ | ✔ |
| `REACH` | ✔ | ✔ | ✔ | ✔ |
| `FOLLOWERS` | ✔ | ✔ | ✔ | ✔ |
| `ENGAGEMENTS` | ✔ | ✔ | ✔ | ✔ |
| `VIDEO_VIEWS` | ✔ | ✔ | ✔ | ✔ |
| `PREROLL_VIEWS` | ✔ | ✔ | ✔ | ✔ |
| `WEBSITE_CLICKS` | ✔ | ✔ | ✔ | ✔ |
**注**: プレースメントとして `TWITTER_PROFILE` だけを指定することはできません。
**注**: `TWITTER_SEARCH` には[キーワードターゲティング](/ja/x-ads-api/campaign-management#targeting-options)が必要です。
**注**: `REACH` objective には `TWITTER_TIMELINE` プレースメントを必ず含める必要があります。`ALL_ON_TWITTER`、`TWITTER_TIMELINE` を含む任意のプレースメントの組み合わせ、または `TWITTER_TIMELINE` 単独を指定できます。
### 広告グループに関するよくある質問
このドキュメントでは、X の Ads API における広告グループに関して、よく寄せられる質問をまとめています。
#### 広告グループとは何ですか？
広告グループは、Ads API では line item と呼ばれ、キャンペーンの配下に属し、特定の X ユーザーの集合に対するターゲティングおよび入札に使用されます。広告主は、ツイートやメディア (例：インストリーム広告として配信される動画など) を line item に関連付けることでプロモーションを行います。
#### Ad Group をどのように作成しますか？
Ad Group は、同じキャンペーン ID に対して [POST accounts/:account\_id/line\_items](/ja/x-ads-api/campaign-management#post-accounts-account-id-line-items) を複数回呼び出し、その各 line item に (まったく異なる内容でもよい) ターゲティングとツイートを関連付けることで作成します。1 つのキャンペーン当たりの line item の上限は 100 個で、1 つの広告アカウント当たりの有効なキャンペーンの上限は 200 個です。すべてのキャンペーンを通じて、1 つの広告アカウント当たり有効な line item は最大 8,000 個までです。
#### なぜ Ad Groups をサポートする必要があるのですか？
Ad Groups は、広告主がキャンペーンを整理・最適化・管理しやすくすることを目的としています。
Ad Groups の利点は、入札単価、予算、クリエイティブ、ターゲティングにまたがるさまざまな戦略を比較・コントロールできる点にあります。複数の Promoted Tweets を 1 つの line item に関連付けると、オークションはまずそのグループ内から最適なツイートを選択し、そのうえで、すべての line item の中からそのキャンペーンにとって最適なツイートを選択します。単一のツイートのみを含む Ad Groups を複数持っている場合は、実質的には、その Ad Group ごとにパフォーマンスが高くなりそうなツイートが選択されることになります。
Ad Groups を使用すると、広告主はターゲティングと入札単価を、従来よりはるかに多くの組み合わせパターンに分割でき、一般的にターゲティングを論理的なグループに分けて管理できるようになります。
特に Ads API ツールは、Ad Groups を用いたきめ細かい最適化ルールを中心に構築できるため、line item とクリエイティブの組み合わせが大規模になることから手動編集では困難な最適化も実現しやすくなります。
#### Ad Groups キャンペーンにおいて、ラインアイテムの予算はキャンペーン予算とどのような関係がありますか？
ラインアイテムに設定する total\_budget\_amount\_local\_micro は、親キャンペーンの総予算を超えることはできません。同様に、ラインアイテムの bid\_amount\_local\_micro の値は、親キャンペーンの daily\_budget\_amount\_local\_micro または total\_budget\_amount\_local\_micro を超えないようにする必要があります。これらの値を誤って設定すると、キャンペーン全体が一時停止状態となり、配信不可の状態になる可能性があります。
なお、キャンペーン全体の総予算は、その子である各ラインアイテムの予算合計よりも少なく設定することができます。また、ラインアイテム間の予算配分は一部 Ads API ツール側に委ねられており、ターゲティング (ラインアイテム) の日々のパフォーマンスは、X のリアルタイム性により日ごとに大きく変動し得るため、それに応じて効果的に最適化・調整されます。
#### 広告グループは単一のラインアイテムよりも良い成果を上げられますか？
キャンペーンの成果は多くの要因に左右されますが、最終的にはツイートが成果を決定づける要素となります。ラインアイテムは、ツイートがユーザーへの配信対象として選考に残るかどうかを左右する要素として扱われます。
同じユーザー層をターゲティングしているラインアイテムは、ユーザーが重複していると見なされます。ラインアイテム間のこのターゲティングの重複を減らすことがベストプラクティスとされており、そうすることで、最も高い成果を上げるユーザー層を明確に特定できるようになります。
## ガイド
### Video Views プレロール目的
このガイドでは、Ads API で PREROLL\_VIEWS キャンペーンを設定するために必要な手順の概要を説明します。大まかに言えば、これらのキャンペーンは「Curated Categories」と「Content Categories」の 2 種類に分類され、後者は Ads UI 上では「Standard Categories」と呼ばれます。
#### 必要なエンドポイント
* [Chunked media upload](https://developer.x.com/en/docs/x-api/v1/media/upload-media/uploading-media/chunked-media-upload) (動画をアップロードするため)
* [POST accounts/:account\_id/media\_library](/ja/x-ads-api/creatives#media-library) (動画を広告アカウントに関連付ける)
* [POST accounts/:account\_id/campaigns](/ja/x-ads-api/campaign-management#post-accounts-account-id-campaigns) (キャンペーンを作成)
* [GET content\_categories](/ja/x-ads-api/campaign-management#content-categories) (コンテンツカテゴリと IAB カテゴリの対応関係を取得)
* [GET accounts/:account\_id/curated\_categories](/ja/x-ads-api/campaign-management#curated-categories-2)
* [GET publishers](/ja/x-ads-api/campaign-management#publishers)
* [POST accounts/:account\_id/line\_item\_curated\_categories](/ja/x-ads-api/campaign-management#line-item-curated-categories)
* [POST accounts/:account\_id/line\_items](/ja/x-ads-api/campaign-management#campaigns) (広告グループを作成)
* [POST accounts/:account\_id/media\_creatives](/ja/x-ads-api/campaign-management#post-accounts-account-id-media-creatives) (広告グループに動画を関連付ける)
* [POST accounts/:account\_id/preroll\_call\_to\_action](/ja/x-ads-api/creatives#preroll-call-to-actions) (CTA とリダイレクト URL を設定)
* [POST batch/accounts/:account\_id/targeting\_criteria](/ja/x-ads-api/campaign-management#post-batch-accounts-account-id-targeting-criteria) (ターゲティング)
#### 手順
#### 動画をアップロードする
動画のアップロードは次の2つの手順で行います。
#### 動画メディアをアップロードする
まず、[Chunked media upload](https://developer.x.com/en/docs/x-api/v1/media/upload-media/uploading-media/chunked-media-upload) エンドポイントを使用して、処理のために動画を X にアップロードします。このエンドポイントで最初に `INIT` を呼び出す際には、`media_category=amplify_video` を指定する必要があります。動画はチャンクに分割してアップロードします。`STATUS` が返す `state` が `succeeded` になったら、次の手順に進むことができます。チャンクアップロードエンドポイントを使用したメディアアップロードの詳細については、[Promoted Video Overview](/ja/x-ads-api/creatives#promoted-video) を参照してください。
#### 動画を広告アカウントに追加する
`STATUS` コマンドで返される状態が `succeeded` になったら、そのエンドポイントから返された `media_key` を使用し、[POST accounts/:account\_id/media\_library](/ja/x-ads-api/creatives#media-library) エンドポイントを呼び出して、動画を広告主のメディアライブラリに追加します。
```json theme={null}
POST https://ads-api.x.com/8/55w3kv/media\_library?media\_key=3_931236738554519552
{
"request": {
"params": {
"account_id": "55w3kv",
"media\_key": "3\_931236738554519552"
}
},
"data": {
"tweeted": false,
"name": null,
"file_name": null,
"media\_url": "https://video.twimg.com/amplify\_video/1059840836186165250/vid/568x320/Gr2l1fB1X7xotKwC.mp4?tag=8",
"media\_category": "AMPLIFY\_VIDEO",
"media\_key": "3\_931236738554519552",
"created_at": "2017-11-16T19:05:14Z",
"media\_status": "TRANSCODE\_COMPLETED",
"media_id": 931236738554519552,
"media_type": "VIDEO",
"updated_at": "2017-11-16T19:05:23Z",
"deleted": false
}
}
```
#### キャンペーンの設定
### キャンペーンの作成
[キャンペーン](/ja/x-ads-api/campaign-management#post-accounts-account-id-campaigns)と[広告グループ (line item/ad group) ](/ja/x-ads-api/campaign-management#campaigns)を作成します。line item (ラインアイテム) は `objective` を `VIDEO_VIEWS_PREROLL`、`product_type` を `MEDIA` に設定して作成します。`categories` パラメータには、適切な[広告主の業種カテゴリ](/ja/x-ads-api/campaign-management#advertiser-business-categories)を設定します。
```json theme={null}
POST https://ads-api.x.com/8/accounts/55w3kv/campaigns?name=test-curated-categories-api&funding\_instrument\_id=103hp9&start\_time=2021-02-10&entity\_status=PAUSED&daily\_budget\_amount\_local\_micro=55000000
{
"request": {
"params": {
"name": "test-curated-categories-api",
"start_time": "2021-02-10T00:00:00Z",
"daily\_budget\_amount\_local\_micro": 55000000,
"funding\_instrument\_id": "103hp9",
"entity_status": "PAUSED",
"account_id": "55w3kv"
}
},
"data": {
"name": "test-curated-categories-api",
"start_time": "2021-02-10T00:00:00Z",
"reasons\_not\_servable": \[
"EXPIRED",
"PAUSED\_BY\_ADVERTISER",
"FUNDING_PROBLEM"
\],
"servable": false,
"purchase\_order\_number": null,
"effective_status": "PAUSED",
"daily\_budget\_amount\_local\_micro": 55000000,
"end_time": null,
"funding\_instrument\_id": "103hp9",
"duration\_in\_days": null,
"standard_delivery": true,
"total\_budget\_amount\_local\_micro": null,
"id": "f2rp3",
"entity_status": "PAUSED",
"frequency_cap": null,
"currency": "USD",
"created_at": "2021-02-08T23:55:38Z",
"updated_at": "2021-02-08T23:55:38Z",
"deleted": false
}
}
```
### ラインアイテムの作成
ラインアイテムでは、[GET content\_categories](/ja/x-ads-api/campaign-management#content-categories) エンドポイントから取得した適切な IAB カテゴリのセットを、`categories` パラメータに設定する必要があります。これらのコンテンツカテゴリは、それぞれ 1 つ以上の IAB カテゴリに対応しています。
これらの値を使用するには、パートナーは適切なコンテンツカテゴリを選択し、レスポンスで返される `iab_categories` のセット全体を使用して、ラインアイテムエンドポイントの `categories` パラメータを設定する必要があります。`iab_categories` のうち一部だけを適用した場合でも、そのグループ全体が当該ラインアイテムに設定されます。例えば、
```json theme={null}
GET https://ads-api.x.com/8/advertiser\_business\_categories
{
"request": {
"params": {}
},
"next_cursor": null,
"data": \[
{
"id": "1jl",
"name": "消費財",
"iab_categories": \[
"IAB9-26",
"IAB9-18",
"IAB9-29",
"IAB9-1",
"IAB9-8",
"IAB9-22",
"IAB6",
"IAB9-5",
"IAB9-12",
"IAB9-11",
"IAB9-23",
"IAB9-14",
"IAB4",
"IAB9-25",
"IAB9-17",
"IAB23",
"IAB9-24",
"IAB9-13",
"IAB16",
"IAB9-4",
"IAB9-9",
"IAB9-20",
"IAB22",
"IAB9-28",
"IAB9-27",
"IAB9-16",
"IAB9-31",
"IAB9-3",
"IAB9-19",
"IAB10",
"IAB9-2",
"IAB9-6",
"IAB9-21",
"IAB9-10",
"IAB9-15"
\]
},
{
"id": "1jm",
"name": "ヘルスケア・医薬品",
"iab_categories": \[
"IAB7"
\]
},
{
"id": "1jn",
"name": "アルコール",
"iab_categories": \[
"IAB8-5",
"IAB8-18"
\]
},
{
"id": "1jo",
"name": "飲食",
"iab_categories": \[
"IAB8-10",
"IAB8-8",
"IAB8-7",
"IAB8-15",
"IAB8-3",
"IAB8-4",
"IAB8-1",
"IAB8-16",
"IAB8-12",
"IAB8-13",
"IAB8-17",
"IAB8-11",
"IAB8-6",
"IAB8-9",
"IAB8-2",
"IAB8-14"
\]
},
{
"id": "1jp",
"name": "金融サービス",
"iab_categories": \[
"IAB3",
"IAB13",
"IAB21"
\]
},
{
"id": "1jq",
"name": "小売",
"iab_categories": \[
"IAB18"
\]
},
{
"id": "1jr",
"name": "旅行",
"iab_categories": \[
"IAB20"
\]
},
{
"id": "1js",
"name": "ゲーム",
"iab_categories": \[
"IAB9-30"
\]
},
{
"id": "1jt",
"name": "テクノロジー",
"iab_categories": \[
"IAB19-22",
"IAB19-13",
"IAB19-4",
"IAB19-33",
"IAB19-26",
"IAB19-3",
"IAB19-16",
"IAB19-9",
"IAB19-32",
"IAB19-25",
"IAB19-30",
"IAB19-36",
"IAB19-21",
"IAB5",
"IAB19-12",
"IAB19-28",
"IAB19-17",
"IAB19-8",
"IAB19-7",
"IAB19-24",
"IAB15",
"IAB19-11",
"IAB19-31",
"IAB19-20",
"IAB19-15",
"IAB19-1",
"IAB19-35",
"IAB19-29",
"IAB19-34",
"IAB19-23",
"IAB19-2",
"IAB19-5",
"IAB19-14",
"IAB19-27",
"IAB19-10",
"IAB19-19"
\]
},
{
"id": "1ju",
"name": "通信",
"iab_categories": \[
"IAB19-6",
"IAB19-18"
\]
},
{
"id": "1jv",
"name": "自動車",
"iab_categories": \[
"IAB2"
\]
},
{
"id": "1jw",
"name": "メディア・エンターテインメント",
"iab_categories": \[
"IAB14-8",
"IAB14-4",
"IAB1-5",
"IAB14-7",
"IAB1-7",
"IAB17",
"IAB14-3",
"IAB1-1",
"IAB12",
"IAB1-6",
"IAB25-1",
"IAB1-2",
"IAB14-2",
"IAB14-6",
"IAB1-3",
"IAB1-4",
"IAB14-5"
\]
},
{
"id": "1jx",
"name": "政治",
"iab_categories": \[
"IAB11-4"
\]
},
{
"id": "1jy",
"name": "ギャンブル",
"iab_categories": \[
"IAB9-7"
\]
},
{
"id": "1jz",
"name": "マッチング",
"iab_categories": \[
"IAB14-1"
\]
},
{
"id": "1k0",
"name": "非営利団体",
"iab_categories": \[
"IAB11-1",
"IAB11-2",
"IAB11-3",
"IAB11-5"
\]
}
\]
}
```
ここでは、`categories` パラメータを「Science & Education」に設定するには、`iab_categories` の全セット、つまり `"IAB5", "IAB15"` をラインアイテムに対して次のように設定する必要があります。
```json theme={null}
POST https://ads-api.x.com/8/accounts/55w3kv/line\_items?campaign\_id=f2rp3&bid\_amount\_local\_micro=5500000&name=curated-category-line-item&product\_type=MEDIA&placements=ALL\_ON\_TWITTER&objective=PREROLL_VIEWS&categories=IAB3,IAB13,IAB21
{
"request": {
"params": {
"name": "curated-category-line-item",
"placements": \[
"ALL\_ON\_TWITTER"
\],
"bid\_amount\_local_micro": 5500000,
"product_type": "MEDIA",
"objective": "PREROLL_VIEWS",
"account_id": "55w3kv",
"categories": \[
"IAB3",
"IAB13",
"IAB21"
\],
"campaign_id": "f2rp3"
}
},
"data": {
"bid_type": "MAX",
"advertiser\_user\_id": 312226591,
"name": "curated-category-line-item",
"placements": \[
"ALL\_ON\_TWITTER"
\],
"start_time": null,
"bid\_amount\_local_micro": 5500000,
"automatically\_select\_bid": false,
"advertiser_domain": null,
"target\_cpa\_local_micro": null,
"raw_categories": \[
"x",
"5l",
"9z"
\],
"primary\_web\_event_tag": null,
"charge\_by": "VIEW\_3S_100PCT",
"product\_type": "PROMOTED\_TWEETS",
"end_time": null,
"duration\_in\_days": null,
"bid\_unit": "VIEW\_3S_100PCT",
"total\_budget\_amount\_local\_micro": null,
"objective": "PREROLL_VIEWS",
"id": "iqwka",
"entity_status": "ACTIVE",
"automatic\_tweet\_promotion": null,
"optimization": "DEFAULT",
"frequency_cap": null,
"android\_app\_store_identifier": null,
"categories": \[
"IAB3",
"IAB13",
"IAB21"
\],
"currency": "USD",
"created_at": "2021-02-09T00:00:46Z",
"tracking_tags": \[\],
"ios\_app\_store_identifier": null,
"amplify_config": {
"auto_promote": true,
"is_open": true
},
"updated_at": "2021-02-09T00:00:46Z",
"campaign_id": "f2rp3",
"creative_source": "MANUAL",
"deleted": false
}
}
```
#### パブリッシャーの選択
広告主は、コンテンツカテゴリとキュレーテッドカテゴリのいずれか一方をターゲットとして選択できます。詳細は以下をご覧ください。
**注:** ラインアイテムでは、キュレーテッドカテゴリかコンテンツカテゴリのどちらか一方のみをターゲットにでき、両方を同時にターゲットにすることはできません。
### キュレーテッドカテゴリ
キュレーテッドカテゴリを使用すると、広告主はあらかじめ定義されたパブリッシャーのグループをターゲティングでき、[GET curated\_categories](/ja/x-ads-api/campaign-management#curated-categories-2) エンドポイントを使用して取得できます。これらのカテゴリは国ごとに定義されているため、カテゴリの country\_code に基づいて、ラインアイテムが適切な国をターゲティングする必要があります。
これらのカテゴリのいずれかを利用するには、以下の手順を記載されている順番どおりに実行する必要があります。
1. ラインアイテムが、キュレーテッドカテゴリの country\_code に基づいて適切な国をターゲティングしている必要があります
2. [POST line\_item\_curated\_categories](/ja/x-ads-api/campaign-management#line-item-curated-categories) エンドポイントを使用して、ラインアイテムを特定の curated\_category\_id に関連付ける必要があります。
**注:** ラインアイテムをキュレーテッドカテゴリに関連付けると、denylist に登録できるパブリッシャー数は 5 件に制限されます。特定のパブリッシャーを denylist するために使用する user\_id の完全なリストは、[GET publishers](/ja/x-ads-api/campaign-management#publishers) エンドポイントから取得できます。さらに、1 つのラインアイテムが同時にターゲティングできるキュレーテッドカテゴリは 1 つのみです。
次の例は、US でのみ利用可能なキュレーテッドカテゴリ id: b0xt を、前の手順で作成したラインアイテムに関連付ける方法を示しています。
まず、ラインアイテムのターゲティング条件を値 96683cc9126741d に設定します。
```json theme={null}
GET https://ads-api.x.com/8/targeting\_criteria/locations?country\_code=US&location_type=COUNTRIES
{
"data": \[
{
"name": "United States",
"country_code": "US",
"location_type": "COUNTRIES",
"targeting_value": "96683cc9126741d1",
"targeting_type": "LOCATION"
}
\],
"request": {
"params": {
"location_type": "COUNTRIES",
"country_code": "US"
}
},
"next_cursor": null
}
POST https://ads-api.x.com/8/batch/accounts/55w3kv/targeting_criteria
\[
{
"operation_type": "Create",
"params": {
"line\_item\_id": "iqwka",
"targeting_type": "LOCATION",
"targeting_value": "96683cc9126741d1",
"operator_type": "EQ"
}
}
\]
{
"data": \[
{
"line\_item\_id": "iqwka",
"name": "United States",
"raw_negated": false,
"raw\_targeting\_value": "2",
"id": "rv9hmc",
"raw\_targeting\_type": "GEO",
"raw\_operator\_type": "EQUAL_TO",
"location_type": "COUNTRIES",
"operator_type": "EQ",
"created_at": "2021-02-09T00:06:28Z",
"targeting_value": "96683cc9126741d1",
"updated_at": "2021-02-09T00:06:28Z",
"deleted": false,
"targeting_type": "LOCATION"
}
\],
"request": \[
{
"params": {
"line\_item\_id": "iqwka",
"account_id": "55w3kv",
"operator_type": "EQ",
"targeting_value": "96683cc9126741d1",
"targeting_type": "LOCATION"
},
"operation_type": "Create"
}
\]
}
POST https://ads-api.x.com/8/accounts/55w3kv/line\_item\_curated\_categories?line\_item\_id=iqwka&curated\_category_id=9ddrgesiap6o
{
"request": {
"params": {
"curated\_category\_id": "9ddrgesiap6o",
"line\_item\_id": "iqwka",
"account_id": "55w3kv"
}
},
"data": {
"line\_item\_id": "iqwka",
"curated\_category\_id": "9ddrgesiap6o",
"id": "xq",
"created_at": "2021-03-30T17:26:42Z",
"updated_at": "2021-03-30T17:26:42Z",
"deleted": false
}
}
```
### コンテンツカテゴリ
コンテンツカテゴリ (Standard Categories とも呼ばれます) は、[GET curated\_categories](/ja/x-ads-api/campaign-management#get-accounts-account-id-curated-categories) エンドポイントから取得できます。これらのカテゴリは、バッチターゲティング条件エンドポイントを使用してラインアイテムのターゲットとして指定できます。次の例では、特定のコンテンツカテゴリ `id: sr` (「News & Current Events」に対応) を選択し、それをラインアイテムに適用する方法を示します。
**Note**: [GET curated\_categories](/ja/x-ads-api/campaign-management#get-accounts-account-id-curated-categories) レスポンスに含まれる `iab_categories` の全セットを、ターゲティング条件エンドポイント経由で必ずターゲット指定する必要があります。そうしない場合は検証エラーが発生します。
```json theme={null}
GET https://ads-api.x.com/8/content_categories
{
"name": "News & Current Events",
"id": "sr",
"iab_categories": \[
"IAB12",
"IAB14"
\],
"publishers\_in\_last\_thirty\_days": 124,
"videos\_monetized\_in\_last\_thirty_days": 5429
}
}
POST https://ads-api.x.com/8/batch/accounts/55w3kv/targeting_criteria
\[
{
"operation_type": "Create",
"params": {
"line\_item\_id": "iqwls",
"targeting\_type": "IAB\_CATEGORY",
"targeting_value": "IAB12",
"operator_type": "EQ"
}
},
{
"operation_type": "Create",
"params": {
"line\_item\_id": "iqwls",
"targeting\_type": "IAB\_CATEGORY",
"targeting_value": "IAB14",
"operator_type": "EQ"
}
}
\]
{
"data": \[
{
"line\_item\_id": "iqwls",
"name": "News",
"raw_negated": false,
"raw\_targeting\_value": "5h",
"id": "saib9p",
"raw\_targeting\_type": "IAB_CATEGORY",
"raw\_operator\_type": "EQUAL_TO",
"operator_type": "EQ",
"created_at": "2021-03-30T17:35:50Z",
"targeting_value": "IAB12",
"updated_at": "2021-03-30T17:35:50Z",
"deleted": false,
"targeting\_type": "IAB\_CATEGORY"
},
{
"line\_item\_id": "iqwls",
"name": "Society",
"raw_negated": false,
"raw\_targeting\_value": "5y",
"id": "saib9q",
"raw\_targeting\_type": "IAB_CATEGORY",
"raw\_operator\_type": "EQUAL_TO",
"operator_type": "EQ",
"created_at": "2021-03-30T17:35:50Z",
"targeting_value": "IAB14",
"updated_at": "2021-03-30T17:35:50Z",
"deleted": false,
"targeting\_type": "IAB\_CATEGORY"
}
\],
"request": \[
{
"params": {
"line\_item\_id": "iqwls",
"account_id": "55w3kv",
"operator_type": "EQ",
"targeting_value": "IAB12",
"targeting\_type": "IAB\_CATEGORY"
},
"operation_type": "Create"
},
{
"params": {
"line\_item\_id": "iqwls",
"account_id": "55w3kv",
"operator_type": "EQ",
"targeting_value": "IAB14",
"targeting\_type": "IAB\_CATEGORY"
},
"operation_type": "Create"
}
\]
}
```
##### アカウントのメディア (動画) をラインアイテムに関連付ける
[POST accounts/:account\_id/media\_creatives](/ja/x-ads-api/campaign-management#post-accounts-account-id-media-creatives) エンドポイントを使用して、この動画を広告グループに関連付けます。
```json theme={null}
POST https://ads-api.x.com/8/accounts/55w3kv/media_creatives
line\_item\_id=4bii5&account\_media\_id=knb
{
"data":{
"account\_media\_id":"74g",
"approval_status":"ACCEPTED",
"created_at":"2016-02-11T22:23:23Z",
"deleted":false,
"id":"qeq",
"landing_url":null,
"line\_item\_id":"4bii5",
"serving_status":"ACTIVE",
"updated_at":"2016-02-11T22:23:23Z"
},
"request":{
"params":{
"line\_item\_id":"4bii5",
"account\_media\_id":"knb"
}
}
}
```
#### CTA とリンク先 URL を設定する
X 上のほとんどの他のキャンペーンと異なり、`VIDEO_VIEWS_PREROLL` 目的では Promoted Tweets や Cards は使用されない点に注意が必要です。代わりに、動画クリエイティブは広告グループ (ラインアイテム) に関連付けられ、CTA 情報は `preroll_call_to_action` エンティティに関連付けられます。[POST accounts/:account\_id/preroll\_call\_to\_action](/ja/x-ads-api/creatives#preroll-call-to-actions) エンドポイントを使用して、ボタンの CTA とリンク先 URL を設定できます。
```json theme={null}
POST https://ads-api.x.com/8/accounts/55w3kv/preroll\_call\_to_action
line\_item\_id=4bii5&call\_to\_action=VISIT\_SITE&call\_to\_action\_url=https%3A%2F%2Fx.com%2FAdsAPI
{
"data":{
"id":"aaa111",
"line\_item\_id":"4bii5",
"call\_to\_action":"WATCH_NOW",
"call\_to\_action_url":"https://x.com/AdsAPI",
"created_at":"2016-02-11T22:23:23Z",
"updated_at":"2016-02-11T22:23:23Z",
"deleted":false
},
"request":{
"params":{
"line\_item\_id":"4bii5",
"call\_to\_action":"VISIT_SITE",
"call\_to\_action_url":"https://x.com/AdsAPI"
}
}
}
```
#### ターゲティング条件を設定する
プレロール動画広告に利用されるターゲティング条件は、バッチターゲティング条件エンドポイント [POST batch/accounts/:account\_id/targeting\_criteria](/ja/x-ads-api/campaign-management#post-batch-accounts-account-id-targeting-criteria) でのみ使用できます。
`CONTENT_PUBLISHER_USER` を除外ターゲティングとして使用し、広告が特定のユーザーと組み合わされないようにします。除外したいハンドル (@ユーザー名) の X の `user_id` または publisher\_user\_id を指定してください。
[GET publishers](/ja/x-ads-api/campaign-management#publishers) エンドポイントを使用すると、コンテンツカテゴリで除外する user\_id のリストを取得できます。[GET curated\_categories](/ja/x-ads-api/campaign-management#curated-categories-2) のレスポンスで返される publisher\_user\_id を利用して、キュレイテッドカテゴリ向けの同様の除外リストを取得することもできます。
**注:** キュレイテッドカテゴリでは最大 5 件の publisher\_user\_id、コンテンツカテゴリでは最大 50 件の user\_id を除外できます。
```json theme={null}
POST https://ads-api.x.com/8/batch/accounts/55w3kv/targeting_criteria
\[
{
"operation_type": "Create",
"params": {
"line\_item\_id": "iqwls",
"targeting\_type": "CONTENT\_PUBLISHER_ID",
"targeting_value": "1917731",
"operator_type": "NE"
}
}
\]
{
"data": \[
{
"line\_item\_id": "iqwka",
"name": "realsaltlake",
"raw_negated": true,
"raw\_targeting\_value": "aajwo",
"id": "sajk32",
"raw\_targeting\_type": "CONTENT_PUBLISHER",
"raw\_operator\_type": "EQUAL_TO",
"operator_type": "NE",
"created_at": "2021-03-30T18:02:32Z",
"targeting_value": 17288520,
"updated_at": "2021-03-30T18:02:32Z",
"deleted": false,
"targeting\_type": "CONTENT\_PUBLISHER_USER"
}
\],
"request": \[
{
"params": {
"line\_item\_id": "iqwka",
"account_id": "55w3kv",
"operator_type": "NE",
"targeting_value": "17288520",
"targeting\_type": "CONTENT\_PUBLISHER_USER"
},
"operation_type": "Create"
}
\]
}
```
#### キャンペーンを開始する
キャンペーンを開始する準備ができたら、[PUT accounts/:account\_id/campaigns/:id](/ja/x-ads-api/campaign-management#put-accounts-account-id-line-items-line-item-id) を実行して一時停止を解除します。
PUT [https://ads-api.x.com/8/accounts/55w3kv/campaigns/f2rp3](https://ads-api.x.com/8/accounts/55w3kv/campaigns/f2rp3)?
entity\_status=ACTIVE
```json theme={null}
{
"request": {
"params": {
"campaign_id": "f2rp3",
"account_id": "55w3kv"
}
},
"data": {
"name": "test-curated-categories-api",
"start_time": "2021-02-10T00:00:00Z",
"reasons\_not\_servable": \[
\],
"servable": false,
"purchase\_order\_number": null,
"effective_status": "ACTIVE",
"daily\_budget\_amount\_local\_micro": 55000000,
"end_time": null,
"funding\_instrument\_id": "103hp9",
"duration\_in\_days": null,
"standard_delivery": true,
"total\_budget\_amount\_local\_micro": null,
"id": "f2rp3",
"entity_status": "ACTIVE",
"frequency_cap": null,
"currency": "USD",
"created_at": "2021-02-08T23:55:38Z",
"updated_at": "2021-02-08T23:55:38Z",
"deleted": false
}
}
```
#### アナリティクス
`VIDEO_VIEWS_PREROLL` キャンペーンのアナリティクスは、stats エンドポイント経由で取得できます。
### タイムラインにおけるキーワードターゲティング
キーワードターゲティングは、キャンペーンのリーチを拡大するうえで、Promoted Tweets 製品の根幹となる機能です。タイムラインでのキーワードターゲティングにより、プラットフォームでは、X ユーザーの直近のツイートに含まれるキーワードに基づいてターゲティングを行うことができます。たとえば、広告主が順不同のキーワードの組み合わせ「plan + trip」をターゲティングしており、キャンペーン配信中にあるユーザーが「カボへの旅行の計画を立て始めたところ。おすすめはある？」とツイートした場合、そのユーザーはその後まもなく広告主の Promoted Tweet を目にする可能性があります。
#### どのように動作しますか？
TL;DR: API の観点から見ると、この変更はとてもシンプルです。タイムライン上のプロモツイートでキーワードターゲティングができるようになります。ラインアイテムの `targeting_type` を `unordered_keywords` または `phrase_keywords` に設定するだけです。
#### クイックスタートガイド
* `ALL_ON_TWITTER` または `TWITTER_TIMELINE` のいずれかを含むように placement を設定して、新しいラインアイテムを作成します。 [POST accounts/:account\_id/line\_items](https://dev.x.com/ads/reference/post/accounts/%3Aaccount_id/line_items)
* 新しく作成したラインアイテム用のターゲティング条件 (targeting criteria) を、`BROAD_KEYWORD` を使用して作成し、キーワード値を設定します。 [POST accounts/:account\_id/targeting\_criteria](https://dev.x.com/ads/reference/post/accounts/%3Aaccount_id/targeting_criteria)
* キーワードは [PUT accounts/:account\_id/targeting\_criteria](https://dev.x.com/ads/reference/put/accounts/%3Aaccount_id/targeting_criteria) で更新できます。
* キャンペーンの配信が開始されたら、ラインアイテムのパフォーマンスを把握するために統計情報を取得します。 [GET stats/accounts/:account\_id](https://dev.x.com/ads/reference/get/stats/accounts/%3Aaccount_id)
## APIリファレンス
### アカウント
Postman で実行
#### GET accounts[](#get-accounts "Permalink to this headline")
認証ユーザーがアクセス権を持つ、広告配信が有効な一部またはすべてのアカウントの詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :----------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_ids
### リクエスト例[](#example-request "この見出しへのパーマリンク")
```json theme={null}
GET https://ads-api.x.com/12/accounts?account_ids=18ce54d4x5t
```
**レスポンス例[](#example-response "この見出しへのパーマリンク")**
```json theme={null}
{
"request": {
"params": {
"account_ids": [
"18ce54d4x5t"
]
}
},
"next_cursor": null,
"data": [
{
"name": "API McTestface",
"business_name": null,
"timezone": "America/Los_Angeles",
"timezone_switch_at": "2016-07-21T07:00:00Z",
"id": "18ce54d4x5t",
"created_at": "2016-07-21T22:42:09Z",
"updated_at": "2017-07-06T16:51:04Z",
"business_id": null,
"approval_status": "ACCEPTED",
"deleted": false
}
]
}
```
#### GET accounts/:account\_id[](#get-accounts-account-id "Permalink to this headline")
認証済みユーザーがアクセス権を持つ特定のアカウントを取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts[](#post-accounts "Permalink to this headline")
注意: **SANDBOX のみ**
サンドボックス環境で広告アカウントを作成します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api-sandbox.x.com/12/accounts`
**Parameters[](#parameters "Permalink to this headline")**
なし
**Example Request[](#example-request "Permalink to this headline")**
`POST https://ads-api-sandbox.x.com/12/accounts`
**Example Response[](#example-response "Permalink to this headline")**
```json theme={null}
{
"request": {
"params": {}
},
"next_cursor": null,
"data": [
{
"name": "Sandbox account",
"business_name": null,
"timezone": "America/Los_Angeles",
"timezone_switch_at": null,
"id": "gq12fh",
"created_at": "2016-07-18T23:02:20Z",
"updated_at": "2016-07-18T23:02:20Z",
"business_id": null,
"approval_status": "ACCEPTED",
"deleted": false
}
]
}
```
#### PUT accounts/:account\_id[](#put-accounts-account-id "この見出しへのパーマリンク")
アカウント名および／または業種タイプを更新します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id[](#delete-accounts-account-id "この見出しへのパーマリンク")
注: **Sandbox 環境のみ**
Sandbox 環境で広告アカウントを削除します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api-sandbox.x.com/12/accounts/:account_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id
### アカウントのApp
[Postman で実行 ❯](https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87)
#### GET account\_apps[](#get-account-apps "Permalink to this headline")
指定された広告アカウントに関連付けられているすべてのモバイルアプリの詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/account_apps`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :----------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### アカウント履歴
Postman で実行する
#### GET accounts/:account\_id/account\_history[](#get-accounts-account-id-account-history "この見出しへのパーマリンク")
リクエストで指定された `entity_id` に対して行われた変更の概要を取得します。
**注**: このエンドポイントは現在ベータ版であり、許可リストへの登録が必要です。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/account_history`
**パラメータ[](#parameters "この見出しへのパーマリンク")**
| 名前 | 説明 |
| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### 広告主の事業カテゴリ
Postman で実行
#### GET advertiser\_business\_categories[](#get-advertiser-business-categories "この見出しへのパーマリンク")
広告主のブランドをパブリッシャーに説明するために Ad Group (`line_items`) で使用できる、有効な広告主ビジネス `categories` を取得します。
注記: これらのカテゴリは `PREROLL_VIEWS` という objective を持つ `line_items` にのみ適用され、ターゲティング条件に使用される `content_categories` とは別個のものです。
各 `advertiser_business_categories` は [IAB Categories](/ja/x-ads-api/campaign-management#iab-categories) の集合を表します。`PREROLL_VIEWS` objective を持つ Ad Group を作成する際は、その Ad Group に 1 つまたは 2 つの `advertiser_business_categories` を設定する必要があります。これは、[line item](/ja/x-ads-api/campaign-management#line-items) エンドポイントのリクエストパラメータ `categories` の値として、このエンドポイントから取得可能な対応する `iab_categories` の集合を指定することで行います。
詳細については、[Video Views Preroll Objective Guide](/ja/x-ads-api/campaign-management#video-views-preroll-objective) を参照してください。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/advertiser_business_categories`
**Parameters[](#parameters "この見出しへのパーマリンク")**
リクエストパラメータはありません。
**Example Request[](#example-request "この見出しへのパーマリンク")**
`GET https://ads-api.x.com/12/advertiser_business_categories`
**Example Response[](#example-response "この見出しへのパーマリンク")**
```json theme={null}
{
"request": {
"params": {}
},
"next_cursor": null,
"data": [
{
"id": "1jl",
"name": "Consumer Packaged Goods",
"iab_categories": [
"IAB9-26",
"IAB9-18",
"IAB9-29",
"IAB9-1",
"IAB9-8",
"IAB9-22",
"IAB6",
"IAB9-5",
"IAB9-12",
"IAB9-11",
"IAB9-23",
"IAB9-14",
"IAB4",
"IAB9-25",
"IAB9-17",
"IAB23",
"IAB9-24",
"IAB9-13",
"IAB16",
"IAB9-4",
"IAB9-9",
"IAB9-20",
"IAB22",
"IAB9-28",
"IAB9-27",
"IAB9-16",
"IAB9-31",
"IAB9-3",
"IAB9-19",
"IAB10",
"IAB9-2",
"IAB9-6",
"IAB9-21",
"IAB9-10",
"IAB9-15"
]
},
{
"id": "1jm",
"name": "Health & Pharma",
"iab_categories": [
"IAB7"
]
},
{
"id": "1jn",
"name": "Alcohol",
"iab_categories": [
"IAB8-5",
"IAB8-18"
]
},
{
"id": "1jo",
"name": "Dining",
"iab_categories": [
"IAB8-10",
"IAB8-8",
"IAB8-7",
"IAB8-15",
"IAB8-3",
"IAB8-4",
"IAB8-1",
"IAB8-16",
"IAB8-12",
"IAB8-13",
"IAB8-17",
"IAB8-11",
"IAB8-6",
"IAB8-9",
"IAB8-2",
"IAB8-14"
]
},
{
"id": "1jp",
"name": "Financial Services",
"iab_categories": [
"IAB3",
"IAB13",
"IAB21"
]
},
{
"id": "1jq",
"name": "Retail",
"iab_categories": [
"IAB18"
]
},
{
"id": "1jr",
"name": "Travel",
"iab_categories": [
"IAB20"
]
},
{
"id": "1js",
"name": "Gaming",
"iab_categories": [
"IAB9-30"
]
},
{
"id": "1jt",
"name": "Technology",
"iab_categories": [
"IAB19-22",
"IAB19-13",
"IAB19-4",
"IAB19-33",
"IAB19-26",
"IAB19-3",
"IAB19-16",
"IAB19-9",
"IAB19-32",
"IAB19-25",
"IAB19-30",
"IAB19-36",
"IAB19-21",
"IAB5",
"IAB19-12",
"IAB19-28",
"IAB19-17",
"IAB19-8",
"IAB19-7",
"IAB19-24",
"IAB15",
"IAB19-11",
"IAB19-31",
"IAB19-20",
"IAB19-15",
"IAB19-1",
"IAB19-35",
"IAB19-29",
"IAB19-34",
"IAB19-23",
"IAB19-2",
"IAB19-5",
"IAB19-14",
"IAB19-27",
"IAB19-10",
"IAB19-19"
]
},
{
"id": "1ju",
"name": "Telecommunication",
"iab_categories": [
"IAB19-6",
"IAB19-18"
]
},
{
"id": "1jv",
"name": "Auto",
"iab_categories": [
"IAB2"
]
},
{
"id": "1jw",
"name": "メディア・エンターテインメント",
"iab_categories": [
"IAB14-8",
"IAB14-4",
"IAB1-5",
"IAB14-7",
"IAB1-7",
"IAB17",
"IAB14-3",
"IAB1-1",
"IAB12",
"IAB1-6",
"IAB25-1",
"IAB1-2",
"IAB14-2",
"IAB14-6",
"IAB1-3",
"IAB1-4",
"IAB14-5"
]
},
{
"id": "1jx",
"name": "Politics",
"iab_categories": [
"IAB11-4"
]
},
{
"id": "1jy",
"name": "Gambling",
"iab_categories": [
"IAB9-7"
]
},
{
"id": "1jz",
"name": "Dating",
"iab_categories": [
"IAB14-1"
]
},
{
"id": "1k0",
"name": "Non-Profit",
"iab_categories": [
"IAB11-1",
"IAB11-2",
"IAB11-3",
"IAB11-5"
]
}
]
}
```
### オーディエンス規模の推定
Postman で実行
POST accounts/:account\_id/audience\_estimate[](#post-accounts-account-id-audience-estimate "この見出しへのパーマリンク")
#### キャンペーンのおおよそのオーディエンス規模を推定します。
このエンドポイントは、ターゲティング条件オブジェクトのパラメータを含む JSON オブジェクトの配列を受け付けます。必須および任意のターゲティング条件パラメータの一覧は、[POST accounts/:account\_id/targeting\_criteria](/ja/x-ads-api/campaign-management#post-accounts-account-id-targeting-criteria) エンドポイントで確認できます。リクエストは HTTP POST で送信し、`Content-Type: application/json` ヘッダーを付与した JSON 本文を含める必要があります。
**注意**: 少なくとも 1 つの**プライマリ**ターゲティング条件を指定する必要があります。すべてのプライマリターゲティング条件の一覧は、[キャンペーンターゲティングのページ](/ja/x-ads-api/campaign-management#targeting)で確認できます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/audience_estimate`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### 認証済みユーザー アクセス
Postman で実行
#### GET accounts/:account\_id/authenticated\_user\_access[](#get-accounts-account-id-authenticated-user-access "Permalink to this headline")
現在認証されているユーザー (access\_token) の、指定した広告アカウントに対する権限を取得します。これらの権限は ads.x.com 上で表示されるものと同一です。
取りうる値は次のとおりです。
* `ACCOUNT_ADMIN`: キャンペーンの変更および統計の閲覧に対するフルアクセス権を持ち、ユーザーの追加・削除や設定変更も可能
* `AD_MANAGER`: キャンペーンの変更および統計の閲覧に対するフルアクセス権を持つが、ユーザーの追加・削除や設定変更は不可
* `CREATIVE_MANAGER`: クリエイティブの変更およびプレビューの閲覧が可能だが、キャンペーンの作成や変更は不可
* `CAMPAIGN_ANALYST`: キャンペーンおよび統計の閲覧が可能だが、キャンペーンの作成や変更は不可
* `ANALYST` (ads.x.com 上では「Organic Analyst」) : オーガニック分析およびオーディエンスインサイトの閲覧が可能だが、キャンペーンの作成、変更、閲覧は不可
* `PARTNER_AUDIENCE_MANAGER`: データパートナーオーディエンスの閲覧および変更に対する API 経由のみのアクセス権を持つが、キャンペーン、クリエイティブ、その他のオーディエンス種別へのアクセス権はなし
加えて、`TWEET_COMPOSER` 権限は、認証されたユーザーが広告主に代わって nullcast (「Promoted-only」) ツイートを作成できることを示します。これは `ACCOUNT_ADMIN`、`AD_MANAGER`、または `CREATIVE_MANAGER` 権限を持つユーザーのみに利用可能です。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/authenticated_user_access`
**Parameters[](#parameters "Permalink to this headline")**
なし
**Example Request[](#example-request "Permalink to this headline")**
`GET https://ads-api.x.com/12/accounts/18ce54d4x5t/authenticated_user_access`
**Example Response[](#example-response "Permalink to this headline")**
```json theme={null}
{
"data": {
"user_id": "2417045708",
"permissions": [
"ACCOUNT_ADMIN",
"TWEET_COMPOSER"
]
},
"request": {
"params": {
"account_id": "18ce54d4x5t"
}
}
}
```
### 入札ルール
Postman で実行
#### GET bidding\_rules[](#get-bidding-rules "Permalink to this headline")
一部またはすべての通貨に対する入札ルールを取得します。レスポンスには、最小および最大の CPE (Cost-Per-Engagement、エンゲージメント単価) の入札額が含まれます。
これらの入札ルールが変更されることは稀ですが、少なくとも月に一度は、システム側でこれらのエンドポイントから最新情報を取得することを推奨します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/bidding_rules`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| currency
### キャンペーン
Postman で実行
#### GET accounts/:account\_id/campaigns[](#get-accounts-account-id-campaigns "この見出しへのパーマリンク")
現在のアカウントに関連付けられている一部またはすべてのキャンペーンの詳細を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/campaigns`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/campaigns/:campaign\_id[](#get-accounts-account-id-campaigns-campaign-id "Permalink to this headline")
現在のアカウントに紐づいている特定のキャンペーンを取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/campaigns/:campaign_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/campaigns[](#post-accounts-account-id-campaigns "この見出しへのパーマリンク")
現在のアカウントに関連付けられた新しいキャンペーンを作成します。
**注意**: 1 アカウントあたりアクティブなキャンペーンのデフォルト上限は 200 件です。ただし、非アクティブなキャンペーンの数に制限はありません。この上限はアクティブなキャンペーン 8,000 件まで引き上げることができます。より高い上限を有効にするには、広告主が自分の X のアカウントマネージャーにリクエストする必要があります。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/campaigns`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :-------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id
#### POST batch/accounts/:account\_id/campaigns[](#post-batch-accounts-account-id-campaigns "Permalink to this headline")
1 回のリクエストで新しい[キャンペーン](#post-accounts-account-id-campaigns)を一括作成できます。
**バッチリクエスト**
* 現在の最大バッチサイズは 40 です。
* すべてのパラメータはリクエストボディで送信され、`Content-Type` として `application/json` が必須です。
* バッチリクエストはグループとしてまとめて失敗または成功し、エラー・成功どちらの API レスポンスでも、最初のリクエスト内のアイテムの順序が維持されます。
**バッチレスポンス**
バッチ API レスポンスは順序付きのアイテムのコレクションを返します。それ以外は、対応する単一アイテムのエンドポイントと構造が同一です。
**バッチエラー**
* リクエストレベルのエラー (例: 最大バッチサイズ超過) は、レスポンス内の `errors` オブジェクトに表示されます。
* アイテムレベルのエラー (例: 必須キャンペーンパラメータの未指定) は、レスポンス内の `operation_errors` オブジェクトに表示されます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/batch/accounts/:account_id/campaigns`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------- | :-------------------------------------------------------------------------------------------------------------------- |
| operation\_type
#### PUT accounts/:account\_id/campaigns/:campaign\_id[](#put-accounts-account-id-campaigns-campaign-id "Permalink to this headline")
現在のアカウントに関連付けられている指定のキャンペーンを更新します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/campaigns/:campaign_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/campaigns/:campaign\_id[](#delete-accounts-account-id-campaigns-campaign-id "この見出しへのパーマリンク")
現在のアカウントに属する指定のキャンペーンを削除します。
**注意**: キャンペーンの削除は取り消しできません。削除済みリソースを再度削除しようとすると、HTTP 404 が返されます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/campaigns/:campaign_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### コンテンツカテゴリー
Postman で実行
#### GET content\_categories[](#get-content-categories "この見出しへのパーマリンク")
ラインアイテムに対して `targeting_criteria` として設定可能な有効なコンテンツ `categories` をリクエストします。
各 `content_category` は 1 つ以上の [IAB Categories](/ja/x-ads-api/campaign-management#iab-categories) にマッピングされます。これは、バッチ `targeting_critera` エンドポイントで `targeting_type` を `IAB_CATEGORY` に設定し、`content_categories` リクエストによって返される対応する `iab_categories` の集合を含めることで指定できます。これを行わない場合は、バリデーションエラーが発生します。
これら各コンテンツカテゴリに対するパブリッシャーの詳細は、[GET publishers](/ja/x-ads-api/campaign-management#publishers) エンドポイントを使用して取得できます。
追加の詳細は、[Video Views Pre-roll Objective Guide](/ja/x-ads-api/campaign-management#video-views-preroll-objective) に記載されています。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/content_categories`
**Parameters[](#parameters "この見出しへのパーマリンク")**
リクエストパラメータはありません
**Example Request[](#example-request "この見出しへのパーマリンク")**
`GET https://ads-api.x.com/12/content_categories`
**Example Response[](#example-response "この見出しへのパーマリンク")**
```json theme={null}
{
"request": {
"params": {}
},
"next_cursor": null,
"data": [
{
"name": "Automotive (Cars, Trucks, Racing)",
"id": "ru",
"iab_categories": [
"IAB2"
],
"publishers_in_last_thirty_days": 12,
"videos_monetized_in_last_thirty_days": 316
},
{
"name": "Comedy",
"id": "sk",
"iab_categories": [
"IAB1-4"
],
"publishers_in_last_thirty_days": 19,
"videos_monetized_in_last_thirty_days": 174
},
{
"name": "Digital Creators",
"id": "sl",
"iab_categories": [
"IAB25-1"
],
"publishers_in_last_thirty_days": 110,
"videos_monetized_in_last_thirty_days": 1257
},
{
"name": "Entertainment & Pop Culture",
"id": "sm",
"iab_categories": [
"IAB1-1",
"IAB1-2",
"IAB1-3",
"IAB1-5"
],
"publishers_in_last_thirty_days": 120,
"videos_monetized_in_last_thirty_days": 3482
},
{
"name": "Financial & Business News",
"id": "sn",
"iab_categories": [
"IAB3",
"IAB13",
"IAB21"
],
"publishers_in_last_thirty_days": 29,
"videos_monetized_in_last_thirty_days": 1461
},
{
"name": "Food & Drink",
"id": "so",
"iab_categories": [
"IAB8-8",
"IAB8-12",
"IAB8-17",
"IAB8-2",
"IAB8-3",
"IAB8-7",
"IAB8-11",
"IAB8-4",
"IAB8-14",
"IAB8-10",
"IAB8-15",
"IAB8-13",
"IAB8-9",
"IAB8-16",
"IAB8-6",
"IAB8-1"
],
"publishers_in_last_thirty_days": 24,
"videos_monetized_in_last_thirty_days": 516
},
{
"name": "ライフスタイル(ファッション、旅行、ウェルネス)",
"id": "sp",
"iab_categories": [
"IAB16",
"IAB9-21",
"IAB9-4",
"IAB9-25",
"IAB9-8",
"IAB4",
"IAB9-3",
"IAB9-15",
"IAB7",
"IAB6",
"IAB9-11",
"IAB9-16",
"IAB9-7",
"IAB9-20",
"IAB9-24",
"IAB9-17",
"IAB9-12",
"IAB9-31",
"IAB9-27",
"IAB10",
"IAB9-10",
"IAB9-23",
"IAB9-6",
"IAB9-18",
"IAB9-13",
"IAB9-1",
"IAB9-28",
"IAB20",
"IAB9-5",
"IAB9-26",
"IAB22",
"IAB23",
"IAB9-9",
"IAB9-22",
"IAB18",
"IAB9-2",
"IAB9-19",
"IAB9-14",
"IAB9-29"
],
"publishers_in_last_thirty_days": 67,
"videos_monetized_in_last_thirty_days": 2412
},
{
"name": "Music",
"id": "sq",
"iab_categories": [
"IAB1-6"
],
"publishers_in_last_thirty_days": 31,
"videos_monetized_in_last_thirty_days": 518
},
{
"name": "News & Current Events",
"id": "sr",
"iab_categories": [
"IAB12",
"IAB14"
],
"publishers_in_last_thirty_days": 125,
"videos_monetized_in_last_thirty_days": 5507
},
{
"name": "Politics",
"id": "s4",
"iab_categories": [
"IAB11"
],
"publishers_in_last_thirty_days": 19,
"videos_monetized_in_last_thirty_days": 1402
},
{
"name": "Science & Education",
"id": "ss",
"iab_categories": [
"IAB5",
"IAB15"
],
"publishers_in_last_thirty_days": 7,
"videos_monetized_in_last_thirty_days": 132
},
{
"name": "Sports",
"id": "se",
"iab_categories": [
"IAB17"
],
"publishers_in_last_thirty_days": 403,
"videos_monetized_in_last_thirty_days": 18281
},
{
"name": "Technology",
"id": "sg",
"iab_categories": [
"IAB19"
],
"publishers_in_last_thirty_days": 13,
"videos_monetized_in_last_thirty_days": 1089
},
{
"name": "Television",
"id": "sh",
"iab_categories": [
"IAB1-7"
],
"publishers_in_last_thirty_days": 58,
"videos_monetized_in_last_thirty_days": 1307
},
{
"name": "Esports & Video Games",
"id": "s0",
"iab_categories": [
"IAB9-30"
],
"publishers_in_last_thirty_days": 109,
"videos_monetized_in_last_thirty_days": 1844
}
],
"total_count": 15
}
```
### キュレーション済みカテゴリー
Postman で実行
#### GET accounts/:account\_id/curated\_categories[](#get-accounts-account-id-curated-categories "この見出しへのパーマリンク")
指定された `country_codes` に対して利用可能なキュレイテッドカテゴリのリストを取得します。
各 `curated_category` は、レスポンス内の `country_codes` によって指定される特定の国でのみ利用可能です。
詳細は [Video Views Pre-roll Objective ガイド](/ja/x-ads-api/campaign-management#video-views-preroll-objective)を参照してください。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/curated_categories`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/curated\_categories/:curated\_category\_id[](#get-accounts-account-id-curated-categories-curated-category-id "Permalink to this headline")
特定の `curated_category_id` の詳細を取得します。
各 `curated_category` は、レスポンスの `country_codes` で指定された特定の国でのみ利用できます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/curated_categories/:curated_category_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### 機能
Postman で実行
#### GET accounts/:account\_id/features[](#get-accounts-account-id-features "この見出しへのパーマリンク")
この広告アカウントで利用可能な、付与済み機能のコレクションを取得します。機能は説明的な feature key で示され、ベータ版またはその他の限定リリースとして導入され、かつ Ads API で利用可能な場合にのみ、このエンドポイントで公開されます。これらの条件を満たさない機能は、このエンドポイントでは公開されません。
**注記**: このエンドポイントは、ベータ版リリースに対するクライアントのアクセス状況の可視性を高めることで、Ads API エコシステムの開発を支援することを目的としています。API 開発者が、広告主に代わって機能へのアクセスをリクエストすることはできません。これらのリクエストは、広告主が担当の X アカウントマネージャーに対してのみ行うことができます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/features`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/features[](#post-accounts-account-id-features "この見出しへのパーマリンク")
**SANDBOX のみ**
sandbox アカウントに機能 (feature) を追加します。
最新のアカウント機能 (account feature) の一覧は、[GET accounts/:account\_id/features](#get-accounts-account-id-features) エンドポイントから取得できます。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api-sandbox.x.com/12/accounts/:account_id/features`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/features[](#delete-accounts-account-id-features "この見出しへのパーマリンク")
**SANDBOX 限定**
サンドボックスアカウントから機能を削除します。
最新のアカウント機能一覧は、[GET accounts/:account\_id/features](#get-accounts-account-id-features) エンドポイントから取得できます。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api-sandbox.x.com/12/accounts/:account_id/features`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### ファンディングインストルメント
Postman で実行
#### GET accounts/:account\_id/funding\_instruments[](#get-accounts-account-id-funding-instruments "この見出しへのパーマリンク")
現在のアカウントに関連付けられている一部またはすべての資金手段の詳細を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/funding_instruments`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/funding\_instruments/:funding\_instrument\_id[](#get-accounts-account-id-funding-instruments-funding-instrument-id "この見出しへのパーマリンク")
現在のアカウントに関連付けられている特定の資金元 (funding instrument) を取得します。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/funding_instruments/:id`
**パラメータ[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/funding\_instruments[](#post-accounts-account-id-funding-instruments "Permalink to this headline")
**SANDBOX 環境限定**
sandbox 環境で funding instrument を作成します。
sandbox funding instrument を使用しても、課金が発生するリスクはありません。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api-sandbox.x.com/12/accounts/:account_id/funding_instruments`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/funding\_instruments/:funding\_instrument\_id[](#delete-accounts-account-id-funding-instruments-funding-instrument-id "Permalink to this headline")
**SANDBOX 環境のみ**
Sandbox 環境で資金ソースを削除します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api-sandbox.x.com/12/accounts/:account_id/funding_instruments/:funding_instrument_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### IAB カテゴリ
Postman で実行
#### GET iab\_categories[](#get-iab-categories "Permalink to this headline")
広告グループ (`line_items`) で使用可能な `categories` を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/iab_categories`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :----------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count
### ラインアイテム
Postman で実行
#### GET accounts/:account\_id/line\_items[](#get-accounts-account-id-line-items "この見出しへのパーマリンク")
現在のアカウントに関連付けられている一部またはすべてのラインアイテムの詳細を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/line_items`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/line\_items/:line\_item\_id[](#get-accounts-account-id-line-items-line-item-id "Permalink to this headline")
現在のアカウントに関連付けられている特定のラインアイテムを取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_items/:line_item_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/line\_items[](#post-accounts-account-id-line-items "この見出しへのパーマリンク")
現在のアカウントに属する指定されたキャンペーンに関連付けられたラインアイテムを作成します。
1 つのキャンペーン内のすべてのラインアイテムは、同じ `product_type` と `objective` でなければなりません。
`PROMOTED_ACCOUNT` の `product_type` を使用する場合、`line_item` にツイートを関連付けると、標準的な `PROMOTED_ACCOUNT` のプレースメントに加えて、モバイルでのタイムライン上のプレースメントが追加されます。
`android_app_store_identifier` または `ios_app_store_identifier` のいずれかを設定すると、プロモーション対象のモバイルアプリに一致するターゲティング条件がラインアイテムに自動的に追加されます。たとえば、`ios_app_store_identifier` を指定すると、`iOS` に対する `PLATFORM` [ターゲティング条件](/ja/x-ads-api/campaign-management#targeting-options) が追加されます。
**注**: キャンペーンごとのラインアイテム数は最大 100 個、すべてのキャンペーンを合計したアクティブなラインアイテム数は最大 256 個です。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/line_items`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
| 名前 | 説明 |
| :----------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST batch/accounts/:account\_id/line\_items[](#post-batch-accounts-account-id-line-items "Permalink to this headline")
1 回のリクエストで新しい [line items](#post-accounts-account-id-line-items) をバッチ作成できるエンドポイントです。
**バッチリクエスト**
* 現在の最大バッチサイズは 40 件です。
* すべてのパラメータはリクエストボディで送信され、`Content-Type` として `application/json` の指定が必須です。
* バッチリクエストは 1 つのグループとしてまとめて成功または失敗し、エラーおよび成功いずれの API レスポンスにおいても、最初のリクエスト内のアイテム順序が保持されます。
**バッチレスポンス**
バッチ API レスポンスは順序付けされたアイテムのコレクションを返します。それ以外の点では、対応する単一アイテムのエンドポイントと構造は同一です。
**バッチエラー**
* リクエストレベルのエラー (例: 最大バッチサイズ超過) は、レスポンス内の `errors` オブジェクトに含まれます。
* アイテムレベルのエラー (例: 必須 line item パラメータの欠如) は、レスポンス内の `operation_errors` オブジェクトに含まれます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/batch/accounts/:account_id/line_items`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |
| operation\_type
#### PUT accounts/:account\_id/line\_items/:line\_item\_id[](#put-accounts-account-id-line-items-line-item-id "Permalink to this headline")
現在のアカウントに関連付けられている指定されたラインアイテムを更新します。
**リソース URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_items/:line_item_id`
**パラメーター[](#parameters "Permalink to this headline")**
| 名前 | 説明 |
| :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id
#### DELETE accounts/:account\_id/line\_items/:line\_item\_id[](#delete-accounts-account-id-line-items-line-item-id "Permalink to this headline")
現在のアカウントに属する指定されたラインアイテムを削除します。
**注記**: ラインアイテムの削除は取り消しできません。その後に同じリソースを削除しようとした場合、HTTP 404 が返されます。
**注記**: ラインアイテムが削除されると、その子である promoted\_tweets は、リクエストで `with_deleted=true` が指定されている場合にのみ、GET accounts/:account\_id/promoted\_tweets および GET accounts/:account\_id/promoted\_tweets/:promoted\_tweet\_id エンドポイントで返されます。これらの promoted\_tweets 自体は実際には削除されません (レスポンスでは `"deleted": false`) 。削除のカスケード処理は行いません。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_items/:line_item_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### ラインアイテムのキュレーテッドカテゴリ
Postman で実行
利用方法の詳細は、[Video Views プレロール目的ガイド](/ja/x-ads-api/campaign-management#video-views-preroll-objective)を参照してください。
#### GET accounts/:account\_id/line\_item\_curated\_categories[](#get-accounts-account-id-line-item-curated-categories "Permalink to this headline")
現在のアカウントに関連付けられている line item curated category の一部またはすべての詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :----------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/line\_item\_curated\_categories/:line\_item\_curated\_category\_id[](#get-accounts-account-id-line-item-curated-categories-line-item-curated-category-id "この見出しへのパーマリンク")
現在のアカウントに紐づく特定の line item curated category の詳細を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :-------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/line\_item\_curated\_categories[](#post-accounts-account-id-line-item-curated-categories "Permalink to this headline")
指定されたラインアイテムに [curated category](/ja/x-ads-api/campaign-management#curated-categories-2) オブジェクトを関連付けます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### PUT accounts/:account\_id/line\_item\_curated\_categories/:line\_item\_curated\_category\_id[](#put-accounts-account-id-line-item-curated-categories-line-item-curated-category-id "Permalink to this headline")
指定した line item curated category を更新します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/line\_item\_curated\_categories/:line\_item\_curated\_category\_id[](#delete-accounts-account-id-line-item-curated-categories-line-item-curated-category-id "Permalink to this headline")
指定した line item curated category を削除します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/line_item_curated_categories/:line_item_curated_category_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### ラインアイテムのプレースメント
Postman で実行
#### GET line\_items/placements[](#get-line-items-placements "この見出しへのパーマリンク")
有効な `placement` と `product_type` の組み合わせを取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/line_items/placements`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| product\_type
### メディアクリエイティブ
Postman で実行
#### GET accounts/:account\_id/media\_creatives[](#get-accounts-account-id-media-creatives "この見出しへのパーマリンク")
現在のアカウントに関連付けられている一部またはすべてのメディアクリエイティブの詳細を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/media_creatives`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/media\_creatives/:media\_creative\_id[](#get-accounts-account-id-media-creatives-media-creative-id "Permalink to this headline")
現在のアカウントに紐づく特定のメディアクリエイティブの詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/media_creatives/:media_creative_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id
#### POST accounts/:account\_id/media\_creatives[](#post-accounts-account-id-media-creatives "Permalink to this headline")
指定したラインアイテムに、[account media](/ja/x-ads-api/creatives#account-media) オブジェクトを関連付けます。
このエンドポイントを使用して、インストリーム広告 (account media の `creative_type` が `PREROLL` の場合) や画像広告 (`BANNER` や `INTERSTITIAL` など) を Twitter Audience Platform 上で配信するために利用します。
**注記**: Account Media リソースにメディアアセットを追加するには、[POST accounts/:account\_id/media\_library](/ja/x-ads-api/creatives#account-media) エンドポイントを使用してください。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/media_creatives`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :--------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/media\_creatives/:media\_creative\_id[](#delete-accounts-account-id-media-creatives-media-creative-id "Permalink to this headline")
現在のアカウントに属する指定の media creative を削除します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/media_creatives/:media_creative_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
Postman で実行
#### GET accounts/:account\_id/promoted\_accounts[](#get-accounts-account-id-promoted-accounts "この見出しへのパーマリンク")
現在のアカウント配下の 1 つ以上のラインアイテムに紐づく、一部またはすべてのプロモーションアカウントの詳細を取得します。
レスポンス内の `user_id` で特定されるユーザーアカウントのユーザーデータを取得するには、[GET users/lookup](https://developer.x.com/en/docs/x-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup) を使用してください。
指定したいずれのラインアイテムもプロモーションアカウントを含むように設定されていない場合、HTTP 400 が返されます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/promoted_accounts`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :--------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/promoted\_accounts/:promoted\_account\_id[](#get-accounts-account-id-promoted-accounts-promoted-account-id "この見出しへのパーマリンク")
現在のアカウント配下のラインアイテムに関連付けられたアカウントを指す特定の参照を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/promoted_accounts/:promoted_account_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :-------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/promoted\_accounts[](#post-accounts-account-id-promoted-accounts "Permalink to this headline")
指定されたラインアイテムにアカウント (`user_id`) を関連付けます。
指定されたラインアイテムが Promoted Accounts と関連付けるように構成されていない場合、HTTP 400 `INCOMPATIBLE_LINE_ITEM` エラーが返されます。指定されたユーザーがプロモーション対象外の場合、HTTP 400 が返され、いずれのユーザーもプロモーションは行われません。指定されたユーザーがすでにプロモーション済みである場合、そのリクエストは無視されます。
Promoted Accounts の詳細については、[campaign management](/ja/x-ads-api/campaign-management#advertiser-api) ページを参照してください。
**注記**: Promoted Accounts エンティティを更新 (PUT) することはできません。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/promoted_accounts`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/promoted\_accounts/:promoted\_account\_id[](#delete-accounts-account-id-promoted-accounts-promoted-account-id "Permalink to this headline")
指定されたラインアイテムからアカウントの関連付けを解除します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/promoted_accounts/:promoted_account_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
Postman で実行
現在のアカウントのラインアイテムに関連付けられたツイート参照を取得します。
ツイートオブジェクトを取得するには、[GET accounts/:account\_id/tweets](/ja/x-ads-api/creatives#get-accounts-account-id-tweets) エンドポイントを使用してください。各 promoted\_tweets オブジェクトの `tweet_id` の値を使用します。
**注記**: 親のラインアイテムが削除されている場合、リクエストで `with_deleted=true` が指定されているときにのみ promoted\_tweets が返されます。これらの promoted\_tweets 自体は削除されていません (レスポンス中の `"deleted": false` を参照) 。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/promoted_tweets`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### プロモーション対象ユーザー
Postman で実行
#### GET accounts/:account\_id/promotable\_users[](#get-accounts-account-id-promotable-users "Permalink to this headline")
現在のアカウントに関連付けられている一部またはすべてのプロモーション可能ユーザーの詳細を取得します。
プロモーション可能ユーザーのtypeは `FULL` または `RETWEETS_ONLY` のいずれかです。これは、そのアカウントによってプロモーションできるコンテンツの種類を制御します。広告主は、他のユーザーのコンテンツをプロモーションする権限を取得し、そのユーザーを `RETWEETS_ONLY` のプロモーション可能ユーザーとして自分のアカウントに追加してもらうために X に連絡する必要があります。
権限が正しく設定されていれば、プロモーション用プロダクトのエンドポイントに対して、プロモーションしたいツイートの Tweet ID を直接参照するリクエストを行うことができます。公開済みツイートをプロモーションするには [POST accounts/:account\_id/promoted-tweets](/ja/x-ads-api/campaign-management#promoted-tweets) エンドポイントを利用し、他の X 広告アカウントの予約済みツイートをプロモーションするには [POST accounts/:account\_id/scheduled-promoted-tweets](/ja/x-ads-api/campaign-management#promoted-tweets) エンドポイントを利用できます。
対象ツイートをリツイートする必要はありません。この方法でツイートをプロモーションすると、返される `tweet_id` は、指定した Tweet ID とは異なる値になります。内部的には、そのツイートは nullcast されたツイートとしてリツイートされ、その後プロモーションされます。返される `tweet_id` は、この新しいツイートに対応しています。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/promotable_users`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/promotable\_users/:promotable\_user\_id[](#get-accounts-account-id-promotable-users-promotable-user-id "Permalink to this headline")
現在のアカウントに関連付けられている特定のプロモーション対象ユーザーを取得します。
プロモーション対象ユーザーの `type` は `FULL` または `RETWEETS_ONLY` のいずれかです。これは、そのアカウントでプロモーションできるコンテンツの種類を制御します。
広告主は、他のユーザーのコンテンツをプロモーションするための権限を取得する必要があります。権限が正しく設定されていれば、プロモーションしたいツイートの Tweet ID を直接参照するプロモーションプロダクトのエンドポイントに対してリクエストを行うことができます。
対象のツイートをリツイートする必要はありません。この方法でツイートをプロモーションする場合、返される `tweet_id` は指定した Tweet ID とは異なります。内部的には、そのツイートは nullcast されたツイートとしてリツイートされ、その後プロモーションされます。返される `tweet_id` はこの新しいツイートに対応します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/promotable_users/:promotable_user_id`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### パブリッシャー
Postman で実行
#### GET publishers[](#get-publishers "Permalink to this headline")
コンテンツカテゴリに属するパブリッシャーの詳細一覧を取得します
詳細については、[Video Views Preroll Objective Guide](/ja/x-ads-api/campaign-management#video-views-preroll-objective) を参照してください
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/publishers`
**Parameters[](#parameters "Permalink to this headline")**
リクエストパラメーターはありません
**Example Request[](#example-request "Permalink to this headline")**
`GET https://ads-api.x.com/12/publishers`
**Example Response[](#example-response "Permalink to this headline")**
```json theme={null}
{
"request": {
"params": {}
},
"next_cursor": null,
"data": [
{
"monetizable_country_codes": [
"US"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "PeoplesSports",
"user_id": "1353868435021721602",
"monetization_restricted": true,
"content_category_ids": [
"se"
]
},
{
"monetizable_country_codes": [
"JP"
],
"promotion_eligible_country_codes": [
"JP"
],
"username": "NewYork_Jack",
"user_id": "1331177123436851206",
"monetization_restricted": true,
"content_category_ids": [
"sk"
]
},
{
"monetizable_country_codes": [
"JP"
],
"promotion_eligible_country_codes": [
"JP"
],
"username": "twispatv",
"user_id": "1331165719128461314",
"monetization_restricted": true,
"content_category_ids": [
"sm"
]
},
{
"monetizable_country_codes": [
"US"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "LAThieves",
"user_id": "1316808678897455105",
"monetization_restricted": true,
"content_category_ids": [
"s0"
]
},
{
"monetizable_country_codes": [
"US"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "Quicktake_EE",
"user_id": "1305900477427724290",
"monetization_restricted": true,
"content_category_ids": [
"sr"
]
},
{
"monetizable_country_codes": [
"BR"
],
"promotion_eligible_country_codes": [
"BR"
],
"username": "eufloribella",
"user_id": "1300812459054436354",
"monetization_restricted": true,
"content_category_ids": [
"sm"
]
},
{
"monetizable_country_codes": [
"EG"
],
"promotion_eligible_country_codes": [
"KW",
"EG",
"SA",
"AE",
"LB",
"QA"
],
"username": "Egypt2021EN",
"user_id": "1296077573399678977",
"monetization_restricted": true,
"content_category_ids": [
"se"
]
},
{
"monetizable_country_codes": [
"US"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "ClubShayShay",
"user_id": "1283068366706454529",
"monetization_restricted": true,
"content_category_ids": [
"se"
]
},
{
"monetizable_country_codes": [
"IN",
"KW",
"ID",
"EG",
"SG",
"TH",
"MY",
"PH",
"ES",
"US",
"AU",
"SA",
"AE",
"LB",
"GB",
"FR",
"KR",
"BR",
"MX",
"QA",
"CA",
"JP"
],
"promotion_eligible_country_codes": [
"KW",
"EG",
"SA",
"AE",
"LB",
"QA"
],
"username": "hiaahsanshow",
"user_id": "1253421442143641601",
"monetization_restricted": false,
"content_category_ids": [
"sh"
]
},
{
"monetizable_country_codes": [
"TH"
],
"promotion_eligible_country_codes": [
"TH"
],
"username": "HoneKrasae",
"user_id": "1240684293719904256",
"monetization_restricted": true,
"content_category_ids": [
"sr"
]
},
{
"monetizable_country_codes": [
"US"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "Sportskind",
"user_id": "1232708694418300930",
"monetization_restricted": true,
"content_category_ids": [
"se"
]
},
{
"monetizable_country_codes": [
"IN",
"KW",
"ID",
"EG",
"SG",
"TH",
"MY",
"PH",
"ES",
"US",
"AU",
"SA",
"AE",
"LB",
"GB",
"FR",
"KR",
"BR",
"MX",
"QA",
"CA",
"JP"
],
"promotion_eligible_country_codes": [
"KW",
"EG",
"SA",
"AE",
"LB",
"QA"
],
"username": "almeerathShow",
"user_id": "1229410512762437633",
"monetization_restricted": false,
"content_category_ids": [
"sh"
]
},
{
"monetizable_country_codes": [
"US"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "SeeYourVoiceFOX",
"user_id": "1225490734653947904",
"monetization_restricted": true,
"content_category_ids": [
"sh"
]
},
{
"monetizable_country_codes": [
"IN",
"KW",
"ID",
"EG",
"SG",
"TH",
"MY",
"PH",
"ES",
"US",
"AU",
"SA",
"AE",
"LB",
"GB",
"FR",
"KR",
"BR",
"MX",
"QA",
"CA",
"JP"
],
"promotion_eligible_country_codes": [
"US"
],
"username": "AUProSports",
"user_id": "1219303449768185859",
"monetization_restricted": false,
"content_category_ids": [
"se"
]
}
]
}
```
### 推奨
Postman で実行
#### GET accounts/:account\_id/recommendations[](#get-accounts-account-id-recommendations "Permalink to this headline")
ステータス: *クローズドベータ*
この広告アカウントに関連付けられたキャンペーンのレコメンデーションを取得します。現在、1つのファンディングインストゥルメントあたり取得できるレコメンデーションは1件までです。
**リソース URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/5/accounts/:account_id/recommendations`
**パラメータ[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/recommendations/:recommendation\_id[](#get-accounts-account-id-recommendations-recommendation-id "この見出しへのパーマリンク")
Status: *クローズドベータ*
この広告アカウントに関連付けられた特定のキャンペーンレコメンデーションを取得します。
キャンペーンレコメンデーションには、オブジェクトツリーとして表現されたキャンペーン構造に対して提案される変更内容一式が含まれます。レスポンスツリーは Batch API エンドポイントと組み合わせて使用されることを想定していますが、必要に応じて単一の更新エンドポイント (POST の Create、PUT の Update、DELETE の Delete) にマッピングすることもできます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/5/accounts/:account_id/recommendations/:recommendation_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
Postman で実行
現在のアカウントに関連付けられている一部またはすべての予約済みプロモツイートの詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/scheduled_promoted_tweets`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### ターゲティング条件
Postman で実行
#### GET accounts/:account\_id/targeting\_criteria[](#get-accounts-account-id-targeting-criteria "この見出しへのパーマリンク")
現在のアカウント配下のラインアイテムに関連付けられているターゲティング条件の詳細を、一部またはすべて取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/targeting_criteria`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id
#### GET accounts/:account\_id/targeting\_criteria/:targeting\_criterion\_id[](#get-accounts-account-id-targeting-criteria-targeting-criterion-id "この見出しへのパーマリンク")
現在のアカウントに関連付けられている特定のターゲティング条件を取得します。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
| Name | 説明 |
| :----------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/targeting\_criteria[](#post-accounts-account-id-targeting-criteria "Permalink to this headline")
特定のターゲティング type に対応する `targeting_value` を確認するには、[Targeting Options](/ja/x-ads-api/campaign-management#targeting-options) ページを参照してください。常に最新のターゲティング type の値を利用できるよう、すべてのデータを毎週更新することを推奨します。X では値や利用可能なターゲティング条件を随時変更します。多くは頻繁には変更されませんが、なかには頻繁に変更されるものもあります。これらの値が変更されないことは保証されません。
`BROAD_KEYWORD`、`EXACT_KEYWORD`、`PHRASE_KEYWORD`、`UNORDERED_KEYWORD` の各ターゲティング type を、`targeting_value` で指定したキーワードとともに使用します。`operator_type` リクエストパラメータを `NE` に設定することで、キーワードを除外できます。各 type の詳細な説明については [targeting keyword types](/ja/x-ads-api/campaign-management#targeting) を参照してください。
**Note**: 1 つのラインアイテムにつき、ターゲットにできる `AGE` バケットは 1 つだけです。
**Note**: Custom Audience をターゲティングするには、そのオーディエンスがターゲット可能である必要があります。つまり、`targerable` が `true` で *なければなりません*。
**Note**: ターゲティング type として `TV_SHOW` を使用する場合、`TV_SHOW` ターゲティングを設定する前に、そのラインアイテムに少なくとも 1 つの `LOCATION` ターゲティング条件が存在している必要があります。また、すべての `LOCATION` はターゲットとする `TV_SHOW` と同じロケール内でなければなりません。
**リソース URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/targeting_criteria`
**パラメータ[](#parameters "Permalink to this headline")**
| Name | Description |
| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST batch/accounts/:account\_id/targeting\_criteria[](#post-batch-accounts-account-id-targeting-criteria "Permalink to this headline")
1 回のリクエストで新しいターゲティング条件をバッチ作成できます。
**バッチリクエスト**
* 現在の最大バッチサイズは 500 です。
* すべてのパラメータはリクエストボディで送信され、`Content-Type` として `application/json` が必須です。
* バッチリクエストはグループとして全体で成功または失敗し、エラーおよび成功の両方の API レスポンスで、最初のリクエストにおける各項目の順序が保持されます。
**バッチレスポンス**
バッチ API レスポンスは順序付きの項目コレクションを返します。構造は、それぞれに対応する単一項目エンドポイントと同一です。
**バッチエラー**
* リクエストレベルのエラー (例: 最大バッチサイズ超過) はレスポンス内の `errors` オブジェクトとして返されます。
* 項目レベルのエラー (例: 必須ターゲティング条件パラメータの欠如) はレスポンス内の `operation_errors` オブジェクトとして返されます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/batch/accounts/:account_id/targeting_criteria`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :-------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| operation\_type
#### DELETE accounts/:account\_id/targeting\_criteria/:targeting\_criterion\_id[](#delete-accounts-account-id-targeting-criteria-targeting-criterion-id "この見出しへのパーマリンク")
現在のアカウントに属する指定されたターゲティング条件を削除します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/targeting_criteria/:targeting_criterion_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### ターゲティングオプション
Postman で実行
* [App Store カテゴリー](#get-targeting-criteria-app-store-categories)
* [会話](#get-targeting-criteria-conversations)
* [デバイス](#get-targeting-criteria-devices)
* [イベント](#get-targeting-criteria-events)
* [興味関心](#get-targeting-criteria-interests)
* [言語](#get-targeting-criteria-languages)
* [ロケーション](#get-targeting-criteria-locations)
* [通信事業者](#get-targeting-criteria-network-operators)
* [プラットフォームバージョン](#get-targeting-criteria-platform-versions)
* [プラットフォーム](#get-targeting-criteria-platforms)
* [テレビ市場](#get-targeting-criteria-tv-markets)
* [テレビ番組](#get-targeting-criteria-tv-shows)
#### GET targeting\_criteria/app\_store\_categories[](#get-targeting-criteria-app-store-categories "Permalink to this headline")
Promoted Products 向けに利用可能な、アプリストアカテゴリに基づくターゲティング条件を取得します。アプリストアカテゴリは iOS App Store と Google Play ストアでのみ利用可能です。
インストール済みアプリカテゴリターゲティングを使用すると、ユーザーがインストールしている、または興味を示したアプリのカテゴリに基づいてユーザーをターゲティングできます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/targeting_criteria/app_store_categories`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------- | :---------------------------------------------------------------------------------------------------- |
| q
#### GET targeting\_criteria/conversations[](#get-targeting-criteria-conversations "この見出しへのパーマリンク")
Promoted Products 向けに利用可能な会話ベースのターゲティング条件を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/conversations`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| conversation\_type
#### GET targeting\_criteria/devices[](#get-targeting-criteria-devices "この見出しへのパーマリンク")
プロモーションプロダクト向けに利用可能なデバイスベースのターゲティング条件を取得します。デバイスターゲティングはプロモツイートで利用できます。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/devices`
**パラメータ[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------- | :------------------------------------------------------------------------------------------------------- |
| count
#### GET targeting\_criteria/events[](#get-targeting-criteria-events "Permalink to this headline")
Promoted Products 向けに利用可能なイベントベースのターゲティング条件を取得します。1 つのラインアイテムにつき、ターゲットにできるイベントは 1 件のみです。
**注記**: イベントはしばしば複数のタイムゾーンにまたがって発生するため、異なるタイムゾーン越しにイベント時刻を扱う際に複雑さが生じます。これを簡素化するため、このエンドポイントで扱うすべてのイベントの `start_time` および `end_time` の値は、イベントのロケールやタイムゾーンに関係なく UTC±00:00 で表現されます。イベントの `start_time` および `end_time` の値をクエリしたり操作したりする際には、この設計を念頭に置いてください。たとえば、米国の独立記念日 (Independence Day) は、UTC±00:00 において `start_time=2017-07-04T00:00:00Z` および `end_time=2017-07-05T00:00:00Z` として表現されるため、この祝日が米国内の複数タイムゾーンにまたがって存在するという問題を回避できます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/targeting_criteria/events`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| event\_types
#### GET targeting\_criteria/interests[](#get-targeting-criteria-interests "この見出しへのパーマリンク")
プロモーションプロダクト向けに利用可能な、興味・関心ベースのターゲティング条件を取得します。インタレストは頻繁には変更されませんが、このリストは少なくとも週に一度は更新することを推奨します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/interests`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |
| count
#### GET targeting\_criteria/languages[](#get-targeting-criteria-languages "この見出しへのパーマリンク")
ターゲティングに利用可能な言語を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/languages`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |
| count
#### GET targeting\_criteria/locations[](#get-targeting-criteria-locations "この見出しへのパーマリンク")
Promoted Products 向けに利用可能な、位置情報に基づくターゲティング条件を取得します。ジオターゲティングは、国レベル、州/地域レベル、市区町村レベル、郵便番号レベルで、Promoted Accounts と Promoted Tweets に対して利用できます。郵便番号レベルで分析情報を取得する場合は、郵便番号ターゲティングを使用する必要があります。
**注**: San Francisco や New York など、特定のターゲット可能な都市を取得するには、`location_type` リクエストパラメータと併せて `CITIES` enum を使用してください。
指定市場エリア (DMA: Designated Market Areas) をターゲットにするには、`METROS` enum を使用してください。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/locations`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count
#### GET targeting\_criteria/network\_operators[](#get-targeting-criteria-network-operators "この見出しへのパーマリンク")
Promoted Products 向けに利用可能な、ネットワークオペレーター (通信事業者) ベースのターゲティング条件を取得できます。
このエンドポイントでは、AT\&T、Verizon、Sprint、T-Mobile など、複数の国におけるターゲティング可能な通信キャリアを検索できます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/network_operators`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------- |
| count
#### GET targeting\_criteria/platform\_versions[](#get-targeting-criteria-platform-versions "この見出しへのパーマリンク")
プロモーション商品向けに利用可能な、モバイル OS バージョンに基づくターゲティング条件を取得します。プラットフォームバージョンを指定したターゲティングは、プロモーションアカウントおよびプロモーションツイートで利用できます。これにより、Android 8.0 や iOS 10.0 など、モバイルオペレーティングシステムのポイントリリースまで細かく指定してターゲティングできます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/platform_versions`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------ | :-------------------------------------------------------------------------------------------------------------------- |
| q
#### GET targeting\_criteria/platforms[](#get-targeting-criteria-platforms "この見出しへのパーマリンク")
プロモーションプロダクト向けに利用可能な、プラットフォームに基づくターゲティング条件を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/platforms`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count
#### GET targeting\_criteria/tv\_markets[](#get-targeting-criteria-tv-markets "この見出しへのパーマリンク")
TV ショーをターゲティングできる利用可能な TV マーケットを取得します。ロケールごとのマーケットを返し、この情報を使用して [GET targeting\_criteria/tv\_shows](/ja/x-ads-api/campaign-management#get-targeting-criteria-tv-shows) エンドポイントをクエリできます。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/tv_markets`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
なし
**リクエスト例[](#example-request "この見出しへのパーマリンク")**
`GET https://ads-api.x.com/12/targeting_criteria/tv_markets`
**レスポンス例[](#example-response "この見出しへのパーマリンク")**
```json theme={null}
{
"data": [
{
"name": "France",
"country_code": "FR",
"locale": "fr-FR"
},
{
"name": "Chile",
"country_code": "CL",
"locale": "es-CL"
},
{
"name": "Germany",
"country_code": "DE",
"locale": "de-DE"
},
{
"name": "Netherlands",
"country_code": "NL",
"locale": "nl-NL"
},
{
"name": "United States",
"country_code": "US",
"locale": "en-US"
},
{
"name": "Venezuela",
"country_code": "VE",
"locale": "es-VE"
},
{
"name": "Brazil",
"country_code": "BR",
"locale": "pt-BR"
},
{
"name": "Mexico",
"country_code": "MX",
"locale": "es-MX"
},
{
"name": "Colombia",
"country_code": "CO",
"locale": "es-CO"
},
{
"name": "United Kingdom",
"country_code": "GB",
"locale": "en-GB"
},
{
"name": "Argentina",
"country_code": "AR",
"locale": "es-AR"
},
{
"name": "Japan",
"country_code": "JP",
"locale": "ja-JP"
},
{
"name": "Canada",
"country_code": "CA",
"locale": "en-CA"
},
{
"name": "Spain",
"country_code": "ES",
"locale": "es-ES"
},
{
"name": "Italy",
"country_code": "IT",
"locale": "it-IT"
},
{
"name": "United States - Hispanic",
"country_code": "US",
"locale": "es-US"
},
{
"name": "Ireland",
"country_code": "IE",
"locale": "en-IE"
}
],
"request": {
"params": {}
}
}
```
#### GET targeting\_criteria/tv\_shows[](#get-targeting-criteria-tv-shows "この見出しへのパーマリンク")
Promoted Products 向けに利用可能な TV 番組ベースのターゲティング条件を取得します。TV 番組ターゲティングは、特定の市場における Promoted ツイートで利用できます。利用可能な市場については、[GET targeting\_criteria/tv\_markets](/ja/x-ads-api/campaign-management#get-targeting-criteria-tv-markets) エンドポイントを参照してください。
**注記**: 1,000 ユーザー未満を含むオーディエンスは、`estimated_users` の値が `1000` として表示されます。
**注記**: TV チャンネルおよびジャンルによるターゲティングオプションは、サポートされなくなりました。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/targeting_criteria/tv_shows`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| locale
### ターゲティング候補
Postman で実行
#### GET accounts/:account\_id/targeting\_suggestions[](#get-accounts-account-id-targeting-suggestions "Permalink to this headline")
初期の選択を補完するために、キーワードまたはユーザーのターゲティング候補を最大 50 個まで取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/targeting_suggestions`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### 税設定
Postman で実行
#### GET accounts/:account\_id/tax\_settings[](#get-accounts-account-id-tax-settings "Permalink to this headline")
現在のアカウントに関連付けられている税設定の詳細を取得します。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/tax_settings`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### PUT accounts/:account\_id/tax\_settings[](#put-accounts-account-id-tax-settings "この見出しへのパーマリンク")
現在のアカウントの税設定を更新します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/tax_settings`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| 名前 | 説明 |
| :---------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### トラッキングタグ
Postman で実行
#### GET accounts/:account\_id/tracking\_tags[](#get-accounts-account-id-tracking-tags "この見出しへのパーマリンク")
現在のアカウントに関連付けられている一部またはすべてのトラッキングタグの詳細を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/tracking_tags`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### GET accounts/:account\_id/tracking\_tags/:tracking\_tag\_id[](#get-accounts-account-id-tracking-tags-tracking-tag-id "この見出しへのパーマリンク")
現在のアカウントに関連付けられている特定のトラッキングタグを取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/tracking_tags/:tracking_tag_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### POST accounts/:account\_id/tracking\_tags[](#post-accounts-account-id-tracking-tags "Permalink to this headline")
指定したラインアイテムにトラッキングタグを関連付けます。
**Resource URL[](#resource-url "Permalink to this headline")**
`https://ads-api.x.com/12/accounts/:account_id/tracking_tags`
**Parameters[](#parameters "Permalink to this headline")**
| Name | Description |
| :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| account\_id
#### PUT accounts/:account\_id/tracking\_tags/:tracking\_tag\_id[](#put-accounts-account-id-tracking-tags-tracking-tag-id "この見出しへのパーマリンク")
指定したラインアイテムにトラッキングタグを関連付けます。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/tracking_tags/:tracking_tag_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :----------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### DELETE accounts/:account\_id/tracking\_tags/:tracking\_tag\_id[](#delete-accounts-account-id-tracking-tags-tracking-tag-id "この見出しへのパーマリンク")
指定したラインアイテムとトラッキングタグとの関連付けを解除します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/tracking_tags/:tracking_tag_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
### ユーザー設定
Postman で実行
([https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87](https://app.getpostman.com/run-collection/1d12b9fc623b8e149f87))
#### GET accounts/:account\_id/user\_settings/:user\_id[](#get-accounts-account-id-user-settings-user-id "この見出しへのパーマリンク")
ユーザー設定を取得します。
**Resource URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/user_settings/:user_id`
**Parameters[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id
#### PUT accounts/:account\_id/user\_settings/:user\_id[](#put-accounts-account-id-user-settings-user-id "この見出しへのパーマリンク")
ユーザー設定を更新します。ユーザーコンテキストが必要です。アカウント管理者ではアクセスできません。
**リソース URL[](#resource-url "この見出しへのパーマリンク")**
`https://ads-api.x.com/12/accounts/:account_id/user_settings/:user_id`
**パラメーター[](#parameters "この見出しへのパーマリンク")**
| Name | Description |
| :------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| account\_id