このページは Cloud Translation API によって翻訳されました。

セグメンテーション

分割は Google 広告の管理画面で個別のメニューとして使用でき、 Google Ads API に実装するには、クエリに適切なフィールドを追加するだけです。対象たとえば、segments.device をデバイスとデバイスの組み合わせごとの行を含むレポートが作成されます。 FROM 句で指定されたリソースと、統計値（インプレッション数、クリック数、コンバージョン数など）をそれらの値に分割します。

Google 広告の管理画面では、一度に使用できるセグメントは 1 つのみですが、 API では、同じクエリで複数のセグメントを指定できます。

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions
FROM campaign

このクエリを GoogleAdsService.SearchStream は次のような JSON 文字列になります。

{
  "results":[
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"10922"
      },
      "segments":{
        "device":"MOBILE"
      }
    },
    {
      "campaign":{
        "resourceName":"customers/1234567890/campaigns/111111111",
        "name":"Test campaign",
        "status":"ENABLED"
      },
      "metrics":{
        "impressions":"28297"
      },
      "segments":{
        "device":"DESKTOP"
      }
    },
    ...
  ]
}

上記のサンプル結果では、1 番目と 2 番目の属性はオブジェクトは同じです。インプレッションはセグメント化され device で指定できるため、同じキャンペーンで 2 つ以上のオブジェクトが返される可能性があります。

暗黙的セグメント分割

どのレポートも最初に FROM で指定されたリソース別に分割されます。句を使用します。FROM 句のリソースの resource_name フィールドは次のようになります。 resource_name フィールドが 1 つでなくても、指標がクエリに明示的に含まれていないからですたとえば、 FROM 句のリソースとして ad_group を指定し、 ad_group.resource_name のアクション自動的にレポートが返され、そのエンティティに対してできます。

このクエリでは、

SELECT metrics.impressions
FROM ad_group

次のような JSON 文字列が得られます。

{
  "results":[
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/2222222222"
      },
      "metrics":{
        "impressions":"237"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/33333333333"
      },
      "metrics":{
        "impressions":"15"
      }
    },
    {
      "adGroup":{
        "resourceName":"customers/1234567890/adGroups/44444444444"
      },
      "metrics":{
        "impressions":"0"
      }
    }
  ]
}

なお、adGroup の resource_name フィールドは常に返されます。 FROM 句でリソースとして ad_group が指定されている。

選択可能なセグメントフィールド

FROM 句の特定のリソースに対して、すべてのセグメントフィールドを選択できるわけではありません。例として、引き続き ad_group からクエリを実行します。リソースです。ad_group リソースからセグメントフィールドを選択できるようにするには、このフィールドは、ad_group の Segments リストに存在している必要があります。Segments 使用可能なフィールドの表の黄色の部分です。 ad_group リソースのメタデータページ。

セグメントに関するリソース

一部のリソースから選択する際に、暗黙的に結合するオプションが関連するリソースに対して、関連するリソースの FROM 句でリソースを宣言します。これらの関連リソースは FROM 句のメタデータにあるリソースに対する Attributed Resources リストできます。ad_group リソースの場合、次のことがわかります。 campaign のリソースです。少なくとも次の値を持つ Attributed Resources の resource_name フィールド。 SELECT 句の 1 つのフィールドが自動的に返されます。これは、 resource_name フィールドがクエリに明示的に含まれていない。

Attributed Resource フィールドを選択する場合と同様に、 Segmenting Resource フィールド。特定のリソースに Segmenting Resources があるかどうかリストを表示し、リスト内のリソースのいずれかからフィールドを選択します。返された resource_name でクエリがさらにセグメント化されます。 Segmenting Resource。例として、このスライドには、 campaign リソースが Segmenting Resource として表示されている（campaign_budget リソースに対して）いずれかを選択中キャンペーンフィールド（campaign.name など）を campaign_budget リソースによって、campaign.name フィールドだけでなく引き渡されることになりますが、 campaign.resource_name 個のフィールドを表示されます

セグメントと指標の選択性

