キャンペーンのパフォーマンス指標と設定属性。
このレポートは、非同期リクエスト(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 |
動的検索広告キャンペーン ID。 | 属性 | ID |
はい |
campaignStatus |
キャンペーンのステータス: Active 、Paused 、Removed 。キャンペーン、広告グループ、キーワード、広告、ターゲットにはそれぞれ固有のステータスがあります。ステータスを確認する。 |
属性 | Status |
はい |
campaignEngineId |
外部エンジン アカウントのキャンペーンの ID。 | 属性 | ID |
はい |
campaignStartDate |
キャンペーンの開始日。 | 属性 | Date |
はい |
campaignEndDate |
キャンペーンの終了日。 | 属性 | Date |
はい |
bingAdsBudgetType |
Bing Ads キャンペーンの予算管理方法: 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 |
Google 広告がこのキャンペーンで使用する入札戦略(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 を使用します。動的検索広告入札戦略を使用しているキャンペーンは 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 Ads のみ。検索ネットワークで獲得したインプレッション数を、獲得可能だったと推定されるインプレッション数で割ったものです。0.1 ~ 1 の間の数値として返されます。シェアが 0.1 未満の場合は、文字列 < 10% が返されます。 |
指標 | Impression share |
はい |
searchBudgetLostImpressionShare |
Google 広告と Bing Ads のみ。予算不足が原因で、検索ネットワークに広告が表示されなかった回数の割合です。0 ~ 0.9 の間の数値として返されます。シェアが 0.9 を超える場合は、文字列 > 90% として返されます。 |
指標 | Impression share |
はい |
searchRankLostImpressionShare |
Google 広告と Bing Ads のみ。広告ランクの低さが原因で、検索ネットワークに広告が表示されなかった回数の割合です。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 Ads のみ。レポートの対象範囲内のすべての期間とキーワードを横断して、インプレッション数によるウェイトを加味したエンジンの品質スコア(QS)の平均値。 | 指標 | Number |
はい |
topOfPageBidAvg |
Google 広告のみ。レポートの期間内に、検索結果の上位に広告を定期的に表示するために必要な平均クリック単価の推定額です。 | 指標 | Money |
はい |
absoluteTopImpressionPercentage |
オーガニック検索結果の上の最初の広告として表示される広告のインプレッションの割合。 | 指標 | Impression share |
はい |
searchAbsoluteTopImpressionShare |
オーガニック検索結果の上部に表示される広告で、1 番上に表示された広告の実際の数(実際のインプレッション数)を、上部に表示可能だった広告の推定インプレッション数で割ったものです。 | 指標 | Impression share |
はい |
topImpressionPercentage |
オーガニック検索結果の上のどこかに表示された広告のインプレッションの割合。 | 指標 | Impression share |
はい |
searchTopImpressionShare |
上部で受け取ることが可能だったインプレッションの推定数と比較される上部(オーガニック検索結果上のどこか)で受け取ったインプレッション数。 | 指標 | Impression share |
はい |
searchBudgetLostAbsoluteTopImpressionShare |
予算が少ないことが原因で、広告がオーガニック検索結果の上の最初の広告でなかった回数の推定値。 | 指標 | Impression share |
はい |
searchBudgetLostTopImpressionShare |
予算の低さが原因で、オーガニック検索結果ページの上部のどこにも広告が表示されなかった割合(推定値)を表します。 | 指標 | 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 |
はい |