レポートタイプ: 広告

広告のパフォーマンス指標と構成属性

このレポートは、非同期リクエスト(Reports.request() メソッド経由)でのみ返すことができます。

抜粋をリクエスト

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

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

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

columnName説明動作タイプフィルタ可能
status 広告のステータス(ActivePaused、または Removed)。キャンペーン、広告グループ、キーワード、広告には、それぞれ固有のステータスがあります。ステータスをご覧ください。 属性 Status 対応
engineStatus 外部エンジン アカウントにおける広告の追加のステータス。考えられるステータス(外部アカウントの種類によって異なります)には、activeeligiblecreative deletedcreative approved family safe などがあります。 属性 String 対応
creationTimestamp 広告作成時のタイムスタンプ(ISO 8601 形式)。 属性 Timestamp 対応
lastModifiedTimestamp 広告の最新の変更のタイムスタンプ(ISO 8601 形式)。 属性 Timestamp 対応
agency 代理店名。 属性 String 対応
agencyId DS 代理店 ID 属性 ID 対応
advertiser 広告主名。 属性 String 対応
advertiserId DS 広告主 ID 属性 ID 対応
account エンジン アカウント名。 属性 String 対応
accountId DS エンジン アカウント ID。 属性 ID 対応
accountEngineId 外部エンジン アカウントの ID。 属性 String 対応
accountType エンジン アカウントの種類: Google AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaidu、または Comparison Shopping 属性 Engine type 対応
campaign キャンペーン名。 属性 String 対応
campaignId DS キャンペーン ID。 属性 ID 対応
campaignStatus このアイテムを含むキャンペーンのステータス。 属性 Status 対応
adGroup 広告グループ名: 属性 String 対応
adGroupId DS 広告グループ ID。 属性 ID 対応
adGroupStatus このアイテムが含まれる広告グループのステータス。 属性 Status 対応
ad 広告名 属性 String 対応
adId DS 広告 ID。値が 0 の場合、広告はアトリビューションなしであることを示します。 属性 ID 対応
adEngineId 外部エンジン アカウントの広告の ID。 属性 ID 対応
isUnattributedAd この行の指標が特定の広告に関連付けられていないかどうかを示します。たとえば、サポートされていないフォーマットの広告や間違ったクリックサーブ URL が原因で、DS が指標を広告に関連付けることができない場合があります。 属性 Boolean 対応
adHeadline 広告見出し。 属性 String 対応
adHeadline2 広告見出し 2。一部のエンジンでは使用できません。 属性 String 対応
adHeadline3 広告見出し 3。一部のエンジンでは使用できません。 属性 String 対応
adDescription1 広告の説明(1 行目) 属性 String 対応
adDescription2 広告の説明文 2(一部のエンジンでは使用できません)。 属性 String 対応
adDisplayUrl 広告の表示 URL。 属性 String 対応
adLandingPage 広告のランディング ページ。ランディング ページとクリックサーブ URL をご覧ください。 属性 String 対応
adType 広告の種類: TextProductDynamic searchMobile app installCall-OnlyExpanded textExpanded dynamic search 属性 Ad type 対応
adPromotionLine 広告プロモーション行。商品広告の短いプロモーション メッセージ。 属性 String 対応
adLabels この広告に直接割り当てられたラベルの名前。継承されたラベルは含まれません。 属性 String list 対応
adPathField1 広告パス欄 1。パス項目 1 と 2 が adDisplayUrl と組み合わされて、広告に表示される URL が作成されます。 属性 String 対応
adPathField2 広告パス欄 2。パス項目 1 と 2 が adDisplayUrl と組み合わされて、広告に表示される URL が作成されます。 属性 String 対応
effectiveLabels この広告に継承された、または直接割り当てられたすべてのラベルの名前。 属性 String list 対応
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 対応
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 対応