AmazonアトリビューションAPIに関するトラブルシューティング

このトラブルシューティングガイドは、次の3つのセクションに分かれています。 アカウントの認可、タグの実装、レポート。まずは、このページの質問をご一読のうえ、タグが適切に実装されていることを確認してください。その後、レポートに関する内容を確認してください。

アカウントの認可

AmazonアトリビューションAPIを使用するには、API開発者アカウントが広告主の広告プロフィールにアクセスできなければなりません。認可方法については、開始するをご覧ください。広告主の地域によって設定の一部（URLドメイン名など）が異なる場合があることに注意してください。

プロフィールエンドポイントを呼び出したのに、広告主のプロフィールがレスポンスに表示されません

プロフィールへのアクセスを広告主から許可してもらう必要があります。そうすることで、2時間以内にそのプロフィールがプロフィールエンドポイントのレスポンスリストに表示されます。APIテストドメインを使用している場合は、代わりに本番環境ドメインを使用してください。開始するを参照して、すべてのセットアップ手順が完了していることを確認してください。

広告主のプロフィールを使用してAmazonアトリビューションエンドポイントを呼び出すと、認可されているのに403エラーが返されます

その広告主プロフィールに、Amazonアトリビューションの利用資格がない可能性があります。利用資格の要件については、概要をご覧ください。

タグの実装

タグをクリックしたのに、キャンペーンがレポートにまったく表示されません

以下の原因が考えられます。

• 無効なランディングページにタグを適用した可能性があります。タグは、Amazonの商品詳細ページまたはストアページに適用された場合にのみ機能します。
• 広告主のキャンペーンを測定するためには、その前にその広告主のプロフィールを使用してタグ取得エンドポイントを呼び出しておく必要があります。このエンドポイントには、測定を可能にする代わりに隠れた副次的影響があるからです。その広告主についてこの手順を省略していた場合は、タグを取得してもう一度試してください。
• キャンペーンの作成には、最初のクリックから最大4時間かかる場合があります。4時間待ってから、もう一度ご確認ください。
• タグの機能を妨げるような方法でタグを変更した可能性があります。元のパラメーターが重複せずにすべて含まれていること、URLの形式が適切であることを確認してください。

タグをクリックするとレポートにキャンペーンが表示されるものの、クリック数とコンバージョン数がすべてゼロになってしまいます

以下の原因が考えられます。

• クリック数が表示されるまで24時間、コンバージョン数が表示されるまで最大48時間かかる場合があります。
• レポートのしきい値設定によって、クリック数が10回未満のデータ行の指標はすべてマスク（ゼロ表示）されます。タグを10回クリックしたら、48時間以内に指標が表示されるはずです。

レポートにキャンペーンが表示され、クリック数も表示されるがコンバージョン数（DPV、ATC、売上）が表示されない

これには以下の理由が考えられます。

• コンバージョン数がレポートに反映されるまでに最大48時間かかる場合があります。しばらく経ってから、もう一度ご確認ください。
• あるマーケットプレイスのタグが別のマーケットプレイスのランディングページに適用されています。たとえば、米国のアカウントのタグがカナダのランディングページに適用されています。
• ある広告主プロフィールのタグが、別の広告主プロフィールに属する商品の商品ページまたはストアページに適用されています。タグは、そのタグのプロフィールに関連付けられている出品用アカウントに属する商品のコンバージョン数のみを測定します。
• 長すぎるパラメーター値、または不正な文字がタグに使用されています。値は255文字未満（マクロ展開後の長さ）にする必要があります。また、URLでエスケープしたとしても、/、&、=、#、?、+、'、”、%、$などの文字を含めてはいけません。
• 使用したaa_campaign_idの値は、別の広告主または別のマーケットで再使用されています。必ず、各マーケットの広告主ごとに固有のキャンペーンIDを使用してください。
• ref_またはtagパラメーターを含むURLにタグが適用されています。アトリビューションタグは独自のref_パラメーターとtagパラメーターを使用するので、URL内のパラメーターが、Amazonアトリビューションによるキャンペーンの測定を妨げています。URLからref_またはtagパラメーターを削除し、アトリビューションタグのパラメーターは残してください。
• ランディングページとして、ASINが割り当てられていないAmazonストアが使用されています。Amazonストアページで、表示するASINを（毎回同じものではなく）リアルタイムで選択する動的ウィジェットのみが使用されている場合、Amazonアトリビューションが、それらのASINをキャンペーンと紐づけられない可能性があります。これを回避するには、ストアページに静的ASINを追加するか、別のランディングページを使用してください。
• パラメーターを削除するなど、タグの機能を妨げるような方法でタグが変更されています。または、標準のURL形式設定ルールに従っていないURLにタグが追加されています。有効なURL形式は（記載する順番どおりに）、Amazonドメイン、商品ページまたはストアページのパス、?文字、その後に、「パラメーター名=値」のペアを&文字で区切ったリストが続きます。

