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에서 쿼리를 작성하는 방법에 대해 자세히 알아보세요.