선택기는 프로그래머가 요청된 Google Ads 항목을 가져오는 쿼리를 구성하는 데 도움이 됩니다. 선택기를 사용하면 검색된 항목 목록을 좁히고 정렬할 수 있습니다. 대부분의 선택기에는 다음과 같은 메서드가 있습니다.
withCondition()- 선택기에 조건을 추가합니다. 여러 조건이 사용되는 경우 AND로 결합됩니다. 즉, 선택기는 지정된 조건을 모두 충족하는 항목만 반환합니다.
withIds()- ID 모음을 조건으로 추가합니다. ID 기반 조건은 다른 모든 조건과 함께 AND로 결합됩니다.
forDateRange()- 조건 또는 정렬 절이 통계 필드(예: Ctr 또는 노출수)를 참조할 때 필요합니다. 노출수가 100회 이상인 모든 캠페인을 요청하면 Google Ads 스크립트에서 조사할 기간을 알아야 합니다.
orderBy()- 반환된 항목의 정렬을 지정합니다.
withLimit()- 반환된 항목 수를 지정된 값으로 제한합니다. 특히 '어제 노출수가 가장 많은 키워드 10개'와 같은 항목을 가져오기 위해
orderBy()와 함께 사용하면 유용합니다. 기본적으로 모든 선택기는 한도를 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");
선택기가 구성되면
Iterator를 호출하여 선택기에서
selector.get()를 가져올 수 있습니다.
효율적인 선택기 사용에 관한 도움말 및 유용한 정보는 권장사항을 참고하세요.