レポートのキャンペーンが{campaignid}などで表示され、実際のキャンペーンIDが表示されないのはなぜですか？

中括弧で囲まれたフレーズは、特定のパブリッシャー向けのマクロです。パブリッシャーがキャンペーンIDの値に置き換える必要があります。レポートに実際のID値の代わりに中括弧が表示される場合は、パブリッシャーがマクロを処理できなかったことを意味します。これには以下の理由が考えられます。

• 別のサイトパブリッシャー向けのタグである可能性があります（Google キャンペーンで使用されているFacebookタグなど）。
• パブリッシャーの広告マネージャーで間違ったフィールドにタグが実装されていたり、ラップされたタグの中で不適切なURLエスケープが指定されているなどしてパブリッシャーによるマクロ処理が妨げられている可能性があります。
• Amazonアトリビューションの非マクロタグを使用している場合は、リンクの作成時に独自のシステムでIDパラメーターを入力する必要があります。

複数のランディングページで同じタグを使用したり、あるランディングページから別のランディングページにタグを移動したりすると、指標が正しく表示されない

各タグは、1つのランディングページでのみ使用できます。同じ広告グループの複数のランディングページにタグを付けたり、タグを新しいランディングページに移動したりする場合は、ランディングページごとに固有のクリエイティブIDを使用してください。ただし、広告グループIDとキャンペーンIDは同じものを使用してください。

レポート

最近のレポートにすべての情報がふくまれていないように見受けられます。 データに遅延はありますか？

指定された日から翌48時間のレポートは、部分的に完成していないものとみなしてください。通常、クリック数は24時間以内に報告されます。タグを正しく実装していれば、待つだけで指標がレポートに表示されます。

最初にレポートを取得したときから、古いコンバージョン指標の一部が変わっているのはなぜですか？

指標は最大で28日後まで修正される可能性があります。たとえば、返品を反映した調整などのために修正されます。時折、直近の28日間のレポートを取得して、その期間の保管データを更新することをおすすめします。

キャンペーンでストアページに誘導しているものの、ページ上のすべての商品が広告掲載商品としてキャンペーンに関連付けられないのはなぜですか？

Amazonストアページで、表示するASINを（毎回同じものではなく）リアルタイムで選択する動的ウィジェットのみが使用されている場合、Amazonアトリビューションが、それらのASINをキャンペーンと紐づけられない可能性があります。これを回避するには、ストアページに静的ASINを追加するか、別のランディングページを使用してください。

レポートに表示されない指標やディメンションがあるのはなぜですか？

レポートタイプごとに特定のディメンションと指標がサポートされるので、お客様が探しているものが、選択したレポートタイプではサポートされていない可能性があります。たとえば、クリック指標やaa_creativeidディメンションは製品レポートには含まれませんが、パフォーマンスレポートには含まれます。ReportRequestBodyのパラメーターと説明にアクセスして、各レポートで使用可能なディメンションと指標を確認してください。

