開発者ガイドの概要

Amazon Ads APIの概要

パフォーマンスベースのルール

パフォーマンスベースのルールを使用すると、指定した条件が満たされたときに予算を増やす予算ルールを作成できます。たとえば、検索結果上部のインプレッションシェア（IS）が50%を超えた場合に予算を増やすルールを作成できます。

広告タイプ別の利用可能な指標

広告タイプごとに、パフォーマンスベースのルールの設定に使用できる異なる指標がサポートされています。

| 指標 | 説明 | サポートされている広告タイプ | |---------|---------| | ACOS | 特定の期間内に行われた広告クリック数について、あるキャンペーンタイプの広告に対して支払われた料金と広告からの売上の比率。合計広告費を広告に起因する売上で割って算出されます。 | スポンサープロダクト広告、スポンサーディスプレイ広告 | | CTR | キャンペーンのクリックスルー率。その期間のクリック数をインプレッション数で割って計算されます。 | スポンサープロダクト広告、スポンサーディスプレイ広告 | | CVR | コンバージョン率。期間内のクリックに起因するコンバージョン数を、その期間に発生したクリック数で割って計算されます。 | スポンサープロダクト広告、スポンサーディスプレイ広告 | | IS | キャンペーンの検索結果上部のインプレッションシェア。獲得対象となったすべての検索結果上部のインプレッション数のうち、キャンペーンが獲得した検索結果上部のインプレッション数の割合として計算されます。注： ISは、動画クリエイティブを含むキャンペーンの指標としては使用できません。 | スポンサーブランド広告 | | NTB | ブランド新規顧客による現地通貨建ての売上の割合 | スポンサーブランド広告 | | ROAS | 広告費用対効果。Amazon RoASは、広告収益を広告費で割って計算され、広告に投資した1ドルごとにどれだけの収益が得られるかを示します。 | スポンサーブランド広告、スポンサープロダクト広告、スポンサーディスプレイ広告 |

注

出品者様の場合、指標の計算に使用される期間は広告クリックから7日以内です。お取引企業様の場合、指標は広告クリックから14日以内に計算されます。

リクエスト

POST /budgetRulesエンドポイントを使用して、パフォーマンスベースの予算ルールを作成できます。広告タイプごとに個別のエンドポイントがあることに注意してください。

広告タイプ 予算ルールエンドポイントの作成
スポンサープロダクト広告 POST /sp/budgetRules
スポンサーブランド広告 POST /sb/budgetRules
スポンサーディスプレイ広告 POST /sd/budgetRules

パラメーター

  1. ルールタイプ：performance

  2. 開始日： ルールの開始日。

  3. 終了日： このパラメーターはオプションですが、ルールの終了日です。

  4. 繰り返し：

    • daily：ルールは、開始日と終了日に基づいて毎日評価されます。
    • weekly：ルールは、開始日と終了日の間の金曜日や土曜日など、特定の曜日にのみ評価されます。

  5. パフォーマンス測定：パフォーマンスベースのルールでは、次のプロパティを指定する必要があります。

    • 指標名： 各広告タイプで利用できる指標については、広告タイプ別の利用可能な指標をご覧ください。
    • しきい値： 選択したメトリックの数値。たとえば、指標名がNTBで、しきい値が50に設定されている場合、これはブランド新規顧客の売上の50％を占めることになります。
    • 比較演算子：LESS_THAN、GREATER_THAN、EQUAL_TO、LESS_THAN_OR_EQUAL_TO、GREATER_THAN_OR_EQUAL_TOのいずれか。

  6. 予算の増額：1日の予算を増やす割合の金額です。

シナリオ

スポンサーブランド広告： ROASが20%未満の場合は、予算を10%増やします。

この結果を実現するには、指標名にROASを指定してルールを作成し、パフォーマンス測定のしきい値として10%を設定します。次に、ルールをキャンペーンに関連付けます。

  1. 指標名にROASを指定してルールを作成し、POST /sb/budgetRulesを使用してしきい値として10%を設定します。

リクエストボディの例：

