検索広告 360 のクエリ言語

検索広告 360 のクエリ言語を使用すると、 Search Ads 360 Reporting API を使用してデータとリソースのメタデータをレポートする方法を学びます。

サービスを検索

Search Ads 360 Query Language を使用すると、次のように API にクエリを実行できます。

SearchAds360Service

このサービスを使用して、リソースとそれに関連する属性、セグメント、リソースをクエリし、 提供しますメソッドには、Search と SearchStream の 2 つがあります。

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

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

詳しくは、検索レポートを作成するをご覧ください。 ご確認ください。

SearchAds360FieldService

このサービスを使用して、使用可能なフィールドとリソースに関するメタデータをクエリします。 このサービスでは、クエリ可能なフィールドのカタログが用意されており、 互換性とタイプ。

SearchAds360FieldService は、SearchAds360Field のリストを返します。 インスタンス:

  • 各フィールドには、リクエストされたフィールドの詳細が含まれます。

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

基本的なクエリの例

以降のセクションでは、Google Cloud で 独自のクエリを作成できます

リソースの属性のクエリ

これは、返される campaign リソースの属性に対する基本的なクエリです。 キャンペーン ID、名前、ステータスを

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • 返される各 SearchAds360Row は、campaign オブジェクトを表します。
  • 行には、選択したフィールド（特定のキャンペーンのフィールドを含む）が入力されます。 resource_name）。
  • キャンペーン ID による並べ替え。

campaign を参照: クエリで使用できる他のフィールドも 確認できます

指標のクエリ

これは、campaign の属性に関連する指標に対する基本的なクエリです。 resource:

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 の属性に関連するセグメントに対する基本的なクエリです。 resource:

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 は 3 つのオプションがあります
  • キャンペーン ID による並べ替え。

詳しくは、segments をご覧ください。 クエリで使用できるセグメントのリストと、詳細はセグメンテーションをご覧ください。 ご覧ください

これは campaign リソースに対する基本的なクエリで、次の属性を結合します。 bidding_strategy リソース（利用可能な場合）。このタイプの関連リソースは リソースがあります。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • このクエリでは、各キャンペーン属性からキャンペーン属性と関連する属性が選択されます。 キャンペーンが選択されました
  • 返される各 SearchAds360Row は、入力された campaign オブジェクトを表します。 選択したキャンペーン属性と入札戦略が表示されます 属性、bidding_strategy.name です。

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 でクエリを作成する方法について詳しくは、以下をご覧ください。