Search Ads 360 쿼리 언어

Search Ads 360 쿼리 언어를 사용하면 Search Ads 360 Reporting API를 사용하여 보고 데이터 및 리소스 메타데이터

검색 서비스

Search Ads 360 Query Language를 사용하면 다음을 사용하여 API를 쿼리할 수 있습니다.

SearchAds360Service

이 서비스를 사용하여 리소스와 관련 속성, 세그먼트, 살펴볼 수 있습니다 두 가지 메서드, Search 및 SearchStream가 있습니다.

SearchAds360Service 쿼리는 SearchAds360Row 인스턴스 목록을 반환합니다.

  • 각 행은 리소스를 나타냅니다.
  • 요청 시 행에는 속성 및 측정항목 필드가 포함됩니다.
  • 분류 기준을 요청하면 각 세그먼트에 추가 행이 포함됩니다. 세그먼트 리소스 튜플입니다.

검색 보고서 만들기에서 다음을 참고하세요. 자세히 알아보세요.

SearchAds360FieldService

이 서비스를 사용하여 사용 가능한 필드 및 리소스에 대한 메타데이터를 쿼리합니다. 이 서비스는 쿼리 가능한 필드의 카탈로그와 호환성 및 유형을 나타냅니다.

SearchAds360FieldService는 SearchAds360Field 목록을 반환합니다. 인스턴스:

  • 각 필드에는 요청된 필드에 대한 세부정보가 포함됩니다.

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

기본 쿼리의 예

다음 섹션에서는 빌드에 맞게 조정할 수 있는 기본 쿼리 예를 제공합니다. 자체 쿼리를 생성할 수 있습니다.

리소스의 속성 쿼리

다음은 다음을 반환하는 campaign 리소스의 속성에 관한 기본 쿼리입니다. 캠페인 ID, 이름 및 상태를 볼 수 있습니다.

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는 채워진 campaign 객체를 나타냅니다. 선택한 캠페인 속성 및 선택한 입찰 전략 사용 속성, bidding_strategy.name.

campaign를 참고하세요. 캠페인 쿼리에 사용할 수 있는 기여 리소스를 확인할 수 있습니다.

필드 메타데이터 쿼리

SearchAds360FieldService를 사용할 수 있습니다. 사용하여 필드 메타데이터를 검색할 수 있습니다.

다음은 필드 메타데이터의 기본 쿼리입니다.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • RESOURCE 또는 FIELD을(를) 리소스(예: customer 또는 campaign) 또는 필드 (예: campaign.id, metrics.impressions 또는 ad_group.id)을 입력합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.

필드 검색에 대한 자세한 내용은 리소스 메타데이터 검색을 참조하세요. 메타데이터로 변환할 수 있습니다.

자세히 알아보기

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