선택자는 프로그래머가 원하는 Google Ads 항목을 가져오는 쿼리를 구성하는 데 도움이 됩니다. 선택기를 사용하면 검색된 항목 목록의 범위를 좁히고 정렬할 수 있습니다. 대부분의 선택기에는 다음과 같은 메서드가 있습니다.
withCondition()- 선택기에 조건을 추가합니다. 여러 조건이 사용된 경우 AND로 연결됩니다. 즉, 선택기는 지정된 조건을 모두 충족하는 항목만 반환합니다.
withIds()- ID 모음을 조건으로 추가합니다. ID 기반 조건은 다른 조건과 함께 AND로 연결됩니다.
forDateRange()- 조건 또는 순서 절이 클릭률이나 노출수와 같은 통계 필드를 참조할 때 필요합니다. 노출수가 100회를 초과하는 모든 캠페인을 요청하는 경우 Google Ads 스크립트에서 살펴볼 기간을 알아야 합니다.
orderBy()- 반환된 항목의 순서를 지정합니다.
withLimit()- 반환되는 항목 수를 지정된 값으로 제한합니다. 특히
orderBy()와 함께 사용하면 '어제 가장 많은 노출수가 발생한 키워드 10개'와 같은 값을 가져올 때 유용합니다. 기본적으로 모든 선택기는 한도를 50,000개로 설정합니다. 수동으로 한도를 지정하여 한도를 늘릴 수 있습니다.
이러한 메서드는 순서와 관계없이 호출할 수 있습니다. 한 가지 예외로 orderBy()는 호출 순서가 중요합니다. 이 메서드를 여러 번 호출하면 여러 개의 순서 절이 지정되고 순서대로 적용됩니다. 다음 스니펫을 살펴보세요.
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
결과는 클릭수를 기준으로 내림차순으로 정렬됩니다. 클릭수가 동일할 경우 Ctr을 기준으로 오름차순으로 정렬됩니다.
선택기의 메서드 호출은 함께 체이닝할 수 있습니다. 연결할 수 있습니다.
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
다음과 같이 더 간단하게 다시 작성할 수 있습니다.
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
선택기가 구성되면 selector.get()를 호출하여 Iterator를 가져올 수 있습니다.
효율적인 선택기 사용에 대한 도움말 및 유용한 정보는 권장사항을 참조하세요.