広告のパフォーマンス指標と構成属性。
このレポートは、非同期リクエスト（Reports.request() メソッド）でのみ返されます。
抜粋をリクエストする
通常の Reports.request() リクエスト本文を送信しますが、"reportType": "ad" を指定します。
{
...
"reportType": "ad",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
レポートで返すまたはフィルタする列ごとに、次の表に示す columnName を指定します。必要に応じて、headerText、startDate、endDate を指定することもできます。一部の列はフィルタできません。下記の表の「フィルタ可能」を参照してください。
columnName | 説明 | 動作 | タイプ | フィルタ可能 |
|---|---|---|---|---|
status |
広告のステータス: Active、Paused、Removed。キャンペーン、広告グループ、キーワード、広告にはそれぞれ固有のステータスがあります。ステータスを確認する。 |
属性 | Status |
はい |
engineStatus |
外部エンジン アカウントの広告の追加ステータス。外部アカウントの種類によって、active、eligible、creative deleted、creative 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 AdWords、Bing Ads、Yahoo Japan Listing Ads、Yahoo Search Marketing、Yahoo Gemini、Baidu、Comparison Shopping のいずれか。 |
属性 | Engine type |
はい |
campaign |
キャンペーン名。 | 属性 | String |
はい |
campaignId |
動的検索広告キャンペーン ID。 | 属性 | ID |
はい |
campaignStatus |
このアイテムを含むキャンペーンのステータス。 | 属性 | Status |
はい |
adGroup |
広告グループ名: | 属性 | String |
はい |
adGroupId |
DS 広告グループ ID。 | 属性 | ID |
はい |
adGroupStatus |
この項目を含む広告グループのステータス。 | 属性 | Status |
はい |
ad |
広告名。 | 属性 | String |
はい |
adId |
データ ソースの広告 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 とクリックサーバー URL をご覧ください。 | 属性 | String |
はい |
adType |
広告の種類: Text、Product、Dynamic search、Mobile app install、Call-Only、Expanded text、Expanded 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 |
レポートを日単位で分割します。各行とその集計指標は、日ごとに複数の行に分割されます。この列には、各行の日付が返されます。 | 分割 | 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 |
はい |