セグメンテーションは、クエリに適切なフィールドを追加するだけで、Google Ads API に実装できます(Google 広告の管理画面からメニューとして利用できます)。たとえば、クエリに segments.device
を追加すると、FROM
句でデバイスと指定したリソースの組み合わせごとに行が含まれ、統計値(インプレッション数、クリック数、コンバージョン数など)がそれらの間で分割されたレポートが作成されます。
Google 広告の管理画面では一度に 1 つのセグメントしか使用できませんが、API では 1 回のクエリで複数のセグメントを指定できます。
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 番目のオブジェクトの属性が同じであることに注意してください。インプレッションはデバイスで分割されるため、同じキャンペーンに対して 2 つ以上のオブジェクトが返されることがあります。
暗黙的セグメント分割
すべてのレポートは、最初は FROM
句で指定されたリソースによって分割されます。resource_name フィールドがクエリに明示的に含まれていない場合でも、FROM
句のリソースの resource_name フィールドが返され、指標がセグメント化されます。たとえば、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"
}
}
]
}
FROM
句で ad_group
がリソースとして指定されているため、adGroup
の resource_name
フィールドが常に返されます。
選択可能なセグメント フィールド
FROM
句で指定したリソースで、すべてのセグメント フィールドを選択できるわけではありません。例として、引き続き ad_group
リソースからクエリを実行します。セグメント フィールドを ad_group リソースから選択できるようにするには、そのフィールドが ad_group の Segments
リストに存在する必要があります。Segments
リストは、ad_group
リソースのメタデータ ページにある使用可能なフィールド テーブルの黄色の部分です。
セグメント リソース
一部のリソースから選択する場合、FROM
句でリソースのフィールドとともにフィールドを選択して、関連リソースを暗黙的に結合することもできます。これらの関連リソースは、FROM
句のメタデータ ページにあるリソースの Attributed Resources
リストにあります。ad_group
リソースの場合は、campaign
リソースからフィールドを選択することもできます。resource_name フィールドがクエリに明示的に含まれていない場合でも、SELECT
句に 1 つ以上のフィールドがある Attributed Resources
の resource_name フィールドが自動的に返されます。
Attributed Resource
フィールドの選択と同様に、Segmenting Resource
フィールドも選択できます。特定のリソースのメタデータ ページに Segmenting Resources
リストがある場合、リストされたリソースのいずれかからフィールドを選択すると、その Segmenting Resource
の返された resource_name によってクエリがさらに分割されます。たとえば、campaign
リソースは campaign_budget
リソースの Segmenting Resource
として表示されています。campaign_budget リソースから campaign.name
などのキャンペーン フィールドを選択すると、campaign.name フィールドが返されるだけでなく、campaign.resource_name
フィールドも返され、セグメントに分割されます。
セグメントと指標の選択可能性
特定のセグメント フィールドが、他の一部のセグメント フィールドまたは一部の指標フィールドと互換性がない場合があります。相互に互換性があるセグメント フィールドを特定するには、SELECT
句のセグメントの selectable_with
リストを確認します。
ad_group
リソースの場合は、選択できるセグメントが 50 以上あります。ただし、segments.hotel_check_in_date
の selectable_with
リストは、互換性のあるセグメント セットははるかに少ないものです。つまり、segments.hotel_check_in_date
フィールドを SELECT
句に追加すると、残りの使用可能なセグメントをこの 2 つのリストの交差部分に限定することになります。
- セグメントを追加すると、概要行の指標が低下することがあります
FROM ad_group_ad
を使用してクエリにsegments.keyword.info.match_type
を追加すると、そのセグメントは、キーワードを含むデータ行のみを取得し、キーワードに関連付けられていない行を削除するようクエリに指示します。この場合、キーワード以外の指標が除外されるため、指標の数は少なくなります。
WHERE 句のセグメントに関するルール
セグメントが WHERE
句に含まれている場合は、SELECT
句にも含まれている必要があります。このルールの例外となる次の日付セグメントは、コア日付セグメントと呼ばれます。
segments.date
segments.week
segments.month
segments.quarter
segments.year
主要日付セグメントのフィールドに関するルール
セグメント segments.date
、segments.week
、segments.month
、segments.quarter
、segments.year
は次のように機能します。
これらのセグメントは、
SELECT
句に含めることなく、WHERE
句でフィルタリングできます。これらのセグメントのいずれかが
SELECT
句に含まれている場合、主要な日付セグメントで構成される有限の期間をWHERE
句で指定する必要があります(SELECT
で指定した日付セグメントと同一である必要はありません)。
例
無効: segments.date が SELECT 句に含まれているため、segments.date 、segments.week 、segments.month 、segments.quarter 、または segments.year の WHERE 句で有限の期間を指定する必要があります。 |
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
リソースの場合、検索キーワードだけでなく広告グループによっても暗黙的にセグメント化されるため、リソース名の構造(広告グループも含まれます)に反映されています。そのため、実際には別の広告グループに属している場合、同じ検索語句を含む行が重複して表示されることがあります。
{
"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 photos」という検索語句は、同じ日(2015-06-15)の 2 つの広告グループ(ID 2222222222
と 33333333333
)に関連付けられます。したがって、API は意図したとおりに動作し、この場合は重複するオブジェクトは返されなかったと結論付けることができます。