{
  "budgetRulesDetails": [
    {
      "name": "SAMPLE_BUDGET_RULE_ROAS",
      "ruleType": "PERFORMANCE",
      "duration": {
        "dateRangeTypeRuleDuration": {
          "startDate": "20201121"
        }
      },
      "recurrence": {
        "type": "DAILY"
      },
      "budgetIncreaseBy": {
        "type": "PERCENT",
        "value": 10
      },
      "performanceMeasureCondition": {
        "metricName": "ROAS",
        "threshold": 20,
        "comparisonOperator": "LESS_THAN_OR_EQUAL_TO"
      }
    }
  ]
}

予想されるHTTPステータスコード： 207

レスポンスボディの例：

{
    "responses": [
        {
            "code": "Ok",
            "details": "Budget rule created",
            "ruleId": "5bc531de-f000-44cf-8a86-54189bcdd380"
        }
    ]
}
  1. POST /sb/campaigns/{campaignId}/budgetRulesを使用して、予算ルールをキャンペーンに関連付けます。

スポンサープロダクト広告： ACOSが20%未満の場合は、予算を10%増やします。

この結果を実現するには、指標名にACOSを指定してルールを作成し、パフォーマンス測定のしきい値として10%を設定します。次に、ルールをキャンペーンに関連付けます。

  1. 指標名にACOSを指定してルールを作成し、POST /sp/budgetRulesを使用してしきい値として10%を設定します。

リクエストボディの例：

{
  "budgetRulesDetails": [
    {
      "name": "SAMPLE_BUDGET_RULE_ACOS",
      "ruleType": "PERFORMANCE",
      "duration": {
        "dateRangeTypeRuleDuration": {
          "startDate": "20201121"
        }
      },
      "recurrence": {
        "type": "DAILY"
      },
      "budgetIncreaseBy": {
        "type": "PERCENT",
        "value": 10
      },
      "performanceMeasureCondition": {
        "metricName": "ACOS",
        "threshold": 20,
        "comparisonOperator": "LESS_THAN_OR_EQUAL_TO"
      }
    }
  ]
}

予想されるHTTPステータスコード： 207

レスポンスボディの例：

{
    "responses": [
        {
            "code": "Ok",
            "details": "Budget rule created",
            "ruleId": "5bc531de-f000-44cf-8a86-54189bcdd380"
        }
    ]
}
  1. POST /sp/campaigns/{campaignId}/budgetRulesを使用して、予算ルールをキャンペーンに関連付けます。

スポンサーディスプレイ広告： ACOSが20%未満の場合は、予算を10%増やします。

この結果を実現するには、指標名にACOSを指定してルールを作成し、パフォーマンス測定のしきい値として10%を設定します。次に、ルールをキャンペーンに関連付けます。

  1. 指標名にACOSを指定してルールを作成し、POST /sd/budgetRulesを使用してしきい値として10%を設定します。

リクエストボディの例：

{
  "budgetRulesDetails": [
    {
      "name": "SAMPLE_BUDGET_RULE_ACOS",
      "ruleType": "PERFORMANCE",
      "duration": {
        "dateRangeTypeRuleDuration": {
          "startDate": "20201121"
        }
      },
      "recurrence": {
        "type": "DAILY"
      },
      "budgetIncreaseBy": {
        "type": "PERCENT",
        "value": 10
      },
      "performanceMeasureCondition": {
        "metricName": "ACOS",
        "threshold": 20,
        "comparisonOperator": "LESS_THAN_OR_EQUAL_TO"
      }
    }
  ]
}

予想されるHTTPステータスコード： 207

レスポンスボディの例：

{
    "responses": [
        {
            "code": "Ok",
            "details": "Budget rule created",
            "ruleId": "5bc531de-f000-44cf-8a86-54189bcdd380"
        }
    ]
}
  1. POST /sd/campaigns/{campaignId}/budgetRulesを使用して、予算ルールをキャンペーンに関連付けます。

最低限の予算

パフォーマンスルールは、キャンペーンのクリック数とコンバージョン数に基づいて指標を生成します。必要最小限の予算は、キャンペーンに十分なトラフィックが生じる可能性を高め、指標を評価できるようにするためのものです。

Amazon Advertising logo