検索広告 360 のクエリ言語を利用すると、Search Ads 360 Reporting API を使ってレポートデータとリソース メタデータを取得する検索クエリを作成できます。
サービスを検索
検索広告 360 のクエリ言語では、次を使って API にクエリを実行できます。
SearchAds360Service
このサービスを使用して、リソースとそれに関連する属性、セグメント、指標をクエリします。メソッドには、
Search
とSearchStream
の 2 つがあります。SearchAds360Service
クエリは、SearchAds360Row
インスタンスのリストを返します。- 各行は 1 つのリソースを表します。
- リクエストされた場合、行には属性と指標フィールドが含まれます。
- セグメントをリクエストすると、セグメントとリソースのタプルごとに追加の行が追加されます。
詳細については、検索レポートを作成するをご覧ください。
SearchAds360FieldService
このサービスを使用して、使用可能なフィールドとリソースに関するメタデータをクエリします。このサービスには、互換性とタイプの詳細を含むクエリ可能なフィールドのカタログが用意されています。
SearchAds360FieldService
はSearchAds360Field
インスタンスのリストを返します。- 各フィールドには、リクエストされたフィールドの詳細が含まれます。
詳細については、リソース メタデータの取得をご覧ください。
基本的なクエリの例
以降のセクションでは、独自のクエリの作成に使用できる基本的なクエリの例について説明します。
リソースの属性のクエリ
以下は、キャンペーン ID、名前、ステータスを返す campaign
リソースの属性に対する基本的なクエリです。
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- 返される各
SearchAds360Row
はcampaign
オブジェクトを表します。 - 行には選択したフィールド(指定したキャンペーンの
resource_name
を含む)が入力されます。 - キャンペーン ID 別のクエリの並べ替え。
クエリで使用できる他のフィールドについては、campaign
をご覧ください。
指標のクエリ
これは、campaign
リソースの属性に関連する指標に対する基本的なクエリです。
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- このクエリでは、ステータスが
PAUSED
で、インプレッション数が 1,000 を超えているキャンペーンが返されます。 - 返される各
SearchAds360Row
には、選択した指標が入力されたmetrics
フィールドがあります。 - キャンペーン ID 別のクエリの並べ替え。
クエリで使用できるその他の指標については、metrics
をご覧ください。
セグメントのクエリ
以下は、campaign
リソースの属性に関連するセグメントに対する基本的なクエリです。
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- このクエリでは、ステータスが
PAUSED
で、インプレッション数が 1,000 を超えているキャンペーンが返されます。 - データが日付別に分割される。
- セグメンテーションの結果、各
SearchAds360Row
はキャンペーンと日付セグメントのタプルを表します。 - キャンペーン ID 別のクエリの並べ替え。
クエリで使用できるセグメントのリストについては segments
を、レポートのセグメント化について詳しくはセグメンテーションをご覧ください。
関連リソースの属性のクエリ
campaign
リソースに対する基本的なクエリで、bidding_strategy
リソースの属性を結合します(利用可能な場合)。このタイプの関連リソースは、帰属するリソースと呼ばれます。
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- このクエリは、選択した各キャンペーンからキャンペーン属性と関連属性を選択します。
- 返される各
SearchAds360Row
は、選択したキャンペーン属性と選択した入札戦略属性bidding_strategy.name
が入力されたcampaign
オブジェクトを表します。
キャンペーン クエリで使用可能な帰属リソースを確認するには、campaign
をご覧ください。
フィールド メタデータのクエリ
SearchAds360FieldService
を使用してフィールド メタデータを取得できます。
フィールド メタデータに対する基本的なクエリは次のとおりです。
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- RESOURCE OR FIELD は、リソース(
customer
、campaign
など)またはフィールド(campaign.id
、metrics.impressions
、ad_group.id
など)に置き換えます。
フィールド メタデータの取得の詳細については、リソース メタデータの取得をご覧ください。
詳細
Search Ads 360 Reporting API でクエリを作成する方法について詳しくは、以下をご覧ください。