広告グループ単位のターゲット(地域ターゲット、動的広告ターゲット、リマーケティング リスト ターゲット、年齢/性別ターゲット、分類対象外ターゲット)のパフォーマンス指標。一部のターゲットは、特定のタイプのエンジン アカウントでのみ使用できます。
このレポートは、非同期リクエスト(Reports.request() メソッド)でのみ返されます。
抜粋をリクエストする
通常の Reports.request() リクエスト本文を送信しますが、"reportType": "adGroupTarget"
を指定します。
{
...
"reportType": "adGroupTarget",
"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 |
はい |
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 |
はい |
engineRemarketingList |
ターゲットに関連付けられているリマーケティング リストの名前。 | 属性 | String |
はい |
engineRemarketingListBidModifier |
ターゲットに関連付けられた入札単価調整。 | 属性 | Number |
はい |
dynamicSearchAdsTargetConditions |
動的広告ターゲットがサイトのドメイン内のページを選択するために使用する条件。 | 属性 | String |
いいえ |
dynamicSearchAdsTargetCpcBid |
動的広告ターゲットの上限クリック単価(上限 CPC)の設定。 | 属性 | Money |
はい |
dynamicSearchAdsTargetLandingPageUrl |
動的広告ターゲットの URL テンプレート。 | 属性 | String |
はい |
dynamicSearchAdsTargetCoverage |
広告主様のサイト内で、動的広告ターゲットと一致するページの割合。 | 属性 | Number |
はい |
locationTargetName |
位置情報ターゲットの名前。 | 属性 | String |
はい |
locationTargetBidModifier |
地域ターゲットに関連付けられている入札単価調整。 | 属性 | Number |
はい |
ageTargetAgeRange |
年齢層の年齢範囲。 | 属性 | Age range |
はい |
ageTargetBidModifier |
年齢ターゲットに関連付けられた入札単価調整。 | 属性 | Number |
はい |
genderTargetGenderType |
性別ターゲットの性別タイプ: 男性、女性、不明。 | 属性 | Gender type |
はい |
genderTargetBidModifier |
性別ターゲットに関連付けられた入札単価調整。 | 属性 | Number |
はい |
unclassifiedTargetName |
未分類のターゲットの名前。 | 属性 | String |
はい |
unclassifiedTargetType |
未分類のターゲットのタイプ: Dynamic search 。 |
属性 | Unclassified target type |
はい |
adGroupTargetId |
広告グループ ターゲット用に生成された ID DS。 | 属性 | ID |
はい |
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 |
はい |