Google Ads 쿼리 언어

Google Ads 쿼리 언어는

리소스와 관련 속성, 세그먼트, 측정항목은
GoogleAdsService Search 또는 SearchStream
GoogleAdsService 쿼리의 결과는 다음과 같습니다. GoogleAdsRow 인스턴스(각 GoogleAdsRow 포함) 리소스를 나타냅니다 속성 또는 측정항목이 요청되면 행에도 해당 필드가 포함됩니다. 세그먼트가 요청되면 각 세그먼트-리소스 튜플에 대한 추가 행도 표시됩니다.
사용 가능한 입력란 및 리소스에 대한 메타데이터
GoogleAdsFieldService

이 서비스는 쿼리 가능한 필드의 카탈로그와 호환성 및 유형을 확인할 수 있습니다.

GoogleAdsFieldService 쿼리의 결과는 인스턴스 GoogleAdsField개(각각 포함) 요청된 필드에 대한 세부정보가 포함된 GoogleAdsField입니다.

리소스의 속성 쿼리

다음은 캠페인 리소스의 속성에 대한 기본 쿼리로, 캠페인 ID, 이름 및 상태를 반환합니다.

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

이 쿼리는 캠페인 ID를 기준으로 정렬됩니다. 각 결과 GoogleAdsRow는 다음을 나타냅니다. 선택된 필드 (주어진 해당 필드 포함)로 채워진 campaign 객체 캠페인의 resource_name)을 입력합니다.

캠페인 쿼리에 사용할 수 있는 다른 필드를 알아보려면 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인 캠페인만 필터링합니다. 캠페인 ID를 기준으로 정렬하면서 노출수가 1, 000회를 초과한 캠페인 각 결과 GoogleAdsRow은 metrics 필드에 확인할 수 있습니다

쿼리 가능한 측정항목 목록은 Metrics 문서를 참조하세요.

세그먼트 쿼리

주어진 리소스에 대해 선택한 속성 외에도 관련 세그먼트:

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회 이상인 캠페인 하지만 이 쿼리는 날짜별로 데이터를 분류합니다. 이를 통해 GoogleAdsRow는 캠페인의 튜플과 날짜 Segment를 나타냅니다. 그것은 분류 기준을 적용하면 선택한 측정항목이 각 항목별로 그룹화되고 세그먼트 세그먼트입니다.

검색 가능한 세그먼트 목록은 Segments 문서를 참조하세요.

주어진 리소스에 대한 쿼리에서 사용할 수 있습니다 이러한 관련 리소스를 '기여 분석 리소스'라고 참조하세요. 지정된 리소스에 대해 암시적으로 조인할 수 있습니다. 속성을 포함해야 합니다.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

이 쿼리는 캠페인 속성을 선택할 뿐만 아니라 속성을 찾습니다. 각 결과 GoogleAdsRow는 선택한 캠페인 속성으로 채워진 campaign 객체 및 선택한 입찰 전략 속성 bidding_strategy.name입니다.

캠페인 쿼리에 사용할 수 있는 기여 리소스를 확인하려면 Campaign 참조 문서를 확인하세요.

쿼리 결과에 따라 변형

주어진 리소스를 쿼리할 때 반환된 리소스를 즉시 가져와서 결과를 객체로 가져와 수정하고 수정 후 리소스 서비스입니다 다음은 샘플 워크플로입니다.

  1. 현재 PAUSED 상태이고 다음과 같은 모든 캠페인에 대해 쿼리를 실행합니다. 노출수가 1,000회를 초과하는지 확인합니다.
  2. 다음에서 각 GoogleAdsRow의 campaign 필드에서 Campaign 객체를 가져옵니다. 확인할 수 있습니다.
  3. 각 캠페인의 상태를 PAUSED에서 ENABLED(으)로 변경합니다.
  4. CampaignService.MutateCampaigns를 호출합니다. 해당 캠페인을 업데이트합니다.

필드 메타데이터

GoogleAdsFieldService로 전송된 쿼리는 필드 메타데이터를 검색하기 위한 것입니다. 이 정보는 필드를 함께 사용하는 방법을 이해하는 데 사용될 수 있습니다. 쿼리에서 찾을 수 없습니다. 데이터는 API에서 사용할 수 있으며 필요한 쿼리를 검증하거나 작성하는 데 필요한 메타데이터로, 이를 통해 개발자는 그렇게 해야 합니다 이 메타데이터의 일반적인 쿼리:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

이 쿼리의 <INSERT_RESOURCE_OR_FIELD>을 리소스 (예: customer 또는 campaign) 또는 필드 (예: campaign.id, metrics.impressions, ad_group.id)을 입력합니다.

쿼리 가능한 필드 목록은 GoogleAdsField 문서를 참조하세요.

코드 예시

클라이언트 라이브러리에는 GoogleAdsService의 Google Ads 쿼리 언어 basic Operations 폴더에는 다음과 같은 항목이 있습니다. 예시: GetCampaigns, GetKeywords, SearchForGoogleAdsFields reporting 폴더에는 GetKeywordStats 예가 있습니다.

다음
쿼리 문법