이 페이지는 Cloud Translation API를 통해 번역되었습니다.

광고 확장 스크립트 이전

이 문서에서는 광고 확장에 액세스하거나 광고 확장을 관리하는 스크립트의 이전 프로세스를 설명합니다. 2022년 3월 28일부터 광고 확장을 업데이트하는 스크립트를 사용하는 고객은 피드 기반 광고 확장을 새로운 애셋 기반 광고 확장으로 이전할 수 있습니다. 2022년 5월 13일부터 스크립트를 가지고 광고 확장을 가져오는 고객은 피드 기반 광고 확장이 새로운 애셋 기반 광고 확장으로 이전됩니다.

개요

기존의 피드 기반 확장 프로그램 패러다임이 지원 중단되고 애셋 기반 확장 프로그램으로 대체되었습니다. Google Ads UI에서는 피드 기반 광고 확장을 '기존' 광고 확장이라고 하고, Google Ads UI에서는 애셋 기반 광고 확장을 '업그레이드된' 광고 확장이라고 합니다.

2022년 3월 28일부터 피드 기반 광고 확장은 새로운 애셋 기반 광고 확장으로 이전됩니다. 이전이 완료되면 피드 기반 광고 확장의 게재가 중단됩니다. 이 가이드에서는 Google Ads 계정에 피드 기반 광고 확장과 애셋 기반 광고 확장이 모두 있거나 피드 기반 광고 확장만 있는 경우의 이전을 간략히 설명합니다.

마이그레이션 세부정보

애셋 기반 광고 확장에 액세스하거나 이를 업데이트하려면 새 Google Ads 스크립트 환경을 사용해야 합니다. 새 Google Ads 스크립트 환경에 관한 자세한 내용은 시작 가이드를 참고하세요.

광고 확장을 가져오는 중

기존 광고 확장 선택기 집합 (예: SitelinkSelector)은 피드 기반 광고 확장 또는 애셋 기반 광고 확장 중 하나를 가져올 수 있습니다. 기본적으로 이러한 선택기는 현재 게재 중인 광고 확장 유형을 반환합니다. 다음 표에는 현재 게재되어 기본적으로 반환되는 광고 확장 유형이 요약되어 있습니다.

계정의 광고 확장 유형
피드 기반 광고 확장만	기본적으로 피드 기반 광고 확장이 표시됩니다.
확장 소재 기반 광고 확장만	기본적으로 애셋 기반 광고 확장이 반환됩니다.
피드 기반 광고 확장과 애셋 기반 광고 확장 모두	기본적으로 애셋 기반 광고 확장이 반환됩니다.

모든 피드 기반 광고 확장이 이전되면 모든 광고 확장 선택기가 기본적으로 애셋 기반 광고 확장을 반환합니다. 계속해서 withOnlyLegacy 메서드를 사용하여 피드 기반 광고 확장을 가져올 수 있습니다. 이는 이전 측정항목을 수집하는 데 유용합니다.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

대부분의 경우 피드 기반 광고 확장이 이전되기 전이나 후에는 코드를 변경할 필요가 없습니다. 그러나 코드 변경이 필요할 수 있는 몇 가지 시나리오도 있습니다.

ID로 광고 확장 필터링

피드 기반 광고 확장이 이전되면 해당하는 확장 소재 기반 광고 확장의 ID가 다른 ID를 갖게 됩니다. 즉, 스크립트가 현재 ID로 광고 확장을 필터링하는 경우 애셋 기반 광고 확장을 가져올 수 없습니다.

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

이 문제를 해결하려면 다른 속성으로 필터링하거나 애셋 기반 광고 확장의 ID를 대신 사용하도록 코드를 업데이트해야 합니다.

통계로 광고 확장 필터링

피드 기반 광고 확장이 이전되면 해당하는 확장 소재 기반 광고 확장의 통계가 재설정됩니다. 통계를 기준으로 광고 확장을 필터링할 때 이 점을 고려해야 합니다. 예를 들어 LAST_MONTH에 Clicks > 100가 포함된 사이트링크 광고 확장을 요청하면 피드 기반 광고 확장이 최근에 이전된 경우 광고 확장이 평소보다 적게 표시될 수 있습니다.

