次のような広告主様のレポート データ
- 広告主のすべてのエンジン アカウントとキャンペーンのパフォーマンス指標。
- 広告主の構成属性。
抜粋をリクエスト
通常の 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 |
広告主のステータス(Active 、Paused 、または 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 |
対応 |