開発者ガイドの概要

Amazon Ads APIの概要

スポンサープロダクト広告のオートターゲティング

注

オートターゲティングエクスプレッションは、すべてのオートターゲティングキャンペーンに対して自動的に作成されます。マニュアルでオートターゲティングエクスプレッションを作成する必要はありません。

オートターゲティングエクスプレッションを使用すると、オートターゲティングキャンペーン内の検索用語および商品のグループに対して異なる入札額を選択できます。

オートターゲティング項目を設定しない場合、広告グループでは、広告グループの作成時に割り当てられた入札額の初期値がすべてのターゲティングで使用されます。オートターゲティングエクスプレッションを使用した場合は、ターゲティングエクスプレッションのターゲティングタイプごとに異なる入札額を指定できます。

オートターゲティングでは、プロダクト広告として広告グループに割り当てられているASINに基づく、4つのターゲティングタイプに対応します。

サポートされるエクスプレッションタイプ

| エクスプレッション | 対応するコンソール項目 | 説明 | |--- |--- |--- | | QUERY_BROAD_REL_MATCHES | おおまか一致 | 商品との関連性が大まかに一致した検索用語。 | | QUERY_HIGH_REL_MATCHES | ほぼ一致 | 商品との関連性が高い検索用語。 | | ASIN_ACCESSORY_RELATED | 補完商品 | 該当商品を補完する商品の詳細ページ。 | | ASIN_SUBSTITUTE_RELATED | 代替商品 | 該当商品の代替となる商品の詳細ページ。 |

始める前に

  1. オートターゲティングキャンペーンを作成します。
  2. 広告グループを作成します。この手順を完了すると、4つのオートターゲティングエクスプレッションが自動的に作成されます。
  3. 広告グループ内に1つ以上のプロダクト広告を作成します。

ターゲットIDの取得

まず、キャンペーンの一部として作成されるオートターゲティングエクスプレッションのターゲットIDを取得する必要があります。

エンドポイント

POST /sp/targets/list

例

ヒント

オートキャンペーンのターゲットのみが返されるようにするには、リクエストボディでcampaignIdまたはadGroupIdフィルターを使用します。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/list' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--data-raw '{
  "campaignIdFilter": {
    "include": [
      "auto_campaign_id"
    ]
  }
}'

レスポンスボディには、広告グループに対して作成された4つのオートターゲティングエクスプレッション（サポートされるエクスプレッションタイプごとに1つ）が含まれます。この段階では、ターゲティング項目に入札額は含まれていません。

{
  "targetingClauses": [
    {
      "adGroupId": "184667233956202",
      "campaignId": "42586816713082",
      "expression": [
        {
          "type": "QUERY_HIGH_REL_MATCHES"
        }
      ],
      "expressionType": "AUTO",
      "resolvedExpression": [
        {
          "type": "QUERY_HIGH_REL_MATCHES"
        }
      ],
      "state": "ENABLED",
      "targetId": "31667521455534"
    },
    {
      "adGroupId": "184667233956202",
      "campaignId": "42586816713082",
      "expression": [
        {
          "type": "QUERY_BROAD_REL_MATCHES"
        }
      ],
      "expressionType": "AUTO",
      "resolvedExpression": [
        {
          "type": "QUERY_BROAD_REL_MATCHES"
        }
      ],
      "state": "ENABLED",
      "targetId": "275709419154538"
    },
    {
      "adGroupId": "184667233956202",
      "campaignId": "42586816713082",
      "expression": [
        {
          "type": "ASIN_ACCESSORY_RELATED"
        }
      ],
      "expressionType": "AUTO",
      "resolvedExpression": [
        {
          "type": "ASIN_ACCESSORY_RELATED"
        }
      ],
      "state": "ENABLED",
      "targetId": "54866135241200"
    },
    {
      "adGroupId": "184667233956202",
      "campaignId": "42586816713082",
      "expression": [
        {
          "type": "ASIN_SUBSTITUTE_RELATED"
        }
      ],
      "expressionType": "AUTO",
      "resolvedExpression": [
        {
          "type": "ASIN_SUBSTITUTE_RELATED"
        }
      ],
      "state": "ENABLED",
      "targetId": "14640417682469"
    }
  ],
  "totalResults": 4
}

