開発者ガイドの概要

Amazon Ads APIの概要

スポンサープロダクト広告キャンペーン

キャンペーンは、スポンサープロダクト広告エンティティ階層の最上位レベルです。キャンペーンのその他の構成要素について詳しくは、キャンペーン階層をご覧ください。

予算、ターゲットタイプ、開始日、終了日はすべてキャンペーンレベルで定義されます。

詳細はこちら

リクエスト

エンドポイント

POST /sp/campaigns

パラメーター

| 名前 | 説明 | |--- |--- | | portfolioId | ポートフォリオを使用すると、広告主様は、ビジネスニーズに基づいたグループにキャンペーンを編成することができます。ポートフォリオの詳細、またはポートフォリオの作成方法をご覧ください。 | | name | キャンペーンの名前。このフィールドのべき等性は、出品者様とお取引会社様では動作が異なることに注意してください。出品者様はキャンペーン名を重複させることはできませんが、お取引会社様はキャンペーン名を重複させることができます。 | | targetingType | 選択肢は、MANUALまたはAUTOのどちらかです。詳しくは、オートキャンペーンおよびマニュアルキャンペーンをご覧ください。 | | state | 選択肢は、ENABLEDまたはPAUSEDです。キャンペーンをすぐに配信しない場合は、stateをPAUSEDに設定してください。 | | budget.budgetType | サポートされる唯一の値はDAILYです。 | | budget.budget | プロフィールの通貨単位による金額。指定できる最大予算と最小予算は、地域によって異なります。詳しくは、マーケットプレイスごとの予算の制約をご覧ください。 | | startDate | YYYY-MM-DD形式のキャンペーンの開始日。この日付を過去の日付にすることはできません。注： 今日に設定し、stateを「ENABLED」に設定した場合、有効な広告グループ、商品広告、ターゲティング項目またはキーワードがキャンペーンに設定されるとすぐにキャンペーンの配信が開始されます。 | | endDate | キャンペーンの終了日。指定しない場合、終了日のないキャンペーンになります。 | | dynamicBidding.strategy | キャンペーンの入札戦略。指定できる値は、LEGACY_FOR_SALES、AUTO_FOR_SALES、MANUAL、およびRULE_BASEDです。入札戦略の詳細はこちら。 | | dynamicBidding.placementBidding.percentage | 指定した掲載枠への入札額を調整するパーセンテージ。 | | dynamicBidding.placementBidding.placement | 入札額を調整するAmazon.comの掲載枠。掲載枠の詳細はこちら。 | | tags | 管理またはレポートの目的でキャンペーンに追加できるオプションのタグ。 |

例

マニュアルキャンペーン

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxx' \
--header 'Accept: application/vnd.spCampaign.v3+json' \
--header 'Content-Type: application/vnd.spCampaign.v3+json' \
--data-raw '{
  "campaigns": [
    {
      "endDate": "2022-11-08",
      "name": "Test manual targeting SP campaign",
      "targetingType": "MANUAL",
      "state": "ENABLED",
      "dynamicBidding": {
        "placementBidding": [
          {
            "percentage": 900,
            "placement": "PLACEMENT_TOP"
          }
        ],
        "strategy": "LEGACY_FOR_SALES"
      },
      "startDate": "2022-10-31",
      "budget": {
        "budgetType": "DAILY",
        "budget": 100
      }
    }
  ]
}'

オートキャンペーン：

curl --location --request POST 'https://advertising-api.amazon.com/sp/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxx' \
--header 'Accept: application/vnd.spCampaign.v3+json' \
--header 'Content-Type: application/vnd.spCampaign.v3+json' \
--data-raw '{
  "campaigns": [
    {
      "endDate": "2022-11-08",
      "name": "Test SP auto campaign",
      "targetingType": "AUTO",
      "state": "ENABLED",
      "dynamicBidding": {
        "placementBidding": [
          {
            "percentage": 900,
            "placement": "PLACEMENT_TOP"
          }
        ],
        "strategy": "LEGACY_FOR_SALES"
      },
      "startDate": "2022-10-31",
      "budget": {
        "budgetType": "DAILY",
        "budget": 100
      }
    }
  ]
}'

レスポンス

呼び出しが成功すると、レスポンスコード207が返され、作成されたキャンペーンのインデックスとキャンペーンIDが示されます。

{
    "campaigns": {
        "error": [],
        "success": [
            {
                "campaignId": "218293333782035",
                "index": 0
            }
        ]
    }
}

ヒント

レスポンスでキャンペーンオブジェクト全体を受け取りたい場合は、Preferヘッダーをreturn=representationに設定して使用します。

次のステップ

キャンペーンの作成が完了したら、広告グループを少なくとも1つ作成する必要があります。

Amazon Advertising logo