Search Ads 360 쿼리 언어

Search Ads 360 쿼리 언어를 사용하면 Search Ads 360 Reporting API를 통해 보고 데이터 및 리소스 메타데이터를 검색하는 검색 쿼리를 만들 수 있습니다.

검색 서비스

Search Ads 360 쿼리 언어를 사용하여 다음을 통해 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를, 보고서 분류에 관한 자세한 내용은 분류를 참고하세요.

이 쿼리는 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에서 쿼리를 빌드하는 방법을 자세히 알아보세요.