開発者ガイドの概要

Amazon Ads APIの概要

手順1: Login with Amazonアプリケーションを作成する

概要 | 1.LwAクライアントを作成する | 2.APIアクセスを申請する | 3.アクセス権を割り当てる

Amazon Ads APIへのオンボーディングの最初の手順は、Login with Amazon(LwA)クライアントアプリケーションを作成することです。このアプリケーションは、後でAPIへのリクエストを行うために使用されます。

APIへのアクセスが承認されたら、後の手順でこのLwAアプリケーションへのアクセス権を割り当てます。

LwAがAmazon Ads APIで果たす役割について詳しくは、以下をご覧ください。

ヒント:すでにLogin with Amazonの認証情報をお持ちですか?

Login with Amazonの認証情報をすでに持っている場合(たとえば、現在セリングパートナーAPIを使用している場合)でも、Amazon Ads APIで使用する新しいLwAセキュリティプロファイルを作成します。Amazon開発者にすでにログインしている場合は、新しいLwAセキュリティプロファイルを作成するに進んでください。

Amazon開発者に登録する

Login with Amazonアプリケーションを作成するには、developer.amazon.comで開発者として登録する必要があります。

開発者として登録するには、「サインイン」をクリックします。

サインイン画面から、次のいずれかを行います。

開発者登録ページにリダイレクトされます。フォームに必要事項を入力し、Amazon開発者サービス契約に同意して、「送信」を選択します。

警告

この段階では、既存のAmazonアカウントを使用するか、Amazon開発者を通じて新しいアカウントを作成するかのいずれかによって、開発者として登録できます。ビジネスに関連するアプリケーションを作成する場合は、組織内の複数の個人によって管理されているEメールアドレスを使用することをおすすめします。

これは、LwA開発者登録に関連付けられたEメールアドレスは、承認されるとAmazon Ads APIのアクセス許可にも関連付けられるためです。また、APIアクセスが承認され、ライセンス契約に同意すると、このEメールに関連付けられたLwAアプリケーションを変更することはできません。そのため、Eメールアドレスに関連付けられているすべての個人が、Eメールアドレスに関連付けるLwAアプリケーションを知っておくことを強くおすすめします。

新しいLwAセキュリティプロファイルを作成する

上記で作成したアカウントを使用してAmazon開発者サイトにログインした後、「開発者コンソール」をクリックします。

開発者コンソールで、メニューバーの「Login with Amazon」をクリックします。
Login with Amazon
新しいセキュリティプロファイルを作成」をクリックします。
新しいセキュリティプロファイルを作成

セキュリティプロファイル管理ページにリダイレクトされます。フォームに以下を入力します。

これらのフィールドの詳細については、LwAのドキュメントをご覧ください。

この情報を入力したら、「保存」ボタンを選択します。

同意プライバシー通知のURLは、会社のプライバシーポリシーURL(ある場合)にしてください。このURLは後でLwA認証サイトのリンクとして表示され、広告主はそこにアクセスしてアプリケーションにアクセス許可を付与します。

自身のデータにアクセスするダイレクト広告主の場合、これはオンボーディングプロセスに必須ではなく、任意のURLを入力できます。

セキュリティ認証情報を取得する

新しいプロファイルを作成すると、「Login with Amazon」ページにリダイレクトされます。

このページには、セキュリティプロファイル名OAuth2認証情報を一覧表示した表が含まれています。前に作成したセキュリティプロファイルの名前を見つけ、「クライアントIDとクライアントシークレットを表示」をクリックします。
クライアントIDとクライアントシークレットを表示

これらの値は、Amazon Ads APIにアクセスするための必須の認証情報であるため、注意してください。クライアントIDはAPIへのすべてのリクエストで渡され、クライアントIDとクライアントシークレットの両方を使用してAPIのアクセストークンが生成されます。これらの値は、このパネルからいつでも取得できます。

ヒント:APIで複数のクライアントIDを使用できますか?

いいえ。ポリシーとして、Amazon Adsでは1社につき1つのクライアントIDのAPIアクセスを有効にしています。企業内で同じクライアントIDを使用できるユーザー数に制限がないため、複数のクライアントIDを使用する必要はありません。追加のユーザーのアクセス許可は、後でAmazon開発者コンソールで管理できます。ただし、最初のオンボーディングシーケンスを完了できるのは、Amazon開発者アカウントの元の作成者だけです。

次のステップ

これらの手順を完了したら、オンボーディングプロセスの次の手順 広告APIアクセスを申請するに進みます。

テクニカルサポート

Amazon Ads APIへの接続に問題がある場合は、テクニカルサポートページをご覧ください。