キーワードのパフォーマンス指標と構成属性
このレポートは、非同期リクエスト（Reports.request() メソッド経由）でのみ返すことができます。
抜粋をリクエスト
通常の Reports.request() リクエストの本文を送信しますが、"reportType": "keyword" を指定します。
{
...
"reportType": "keyword",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName を指定します。headerText、startDate、endDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。
columnName | 説明 | 動作 | タイプ | フィルタ可能 |
|---|---|---|---|---|
status |
キーワードのステータス: Active、Paused、または Removed。キャンペーン、広告グループ、キーワード、広告には、それぞれ固有のステータスがあります。ステータスをご覧ください。 |
属性 | Status |
対応 |
engineStatus |
外部エンジン アカウントにおけるキーワードの追加ステータスです。考えられるステータス（外部アカウントの種類によって異なります）には、criterion rarely served、criterion below first page bid、criterion low quality score、review、campaign paused などがあります。 |
属性 | 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 |
対応 |
adGroup |
広告グループ名: | 属性 | String |
対応 |
adGroupId |
DS 広告グループ ID。 | 属性 | ID |
対応 |
adGroupStatus |
このアイテムが含まれる広告グループのステータス。 | 属性 | Status |
対応 |
keywordId |
DS キーワード ID。値が 0 の場合、そのキーワードには貢献度が割り当てられていません。 | 属性 | ID |
対応 |
keywordMatchType |
キーワードのマッチタイプ: Broad、Exact、Phrase、または Content。 |
属性 | Match type |
対応 |
keywordText |
キーワード テキスト。 | 属性 | String |
対応 |
keywordEngineId |
外部エンジン アカウントのキーワードの ID。 | 属性 | ID |
対応 |
keywordMaxCpc |
広告グループの上限クリック単価をオーバーライドし、このキーワードで広告がクリックされた場合に支払う上限額を設定します。このフィールドが空の場合、キーワードには広告グループの上限 CPC が使用されます。 | 属性 | Money |
対応 |
effectiveKeywordMaxCpc |
このキーワードで適用される上限クリック単価（上限 CPC）。この値は、広告グループの上限 CPC と同じ値になります。キーワードが広告グループの設定を上書きしている場合は、キーワード自体の上限 CPC になります。 | 属性 | Money |
対応 |
keywordLandingPage |
ユーザーが広告をクリックしたときに表示される最終ページ URL。ランディング ページとクリックサーブ URL をご覧ください。 | 属性 | String |
対応 |
keywordClickserverUrl |
DS がアクティビティのトラッキングに使用する URL。広告をクリックしたユーザーはまずクリックサーブ URL にアクセスし、次に最終的なランディング ページにリダイレクトされます。ランディング ページとクリックサーブ URL をご覧ください。 | 属性 | String |
対応 |
isDisplayKeyword |
ディスプレイ キャンペーン、プレースメント レポートに使用されるプレースホルダ キーワードかどうかを示します。 | 属性 | Boolean |
対応 |
keywordMaxBid |
キーワードが DS 入札戦略によって管理されている場合、入札戦略がこの上限を超えることはありません。詳しくは、キーワードに入札戦略を適用するをご覧ください。 | 属性 | Money |
対応 |
keywordMinBid |
このキーワードが DS 入札戦略によって管理されている場合、入札戦略がこの上限を下回ることはありません。詳しくは、キーワードに入札戦略を適用するをご覧ください。 | 属性 | Money |
対応 |
keywordUrlParams |
追加の URL パラメータがランディング ページに追加されました。URL パラメータを追加するをご覧ください。 | 属性 | String |
対応 |
bingKeywordParam2 |
Bing Ads キーワードのパラメータ 2。 | 属性 | String |
対応 |
bingKeywordParam3 |
Bing Ads キーワードのパラメータ 3。 | 属性 | String |
対応 |
keywordLabels |
このキーワードに直接割り当てられているラベルの名前。継承されたラベルは含まれません。 | 属性 | String list |
対応 |
qualityScoreCurrent |
Google 広告と Bing 広告のみ。キーワードの最新の品質スコア（QS）です。この列には、レポートの期間に関係なく、常にキーワードの最新の QS が表示されます。 | 属性 | Integer |
対応 |
topOfPageBidCurrent |
Google 広告のみ。検索結果の上部に広告を表示するために通常必要な現在のクリック単価を概算します。なお、この列にはレポートの期間に関係なく、現在必要な CPC が表示されます。 | 属性 | Money |
対応 |
effectiveBidStrategyId |
このエンティティに割り当てられている、またはこのエンティティによって継承されている入札戦略の DS ID。 | 属性 | ID |
対応 |
effectiveBidStrategy |
このエンティティに割り当てられている、またはこのエンティティによって継承されている入札戦略の名前。 | 属性 | String |
対応 |
bidStrategyInherited |
このエンティティの入札戦略が継承されているかどうかを示します。 | 属性 | Boolean |
対応 |
effectiveLabels |
このキーワードに継承された、または直接割り当てられたすべてのラベルの名前。 | 属性 | String list |
対応 |
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 |
対応 |
qualityScoreAvg |
Google 広告と Bing 広告のみ。レポート対象期間内のすべての日付とキーワードにおける、エンジンの品質スコア（QS）の加重平均。 | 指標 | Number |
対応 |
topOfPageBidAvg |
Google 広告のみ。検索結果の上部で広告が定期的に掲載されるために必要なレポート期間の平均 CPC の概算。 | 指標 | Money |
対応 |
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 |
対応 |
ad |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では各行の広告名が返されます。 | 分割 | String |
対応 |
adId |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告の DS ID が返されます。 | 分割 | ID |
対応 |
isUnattributedAd |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列には、この行の指標が特定の広告に関連付けられていないかどうかを示します。 | 分割 | Boolean |
対応 |
adHeadline |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では各行の広告見出しが返されます。 | 分割 | String |
対応 |
adHeadline2 |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告見出し 2 が返されます。一部のエンジンでは使用できません。 | 分割 | String |
対応 |
adHeadline3 |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告見出し 3 が返されます。一部のエンジンでは使用できません。 | 分割 | String |
対応 |
adDescription1 |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告の説明行 1 が返されます。 | 分割 | String |
対応 |
adDescription2 |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告の説明行 2 が返されます。 | 分割 | String |
対応 |
adDisplayUrl |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告の表示 URL が返されます。 | 分割 | String |
対応 |
adLandingPage |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告のランディング ページが返されます。 | 分割 | String |
対応 |
adType |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の広告の種類（Text または Product）が返されます。 |
分割 | Ad type |
対応 |
adPromotionLine |
レポートを広告別に分割します。各行とその集計指標は、広告ごとに最大 1 つの行に分割されます。この列では、各行の商品広告のプロモーション行が返されます。 | 分割 | String |
対応 |