レポートタイプ: 広告主

次のような広告主様のレポート データ

  • 広告主のすべてのエンジン アカウントとキャンペーンのパフォーマンス指標。
  • 広告主の構成属性。

抜粋をリクエスト

通常の Reports.request() または Reports.generate() リクエストの本文を送信しますが、"reportType": "advertiser" を指定します。

{
...
  "reportType": "advertiser",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName を指定します。headerTextstartDateendDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。

columnName説明動作タイプフィルタ可能
status 広告主のステータス(ActivePaused、または Removed)。 属性 Status 対応
creationTimestamp 広告主の作成時のタイムスタンプ(ISO 8601 形式)。 属性 Timestamp 対応
lastModifiedTimestamp 広告主の最終更新日のタイムスタンプ(ISO 8601 形式)。 属性 Timestamp 対応
agency 代理店名。 属性 String 対応
agencyId DS 代理店 ID 属性 ID 対応
advertiser 広告主名。 属性 String 対応
advertiserId DS 広告主 ID 属性 ID 対応
dfaAdvertiserId この DS 広告主に関連付けられているキャンペーン マネージャー広告主の ID。 属性 ID 対応
dfaNetworkId この DS 広告主に関連付けられているキャンペーン マネージャー ネットワークの ID。 属性 ID 対応
dfaNetworkTimeZone この DS 広告主に関連付けられているキャンペーン マネージャー ネットワークのタイムゾーン(IANA タイムゾーン データベース形式、America/New_York など)。 属性 String 対応
advertiserCurrencyCode 広告主の通貨コード(ISO 4217 形式)。 属性 String 対応
googleAnalyticsTimeZone この DS 広告主にリンクされている Google アナリティクス ビューのタイムゾーン。IANA タイムゾーン データベース形式(America/New_York など)を使用します。 属性 String 対応
dfaActions キャンペーン マネージャー アクションの合計数。 指標 Integer 対応
dfaRevenue キャンペーン マネージャーのトランザクションで発生した収益の集計。 指標 Money 対応
dfaTransactions キャンペーン マネージャー トランザクションの合計数。 指標 Integer 対応
dfaWeightedActions キャンペーン マネージャー アクションの加重合計。 指標 Number 対応
dfaActionsCrossEnv 環境間のキャンペーン マネージャー アクションの合計数。 指標 Number 対応
dfaRevenueCrossEnv 環境間のキャンペーン マネージャー トランザクションによって発生した収益の集計。 指標 Money 対応
dfaTransactionsCrossEnv 環境間のキャンペーン マネージャー トランザクションの合計数。 指標 Number 対応
dfaWeightedActionsCrossEnv 環境間のキャンペーン マネージャー アクションの加重合計。 指標 Number 対応
avgCpc 平均クリック単価。 指標 Money 対応
avgCpm 平均インプレッション単価。 指標 Money 対応
avgPos 平均掲載順位。 指標 Number 対応
clicks 総クリック数。 指標 Integer 対応
cost エンジン アカウントに対する合計費用 指標 Money 対応
ctr 平均クリック率。 指標 Number 対応
impr インプレッションの合計数。 指標 Integer 対応
adWordsConversions 広告主様が Google 広告コンバージョン列に表示するよう設定したデータGoogle 広告のコンバージョン アクションを作成する際、広告主は [コンバージョン] 列でコンバージョンをカウントするかどうかを選択できます。 指標 Number 対応
adWordsConversionValue Google 広告コンバージョンの合計値。 指標 Number 対応
adWordsViewThroughConversions Google 広告のビュースルー コンバージョンの合計数。 指標 Integer 対応
visits DS の訪問の総数。 指標 Integer 対応
searchImpressionShare Google 広告と Bing 広告のみ。検索ネットワークで獲得したインプレッション数を、獲得可能だったと推定されるインプレッション数で割った値です。0.1 ~ 1 の範囲で返されます。シェアが 0.1 未満の場合は、文字列 < 10% を返します。 指標 Impression share 対応
searchBudgetLostImpressionShare Google 広告と Bing 広告のみ。予算不足が原因で、検索ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 指標 Impression share 対応
searchRankLostImpressionShare Google 広告と Bing 広告のみ。広告ランクの低さが原因で、検索ネットワークに広告が掲載されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 指標 Impression share 対応
displayImpressionShare Google 広告のみ。ディスプレイ ネットワークで発生した実際の表示回数を、表示候補となった回数の推定値で割ったものです。0.1 ~ 1 の範囲で返されます。シェアが 0.1 未満の場合は、文字列 < 10% を返します。 指標 Impression share 対応
displayBudgetLostImpressionShare Google 広告のみ。予算不足が原因で、ディスプレイ ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 指標 Impression share 対応
displayRankLostImpressionShare Google 広告のみ。広告ランクの低さが原因で、ディスプレイ ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 指標 Impression share 対応
qualityScoreAvg Google 広告と Bing 広告のみ。レポート対象期間内のすべての日付とキーワードにおける、エンジンの品質スコア(QS)の加重平均。 指標 Number 対応
topOfPageBidAvg Google 広告のみ。検索結果の上部で広告が定期的に掲載されるために必要なレポート期間の平均 CPC の概算。 指標 Money 対応
absoluteTopImpressionPercentage オーガニック検索の上部で最初に表示された広告のインプレッションの割合。 指標 Impression share 対応
searchAbsoluteTopImpressionShare 検索結果の最上部(オーガニック検索結果の上部の 1 番目の広告)で獲得したインプレッション数を、ページ上部に表示可能だった広告の推定インプレッション数で割った値です。 指標 Impression share 対応
topImpressionPercentage オーガニック検索結果の上の任意の場所に表示された広告インプレッションの割合。 指標 Impression share 対応
searchTopImpressionShare ページ上部に表示可能だった広告の推定インプレッション数と比較した、上部(オーガニック検索結果の上部の任意の場所)でのインプレッション数。 指標 Impression share 対応
searchBudgetLostAbsoluteTopImpressionShare 予算の低さが原因で、オーガニック検索結果の上部の 1 番目に広告が表示されなかった割合(推定値)を表します。 指標 Impression share 対応
searchBudgetLostTopImpressionShare 予算が低いため、オーガニック検索結果の上部に広告が表示されなかった頻度を把握できます。 指標 Impression share 対応
searchRankLostAbsoluteTopImpressionShare 広告ランクの低さが原因で、オーガニック検索結果の上部に広告が最初に表示されない頻度を推定します。 指標 Impression share 対応
searchRankLostTopImpressionShare 広告ランクの低さが原因で、オーガニック検索結果の上部に広告が表示されなかった割合(推定値)を表します。 指標 Impression share 対応
date レポートを日別に分割します。各行とその集計指標は、1 行に 1 つずつ複数の行に分割されます。この列では各行の日付が返されます。 分割 Date 対応
monthStart レポートを月別に分割します。各行とその集計指標は、月ごとに複数の行に分割されます。この列では、各行の最初の月の日が返されます。 分割 Date 対応
monthEnd レポートを月別に分割します。各行とその集計指標は、月ごとに複数の行に分割されます。この列では、各行の月の最終日を返します。 分割 Date 対応
quarterStart レポートを四半期ごとに分割します。各行とその集計指標は、四半期ごとに 1 行ずつ、複数ある行に分割されます。この列では各行の四半期の最初の日が返されます。 分割 Date 対応
quarterEnd レポートを四半期ごとに分割します。各行とその集計指標は、四半期ごとに 1 行ずつ、複数ある行に分割されます。この列では、各行の四半期の最終日が返されます。 分割 Date 対応
weekStart レポートを週(日曜日~土曜日)で分割します。各行とその集計指標は、週ごとに 1 行ずつ、複数行に分割されます。この列では、各行の最初の日(日曜日)が返されます。 分割 Date 対応
weekEnd レポートを週(日曜日~土曜日)で分割します。各行とその集計指標は、週ごとに 1 行ずつ、複数行に分割されます。この列では、各行の最終日(土曜日)が返されます。 分割 Date 対応
yearStart レポートを年別に分割(各行とその集計指標は複数年に分割)この列では各年の初日が返されます。 分割 Date 対応
yearEnd レポートを年別に分割(各行とその集計指標は複数年に分割)この列では、各年の年の最終日を返します。 分割 Date 対応
deviceSegment レポートをデバイス別に分割できます。各行とその集計指標は、デバイス セグメントごとに 1 行ずつ、複数の行に分割されます。この列では、各行のデバイス セグメントが返されます。 分割 Device segment 対応
floodlightGroup Floodlight グループ別にレポートを分割します。各行とその集計指標は、Floodlight グループごとに 1 行ずつ、複数の行に分割されます。この列では各行の Floodlight グループ名が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 分割 String 対応
floodlightGroupId Floodlight グループ別にレポートを分割します。各行とその集計指標は、Floodlight グループごとに 1 行ずつ、複数の行に分割されます。この列では各行の DS Floodlight グループ ID が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 分割 ID 対応
floodlightGroupTag Floodlight グループ別にレポートを分割します。各行とその集計指標は、Floodlight グループごとに 1 行ずつ、複数の行に分割されます。この列では各行の Floodlight グループタグが返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 分割 String 対応
floodlightActivity Floodlight アクティビティ別にレポートを分割します。各行とその集計指標は、Floodlight アクティビティごとに最大 1 つの複数行に分割されます。この列では各行の Floodlight アクティビティ名が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 分割 String 対応
floodlightActivityId Floodlight アクティビティ別にレポートを分割します。各行とその集計指標は、Floodlight アクティビティごとに最大 1 つの複数行に分割されます。この列では、各行の DS Floodlight アクティビティ ID が返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 分割 ID 対応
floodlightActivityTag Floodlight アクティビティ別にレポートを分割します。各行とその集計指標は、Floodlight アクティビティごとに最大 1 つの複数行に分割されます。この列では各行の Floodlight アクティビティ タグが返されます。指標の中には、クリック数や訪問数など、Floodlight で分割された値がないものもあります。 分割 String 対応