レポートタイプ: 検索広告とオーガニック

有料とオーガニックのレポートには、Google で広告の表示につながった検索語句、Google でサイトの無料(オーガニック)検索結果の表示につながった検索語句、またはその両方が表示されます。レポートには、レポート対象のエンジン アカウントで有料とオーガニックのレポートを設定している場合にのみ結果が返されます。

このレポートは、非同期リクエスト(Reports.request() メソッド経由)でのみ返すことができます。

抜粋をリクエスト

通常の Reports.request() リクエストの本文を送信しますが、"reportType": "paidAndOrganic" を指定します。

{
...
  "reportType": "paidAndOrganic",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

レポート内で返されたりフィルタリングしたりしたい列ごとに、以下の表に示す columnName を指定します。headerTextstartDateendDate を指定することもできます。なお、一部の列はフィルタできません。下の表の「フィルタ可能」をご覧ください。

columnName説明動作タイプフィルタ可能
agency 代理店名。 属性 String 対応
agencyId DS 代理店 ID 属性 ID 対応
advertiser 広告主名。 属性 String 対応
advertiserId DS 広告主 ID 属性 ID 対応
account エンジン アカウント名。 属性 String 対応
accountId DS エンジン アカウント ID。 属性 ID 対応
accountEngineId 外部エンジン アカウントの ID。 属性 String 対応
accountType エンジン アカウントの種類: Google AdWordsBing AdsYahoo Japan Listing AdsYahoo Search MarketingYahoo GeminiBaidu、または Comparison Shopping 属性 Engine type 対応
searchQuery Google ユーザーが入力した検索語句。 属性 String 対応
serpType

Google ユーザーがクリックした検索結果の種類。

表示される値は次のとおりです。

  • オーガニックのみ: このクエリを入力したユーザーは、無料の検索結果しかクリックしていません。
  • 支払い済みのみ: このクエリを入力したユーザーは、広告のみをクリックしました。
  • 検索広告とオーガニック検索: このクエリを入力したユーザーの中には、料金のかからない検索結果をクリックしたユーザーと、広告をクリックしたユーザーがあります(両方をクリックした可能性も考えられます)。
属性 SERP type 対応
paidClicks ユーザーが検索クエリを入力した後に広告がクリックされた回数です。 指標 Integer 対応
organicClicks ユーザーが searchQuery を入力した後の、サイトの無料の検索結果のクリック数。 指標 Integer 対応
paidAndOrganicClicks ユーザーが検索語句を入力した後に、お客様のサイトで表示された広告または無料の検索結果のクリック数です。 指標 Integer 対応
paidImpressions ユーザーが検索語句を入力した後に、検索結果ページまたは Google ネットワーク内のウェブサイトに広告が表示された回数です。 指標 Integer 対応
organicQueries ユーザーが searchQuery に入って、あなたのサイトからオーガニック検索結果を 1 回以上閲覧した合計回数です。 指標 Integer 対応
paidAndOrganicQueries ユーザーが searchQuery にアクセスし、少なくとも 1 つの広告またはサイトのオーガニック検索結果が表示された合計回数です。 指標 Integer 対応
paidCtr 広告のクリック率です。広告が表示されたユーザーが検索クエリを入力して広告をクリックする頻度を表します。 指標 Number 対応
organicCtr サイトの無料の検索結果を目にしたユーザーが、最終的に無料の結果をクリックしてサイトにアクセスする割合です。 指標 Number 対応
paidAndOrganicCtr サイトまたは無料検索結果の広告を目にしたユーザーが、最終的にそのいずれかをクリックしてサイトにアクセスする割合。 指標 Number 対応
paidAvgPos ユーザーが検索語句を入力した後の、広告の平均掲載順位です。 指標 Number 対応
organicAvgPos サイトの無料検索結果の平均掲載順位。 指標 Number 対応
paidCostPerClick 広告の平均クリック単価。広告の 1 回のクリックに対してお支払いいただく金額の平均です。 指標 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 対応
campaign レポートをキャンペーン別に分割します。各行とその集計指標は、レポートの対象に含まれるキャンペーンごとに 1 行ずつ、複数に分割されます。この列ではキャンペーン名が返されます。 分割 String 対応
campaignId レポートをキャンペーン別に分割します。各行とその集計指標は、レポートの対象に含まれるキャンペーンごとに 1 行ずつ、複数に分割されます。この列では DS キャンペーン ID が返されます。 分割 ID 対応
adGroup レポートを広告グループ別に分割します。各行とその集計指標は、レポート範囲の広告グループごとに 1 行ずつ、複数に分割されます。この列では広告グループ名が返されます。 分割 String 対応
adGroupId レポートを広告グループ別に分割します。各行とその集計指標は、レポート範囲の広告グループごとに 1 行ずつ、複数に分割されます。この列では DS 広告グループ ID が返されます。 分割 ID 対応
keywordId レポートをキーワードで分割します。各行とその集計指標は、レポートの対象に含まれるキーワードごとに 1 行ずつに分割されます。この列では DS キーワード ID が返されます。 分割 ID 対応
keywordMatchType レポートをキーワードで分割します。各行とその集計指標は、レポートの対象に含まれるキーワードごとに 1 行ずつに分割されます。この列には、キーワードのマッチタイプが返されます。 分割 Match type 対応
keywordText レポートをキーワードで分割します。各行とその集計指標は、レポートの対象に含まれるキーワードごとに 1 行ずつに分割されます。この列はキーワード テキストを返します。 分割 String 対応