Campaign management
おすすめ
GET accounts/:account_id/recommendations¶
ステータス: クローズドベータ版
この広告アカウントに関連付けられているキャンペーンのお勧めを取得します。現時点では、お勧めはお支払い方法ごとに1つに制限されています。
リソースURL¶
https://ads-api.x.com/5/accounts/:account_id/recommendations
パラメーター¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
リクエストの例¶
GET https://ads-api.x.com/5/accounts/18ce54d4x5t/recommendations
応答の例¶
"request": {
"params": {
"account_id": "18ce54d4x5t"
}
},
"total_count": 1,
"data": [
{
"funding_instrument_id": "gpvzb",
"id": "62ce8zza1q0w",
"account_id": "18ce54d4x5t",
"status": "PENDING",
"message": "Recommendation for testing",
"created_at": "2016-11-14T23:07:54Z",
"updated_at": "2016-11-14T23:07:54Z"
}
]
GET accounts/:account_id/recommendations/:recommendation_id¶
ステータス: クローズドベータ版
この広告アカウントに関連付けられている特定のキャンペーンのお勧めを取得します。
キャンペーンのお勧めには、キャンペーン構造に対して提案された一連の変更がすべて含まれており、オブジェクトツリーとして表示されます。応答ツリーはバッチAPIエンドポイントと連動させて利用することを目的としていますが、必要に応じて単一の更新エンドポイントにマッピングすることもできます（作成とPOST、更新とPUT、削除とDELETE）。
リソースURL¶
https://ads-api.x.com/5/accounts/:account_id/recommendations/:recommendation_id
パラメーター¶
| 名前 | 説明 |
|---|---|
account_id 必須 |
利用するアカウントのID。リソースのパス内に表示され、通常、GET accountsを除くすべての広告主APIリクエストに必須のパラメーターです。指定するアカウントは、認証済みユーザーに関連付けられている必要があります。 タイプ: 文字列 例: |
recommendation_id 必須 |
リクエストで操作するお勧めIDへの参照 タイプ: 文字列 例: |
リクエストの例¶
GET https://ads-api.x.com/5/accounts/18ce54d4x5t/recommendations/62ce8zza1q0w
応答の例¶
{
"request": {
"params": {
"recommendation_id": "62ce8zza1q0w",
"account_id": "18ce54d4x5t"
}
},
"data_type": "recommendations",
"data": {
"changes": [
{
"entity_type": "campaigns",
"params": {
"start_time": "2016-11-08T22:00:00Z",
"daily_budget_amount_local_micro": 2200000,
"end_time": "2016-11-16T07:59:00Z",
"total_budget_amount_local_micro": 12000000,
"id": "64m0d"
},
"operation_type": "Update",
"dependent_entities": [
{
"entity_type": "line_items",
"params": {
"name": "Campaign for recommendations",
"placements": [
"TWITTER_TIMELINE"
],
"bid_amount_local_micro": 1430000,
"id": "6f5kq",
"include_sentiment": "ALL"
},
"operation_type": "Update",
"dependent_entities": [
{
"entity_type": "targeting_criteria",
"params": {
"id": "a8po6p"
},
"operation_type": null,
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "election results",
"targeting_value": "election results",
"targeting_type": "PHRASE_KEYWORD"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "promoted_tweets",
"params": {
"id": "101ftp"
},
"operation_type": "Delete",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "Male",
"targeting_value": 1,
"targeting_type": "GENDER"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "San Francisco-Oakland-San Jose CA, US",
"targeting_value": "",
"targeting_type": "LOCATION"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "promoted_tweets",
"params": {
"id": "101fto"
},
"operation_type": "Delete",
"dependent_entities": []
},
{
"entity_type": "promoted_tweets",
"params": {
"line_item_id": "6f5kq",
"display_properties": [],
"paused": false,
"approval_status": "ACCEPTED",
"tweet_id": "91125952589766656"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "Partner audience targeting",
"targeting_value": "v2cx",
"targeting_type": "NEGATIVE_BEHAVIOR"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "AGE_21_TO_34",
"targeting_value": "AGE_21_TO_34",
"targeting_type": "AGE"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"id": "a8po6o"
},
"operation_type": "Delete",
"dependent_entities": []
},
{
"entity_type": "promoted_tweets",
"params": {
"line_item_id": "6f5kq",
"display_properties": [],
"paused": false,
"approval_status": "ACCEPTED",
"tweet_id": "991101965843460096"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "promoted_tweets",
"params": {
"line_item_id": "6f5kq",
"display_properties": [],
"paused": false,
"approval_status": "ACCEPTED",
"tweet_id": "991127212156096516"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "debate",
"targeting_value": "debate",
"targeting_type": "NEGATIVE_PHRASE_KEYWORD"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"line_item_id": "6f5kq",
"name": "60004, IL, US",
"targeting_value": "",
"targeting_type": "LOCATION"
},
"operation_type": "Create",
"dependent_entities": []
},
{
"entity_type": "targeting_criteria",
"params": {
"id": "a8po6n"
},
"operation_type": null,
"dependent_entities": []
},
{
"entity_type": "promoted_tweets",
"params": {
"id": "101ftn"
},
"operation_type": null,
"dependent_entities": []
}
]
}
]
}
],
"funding_instrument_id": "gpvzb",
"id": "62ce8zza1q0w",
"account_id": "18ce54d4x5t",
"status": "PENDING",
"message": "Recommendation for testing",
"created_at": "2016-11-14T23:07:54Z",
"updated_at": "2016-11-14T23:07:54Z"
}
}