レポートタイプ: キーワード

キーワードのパフォーマンス指標と構成属性。

このレポートを返すことができるのは、非同期リクエスト（ 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 広告グループの上限クリック単価を上書きし、この特定のキーワードの広告がクリックされた場合にお支払いいただく上限額を設定します。このフィールドが空の場合、キーワードでは広告グループの上限クリック単価が使用されます。 属性 Money ○
effectiveKeywordMaxCpc このキーワードで有効な上限クリック単価（上限クリック単価）です。これは、広告グループの上限クリック単価と同じ値か、キーワードによって広告グループの設定がオーバーライドされている場合はキーワード独自の上限クリック単価のいずれかになります。 属性 Money ○
keywordLandingPage ユーザーが広告をクリックしたときにアクセスする最終ページ URL。ランディング ページ URL とクリックサーバー URL をご覧ください。 属性 String ○
keywordClickserverUrl DS がアクティビティのトラッキングに使用する URL。広告をクリックしたユーザーは、まずクリックサーバー URL にアクセスし、その後、最終的なランディング ページにリダイレクトされます。ランディング ページ URL とクリックサーバー URL をご覧ください。 属性 String ○
isDisplayKeyword ディスプレイ レポートとプレースメント レポートに使用されるプレースホルダ キーワードかどうかを示します。 属性 Boolean ○
keywordMaxBid このキーワードが DS 入札戦略によって管理されている場合、入札戦略によって入札単価がこの上限を超えることはありません。詳しくは、キーワードに入札戦略を適用するをご覧ください。 属性 Money ○
keywordMinBid このキーワードが DS 入札戦略によって管理されている場合、入札戦略によって入札単価がこの上限を下回ることはありません。詳しくは、キーワードに入札戦略を適用するをご覧ください。 属性 Money ○
keywordUrlParams ランディング ページに余分な URL パラメータが追加されました。URL パラメータを追加するをご覧ください。 属性 String ○
bingKeywordParam2 Bing Ads キーワードの Param2。 属性 String ○
bingKeywordParam3 Bing Ads キーワードの Param3。 属性 String ○
keywordLabels このキーワードに直接割り当てられたラベルの名前継承されたラベルは含まれません 属性 String list ○
qualityScoreCurrent Google 広告と Bing Ads のみ。キーワードに対するエンジンの品質スコア（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 Ads のみ。レポート範囲内のすべての日付とキーワードにおけるエンジンの品質スコア（QS）のインプレッション加重平均。 指標 Number ○
topOfPageBidAvg Google 広告のみ。レポートの期間内で常に検索結果ページの上部に広告を表示するために必要な平均クリック単価の見積もりです。 指標 Money ○
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 ○
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 ○