Search Ads 360 쿼리 언어

Search Ads 360 Query Language를 사용하면 Search Ads 360 Reporting API를 사용하여 보고 데이터 및 리소스 메타데이터를 가져오는 검색 쿼리를 작성할 수 있습니다.

Google 검색 서비스

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를 참고하고 보고서 세분화에 관한 자세한 내용은 Segmentation을 참고하세요.

다음은 사용 가능한 경우 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에서 쿼리를 작성하는 방법을 자세히 알아보세요.