広告グループのパフォーマンス指標と構成属性。
このレポートを返すことができるのは、非同期リクエスト（ 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 |
DS キャンペーン 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 |
レポートを日単位で分割します。各行とその集計指標は複数の行（1 日につき 1 行）に分割されます。この列では、各行の日付が返されます。 | 分割 | Date |
○ |
monthStart |
レポートを月別に分割する各行とその集計指標は、月ごとに 1 つずつ、複数の行に分割されます。この列では、各行の月の初日を返します。 | 分割 | Date |
○ |
monthEnd |
レポートを月別に分割する各行とその集計指標は、月ごとに 1 つずつ、複数の行に分割されます。この列では、各行の月の最終日を返します。 | 分割 | Date |
○ |
quarterStart |
四半期ごとにレポートを分割します。各行とその集計指標は複数の行（四半期ごとに 1 行）に分割されます。この列では、各行の四半期の初日を返します。 | 分割 | Date |
○ |
quarterEnd |
四半期ごとにレポートを分割します。各行とその集計指標は複数の行（四半期ごとに 1 行）に分割されます。この列では、各行の四半期の最終日を返します。 | 分割 | Date |
○ |
weekStart |
レポートを週単位（日曜日～土曜日）で分割します。各行とその集計指標は、週ごとに 1 つずつ、複数の行に分割されます。この列では、各行の初日（日曜日）が返されます。 | 分割 | Date |
○ |
weekEnd |
レポートを週単位（日曜日～土曜日）で分割します。各行とその集計指標は、週ごとに 1 つずつ、複数の行に分割されます。この列では、各行の最終日（土曜日）が返されます。 | 分割 | Date |
○ |
yearStart |
レポートを年別に分割します。各行とその集計指標は、年ごとに 1 つずつ、複数の行に分割されます。この列では、各行の年初日を返します。 | 分割 | Date |
○ |
yearEnd |
レポートを年別に分割します。各行とその集計指標は、年ごとに 1 つずつ、複数の行に分割されます。この列では、各行の年の最終日を返します。 | 分割 | 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 |
サイトリンク別にレポートを分割する各行とその集計指標は複数の行（サイトリンクごとに 1 行）に分割されます。この列では、各行のサイトリンク表示テキストを返します。 | 分割 | String |
○ |
sitelinkDescription1 |
サイトリンク別にレポートを分割する各行とその集計指標は複数の行（サイトリンクごとに 1 行）に分割されます。この列では、各行のサイトリンクの説明 1 を返します。 | 分割 | String |
○ |
sitelinkDescription2 |
サイトリンク別にレポートを分割する各行とその集計指標は複数の行（サイトリンクごとに 1 行）に分割されます。この列では、各行のサイトリンクの説明 2 を返します。 | 分割 | String |
○ |
sitelinkLandingPageUrl |
サイトリンク別にレポートを分割する各行とその集計指標は複数の行（サイトリンクごとに 1 行）に分割されます。この列では、各行のサイトリンクのランディング ページ URL を返します。 | 分割 | String |
○ |
sitelinkClickserverUrl |
サイトリンク別にレポートを分割する各行とその集計指標は複数の行（サイトリンクごとに 1 行）に分割されます。この列では、各行のサイトリンクのクリックサーバー URL を返します。 | 分割 | String |
○ |
locationBusinessName |
ビジネス プロフィール アカウントにリンクされているアップグレード版の住所表示オプションでレポートが分割される。各行とその集計指標は複数の行に分割され、利用可能な指標があるロケーションごとに 1 つずつ行われます。この列では、各行のビジネス名が返されます。 | 分割 | String |
○ |
locationCategory |
ビジネス プロフィール アカウントにリンクされているアップグレード版の住所表示オプションでレポートが分割される。各行とその集計指標は複数の行に分割され、利用可能な指標があるロケーションごとに 1 つずつ行われます。この列では、行ごとにビジネスのカテゴリが返されます。 | 分割 | String |
○ |
locationDetails |
ビジネス プロフィール アカウントにリンクされているアップグレード版の住所表示オプションでレポートが分割される。各行とその集計指標は複数の行に分割され、利用可能な指標があるロケーションごとに 1 つずつ行われます。この列では、各行のロケーションに関する詳細を返します。 | 分割 | String |
○ |
locationFilter |
ビジネス プロフィール アカウントにリンクされているアップグレード版の住所表示オプションでレポートが分割される。各行とその集計指標は複数の行に分割され、利用可能な指標があるロケーションごとに 1 つずつ行われます。この列では、各行のビジネスのフィルタが返されます。 | 分割 | String |
いいえ |
callPhoneNumber |
電話番号表示オプション別にレポートを分割します。各行とその集計指標は複数の行（電話番号表示オプションごとに 1 行）に分割されます。この列では電話番号表示オプションの電話番号を返します。 | 分割 | String |
○ |
callCountryCode |
電話番号表示オプション別にレポートを分割します。各行とその集計指標は複数の行（電話番号表示オプションごとに 1 行）に分割されます。この列では、各行の電話番号表示オプションの国コードを返します。 | 分割 | String |
○ |
callIsTracked |
電話番号表示オプション別にレポートを分割します。各行とその集計指標は複数の行（電話番号表示オプションごとに 1 行）に分割されます。この列は、電話番号表示オプションの呼び出しがトラッキングされる場合は true を、それ以外の場合は false を返します。 | 分割 | Boolean |
○ |
callCallOnly |
電話番号表示オプション別にレポートを分割します。各行とその集計指標は複数の行（電話番号表示オプションごとに 1 行）に分割されます。この列では、電話番号表示オプションに電話番号のみが表示されている場合は true、電話番号とリンクの両方が表示されている場合は false が返されます。 | 分割 | Boolean |
○ |
callConversionTracker |
電話番号表示オプション別にレポートを分割します。各行とその集計指標は複数の行（電話番号表示オプションごとに 1 行）に分割されます。この列では、フィード アイテムに関連付けられているコンバージョン トラッカーの名前（存在する場合）が返されます。 | 分割 | String |
○ |
callConversionTrackerId |
電話番号表示オプション別にレポートを分割します。各行とその集計指標は複数の行（電話番号表示オプションごとに 1 行）に分割されます。この列では、電話番号表示オプションに関連付けられたコンバージョン トラッカーの ID が返されます（存在する場合）。 | 分割 | ID |
○ |
appId |
アプリリンク表示オプション別にレポートを分割します。各行とその集計指標は複数の行に分割され、アプリリンク表示オプションごとに 1 つずつ表示されます。アプリ ID が存在する場合は、この列でその ID が返されます。 | 分割 | String |
○ |
appStore |
アプリリンク表示オプション別にレポートを分割します。各行とその集計指標は複数の行に分割され、アプリリンク表示オプションごとに 1 つずつ表示されます。アプリストアの種類（Apple App Store、Google Play ストア）が存在する場合、この列を返します。 | 分割 | App store |
○ |
feedItemId |
フィード アイテム別にレポートを分割します。各行とその集計指標は複数の行（フィード アイテムごとに 1 行）に分割されます。この列では、各行の DS フィード アイテムの行 ID を返します。 | 分割 | ID |
○ |
feedId |
フィード アイテム別にレポートを分割します。各行とその集計指標は複数の行（フィード アイテムごとに 1 行）に分割されます。この列では、各行の DS フィード表 ID を返します。 | 分割 | ID |
○ |
feedType |
フィード アイテム別にレポートを分割します。各行とその集計指標は複数の行（フィード アイテムごとに 1 行）に分割されます。この列では、各行のフィード アイテムのタイプを返します。 | 分割 | Feed type |
○ |