広告主様のレポートデータ(以下を含む):
- 広告主のすべてのエンジン アカウントとキャンペーンのパフォーマンス指標。
- 広告主の構成属性。
抜粋をリクエストする
通常の 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 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 |
レポートを日単位で分割します。各行とその集計指標は、日ごとに複数の行に分割されます。この列には、各行の日付が返されます。 | 分割 | Date |
はい |
monthStart |
レポートを月別に分割します。各行とその集計指標は、月ごとに複数の行に分割されます。この列には、各行の月の 1 日が返されます。 | 分割 | Date |
はい |
monthEnd |
レポートを月別に分割します。各行とその集計指標は、月ごとに複数の行に分割されます。この列には、各行の月の最終日が返されます。 | 分割 | Date |
はい |
quarterStart |
レポートを四半期ごとに分割します。各行とその集計指標は、四半期ごとに複数の行に分割されます。この列には、各行の四半期の最初の日付が返されます。 | 分割 | Date |
はい |
quarterEnd |
レポートを四半期ごとに分割します。各行とその集計指標は、四半期ごとに複数の行に分割されます。この列には、各行の四半期の最終日が返されます。 | 分割 | Date |
はい |
weekStart |
レポートを週(日曜日から土曜日)ごとに分割します。各行とその集計指標は、週ごとに複数の行に分割されます。この列には、各行の最初の日(日曜日)が返されます。 | 分割 | Date |
はい |
weekEnd |
レポートを週(日曜日から土曜日)ごとに分割します。各行とその集計指標は、週ごとに複数の行に分割されます。この列には、各行の最終日(土曜日)が返されます。 | 分割 | 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 |
はい |