検索広告 360 のクエリ言語

Search Ads 360 クエリ言語を使用すると、Search Ads 360 Reporting API を使ってレポートデータとリソース メタデータを取得する検索クエリを作成できます。

検索サービス

Search Ads 360 クエリ言語を使用して、次の方法で API をクエリできます。

SearchAds360Service

このサービスを使用して、リソースとその関連する属性、セグメント、指標をクエリします。Search と SearchStream の 2 つの方法があります。

SearchAds360Service クエリは、SearchAds360Row インスタンスのリストを返します。

  • 各行はリソースを表しています。
  • リクエストされた場合、行には属性と指標フィールドが含まれます。
  • セグメントをリクエストすると、セグメント リソース タプルごとに追加の行が含まれます。

詳細については、検索レポートを作成するをご覧ください。

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 をご覧ください。レポートのセグメント化について詳しくは、セグメンテーションをご覧ください。

これは、bidding_strategy リソースの属性（利用可能な場合）を結合する campaign リソースの基本的なクエリです。このタイプの関連リソースは、属性リソースと呼ばれます。

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
  • リソースまたはフィールドは、リソース（customer、campaign など）またはフィールド（campaign.id、metrics.impressions、ad_group.id など）に置き換えます。

フィールド メタデータの取得の詳細については、リソース メタデータを取得するをご覧ください。

その他の情報

Search Ads 360 Reporting API でクエリを作成する方法について詳しくは、以下をご覧ください。