開発者ガイドの概要

Amazon Ads APIの概要

推奨機能を使用してスポンサーディスプレイ広告キャンペーンを最適化する

このチュートリアルでは、推奨機能を使用してスポンサーディスプレイ広告キャンペーンを作成および更新する手順について説明します。

前提条件

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

手順

推奨APIはOAuthを使用して保護されているので、有効なアクセストークンが必要です。次の手順を実行する必要があります。

  1. アクセストークンを取得する
  2. 推奨サービスを呼び出す
  3. スポンサーディスプレイ広告キャンペーンを作成または更新する

手順1：アクセストークンを取得する

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

  1. 「collections」タブで、「Amazon SD API (Contextual)」を選択してサブフォルダーを展開します。

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

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

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

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

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

  7. 「OAuth Form Login」から認可コードが返されます。このコードは、redirect_uriに返される中間コードです。Postmanスクリプトにより、次の手順のためにこの値が正しい変数にコピーされます。

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

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

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

ステップ2：推奨サービスを呼び出す

Postmanコレクションを使用して、推奨APIを呼び出します。

  1. 「collections」タブで、「Amazon SD API Recommendations」を選択し、「Recommendations」サブフォルダーを展開します。

  2. 「SD Product Recommendations」の操作を選択します。

  3. 「Body」タブを選択し、以下のproducts配列内のASINを置換してペイロードを変更します。

    {
    "tactic": "T00020",
    "products": [
        {
            "asin": "B015FK1EH2"
        }
    ],
    "typeFilter": [
        "PRODUCT"
    ]
}

注： 同じオブジェクト構造を使用して、products配列内に複数のASINを指定することができます。

  1. 「Send」をクリックします。応答で、一連の推奨商品のASINがランク順に返されます。
  2. 「Tests」タブをクリックしてコードを確認します。8行目のランク番号が、変数targetASINに保存するASINを指定しています。この値を変更して、別のランク番号を使用することができます。
  3. 「Get Amazon ASIN Details」リクエストを開いて、推奨ASINのAmazon商品詳細ページを呼び出します。応答で「Pretty」タブを「Preview」に切り替えて、Webページを確認します。

ステップ3：スポンサーディスプレイ広告キャンペーンを作成または更新する

Postmanを使用してスポンサーディスプレイ広告キャンペーンを作成するには、ターゲット項目の作成を除き、こちらのチュートリアルの手順に従ってください。以下の手順で、推奨ASINからターゲット項目を作成できます。

  1. 「Amazon SD API (Contextual)」コレクションを開き、「body」タブを選択し、キャンペーンを反映するようにフィールド値を変更します。具体的には、expressionオブジェクトのvalue属性を{{targetASIN}}に変更します。{{targetASIN}}の値は、前のリクエストから自動的にコピーされます。同じリクエストを使用し、推奨ASINを使用したターゲット項目を指定して、既存のキャンペーンを更新します。

    [
    {
        "adGroupId": "{{adGroupId}}",
        "state": "enabled",
        "expressionType": "manual",
        "expression": [
            {
                "type": "asinSameAs",
                "value": "{{targetASIN}}"
            }
        ]
    }
]

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

    [
{
    "targetId": 111222333444555,
    "code": "SUCCESS"
}
]

  3. 以下を使用して、あまり効果的でない既存のターゲット項目を削除できます。

    DELETE /sd/targets/222333444555666 HTTP/1.1

この方法を使用すると、キャンペーンのパフォーマンスと商品推奨機能の組み合わせに基づき、あまり効果的でないターゲット項目を削除することで、ターゲット項目をプログラムで最適化できます。

概要

このチュートリアルでは、商品推奨APIを使用してキャンペーンを作成して更新し、キャンペーンの目標に基づいてキャンペーンのパフォーマンスを最適化する方法を学習しました。

Amazon Advertising logo