이전

새 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인 행'을 지원하지 않습니다. 보고서에 노출수가 0이 포함되어야 한다고 지정하면 오류가 발생합니다.
  • 모호한 필드 일부는 필터에서 사용할 수 없습니다. 예를 들어 '광고 제목'은 여러 광고 필드를 참조할 수 있습니다.
  • 일부 필드는 결과를 다른 형식으로 반환할 수 있습니다. 예를 들어 하나의 결과를 여러 열로 분할할 수 있습니다.

선택기 정리

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

.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')

이제 가능하면 다음 조건에 새 필드 이름을 사용해야 합니다.

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

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

한도

많은 제한사항은 이전 인프라와 동일하며 여기에서 변경하면 일반적으로 실적이 향상됩니다.

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

기타 변경사항

ExecutionInfo는 getRemainingCreateQuota() 또는 getRemainingGetQuota()를 더 이상 노출하지 않습니다. 이러한 할당량이 새 환경에 더 이상 적용되지 않기 때문입니다.