スポンサープロダクト広告の商品ターゲティングの概要

マニュアルスポンサープロダクト広告キャンペーンでは、ターゲティング項目を少なくとも1つ追加する必要があります。キーワードターゲティングまたは製品ターゲティング（このドキュメントで説明）のいずれかを使用できます。ターゲティングは広告グループレベルで割り当てられます。広告グループ内のすべての商品には同じターゲティング項目があります。

商品ターゲティングは、商品、カテゴリー、またはブランドレベルで適用できます。たとえば、特定のランニングシューズ商品をASINでターゲットにしたり、カテゴリーIDを使用してランニングシューズをカテゴリーとしてターゲットにできます。

キャンペーンの構造に関する詳細については、キャンペーン階層をご覧ください。

始める前に

商品ターゲティングエクスプレッションを作成する前に、以下を行う必要があります。

リクエスト

エンドポイント

POST sp/targets

個々の商品のターゲティング

個々の商品をターゲットにする場合は、特定のASINのみをターゲットにすることも、特定のASINとその他の類似ASIN（代替商品、補完商品、その他の関連商品など）をターゲットにすることも可能です。拡張されたASINターゲティングの詳細については、広告コンソールのヘルプセンターをご覧ください。

パラメーター

| 名前 | 任意 | タイプ | 説明 | |--- |--- |--- |--- | | campaignId | いいえ | number | ターゲティングエクスプレッションを関連付けるキャンペーン。 | | adGroupId | いいえ | String | キャンペーンを関連付ける広告グループ。 | | expression.type | いいえ | string | 商品をターゲットにする場合は、必ずASIN_SAME_AS（特定のASINのみをターゲットにする）またはASIN_EXPANDED_FROM（特定のASINとその他の類似ASINをターゲットにする）に設定します。 | | expression.value | いいえ | string | ターゲットにする商品のASIN。どのASINをターゲットにすべきか確かでない場合は、商品の推奨事項エンドポイントを使用してください。 | | expressionType | いいえ | string | 必ずMANUALに設定します。 | | state | いいえ | string | ターゲティングエクスプレッションの状態、ENABLEDまたはPAUSEDのいずれか。 | | bid | はい | float | エクスプレッションの入札額。指定しない場合は、広告グループ入札額が使用されます。入札額に何を使用すればよいかわからない場合は、入札額に関する推奨事項エンドポイントを試してください。 |

例

1つのASIN

この例では、ASIN B07FKDZPZWの商品ターゲティングエクスプレッションを作成します。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--header 'Prefer: return=representation' \
--data-raw '{
  "targetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B07FKDZPZW"
        }
      ],
      "campaignId": "123456789",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "987654321"
    }
  ]
}'

複数のASIN

ターゲティング項目ごとに追加可能なASINは1つのみです。複数のASINをターゲットにする場合は、2つのターゲティング項目を作成する必要があります。

{
  "targetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B07YT8NVF9"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    },
    {
      "expression": [
        {
          "type": "ASIN_SAME_AS",
          "value": "B09LJWZT6G"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 2.50,
      "adGroupId": "169462822148652"
    }
  ]
}

ASINおよび関連商品

この例では、ASIN B07YT8NVF9、およびその他の関連ASINのターゲティングエクスプレッションを作成します。

