レポートタイプ: 広告主

広告主向けの、以下を含むレポートデータ

  • 広告主のすべてのエンジン アカウントとキャンペーンにわたるパフォーマンス指標。
  • 広告主の設定属性。

抜粋をリクエスト

通常の Reports.request() または Reports.generate() "reportType": "advertiser" を指定します。

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

レポートに表示またはフィルタする列ごとに、 次の表に示す columnName を指定します。 必要に応じて headerText startDate, および endDate。 なお、一部の列はフィルタできません。「フィルタ可能」をご覧ください下の表をご覧ください。

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 Ads のみ。検索ネットワークで顧客が実際に獲得したインプレッションの回数を、顧客の広告が表示候補となった推定回数で割ったもの。0.1 ~ 1 の間の数値、またはシェアが 0.1 未満の場合は文字列 < 10% を返します。 指標 Impression share
searchBudgetLostImpressionShare Google 広告と Bing Ads のみ。予算不足が原因で検索ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の数値、またはシェアが 0.9 より大きい場合は文字列 > 90% として返されます。 指標 Impression share
searchRankLostImpressionShare Google 広告と Bing Ads のみ。広告ランクの低さが原因で、検索ネットワークに広告が表示されなかった回数の割合です。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 Ads のみ。レポート範囲内のすべての日付とキーワードにおけるエンジンの品質スコア(QS)のインプレッション加重平均。 指標 Number
topOfPageBidAvg Google 広告のみ。レポートの期間内で常に検索結果ページの上部に広告を表示するために必要な平均クリック単価の見積もりです。 指標 Money
absoluteTopImpressionPercentage オーガニック検索の上部で最初に表示された広告のインプレッションの割合です。 指標 Impression share
searchAbsoluteTopImpressionShare 検索結果ページの最上部(オーガニック検索結果の上部の 1 番目)に広告が表示された回数を、上部に表示可能だった広告の推定インプレッション数で割ったもの。 指標 Impression share
topImpressionPercentage オーガニック検索結果の上部に表示されている広告インプレッションの割合です。 指標 Impression share
searchTopImpressionShare 上部(オーガニック検索結果の上部の任意の場所)に実際に表示されていたインプレッション数と、上部に表示可能だった広告の推定インプレッション数を比較できます。 指標 Impression share
searchBudgetLostAbsoluteTopImpressionShare 予算の低さが原因で、オーガニック検索結果ページの最上部に広告が表示されなかった割合(推定値)を表します。 指標 Impression share
searchBudgetLostTopImpressionShare 予算の低さが原因で、オーガニック検索結果の上部に広告が表示されなかった頻度を確認できます。 指標 Impression share
searchRankLostAbsoluteTopImpressionShare 広告ランクの低さが原因で、オーガニック検索結果ページの最上部に広告が表示されなかった割合(推定値)を表します。 指標 Impression share
searchRankLostTopImpressionShare 広告ランクの低さが原因で、オーガニック検索結果ページの上部に広告が表示されなかった割合(推定値)を表します。 指標 Impression share
date レポートを日単位で分割します。各行とその集計指標は複数の行(1 日につき 1 行)に分割されます。この列では、各行の日付が返されます。 分割 Date
monthStart レポートを月別に分割する各行とその集計指標は、月ごとに 1 つずつ、複数の行に分割されます。この列では、各行の月の初日を返します。 分割 Date
monthEnd レポートを月別に分割する各行とその集計指標は、月ごとに 1 つずつ、複数の行に分割されます。この列では、各行の月の最終日を返します。 分割 Date
quarterStart 四半期ごとにレポートを分割します。各行とその集計指標は複数の行(四半期ごとに 1 行)に分割されます。この列では、各行の四半期の初日を返します。 分割 Date
quarterEnd 四半期ごとにレポートを分割します。各行とその集計指標は複数の行(四半期ごとに 1 行)に分割されます。この列では、各行の四半期の最終日を返します。 分割 Date
weekStart レポートを週単位(日曜日~土曜日)で分割します。各行とその集計指標は、週ごとに 1 つずつ、複数の行に分割されます。この列では、各行の初日(日曜日)が返されます。 分割 Date
weekEnd レポートを週単位(日曜日~土曜日)で分割します。各行とその集計指標は、週ごとに 1 つずつ、複数の行に分割されます。この列では、各行の最終日(土曜日)が返されます。 分割 Date
yearStart レポートを年別に分割します。各行とその集計指標は、年ごとに 1 つずつ、複数の行に分割されます。この列では、各行の年初日を返します。 分割 Date
yearEnd レポートを年別に分割します。各行とその集計指標は、年ごとに 1 つずつ、複数の行に分割されます。この列では、各行の年の最終日を返します。 分割 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