새로운 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()는 더 이상 노출되지 않습니다.