開発者ガイドの概要

Amazon Ads APIの概要

キャンペーンの開始

始める前に

ヒント

広告費なしで、スポンサーブランド広告キャンペーンの作成手順を試したい場合は、テストアカウントを作成し、このチュートリアルでご利用ください。

手順1： キャンペーンを作成する

最初の手順では、POST /sb/v4/campaignsエンドポイントを使用してキャンペーンを作成します。

入札戦略はキャンペーンレベルで指定できます。入札は、Amazonが検索結果ページの上部以外の掲載枠への入札額を自動で最適化したり、カスタム入札調整を指定したりすることで行うことができます。

注

出品者様は、ブランドが承認されている場合、brandEntityIdを入力する必要があります。brandEntityIdはGET /brands endpoint呼び出すことで取得できます。

自動入札によるサンプルリクエスト

bidOptimizationがtrueに設定されている場合、Amazonは適切な掲載枠調整入札額を自動的に設定します。

curl --location --request POST 'https://advertising-api.amazon.com/sb/v4/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxxx' \
--header 'Accept: application/vnd.sbcampaignresource.v4+json' \
--data-raw'{
"campaigns": [{
    "budgetType": "DAILY",
    "name": "My campaign",
    "state": "PAUSED",
    "startDate": "2023-06-25",
    "budget": 10,
    "bidding": {
        "bidOptimization": "true"
    }
}]
}
'

カスタム入札によるサンプルリクエスト

bidAdjustmentsByShopperSegmentオブジェクトがリクエストに含まれている場合は、貴社のブランドから商品を購入していない新規のお客様が広告に反応する毎に、入札額を引き上げる割合を指定できます。bidAdjustmentsByPlacementオブジェクトを含めると、ページの広告掲載枠に応じて入札額を増減する割合を指定できます。両方のオブジェクトを指定した場合、入札額調整は乗算されます。bidOptimizationStrategyパラメーターのデフォルトは、販売を最大化するように最適化されています。もう1つのオプションは、ブランド新規顧客の獲得に基づいて最適化することです。

curl --location --request POST 'https://advertising-api.amazon.com/sb/v4/campaigns' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxxx' \
--header 'Accept: application/vnd.sbcampaignresource.v4+json' \
--data-raw'{
"campaigns": [{
    "budgetType": "DAILY",
    "name": "My campaign",
    "state": "PAUSED",
    "startDate": "2023-06-30",
    "budget": 10,
    "bidding": {
        "bidOptimization": "false",
        "bidAdjustmentsByShopperSegment": [{
            "percentage": 200,
            "shopperSegment": "NEW_TO_BRAND_PURCHASE"
        }],
        "bidAdjustmentsByPlacement": [{
                "percentage": 20,
                "placement": "HOME"
            },
            {
                "percentage": 15,
                "placement": "DETAIL_PAGE"
            },
            {
                "percentage": 15,
                "placement": "OTHER"
            }
        ],
        "bidOptimizationStrategy": "MAXIMIZE_NEW_TO_BRAND_CUSTOMERS"
    }
}]
}
}
'

手順2： 広告グループを作成する

POST /sb/v4/adGroupsエンドポイントを使用して、広告グループを1つ以上作成します。手順1で返されたcampaignIdを使用して広告グループを作成します。

サンプルリクエスト

このサンプルリクエストでは、1件のキャンペーンに紐づけられた広告グループを作成します。呼び出しが完了すると、207レスポンスコードが返され、作成された広告グループのadGroupIdが示されます。

curl --location --request POST 'https://advertising-api.amazon.com/sb/v4/adGroups' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxxxxx' \
--header 'Accept: application/vnd.sbadgroupresource.v4+json' \
--data-raw '{
"adGroups": [{
    "campaignId": "{{campaignId}}",
    "name": "My ad group name",
    "state": "ENABLED"
}]
}
'

手順3： アセットをアップロードして登録する

広告を作成する前に、クリエイティブアセットライブラリAPIを使用して、動画アセットや画像アセットをアップロードのうえ登録できます。

手順4： 広告を作成する

前の手順でassetIdを取得したら、広告を作成できます。広告タイプには、商品コレクション、動画、ブランド動画、ストアスポットライトがあります。広告グループには1つ以上の広告が必要であり、1つの広告グループに複数の広告タイプを含めることはできません。

各広告タイプの要件について、詳しくは以下をご覧ください。

手順5： 広告グループにターゲティングを追加する

広告グループに広告を作成した後、ターゲティングを追加する必要があります。広告グループは、商品またはキーワードのターゲティングエクスプレッションに紐づけることが可能です。

手順6： 審査の状況を確認する

広告の審査状況を確認するには、モデレーションAPIでadIdをidとして渡します。

手順7： 広告やクリエイティブを更新する

審査の状況によっては、広告やクリエイティブに変更が必要となる場合があります。詳細については、アセットの管理およびキャンペーンの管理をご覧ください。

Amazon Advertising logo