開発者ガイドの概要

Amazon Ads APIの概要

スポンサーディスプレイ広告のオーディエンスキャンペーンを作成する方法

このハウツーでは、スポンサーディスプレイ広告キャンペーンを作成する手順を説明します。

前提条件

こちらの設定手順に従ってください。以前にスポンサーディスプレイ広告Postmanコレクションを設定している場合は、これらの手順をスキップできます。

手順

アクセストークンを取得する

新しいアクセストークンを取得するには、次の手順を実行します。アクセストークンをすでに取得しているものの、有効期限が切れている場合は、OAuth Refresh Tokenリクエストを使用して、期限切れのアクセストークンを置き換えることができます。それ以外の場合は、この手順の指示に従ってください。

  1. コレクションタブで、「Amazon SD API（AUDT）」を選択してサブフォルダーを展開します。

  2. サブフォルダーで「OAuth」を選択します。

  3. 「GET OAuth Access Code」リクエストを選択します。

  4. 「送信」ボタンを選択してリクエストを送信します。

  5. 応答として、ログインフォームが入力されたWebページが表示されます。「プレビュー」を選択します。

  6. 「OAuthフォームログイン」を選択して、フォームログインをシミュレートします。これには、以前に環境で構成したEメールアドレスとパスワードが使用されます。初めてログインする場合は、権限を付与するための同意ページにリダイレクトされます。

  7. OAuthフォームログインでは認証コードが返されます。このコードは、redirect_uriに返される中間コードです。Postmanスクリプトでは、次の手順のためにこの値が正しい変数にコピーされます。

  8. OAuth Code to Tokenリクエストを開きます。「送信」を選択します。応答には、アクセストークンとリフレッシュトークンが含まれます。例：

    {
    "access_token": "<access_token>",
    "refresh_token": "<refresh_token>",
    "token_type": "bearer",
    "expires_in": 3600
}

  9. Amazon-Advertising-API-Scopeヘッダーの値も必要です。「GET profile information」リクエストを選択し、「送信」を選択します。応答には、profileIdフィールドの値が含まれます。

スポンサーディスプレイ広告キャンペーンを作成する

Postmanを使用してスポンサーディスプレイキャンペーンを作成するには、次の手順に従ってください。

  1. Postmanコレクションで、1つ以上のキャンペーンの作成リクエストを開きます。「本文」タブを選択し、キャンペーンに合わせてフィールド値を変更します。例：

    [{
"name": "My Audiences Campaign",
"tactic": "T00030",
"startDate": "20200810",
"endDate": "20301201",
"state": "enabled",
"budget": 100.00,
"budgetType": "daily",
"costType": "cpc"
}]

  2. 「送信」ボタンをクリックして、リクエストが完了したことを確認します。例：

    [
{
    "campaignId": 222756009537583,
    "code": "SUCCESS"
}
]

  3. 後続のリクエストを開きます。リクエストされたキャンペーンを取得し、「送信」を選択します。前の応答のcampaignIdの値は、後続のリクエストに自動的にコピーされます。

    {
    "campaignId": 222756009537583,
    "name": "My Audiences Campaign 2",
    "tactic": "T00030",
    "startDate": "20200812",
    "endDate": "20301201",
    "state": "paused",
    "budget": 100.00,
    "budgetType": "daily",
    "costType": "cpc",
    "deliveryProfile": "as_soon_as_possible"
}

  4. 同じ手順を繰り返し、残りのコンポーネントを作成のうえ取得します。

  1. GET Gets a targeting clause specified by identifier.からの最終的な応答は次のようになります。

    {
    "adGroupId": 209426065354910,
    "bid": 0.25,
    "expression": [
        {
            "type": "views",
            "value": [
                {
                    "type": "similarProduct"
                },
                {
                    "type": "lookback",
                    "value": "30"
                }
            ]
        }
    ],
    "expressionType": "manual",
    "resolvedExpression": [
        {
            "type": "views",
            "value": [
                {
                    "type": "similarProduct"
                },
                {
                    "type": "lookback",
                    "value": "30"
                }
            ]
        }
    ],
    "state": "enabled",
    "targetId": 235944225366139
}

スポンサーディスプレイ広告APIを使用して既存のキャンペーンを変更する

スポンサーディスプレイ広告キャンペーンを変更して、値の更新やリソースの削除が可能です。Amazon SD APIコレクション内のModify Campaignsフォルダーを展開してこれらのリクエストを試し、要件に基づいてキャンペーンを変更します。各コンポーネントには、PUT（更新）リソースとDELETE（アーカイブ）リソースが含まれています。

レポート

また、レポートのリクエストやダウンロードを通じて、キャンペーンのパフォーマンスに関する詳細な指標を把握することもできます。Reportフォルダーを展開し、リクエストを確認します。

Postmanを使用してスポンサーディスプレイ広告キャンペーンのテストを自動化する

前のセクションでは、スポンサーディスプレイ広告APIを手動で呼び出してキャンペーンを作成しました。また、Postmanコレクションランナーを使用してキャンペーンを一括作成するなど、キャンペーンの作成を自動化することもできます。

  1. Postmanで、左上隅にある「ランナー」ボタンを選択します。新しいウィンドウが開きます。
  2. コレクションランナーで、「Amazon SD API（AUDT）」コレクションを選択します。
  3. 環境では、「Amazon SD API」を選択します。
  4. 実行順序では、「すべて」の選択を解除します。次に、OAuthリフレッシュトークンから始まるすべてのリクエストを選択します。これは有効なアクセストークンを持っていることを前提としています。そうでない場合は、前のセクションで説明したように、手動でOAuthリクエストを行ってアクセストークンを取得できます。
  5. 1つ以上のキャンペーンの作成リクエストを開きます。固有の名称を入力します。固有の名称を入力しない場合はキャンペーン名が重複するため、最初の呼び出しに失敗します。
  6. 「Amazon SD APIを実行」を選択します。
  7. 結果を確認します。結果が想定通りであれば、スポンサーディスプレイ広告キャンペーンの作成は正常に自動化されています。

まとめ

このチュートリアルでは、オーディエンスAPIを使用してキャンペーンを作成および更新する方法をご紹介しました。これにより、オーディエンスをターゲットにして、商品の認知向上や売上拡大につなげることができます。

Amazon Advertising logo