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