광고 확장의 실적 보고서를 생성할 때도 이 점을 염두에 두어야 합니다. 피드 기반 광고 확장이 이전되면 보고서에 상당한 변동 또는 감소가 발생할 수 있습니다.

지원 중단된 메서드

이전 과정에서 일부 필드가 더 이상 지원되지 않습니다. 예를 들어 시작일과 종료일은 스니펫 확장 프로그램에서 지원 중단되었습니다. getStartDate()를 호출하면 null가 반환됩니다. 또한 경고 메시지가 로깅됩니다. 지원 중단된 메서드를 알아보려면 다음 표를 참고하세요.

클래스	지원 중단된 메서드
콜아웃	지원 중단된 메서드 없음
MobileApp	`getSchedules`
PhoneNumber	`getEndDate` `getStartDate`
가격	`getEndDate` `getSchedules` `getStartDate`
사이트링크	지원 중단된 메서드 없음
snippet	`getEndDate` `getSchedules` `getStartDate`

광고 확장 업데이트

이전 과정에서 일부 필드가 더 이상 지원되지 않습니다. 예를 들어 시작일과 종료일은 스니펫 확장 프로그램에서 지원 중단되었습니다. setStartDate 호출은 광고 확장에 영향을 주지 않습니다. 또한 경고 메시지가 로깅됩니다. 지원 중단된 메서드를 알아보려면 다음 표를 참고하세요.

클래스	지원 중단된 메서드
콜아웃	지원 중단된 메서드 없음
MobileApp	`setSchedules`
PhoneNumber	`clearEndDate` `clearStartDatesetEndDate` `setStartDate`
가격	`clearEndDate` `clearStartDatesetEndDate` `setSchedules` `setStartDate`
사이트링크	지원 중단된 메서드 없음
snippet	`clearEndDate` `clearStartDatesetEndDate` `setSchedules` `setStartDate`

광고 확장 만들기

기존 광고 확장 빌더 집합 (예: SitelinkBuilder)을 사용하면 피드 기반 광고 확장 또는 확장 소재 기반 광고 확장을 만들 수 있습니다. 기본적으로 이러한 빌더는 현재 게재 중인 광고 확장 유형을 만듭니다. 다음 표에는 현재 게재 중이며 기본적으로 생성되는 광고 확장 유형이 요약되어 있습니다.

계정의 광고 확장 유형
피드 기반 광고 확장만	피드 기반 광고 확장은 기본적으로 생성됩니다.
확장 소재 기반 광고 확장만	확장 소재 기반 광고 확장이 기본적으로 생성됩니다.
피드 기반 광고 확장과 애셋 기반 광고 확장 모두	확장 소재 기반 광고 확장이 기본적으로 생성됩니다.

고객이 광고 확장을 이전하면 모든 광고 확장 작성 도구는 기본적으로 애셋 기반 광고 확장을 만듭니다. 피드 기반 광고 확장이 더 이상 게재되지 않으므로 피드 기반 광고 확장 만들기는 더 이상 지원되지 않습니다.

기본 동작에 의존하는 대신 피드 기반 확장 프로그램을 만들려면 build() 대신 build(true)를 호출하면 됩니다. 예를 들면 다음과 같습니다.

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

애셋 기반 광고 확장을 만들려고 하는데 현재 계정에 피드 기반 광고 확장만 있는 경우 3월 28일까지 기다리거나 build(false)에 전화하세요.

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

지원되지 않는 필드

광고 확장 이전의 일환으로 일부 필드의 지원이 중단되었습니다. 예를 들어 시작일과 종료일은 스니펫 광고 확장에서 지원 중단되었습니다. withEndDate 또는 withStartDate 호출은 확장 프로그램에 영향을 주지 않으며 대신 경고 메시지가 로깅됩니다. 각 클래스에서 지원 중단된 메서드를 알아보려면 다음 표를 참고하세요.

클래스	지원 중단된 메서드
CalloutBuilder	`withMobilePreferred`
MobileAppBuilder	`withMobilePreferred` `withSchedules`
PhoneNumberBuilder	`withEndDate` `withMobilePreferred` `withStartDate`
PriceBuilder	`withEndDate` `withMobilePreferred` `withSchedules` `withStartDate`
SitelinkBuilder	`withMobilePreferred`
SnippetBuilder	`withEndDate` `withMobilePreferred` `withSchedules` `withStartDate`