캠페인 타겟팅

Google Ads 스크립트를 사용하면 계정에서 캠페인 수준 타겟팅 설정을 사용할 수 있습니다. 광고 일정, 타겟팅 및 제외된 위치, 타겟 인접지역, 플랫폼에 대한 지원이 제공됩니다. 이 가이드에서는 캠페인 타겟을 사용하는 방법을 설명합니다.

광고 일정

광고 일정을 이용하면 광고가 게재되는 시기를 관리할 수 있습니다.

가져오기

캠페인 타겟의 adSchedules 메서드를 사용하여 캠페인의 광고 일정을 가져올 수 있습니다. 다음 코드 스니펫은 캠페인의 모든 AdSchedule 기준 목록을 검색하는 방법을 보여줍니다.

const campaign = AdsApp.campaigns()
    .withCondition("campaign.name = 'My campaign'")
    .get()
    .next();

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

기본적으로 캠페인은 항상 게재되므로 캠페인에 맞춤 광고 일정을 설정하지 않으면 광고 일정이 반환되지 않습니다.

업데이트

광고 일정을 가져온 후 광고 일정을 직접 수정할 수 있습니다. 예를 들어 광고 일정의 입찰가 조정을 다음과 같이 업데이트할 수 있습니다.

adSchedule.setBidModifier(1.1);

만들기

새 광고 일정을 만들려면 Campaign의 addAdSchedule 메서드를 사용하세요. 다음 코드 스니펫은 계정 시간대로 매주 토요일 오전 7시부터 오전 11시까지 입찰 조정을 1.1로 설정하여 캠페인의 맞춤 광고 일정을 만듭니다.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

각 매개변수에 허용되는 값과 광고 일정을 만들 때 유의해야 할 추가 제한사항에 대한 자세한 내용은 문서를 참조하세요.

삭제

광고 일정을 삭제하려면 remove 메서드를 사용하세요. 캠페인의 맞춤 광고 예약을 재설정하려면 다음과 같이 모든 맞춤 광고 일정을 삭제합니다.

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

위치

Google Ads 스크립트를 사용하여 캠페인의 위치를 타겟팅하거나 제외할 수도 있습니다.

가져오기

캠페인 타겟의 targetedLocations 메서드를 사용하여 타겟 위치 목록을 가져올 수 있습니다. 제외된 위치는 excludedLocations 메서드를 사용하여 가져올 수 있습니다. 다음 코드 스니펫은 전월에 100회 이상의 노출이 발생한 모든 타겟 위치를 선택합니다.

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

모든 국가 및 지역에 광고를 게재하도록 캠페인을 설정한 경우 빈 위치 목록이 표시됩니다.

업데이트

위치를 가져온 후에는 속성을 직접 수정할 수 있습니다. 예를 들어 위치의 입찰가 조정을 다음과 같이 업데이트할 수 있습니다.

location.setBidModifier(1.1);

만들기

addLocation 메서드를 사용하여 캠페인에 위치 타겟을 만들 수 있습니다. 마찬가지로 excludeLocation 메서드를 사용하여 위치를 제외할 수 있습니다. 다음 코드 스니펫은 입찰가 수정자를 1.15로 설정하고 뉴욕을 제외한 미국에 대한 캠페인을 타겟팅합니다.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

위치 타겟팅을 추가할 때 사용할 ID 목록은 Google Ads API 지역 타겟팅 문서를 참고하세요. 타겟 위치의 실적을 추적하려면 location_view 보고서 리소스에서 검색하세요.

삭제

remove 메서드를 사용하여 타겟 위치를 삭제할 수 있습니다.

인접

Google Ads 스크립트를 사용하여 특정 위치 주변의 반경 (근접성)을 기준으로 캠페인을 타겟팅할 수 있습니다.

가져오기

캠페인의 타겟에서 targetedProximities 메서드를 사용하여 타겟팅된 인접지역 목록을 가져올 수 있습니다. 다음 코드 스니펫은 지난달에 100회가 넘는 노출수를 수신한 모든 타겟 인접지역을 선택합니다.

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

만들기

addProximity 메서드를 사용하여 캠페인의 인접 타겟을 만들 수 있습니다. 다음 코드 스니펫은 캠페인을 좌표 (37.423021, -122.083739) 주변 20킬로미터로 타겟팅합니다.

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

이 방법을 이용해 입찰가 조정과 주소를 포함하는 동일한 인접 타겟을 만들 수도 있습니다.

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

주소가 실제로 지정된 위도와 경도에 속하는지 확인하는 유효성 검사는 없습니다. 주소는 캠페인 관리 인터페이스에 표시되는 내용을 변경하는 것 외에는 다른 목적으로 사용되지 않습니다.

삭제

인접 타겟은 remove 메서드를 사용하여 삭제할 수 있습니다.

플랫폼

캠페인 타겟의 platforms 메서드를 사용하여 캠페인이 타겟팅하는 플랫폼 목록을 검색할 수 있습니다. Google Ads 캠페인은 모든 플랫폼 (데스크톱, 모바일, 태블릿)을 타겟팅하므로 Platform 기준을 추가하거나 삭제할 수 없습니다. 이 타겟팅 기준은 캠페인의 기기 입찰가 조정을 설정하는 데 가장 일반적으로 사용됩니다.

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

플랫폼 ID는 캠페인 간에 공유되며 Google Ads API 플랫폼 부록에 지정된 대로 사전 정의된 값을 갖습니다. 이러한 ID는 보고서를 파싱할 때 유용할 수 있습니다. 기준을 직접 선택할 때는 PlatformSelector에서 제공하는 도우미 메서드를 사용할 수 있습니다.