이전

새로운 Google Ads 스크립트 인프라는 Google Ads API를 기반으로 합니다. API의 아키텍처가 다르기 때문에 기존 스크립트를 업데이트해야 할 수도 있습니다. Google은 이전 버전과의 호환성을 최대한 유지하기 위해 모든 노력을 기울였으므로 이러한 변경사항은 사소합니다.

보고서

대부분의 AWQL 보고서는 계속 작동합니다. 백그라운드에서 새 인프라를 사용할 때 스크립트는 AWQL 쿼리를 GAQL (Google Ads API의 새 쿼리 언어)로 변환하고 새 백엔드를 대상으로 실행한 다음 결과를 AWQL 보고서에서 원래 사용했던 형식으로 다시 변환합니다. GAQL을 사용한 쿼리는 그대로 전달됩니다.

이러한 오버헤드가 발생하므로 가능한 경우 스크립트를 살펴보고 AWQL 쿼리를 GAQL로 업데이트하는 것이 ���습니다. 스크립트와 동일한 로직을 사용하여 지정된 AWQL 쿼리의 GAQL 쿼리를 결정하는 쿼리 이전 도구를 사용하거나 대화형 쿼리 빌더를 사용하여 쿼리를 작성할 수 있습니다.

AWQL에서 GAQL로 자동 변환 시 적용되는 몇 가지 제한사항은 다음과 같습니다.

  • 모든 AWQL 쿼리가 GAQL 쿼리로 완벽하게 변환되는 것은 아닙니다. 이러한 경우 문제에 관한 세부정보가 포함된 오류 메시지가 로깅되어 수동으로 문제를 해결하는 데 도움이 됩니다.
  • AWQL의 모든 보고서 유형이 GAQL에서 지원되지는 않습니다.
  • GAQL은 '노출수가 없는 행'을 지원하지 않습니다. 보고서에 노출수 0을 포함하도록 지정하면 오류가 발생합니다.
  • 일부 모호한 필드는 필터에 사용할 수 없습니다. 예를 들어 '제목'은 다양한 광고 필드를 참조할 수 있습니다
  • 일부 필드는 다른 형식으로 결과를 반환할 수 있습니다. 예를 들어 결과 하나를 여러 열로 나눌 수 있습니다.

선택기 구성

스크립트를 사용하여 리소스를 가져올 때는 withCondition 및 orderBy 호출을 사용하여 반복기에서 결과를 제한하거나 정렬하는 것이 일반적입니다. 이러한 호출에 포함된 필드에는 이제 새 Google Ads API 이름이 사용됩니다. 예를 들어 이전에는 캠페인 이름으로 필터링하려면 다음을 사용했습니다.

.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')

이제 가능한 경우 이러한 조건에 새 필드 이름을 사용해야 합니다.

.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')

하지만 Google에서는 이전 이름을 새 이름에 매핑하기 위해 노력했으므로 스크립트가 여전히 CampaignName을 사용하는 경우 스크립트가 계속 작동하도록 런타임에 campaign.name로 자동 대체됩니다. 이전 스타일 이름에 문제가 발생하면 첫 번째 문제 해결 단계로 새 스타일 이름을 사용하도록 스크립트를 업데이트하세요.

한도

많은 한도가 이전 인프라와 동일하며 여기에서 변경하면 일반적으로 성능을 높이는 데 도움이 됩니다.

  • 시간 제한은 동일합니다. 스크립트는 30분 동안 실행될 수 있습니다.
  • 반복자는 기본적으로 50,000개의 항목을 반환하지만 이는 재정의할 수 있습니다. 이전에는 이 50,000개 한도를 맞춤설정할 수 없었습니다.
  • 단일 선택기는 최대 10,000개의 ID를 처리할 수 있습니다 (변경되지 않음).
  • 새 인프라는 단일 스크립트에서 처리할 수 있는 항목 수에 제한이 없습니다. 이전에는 한도가 250,000개였습니다.
  • 새 인프라는 실행당 만들 수 있는 키워드 또는 광고의 수에 제한이 없습니다. 이전에는 한도가 250,000개였습니다.
  • 로깅 출력은 100KB에서 잘립니다 (변경되지 않음).
  • Apps Script 서비스 (SheetsApp, MailApp 등)의 할당량은 변경되지 않습니다.
  • Google Ads의 할당량은 API를 사용하는 것처럼 적용됩니다. 즉, 스크립트에 API 비율 제한이 적용되지만 이를 통해 더 많은 보고서에 액세스하거나 실행당 더 많은 변경사항을 적용할 수 있습니다.

기타 변경사항

이러한 할당량이 새 환경에 더 이상 적용되지 않으므로ExecutionInfo getRemainingCreateQuota() 또는 getRemainingGetQuota()는 더 이상 노출되지 않습니다.