AdSense Management API のレポート システムでは、AdSense ウェブサイトの柔軟性とカスタマイズ機能を使用できます。レポートを作成するには、ディメンションと指標のリストを指定します。
ディメンション
AdSense で広告が表示されるたびに、その広告に関連付けられたすべてのイベントが、日付、国、チャネル、広告ユニットなどの属性とともに記録されます。これらの属性はディメンションと呼ばれます。
ディメンションは、レポートでグループ化を行う目的で使用されます。
指標
レポートがリクエストされると、ログに記録されたイベントが選択したディメンションに応じて集計されます。指標は、そのデータで実施できるさまざまな測定を表します。
一部の指標は、直接測定されるのではなく計算される。
複数のディメンションの適切な使用
生成されるレポートは一連の行で構成され、各行に 1 つ以上のフィールドがあります。レポートに新しい指標を追加すると新しい列が生成されますが、ディメンションを追加すると行数が増加します。
たとえば、ディメンションとして DATE
を含むレポートでは、アクティビティが発生した日ごとに 1 行ずつ、一連の行が生成されます。CUSTOM_CHANNEL_NAME
などの新しいディメンションを追加すると、1 日および既存のチャネルごとに行が生成されます。指標はいくつでも使用してもかまいませんが、1 つのレポートで使用するディメンションは 3 つまでにしましょう。
ディメンションと指標に互換性がない
1 つのレポートで組み合わせることができない指標とディメンションがいくつかあります。たとえば、URL とカスタム チャネルを同時に取得しようとすると競合が発生します。この制限は AdSense ウェブサイトの [パフォーマンス レポート] タブと同じです。