広告グループのパフォーマンス指標と設定属性。
このレポートは、非同期リクエスト（Reports.request() メソッド）でのみ返されます。
抜粋をリクエストする
通常の Reports.request() リクエスト本文を送信しますが、"reportType": "adGroup" を指定します。
{
...
"reportType": "adGroup",
"columns": [
{
"columnName":string ,
"headerText":string ,
"startDate":string ,
"endDate":string
}
],
"filters": [
{
"column": {
"columnName":string ,
},
...
},
...
],
...
}
レポートで返すまたはフィルタする列ごとに、次の表に示す columnName を指定します。必要に応じて、headerText、startDate、endDate を指定することもできます。一部の列はフィルタできません。下記の表の「フィルタ可能」を参照してください。
columnName | 説明 | 動作 | タイプ | フィルタ可能 |
|---|---|---|---|---|
status |
adGroupStatus 属性のエイリアス。 |
属性 | Status |
はい |
engineStatus |
外部エンジン アカウントの広告グループの追加ステータス。外部アカウントの種類によって、eligible、campaign ended などのステータスが表示されます。 |
属性 | 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 |
はい |
adRotation |
広告グループで使用される広告配信のローテーション: Optimize または Rotate indefinitely。 |
属性 | String |
いいえ |
adGroup |
広告グループ名: | 属性 | String |
はい |
adGroupId |
DS 広告グループ ID。 | 属性 | ID |
はい |
adGroupStatus |
広告グループのステータス: Active、Paused、Removed。キャンペーン、広告グループ、キーワード、広告、ターゲットにはそれぞれ固有のステータスがあります。ステータスを確認する。 |
属性 | Status |
はい |
adGroupEngineId |
外部エンジン アカウントの広告グループの ID。 | 属性 | ID |
はい |
adGroupStartDate |
広告グループの開始日。 | 属性 | Date |
はい |
adGroupEndDate |
広告グループの終了日。 | 属性 | Date |
はい |
adGroupSearchMaxCpc |
この広告グループの検索キーワードのデフォルトの入札単価。 | 属性 | Money |
はい |
adGroupBroadMaxCpc |
この広告グループの部分一致検索キーワードのデフォルトの入札単価（Bing Ads のみ）。 | 属性 | Money |
はい |
adGroupExactMaxCpc |
この広告グループの完全一致キーワードのデフォルトの入札単価（Bing Ads のみ）。 | 属性 | Money |
はい |
adGroupPhraseMaxCpc |
この広告グループのフレーズ一致検索キーワードのデフォルトの入札単価（Bing Ads のみ）。 | 属性 | Money |
はい |
adGroupContentMaxCpc |
この広告グループのコンテンツ キーワードのデフォルトの入札単価。 | 属性 | Money |
はい |
adGroupMobileBidAdjustment |
モバイル向けの入札単価を調整する割合（%）。たとえば、0.2 は 20% の増加を意味し、モバイル単価はデフォルトの入札単価の 1.2 倍になります。有効な値の範囲は、外部エンジンによって異なります。 | 属性 | Number |
はい |
adGroupTabletBidAdjustment |
タブレット向けの入札単価調整の割合。たとえば、0.2 は 20% の増加を意味し、タブレットの入札単価はデフォルトの入札単価の 1.2 倍になります。有効な値の範囲は、外部エンジンによって異なります。 | 属性 | Number |
はい |
adGroupDesktopBidAdjustment |
パソコンの入札単価を調整する割合。たとえば、0.2 は 20% の増加を意味し、デスクトップの入札単価はデフォルトの入札単価の 1.2 倍になります。有効な値の範囲は、外部エンジンによって異なります。 | 属性 | Number |
はい |
adGroupType |
（Google 広告にのみ該当）広告グループのタイプ（Standard、Dynamic、Showcase）を示します。 |
属性 | Ad group type |
はい |
bingAdsLanguage |
Bing Ads 広告グループ内の広告とキーワードの言語。 | 属性 | Microsoft language code |
はい |
bingAdsAdDistributions |
Bing Ads 広告グループで使用される広告配信チャネル。Search と Content の組み合わせです。 |
属性 | String |
いいえ |
adGroupLabels |
この広告グループに直接割り当てられているラベルの名前。継承されたラベルは含まれません。 | 属性 | String list |
はい |
effectiveBidStrategyId |
このエンティティに割り当てられている、またはこのエンティティが継承している入札戦略の DS ID。 | 属性 | ID |
はい |
effectiveBidStrategy |
このエンティティに割り当てられている、またはこのエンティティが継承している入札戦略の名前。 | 属性 | String |
はい |
bidStrategyInherited |
このエンティティの入札戦略が継承されているかどうかを示します。 | 属性 | Boolean |
はい |
deviceTargets |
広告グループ単位のデバイス ターゲット（Desktop、Mobile、Tablet、Other の組み合わせ）。 |
属性 | String |
いいえ |
effectiveDeviceTargets |
広告グループ単位のデバイス ターゲット、またはキャンペーンから継承されたデバイス ターゲット（Desktop、Mobile、Tablet、Other の組み合わせ）。 |
属性 | String |
いいえ |
countryTargets |
広告グループに含まれる国ターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
provinceTargets |
広告グループに含まれる都道府県のターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
metroTargets |
広告グループに含まれるメトロ ターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
cityTargets |
広告グループに含まれる都市のターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
effectiveCountryTargets |
広告グループに含まれている、またはキャンペーンから継承された国ターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
effectiveProvinceTargets |
広告グループに含まれている、またはキャンペーンから継承された都道府県のターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
effectiveMetroTargets |
広告グループに含まれる、またはキャンペーンから継承されたメトロ ターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
effectiveCityTargets |
広告グループに含まれる、またはキャンペーンから継承された都市ターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
いいえ |
effectiveLabels |
この広告グループに継承されている、または直接割り当てられているすべてのラベルの名前。 | 属性 | String list |
はい |
engineRemarketingListTargetAll |
広告グループで入札単価の調整にリマーケティング ターゲットのみを使用するかどうかを示します。 考えられる値は次のとおりです。
|
属性 | Boolean |
はい |
clicksWithFeedItemShowing |
フィードアイテムが表示されている間に、広告内の任意のリンクがクリックされた場合。この列は、フィードアイテム レポートまたはフィードアイテム列でセグメント化されたレポートでのみ値を返します。 | 指標 | Integer |
はい |
costWithFeedItemShowing |
フィード項目が表示されていたときのすべての広告の費用。この列は、フィードアイテム レポートまたはフィードアイテム列でセグメント化されたレポートでのみ値を返します。 | 指標 | Money |
はい |
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 |
はい |
searchRankLostImpressionShare |
Google 広告と Bing Ads のみ。広告ランクの低さが原因で、検索ネットワークに広告が表示されなかった回数の割合です。0 ～ 0.9 の間の数値として返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 |
指標 | Impression share |
はい |
displayImpressionShare |
Google 広告のみ。ディスプレイ ネットワークで獲得したインプレッション数を、獲得可能だったと推定されるインプレッション数で割ったものです。0.1 ～ 1 の間の数値として返されます。シェアが 0.1 未満の場合は、文字列 < 10% が返されます。 |
指標 | 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 |
はい |
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 |
はい |
sitelinkDisplayText |
レポートをサイトリンク別にセグメント化します。各行とその集計指標は、サイトリンクごとに複数の行に分割されます。この列には、各行のサイトリンクの表示テキストが返されます。 | 分割 | String |
はい |
sitelinkDescription1 |
レポートをサイトリンク別にセグメント化します。各行とその集計指標は、サイトリンクごとに複数の行に分割されます。この列には、各行のサイトリンクの説明 1 が返されます。 | 分割 | String |
はい |
sitelinkDescription2 |
レポートをサイトリンク別にセグメント化します。各行とその集計指標は、サイトリンクごとに複数の行に分割されます。この列には、各行のサイトリンクの説明 2 が返されます。 | 分割 | String |
はい |
sitelinkLandingPageUrl |
レポートをサイトリンク別にセグメント化します。各行とその集計指標は、サイトリンクごとに複数の行に分割されます。この列には、各行のサイトリンクのランディング ページ URL が返されます。 | 分割 | String |
はい |
sitelinkClickserverUrl |
レポートをサイトリンク別にセグメント化します。各行とその集計指標は、サイトリンクごとに複数の行に分割されます。この列には、各行のサイトリンクのクリックサーバー URL が返されます。 | 分割 | String |
はい |
locationBusinessName |
ビジネス プロフィール アカウントにリンクされているアップグレード済みの住所表示オプションごとにレポートを分割します。各行とその集計指標は、指標が利用可能な拠点ごとに複数の行に分割されます。この列には、行ごとにビジネス拠点のビジネス名が返されます。 | 分割 | String |
はい |
locationCategory |
ビジネス プロフィール アカウントにリンクされているアップグレード済みの住所表示オプションごとにレポートを分割します。各行とその集計指標は、指標が利用可能な拠点ごとに複数の行に分割されます。この列には、各行のロケーションのカテゴリが返されます。 | 分割 | String |
はい |
locationDetails |
ビジネス プロフィール アカウントにリンクされているアップグレード済みの住所表示オプションごとにレポートを分割します。各行とその集計指標は、指標が利用可能な拠点ごとに複数の行に分割されます。この列には、各行の場所の詳細が返されます。 | 分割 | String |
はい |
locationFilter |
ビジネス プロフィール アカウントにリンクされているアップグレード済みの住所表示オプションごとにレポートを分割します。各行とその集計指標は、指標が利用可能な拠点ごとに複数の行に分割されます。この列には、各行の場所のフィルタが返されます。 | 分割 | String |
いいえ |
callPhoneNumber |
電話番号表示オプションごとにレポートを分割します。各行とその集計指標は、電話番号表示オプションごとに複数の行に分割されます。この列には、通話オプションの電話番号が表示されます。 | 分割 | String |
はい |
callCountryCode |
電話番号表示オプションごとにレポートを分割します。各行とその集計指標は、電話番号表示オプションごとに複数の行に分割されます。この列には、各行のコール拡張機能の国コードが返されます。 | 分割 | String |
はい |
callIsTracked |
レポートを電話番号表示オプション別にセグメント化します。各行とその集計指標は、電話番号表示オプションごとに複数の行に分割されます。この列は、通話エクステンションの通話がトラッキングされる場合は true を、それ以外の場合は false を返します。 | 分割 | Boolean |
はい |
callCallOnly |
電話番号表示オプションごとにレポートを分割します。各行とその集計指標は、電話番号表示オプションごとに複数の行に分割されます。この列は、電話番号表示オプションに電話番号のみが表示される場合は true、電話番号とリンクの両方が表示される場合は false を返します。 | 分割 | Boolean |
はい |
callConversionTracker |
レポートを電話番号表示オプションでセグメント化します。各行とその集計指標は、電話番号表示オプションごとに複数の行に分割されます。この列には、フィードアイテムに関連付けられているコンバージョン トラッカーの名前（存在する場合）が表示されます。 | 分割 | String |
はい |
callConversionTrackerId |
レポートを電話番号表示オプションでセグメント化します。各行とその集計指標は、電話番号表示オプションごとに複数の行に分割されます。この列には、通話件数拡張機能に関連付けられているコンバージョン トラッカーの ID（存在する場合）が表示されます。 | 分割 | ID |
はい |
appId |
アプリ拡張機能別にレポートをセグメント化します。各行とその集計指標は、アプリ拡張機能ごとに複数の行に分割されます。この列には、アプリ ID（存在する場合）が返されます。 | 分割 | String |
はい |
appStore |
アプリ拡張機能別にレポートをセグメント化します。各行とその集計指標は、アプリ拡張機能ごとに複数の行に分割されます。この列には、アプリストアの種類（Apple App Store、Google Play ストア）が返されます（存在する場合）。 | 分割 | App store |
はい |
feedItemId |
レポートをフィードアイテム別に分割します。各行とその集計指標は、フィードアイテムごとに複数の行に分割されます。この列には、各行の DS フィードアイテムの行 ID が返されます。 | 分割 | ID |
はい |
feedId |
レポートをフィードアイテム別に分割します。各行とその集計指標は、フィードアイテムごとに複数の行に分割されます。この列には、各行の DS フィード テーブル ID が返されます。 | 分割 | ID |
はい |
feedType |
レポートをフィードアイテム別に分割します。各行とその集計指標は、フィードアイテムごとに複数の行に分割されます。この列には、各行のフィードアイテムのタイプが返されます。 | 分割 | Feed type |
はい |