キャンペーンのパフォーマンス指標と設定属性
このレポートは、非同期リクエスト(Reports.request() メソッド経由)でのみ返すことができます。
抜粋をリクエスト
通常の Reports.request() リクエストの本文を送信しますが、"reportType": "campaign"
を指定します。
{ ... "reportType": "campaign", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName
を指定します。headerText、startDate、endDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。
columnName | 説明 | 動作 | タイプ | フィルタ可能 |
---|---|---|---|---|
status |
campaignStatus 属性のエイリアス。 |
属性 | Status |
対応 |
engineStatus |
外部エンジン アカウントのキャンペーンの追加ステータス。外部アカウントの種類に応じて、disapproved 、budget constrained などのステータスが表示されます。 |
属性 | 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 |
キャンペーンのステータス: Active 、Paused 、または Removed 。キャンペーン、広告グループ、キーワード、広告、ターゲットには、それぞれ固有のステータスがあります。ステータスをご覧ください。 |
属性 | Status |
対応 |
campaignEngineId |
外部エンジン アカウントのキャンペーン ID。 | 属性 | ID |
対応 |
campaignStartDate |
キャンペーンの開始日。 | 属性 | Date |
対応 |
campaignEndDate |
キャンペーンの終了日。 | 属性 | Date |
対応 |
bingAdsBudgetType |
Bing 広告キャンペーンの予算管理方法: Daily budget 、Monthly even spend 、Monthly accelerated spend 、Daily accelerated spend 、または Daily even spend 。 |
属性 | Microsoft Advertising budget type |
対応 |
dailyBudget |
キャンペーンの 1 日の予算です。 | 属性 | Money |
対応 |
monthlyBudget |
キャンペーンの 1 か月の予算。 | 属性 | Money |
対応 |
deliveryMethod |
キャンペーンの予算予算配分方法: Standard または Accelerated 。 |
属性 | Budget delivery method |
対応 |
adWordsBidStrategy |
このキャンペーンで使用する入札戦略: Manual cpc 、Manual cpm 、Percent cpa 、Budget optimizer 、または Conversion optimizer 。DS 入札戦略を使用しているキャンペーンは、Manual cpc または Manual cpm に設定されています。 |
属性 | AdWords bid strategy |
対応 |
yahooJapanBidStrategy |
入札戦略 Yahoo!JAPAN のこのキャンペーンは Manual cpc または Budget optimizer で使用されます。DS 入札戦略を使用しているキャンペーンは「Manual cpc 」に設定されています。 |
属性 | Yahoo! JAPAN bid strategy |
対応 |
keywordNearMatchEnabled |
キャンペーンで部分一致に近いキーワードが有効になっているかどうか: Enabled または Disabled 。 |
属性 | Keyword match setting |
対応 |
campaignMobileBidAdjustment |
モバイルの入札単価調整比。たとえば、「0.2」は 20% 増加することを意味し、モバイルの入札単価はデフォルトの入札単価の 1.2 倍です。有効な値の範囲は、外部エンジンによって異なります。 | 属性 | Number |
対応 |
campaignTabletBidAdjustment |
タブレット向けに入札単価を調整する割合。たとえば、「0.2」は 20% 増加することを意味し、タブレットの入札単価はデフォルトの入札単価の 1.2 倍です。有効な値の範囲は、外部エンジンによって異なります。 | 属性 | Number |
対応 |
campaignDesktopBidAdjustment |
パソコンの入札単価調整に使用される割合です。たとえば、「0.2」は 20% 増加することを意味し、パソコンの入札単価はデフォルトの入札単価の 1.2 倍です。有効な値の範囲は、外部エンジンによって異なります。 | 属性 | Number |
対応 |
networkTarget |
キャンペーンの対象となるネットワークの種類です。 | 属性 | String |
× |
yahooGeoTargets |
Yahoo Search Marketing キャンペーンのターゲット地域。アップロード テンプレートと地域 / 言語コードをダウンロードするをご覧ください。 | 属性 | String |
× |
campaignLabels |
このキャンペーンに直接割り当てられたラベルの名前。継承されたラベルは含まれません。 | 属性 | String list |
対応 |
campaignType |
キャンペーンのタイプ(Manual 、Inventory 、Inventory - PLA 、Shopping 、Comparison shopping 、Mobile app install 、Universal app 、Smart shopping )を示します。 |
属性 | Campaign type |
対応 |
effectiveBidStrategyId |
このエンティティに割り当てられている、またはこのエンティティによって継承されている入札戦略の DS ID。 | 属性 | ID |
対応 |
effectiveBidStrategy |
このエンティティに割り当てられている、またはこのエンティティによって継承されている入札戦略の名前。 | 属性 | String |
対応 |
bidStrategyInherited |
このエンティティの入札戦略が継承されているかどうかを示します。 | 属性 | Boolean |
対応 |
deviceTargets |
キャンペーン レベルでのデバイス ターゲット(Desktop 、Mobile 、Tablet 、または Other の組み合わせ)。 |
属性 | String |
× |
effectiveDeviceTargets |
キャンペーン レベルでのデバイス ターゲット(Desktop 、Mobile 、Tablet 、または Other の組み合わせ)。 |
属性 | String |
× |
languageTargets |
キャンペーン レベルのターゲット言語。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
countryTargets |
キャンペーンに含まれる対象国。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
× |
provinceTargets |
キャンペーンに含まれる都道府県ターゲット。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
metroTargets |
キャンペーンに含まれる大都市圏のターゲット。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
cityTargets |
キャンペーンに含まれる都市ターゲット。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
effectiveCountryTargets |
キャンペーンに含まれる対象国。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
effectiveProvinceTargets |
キャンペーンに含まれる都道府県ターゲット。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
effectiveMetroTargets |
キャンペーンに含まれる大都市圏のターゲット。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
effectiveCityTargets |
キャンペーンに含まれる都市ターゲット。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
excludedCountryTargets |
キャンペーンから除外された国。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
excludedProvinceTargets |
キャンペーンから除外された都道府県ターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
× |
excludedMetroTargets |
キャンペーンから除外された大都市圏のターゲット。アップロード テンプレートと地域/言語コードをダウンロードする。 | 属性 | String |
× |
excludedCityTargets |
キャンペーンから除外された都市のターゲット設定。アップロード テンプレートと地域 / 言語コードをダウンロードする。 | 属性 | String |
× |
effectiveLabels |
このキャンペーンに継承された、または直接割り当てられたすべてのラベルの名前。 | 属性 | String list |
対応 |
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 広告のみ。検索ネットワークで獲得したインプレッション数を、獲得可能だったと推定されるインプレッション数で割った値です。0.1 ~ 1 の範囲で返されます。シェアが 0.1 未満の場合は、文字列 < 10% を返します。 |
指標 | Impression share |
対応 |
searchBudgetLostImpressionShare |
Google 広告と Bing 広告のみ。予算不足が原因で、検索ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 |
指標 | Impression share |
対応 |
searchRankLostImpressionShare |
Google 広告と Bing 広告のみ。広告ランクの低さが原因で、検索ネットワークに広告が掲載されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 |
指標 | Impression share |
対応 |
displayImpressionShare |
Google 広告のみ。ディスプレイ ネットワークで発生した実際の表示回数を、表示候補となった回数の推定値で割ったものです。0.1 ~ 1 の範囲で返されます。シェアが 0.1 未満の場合は、文字列 < 10% を返します。 |
指標 | Impression share |
対応 |
displayBudgetLostImpressionShare |
Google 広告のみ。予算不足が原因で、ディスプレイ ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 |
指標 | Impression share |
対応 |
displayRankLostImpressionShare |
Google 広告のみ。広告ランクの低さが原因で、ディスプレイ ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の範囲で返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 |
指標 | Impression share |
対応 |
qualityScoreAvg |
Google 広告と Bing 広告のみ。レポート対象期間内のすべての日付とキーワードにおける、エンジンの品質スコア(QS)の加重平均。 | 指標 | Number |
対応 |
topOfPageBidAvg |
Google 広告のみ。検索結果の上部で広告が定期的に掲載されるために必要なレポート期間の平均 CPC の概算。 | 指標 | Money |
対応 |
absoluteTopImpressionPercentage |
オーガニック検索の上部で最初に表示された広告のインプレッションの割合。 | 指標 | Impression share |
対応 |
searchAbsoluteTopImpressionShare |
検索結果の最上部(オーガニック検索結果の上部の 1 番目の広告)で獲得したインプレッション数を、ページ上部に表示可能だった広告の推定インプレッション数で割った値です。 | 指標 | Impression share |
対応 |
topImpressionPercentage |
オーガニック検索結果の上の任意の場所に表示された広告インプレッションの割合。 | 指標 | Impression share |
対応 |
searchTopImpressionShare |
ページ上部に表示可能だった広告の推定インプレッション数と比較した、上部(オーガニック検索結果の上部の任意の場所)でのインプレッション数。 | 指標 | Impression share |
対応 |
searchBudgetLostAbsoluteTopImpressionShare |
予算の低さが原因で、オーガニック検索結果の上部の 1 番目に広告が表示されなかった割合(推定値)を表します。 | 指標 | Impression share |
対応 |
searchBudgetLostTopImpressionShare |
予算が低いため、オーガニック検索結果の上部に広告が表示されなかった頻度を把握できます。 | 指標 | Impression share |
対応 |
searchRankLostAbsoluteTopImpressionShare |
広告ランクの低さが原因で、オーガニック検索結果の上部に広告が最初に表示されない頻度を推定します。 | 指標 | Impression share |
対応 |
searchRankLostTopImpressionShare |
広告ランクの低さが原因で、オーガニック検索結果の上部に広告が表示されなかった割合(推定値)を表します。 | 指標 | Impression share |
対応 |
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 |
対応 |
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 |
アプリリンク表示オプション別にレポートを分割します。各行とその集計指標は、アプリリンク表示オプションごとに複数の行に分割されます。この列ではアプリ ID が返されます(存在する場合)。 | 分割 | String |
対応 |
appStore |
アプリリンク表示オプション別にレポートを分割します。各行とその集計指標は、アプリリンク表示オプションごとに複数の行に分割されます。この列では、アプリストアのタイプ(Apple App Store、Google Play ストア)が存在する場合はそれが返されます。 | 分割 | App store |
対応 |
feedItemId |
フィード アイテム別にレポートを分割します。各行とその集計指標は、フィード アイテムごとに複数の行に分割されます。この列では、各行の DS フィード アイテムの行 ID が返されます。 | 分割 | ID |
対応 |
feedId |
フィード アイテム別にレポートを分割します。各行とその集計指標は、フィード アイテムごとに複数の行に分割されます。この列では各行の DS フィード テーブル ID が返されます。 | 分割 | ID |
対応 |
feedType |
フィード アイテム別にレポートを分割します。各行とその集計指標は、フィード アイテムごとに複数の行に分割されます。この列では、各行のフィード アイテムの種類が返されます。 | 分割 | Feed type |
対応 |