あるセグメントフィールドは、他の一部のセグメントと互換性がない可能性があります一部の指標フィールドと組み合わせますどのセグメントフィールドが互換性がある場合は、selectable_with リストで確認できます。 SELECT 句でセグメントの見直しを行います。

この例の場合、 ad_group リソースには、利用可能なセグメントが 50 以上あります。選択できます。ただし、selectable_with リストは segments.hotel_check_in_date 互換性のあるセグメントの小さなセットですつまり、 segments.hotel_check_in_date フィールドを SELECT 句に追加すると、これら 2 つのセグメントが交差する領域まで残りの利用可能なセグメントが表示されますできます。

セグメントを追加すると、概要行の指標が低下することがあります: segments.keyword.info.match_type をクエリに追加すると、 FROM ad_group_ad の場合、そのセグメントは、次の行のみを取得するようにクエリに指示しています。キーワードを含むデータを取得し、キーワードに関連付けられていない行をすべて削除します。できます。この場合、すべての指標が除外されるため、指標の値は低くなります。指標が含まれます。

WHERE 句のセグメントのルール

セグメントを WHERE 句に含める場合は、SELECT にも含める必要がある句を使用します。このルールの例外となる次の日付セグメントは 主要な日付セグメントと呼ばれます。

segments.date
segments.week
segments.month
segments.quarter
segments.year

主要な日付セグメントフィールドのルール

セグメント segments.date、segments.week、segments.month、 segments.quarter、segments.year は次のように機能します。

これらのセグメントは、出現せずに WHERE 句でフィルタできます。 SELECT 句の中で指定します。
これらのセグメントのいずれかが SELECT 句に含まれている場合、期間は有限 主要な日付セグメントで構成されたものは、WHERE 句で指定する必要があります（日付セグメントは、 SELECT）。

例

無効: `segments.date` は `SELECT` 句で、有限期間を `segments.date` の `WHERE` 句 `segments.week`、`segments.month`、 `segments.quarter` または `segments.year`。	SELECT campaign.name, metrics.clicks, segments.date FROM campaign
有効: このクエリは、キャンペーン名と期間中に発生したクリック数。なお、`segments.date` は `SELECT` 句に含める必要はありません。	SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01'
有効: このクエリは、キャンペーン名と期間内のすべての日について、日付別に分割されたクリック数。	SELECT campaign.name, metrics.clicks, segments.date FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01'
有効: このクエリは、キャンペーン名と期間内のすべての日のクリック数（月別）	SELECT campaign.name, metrics.clicks, segments.month FROM campaign WHERE segments.date > '2020-01-01' AND segments.date < '2020-02-01'
有効: このクエリは、キャンペーン名と四半期ごとに分割され、次に年のすべての月について月ごとに分割されたクリック数。	SELECT campaign.name, metrics.clicks, segments.quarter, segments.month FROM campaign WHERE segments.year > 2015 AND segments.year < 2020

search_term_view

なお、 search_term_view リソースを使用する場合、検索語句だけでなく広告グループ別に暗示的に分割され、そのリソースの構造できます。広告グループも含まれますそのため、一部の Pod が同じ検索語句の行にこの場合、行はそれぞれ別の広告グループになります。

{
  "results":[
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~2222222222~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"3"
      },
      "segments":{
        "date":"2015-06-15"
      }
    },
    {
      "searchTermView":{
        "resourceName":"customers/1234567890/searchTermViews/111111111~33333333333~Z29vZ2xlIHBob3RvcyBpb3M",
        "searchTerm":"google photos"
      },
      "metrics":{
        "impressions":"2"
      },
      "segments":{
        "date":"2015-06-15"
      }
    }
  ]
}

この例で返される 2 つのオブジェクトは重複しているように見えますが、特に「広告グループ」で、リソース名が異なっています。なります。「google フォト」という検索キーワードは2 つの Pod に広告グループ（ID 2222222222 と 33333333333）を同じ日付（2015-06-15）に設定しました。したがって、API は意図したとおりに機能し、重複オブジェクトも認識されます

条件の指標

指標がゼロ