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