以降の手順で必要となるため、各エクスプレッションのtargetIdをメモに残します。

入札額に関する推奨事項の取得

テーマベースの推奨入札額を使用することで、各エクスプレッションタイプの推奨入札額を取得できます。campaignIdとadGroupIdを入力する必要があります。adGroupIdには、有効なプロダクト広告子エンティティが存在する必要があります。

エンドポイント

POST sp/targets/bid/recommendations

リクエスト

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets/bid/recommendations' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spthemebasedbidrecommendation.v3+json' \
--header 'Content-Type: application/vnd.spthemebasedbidrecommendation.v3+json' \
--data-raw '{
  "recommendationType": "BIDS_FOR_EXISTING_AD_GROUP",
  "targetingExpressions": [
    {
      "type": "CLOSE_MATCH"
    },
    {
      "type": "COMPLEMENTS"
    },
    {
      "type": "LOOSE_MATCH"
    },
    {
      "type": "SUBSTITUTES"
    }
  ],
  "campaignId": "auto_campaignId",
  "adGroupId": "auto_campaign_adGroupId"
}‘

レスポンス

レスポンスには、各ターゲティングエクスプレッションタイプの推奨入札額の最小値、中央値、最大値が含まれます。

{
    "bidRecommendations": [
        {
            "theme": "CONVERSION_OPPORTUNITIES",
            "impactMetrics": {
                "clicks": {
                    "values": [
                        {
                            "lower": 24,
                            "upper": 32
                        },
                        {
                            "lower": 48,
                            "upper": 64
                        },
                        {
                            "lower": 71,
                            "upper": 96
                        }
                    ]
                },
                "orders": {
                    "values": [
                        {
                            "lower": 3,
                            "upper": 4
                        },
                        {
                            "lower": 5,
                            "upper": 7
                        },
                        {
                            "lower": 8,
                            "upper": 10
                        }
                    ]
                }
            },
            "bidRecommendationsForTargetingExpressions": [
                {
                    "targetingExpression": {
                        "type": "CLOSE_MATCH",
                        "value": null
                    },
                    "bidValues": [
                        {
                            "suggestedBid": 0.77
                        },
                        {
                            "suggestedBid": 1
                        },
                        {
                            "suggestedBid": 1.28
                        }
                    ]
                },
                {
                    "targetingExpression": {
                        "type": "COMPLEMENTS",
                        "value": null
                    },
                    "bidValues": [
                        {
                            "suggestedBid": 1.01
                        },
                        {
                            "suggestedBid": 1.11
                        },
                        {
                            "suggestedBid": 1.25
                        }
                    ]
                },
                {
                    "targetingExpression": {
                        "type": "LOOSE_MATCH",
                        "value": null
                    },
                    "bidValues": [
                        {
                            "suggestedBid": 0.12
                        },
                        {
                            "suggestedBid": 0.13
                        },
                        {
                            "suggestedBid": 0.16
                        }
                    ]
                },
                {
                    "targetingExpression": {
                        "type": "SUBSTITUTES",
                        "value": null
                    },
                    "bidValues": [
                        {
                            "suggestedBid": 0.64
                        },
                        {
                            "suggestedBid": 1.01
                        },
                        {
                            "suggestedBid": 1.36
                        }
                    ]
                }
            ]
        }
    ]
}

ターゲティングエクスプレッションの入札額の更新

各オートターゲティングエクスプレッションで使用する入札額が決まったら、入札額を更新できます。

エンドポイント

PUT sp/targets

例

curl --location --request PUT 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--data-raw '{
  "targetingClauses": [
    {
      "targetId": "137528803021084",
      "bid": 3.25
    }
  ]
}'

次の手順

Amazon Advertising logo