レポートタイプ	含まれるディメンション	集計レベル	指標	レポートできる日数
パフォーマンス	aa_campaignid、aa_adgroupid、aa_creativeid、publisher	CAMPAIGN、ADGROUP、またはCREATIVEレベルで集計することを選択できます（デフォルト： CREATIVE）	クリックスルー、およびすべての広告掲載コンバージョンと合計コンバージョンの指標。詳しいリストについては、レポートエンドポイントをご覧ください。	過去13か月間
商品	aa_campaignid、aa_adgroupid、publisher、productName、productGroup、productCategory、productSubcategory、brandName、productAsin、productConversionType	常に広告グループレベルで集計されます。	「トップ100商品」の広告掲載商品およびブランドハロー効果商品のコンバージョン指標のみで、クリックスルー数はありません。（詳しいリストについては、レポートエンドポイントをご覧ください。） トップ100商品に限定されます。	過去90日間

90日前の商品レポートを取得するとエラーが表示されるのはなぜですか？

データ提供の制限により、開始日が過去90日以内の商品レポートしか取得できません。

一度にすべてのレポートを取得しようとするとエラーになるのはなぜですか？

データが大量にある場合は、ページ番号表示を使用してレポートを複数バッチに分けて取得することをおすすめします。「count」パラメーターを使用してバッチごとに取得するレコード件数を指定し、「cursorId」パラメーターを使用して後続のバッチを取得できます。詳しくは、レポートエンドポイントのリファレンスをご覧ください。

ビュースルーコンバージョン数が表示されないのはなぜですか？**

AmazonアトリビューションAPIは、コンバージョンをクリックのみに結び付け、インプレッションには結び付けません。

Amazonアトリビューションキャンペーンレポートに表示されるクリック数が、広告パブリッシャーのキャンペーンレポートと異なるのはなぜですか？

これは、キャンペーンの一部の広告にのみAmazonアトリビューションタグが追加された場合に発生する可能性があります。また、タグをトラッキングテンプレートとして実装した場合は、同じキャンペーンの複数の異なるレベルで複数のトラッキングテンプレートを実装すると、最下位のテンプレートのみが起動されるので、Amazonアトリビューションタグの代わりに他のトラッキングテンプレートが起動する可能性があることに注意してください。

APIレポートに表示される数値が、Amazon広告コンソールと異なるのはなぜですか？

この不一致は、おそらくレポート集計しきい値の結果です。お客様のプライバシーを保護するために、Amazonアトリビューションでは、期間中のクリック数が10回未満のタグまたはタググループを表すレポート行のデータはマスクされます。たとえば、広告グループレベルで集計されたレポートでは、広告グループの一部のタグのクリック数が10回未満であっても、10回以上クリックされた広告グループのデータがすべて表示されます。クリックのしきい値を超えるまで、マスクされた行の指標値はゼロと表示されます。予算が非常に少ないキャンペーンや、非常に少数のオーディエンスに表示されるキャンペーンでは、このしきい値を超えるまでに時間がかかる場合があります。

キャンペーンレベルまたは広告グループレベルでレポートを表示するには、データを自分で集計するのではなく、特定の集計レベルでパフォーマンスレポートをリクエストする必要があります。そのようにすることにより、利用可能なデータがすべてレポートに含まれ、Amazon Adsコンソールと確実に一致するようになります。

レポートにサードパーティのパブリッシャーディメンションを含める場合、デフォルトタグにあるものとは異なるマクロを使用できますか？

はい。必要に応じてタグを変更したり、マクロを追加または削除したりできます。その場合は、aa_creativeidパラメーター値の末尾に追加し、アンダースコアまたはダッシュを使用して実際のクリエイティブIDと区切ることをお勧めします。マクロを削除したい場合は削除することもできます。ただし、最終的なクリエイティブIDの値が一意になることを確認してください。

レポートのしきい値によって、クリック数が10回未満のタグまたはタググループを表すデータ行のレポートはマスクされるので、タグが詳細になりすぎたり（1行に複数のマクロがあるなど）、オーディエンスや個人が限定的になるマクロ（ユーザーIDやクリックIDなど）は追加しないでください。そうしないと、レポートがしきい値を超えることができなくなります。