開発者ガイドの概要

Amazon Ads APIの概要

Developer guides

API reference

スポンサーディスプレイ広告のコンテキストターゲティングキャンペーンを作成する方法

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

前提条件

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

手順

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

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

  1. コレクションタブで、「Amazon SD API（コンテキスト）」を選択してサブフォルダーを展開します。
  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
}
  1. Amazon-Advertising-API-Scopeヘッダーの値も必要です。「GET profile information」リクエストを選択し、「送信」を選択します。応答には、profileIdフィールドの値が含まれます。

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

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

  1. Postmanコレクションで、1つ以上のキャンペーンの作成リクエストを開きます。「本文」タブを選択し、キャンペーンに合わせてフィールド値を変更します。例：
[{
  "name": "My Contextual Targeting Campaign",
  "tactic": "T00020",
  "startDate": "20200810",
  "endDate": "20301201",
  "state": "enabled",
  "budget": 100.00,
  "budgetType": "daily",
  "costType": "cpc"
}]
  1. 「送信」ボタンをクリックして、リクエストが完了したことを確認します。例：
[
  {
    "campaignId": 222756009537583,
    "code": "SUCCESS"
  }
]
  1. 後続のリクエストを開きます。リクエストされたキャンペーンを取得し、「送信」を選択します。前の応答のcampaignIdの値は、後続のリクエストに自動的にコピーされます。
{
    "campaignId": 222756009537583,
    "name": "My Contextual Targeting Campaign 2",
    "tactic": "T00020",
    "startDate": "20200812",
    "endDate": "20301201",
    "state": "paused",
    "budget": 100.00,
    "budgetType": "daily",
    "costType": "cpc",
    "deliveryProfile": "as_soon_as_possible"
}
  1. 同じ手順を繰り返して、残りのコンポーネントを作成して取得します。
  1. GET Gets a targeting clause specified by identifier.からの最終的な応答は次のようになります。
{
    "adGroupId": 12345678900000,
    "expression": [
        {
            "type": "asinSameAs",
            "value": "B07V5HK595"
        }
    ],
    "expressionType": "manual",
    "resolvedExpression": [
        {
            "type": "asinSameAs",
            "value": "B07V5HK595"
        }
    ],
    "state": "enabled",
    "targetId": 1234567890
}

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

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

レポート

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

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

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

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

まとめ

このチュートリアルでは、オーディエンスAPIを使用してキャンペーンを作成および更新する方法を学びました。これにより、オーディエンスをターゲットにして商品の認知度を高め、売り上げを伸ばすことができます。

Amazon Advertising logo