선택기는 프로그래머가 원하는 Google Ads 항목을 가져오는 쿼리를 구성하는 데 도움이 됩니다. 선택기를 사용하면 검색된 항목의 목록을 좁히고 정렬할 수 있습니다. 대부분의 선택기에는 다음과 같은 메서드가 있습니다.
withCondition()- 선택기에 조건을 추가합니다. 여러 조건이 사용되면 조건이 AND 연산으로 연결됩니다. 즉, 선택기는 지정된 조건을 모두 충족하는 항목만 반환합니다.
withIds()- ID 컬렉션을 조건으로 추가합니다. ID 기반 조건은 다른 모든 조건과 함께 AND로 연결됩니다.
forDateRange()- 조건 또는 순서 절에서 Ctr 또는 노출수와 같은 통계 필드를 참조할 때 필요합니다. 노출수가 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를 가져올 수 있습니다.
권장사항에서 효율적인 선택자 사용에 관한 도움말과 요령을 읽어보세요.