AmazonアトリビューションAPIの使用を開始する
AmazonアトリビューションAPIの使用を開始するには、まず次のことを行う必要があります。
- Advertising API開発者アカウントをセットアップします。
- 利用資格を持つ広告主のAmazon Adsアカウントの認可またはアクセス権を取得します。
承認を得るには次の3つの方法があります。
- **推奨されるアプローチ:**ユーザーがOAuth Login With Amazonアプリケーションを作成します。広告主はそれを使用して広告主プロフィールへのアクセスをユーザーに許可することができます。
- 広告主が、ユーザーのAPI開発者アカウントに関連付けられたEメールアドレスを使用して、広告コンソールアカウントにユーザーを招待します。
- 広告主が、ユーザーのAPI開発者アカウントに関連付けられたEメールアドレスを使用して、広告コンソールアカウントにリンクされているマネージャーアカウントにユーザーを招待します。
認可とアクセス権
Amazon Ads APIの認証情報の詳細については、オンボーディングの概要を参照してください。
上記の要件を満たしたら、AmazonアトリビューションAPIを使用して、広告主に関連付けられた以下のリソースを読み取ることができます。
- プロファイル
- パブリッシャー
- アトリビューションタグ
- レポート
DSPから広告コンソールへのAmazonアトリビューションの移行に関する注意事項
Amazonアトリビューションの利用資格を持つ広告主様は、スポンサープロダクト広告、スポンサーブランド広告、スポンサーディスプレイ広告、ストアなどの他のセルフサービス広告プロダクトに加えて、Amazonアトリビューションに広告コンソールからアクセスできます。
従来のAmazonアトリビューションアカウントにウェブブラウザインターフェイスからアクセスすることはできなくなりましたが、APIでは通常どおり機能します。従来のアカウントを持つ広告主様は、データを広告コンソールアカウントにすでに移行しているはずです。アカウントの移行に関するサポートが必要な場合は、広告コンソールのヘルプセンターを使用してAmazon Advertisingサポートにお問い合わせください。
APIインテグレーターが簡単に移行できるように、AmazonアトリビューションAPIでは、従来のプロフィールと広告プロフィールの両方に同じAPIエンドポイントを使用しています。従来のプロフィールには複数のAmazonアトリビューション広告主を含めることができましたが、広告コンソールのプロフィールには該当しません。広告プロフィールは広告主と1対1の関係です。完全な下位互換性を確保するために、広告主リソースは、どちらのタイプのプロフィールでも引き続き機能しますが、advertiserId
値はプロフィールごとに異なります。
Amazonアトリビューションの従来のプロフィールは、subType
プロパティの値AMAZON_ATTRIBUTION
で区別できます。新しいインテグレーターは、混乱を避けるために、ユーザーアカウントのオンボーディングプロセスでこれらの古いプロフィールを除外する必要があります。
次のステップ
AmazonアトリビューションAPIの使用方法について説明します。