Search Ads 360 쿼리 언어

Search Ads 360 Query Language를 사용하면 Search Ads 360 Reporting API를 사용하여 보고 데이터 및 리소스 메타데이터를 검색하는 검색어를 빌드할 수 있습니다.

서비스 검색

Search Ads 360 Query Language의 경우 다음을 이용하여 API를 쿼리할 수 있습니다.

SearchAds360Service

이 서비스를 사용하여 리소스 및 관련 속성, 세그먼트, 측정항목을 쿼리합니다. 메서드에는 Search 및 SearchStream, 두 가지가 있습니다.

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
  • RESOURCE OR FIELD를 리소스 (예: customer 또는 campaign) 또는 필드 (예: campaign.id, metrics.impressions, ad_group.id)로 바꿉니다.

필드 메타데이터 검색에 대한 자세한 내용은 리소스 메타데이터 검색을 참조하세요.

자세히 알아보기

Search Ads 360 Reporting API에서 쿼리를 작성하는 방법에 대해 자세히 알아보세요.