スポンサープロダクト広告の広告グループ

広告グループの作成

広告グループを使用することで、キャンペーン内の商品パフォーマンスを整理、管理、追跡できます。同じ広告グループに入っている商品は、同じ入札額とターゲティング（キーワードや商品）が適用されます。各キャンペーンは、1つ以上の広告グループで構成されます。

始める前に

広告グループを作成するには、まずキャンペーンを作成のうえ、campaignIdを取得する必要があります。キャンペーン作成の詳細については、スポンサープロダクト広告キャンペーンをご覧ください。

ベストプラクティス

**広告グループ名：**分かりやすく、意味のある広告グループ名を設定します。キャンペーン内で固有の広告グループ名を設定する必要がありますが、異なるキャンペーンであれば同じ広告グループ名を使用することができます。広告グループ名はキャンペーンマネージャーでの表示にのみ使用され、お客様には表示されません。
キーワードまたは商品ターゲティング：
- オートターゲティングキャンペーンでは、除外キーワードターゲティングと除外商品ターゲティングを広告グループに適用できます。Amazonによって、ターゲティングエクスプレッションとキーワードが割り当てられます。
- マニュアルターゲティングキャンペーンでは、広告グループ内のすべての商品に共通のキーワードまたは商品ターゲットのグループを適用できます。Amazonの推奨キーワード、独自のキーワード、除外キーワード、または商品別のターゲットを使用できます。
**入札額の初期値：**子エンティティに明示的に入札額を設定しない場合は、広告グループのすべての子エンティティ（キーワード、ターゲティングエクスプレッションなど）にデフォルトの入札額が適用されます。たとえば、キーワードの子エンティティに設定済みの入札額が含まれていない場合、そのキーワードには広告グループのデフォルトの入札額が適用されます。詳細については、スポンサープロダクト広告キャンペーンの構造をご覧ください。

リクエスト

エンドポイント

POST /sp/adGroups

例

このサンプルをコピーする場合は、必ず実際のクライアントID、アクセストークン、キャンペーンID、プロフィールIDを入力してください。

curl --location --request POST 'https://advertising-api.amazon.com/sp/adGroups' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxx' \
--header 'Authorization: Bearer xxxxxxxx' \
--header 'Accept: application/vnd.spAdGroup.v3+json' \
--header 'Content-Type: application/vnd.spAdGroup.v3+json' \
--data-raw '[
  {
    "name": name,
    "campaignId": 153839444046652,
    "defaultBid": "3.0",
    "state": "enabled"
  }
]'

応答

成功した応答では、207応答コードが返されます。広告グループの作成時にエラーメッセージが発生した場合は、error配列にエラーメッセージが含まれています。success配列では、adGroupIdを含む広告グループオブジェクトが返されます。

 {
    "adGroups": {
        "error": [],
        "success": [
            {
                "adGroup": {
                    "adGroupId": "38308592845076",
                    "name": "adGroupTest"
                },
                "adGroupId": "38308592845076",
                "index": 0
            }
        ]
    }
}

次のステップ

プロダクト広告の作成

開発者ガイドの概要

Amazon Ads APIの概要