{
  "targetingClauses": [
    {
      "expression": [
        {
          "type": "ASIN_EXPANDED_FROM",
          "value": "B07YT8NVF9"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    }
}

商品カテゴリーのターゲティング

商品カテゴリーのターゲティングエクスプレッションを作成すると、単一のASINのエクスプレッションよりも多くの絞り込みが可能になります。

パラメーター

| 名前 | 任意 | タイプ | 説明 | |--- |--- |--- |--- | | campaignId | いいえ | number | ターゲティングエクスプレッションを関連付けるキャンペーン。 | | adGroupId | いいえ | String | キャンペーンを関連付ける広告グループ。 | | expression.type | いいえ | string | 以下のサポートされるエクスプレッションタイプの表をご覧ください。少なくとも、ASIN_CATEGORY_SAME_ASを含める必要があります。詳細については、以下のサポートされるエクスプレッションタイプの表をご覧ください。 | | expression.value | いいえ | string | 値はエクスプレッションタイプによって異なります。詳細については、以下の表をご覧ください。 | | expressionType | いいえ | string | 必ずMANUALに設定します。 | | state | いいえ | string | ターゲティングエクスプレッションの状態、ENABLEDまたはPAUSEDのいずれか。 | | bid | はい | float | エクスプレッションの入札額。指定しない場合、エクスプレッションでは広告グループ入札額が使用されます。入札額に何を使用すればよいかわからない場合は、入札額に関する推奨事項エンドポイントを試してください。 |

サポートされるエクスプレッションタイプ

すべてのカテゴリーターゲティングエクスプレッションにASIN_CATEGORY_SAME_ASを含める必要があります。カテゴリーに基づいてさまざまな絞り込みが可能です。どのような絞り込みが可能かを確認するには、商品カテゴリーターゲティングの推奨事項と絞り込みをご覧ください。

| 述語 | 説明 | 値の例 | |--- |--- |--- | | ASIN_CATEGORY_SAME_AS | 表示されているカテゴリーと同じカテゴリーを除外ターゲットにします。値はカテゴリーIDです。 | 11056341 | | ASIN_BRAND_SAME_AS | 表示されているブランドと同じブランドをターゲットにします。値はブランドIDです。 | 7048034011 | | ASIN_PRICE_LESS_THAN | 表示されている価格よりも低い価格をターゲットにします。値は口座通貨での価格です。 | 20.5 | | ASIN_PRICE_BETWEEN | 表示されている価格の中間の価格をターゲットにします。値は口座通貨での2つの価格をハイフンで区切ったものです。 | 10.5-12.5 | | ASIN_PRICE_GREATER_THAN | 表示されている価格よりも高い価格をターゲットにします。値は口座通貨での価格です。 | 10.75 | | ASIN_REVIEW_RATING_LESS_THAN | 表示されているレビュー評価よりも低いレビュー評価をターゲットにします。値は5未満の数値です。 | 4 | | ASIN_REVIEW_RATING_BETWEEN | 表示されているレビュー評価の中間にあるレビュー評価をターゲットにします。 | 4～5 | | ASIN_REVIEW_RATING_GREATER_THAN | 表示されているレビュー評価よりも高いレビュー評価をターゲットにします。値は1より大きい数値です。 | 3 | | ASIN_IS_PRIME_SHIPPING_ELIGIBLE | Amazonプライム配送の対象となる商品をターゲットにします。この絞り込みは、カテゴリーまたはブランドレベルでのみ適用できます。値はブール値です。 | TRUE | | ASIN_AGE_RANGE_SAME_AS | 表示されている範囲内の年齢層をターゲットにします。この絞り込みは、おもちゃとゲームのカテゴリーにのみ適用できます。値は年齢範囲IDです。 | 165890011 | | ASIN_GENRE_SAME_AS | 値はジャンルIDです。 | 1235687 |

例

絞り込みなしのカテゴリー

この例は、絞り込みなしでカテゴリー全体をターゲットにするエクスプレッションを示しています。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--data-raw '{
  "targetingClauses": [
    {
      "expression": [
        {
            "type":"ASIN_CATEGORY_SAME_AS",
            "value":"2522102011"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    }
  ]
}'

絞り込みのあるカテゴリー

この例は、複数の絞り込み（ブランドと評価）のあるターゲティングエクスプレッションを作成する方法を示しています。絞り込みを使用する場合は、最初にカテゴリーを定義する必要があります。

curl --location --request POST 'https://advertising-api.amazon.com/sp/targets' \
--header 'Amazon-Advertising-API-ClientId: amzn1.application-oa2-client.xxxxxxxxxxxx' \
--header 'Authorization: Bearer Atza|xxxxxxxxxxx' \
--header 'Amazon-Advertising-API-Scope: xxxxxxxxxx' \
--header 'Prefer: return=representation' \
--header 'Accept: application/vnd.spTargetingClause.v3+json' \
--header 'Content-Type: application/vnd.spTargetingClause.v3+json' \
--data-raw '{
  "targetingClauses": [
    {
      "expression": [
        {
            "type":"ASIN_CATEGORY_SAME_AS",
            "value":"2522102011"
        },
        {
          "type": "ASIN_BRAND_SAME_AS",
          "value": "7048034011"
        },
        {
          "type": "ASIN_REVIEW_RATING_BETWEEN",
          "value": "3-4.5"
        }
      ],
      "campaignId": "26256301417055",
      "expressionType": "MANUAL",
      "state": "ENABLED",
      "bid": 1.50,
      "adGroupId": "169462822148652"
    }
  ]
}'

レスポンス

リクエストが成功すると、作成した各ターゲット項目の個別のステータスメッセージを含む207レスポンスが返されます。成功配列に、作成予定のオブジェクトがすべて含まれていることを確認する必要があります。失敗はすべてエラー配列に示されます。

ID（カテゴリーID、ブランドID、年齢層ID、またはジャンルID）を含むカテゴリーターゲティングエクスプレッションの場合、解決されたエクスプレッションオブジェクトにはそのIDに関連する読みやすい説明が含まれます。

ヒント

リクエストのターゲティングオブジェクト全体を返したい場合、ヘッダーにPrefer: return=representationを含めるようにしてください。

例

{
  "targetingClauses": {
    "error": [],
    "success": [
      {
        "index": 0,
        "targetId": "269280454302686",
        "targetingClause": {
          "adGroupId": "169462822148652",
          "bid": 1.5,
          "campaignId": "26256301417055",
          "expression": [
            {
              "type": "ASIN_SAME_AS",
              "value": "B07FKDZPZW"
            }
          ],
          "expressionType": "MANUAL",
          "resolvedExpression": [
            {
              "type": "ASIN_SAME_AS",
              "value": "B07FKDZPZW"
            }
          ],
          "state": "ENABLED",
          "targetId": "269280454302686"
        }
      }
    ]
  }
}

開発者ガイドの概要

Amazon Ads APIの概要

スポンサープロダクト広告の商品ターゲティングの概要

始める前に

リクエスト

エンドポイント

個々の商品のターゲティング

パラメーター

例

商品カテゴリーのターゲティング

パラメーター

サポートされるエクスプレッションタイプ

例

レスポンス

ヒント

例