2025년 8월 7일 목요일
변경되는 사항
작년에 발표한 바와 같이, Google은 2025년 10월에 새로운 규정이 시행되기에 앞서 유럽연합에서 정치 광고 게재를 중단할 예정입니다. 2025년 9월 3일부터 Google Ads API 및 Google Ads 스크립트에서 이 변경사항과 관련된 시정 조치가 시행됩니다. 이러한 제품 중 하나를 사용하여 캠페인을 만들거나 관리하는 경우 2025년 9월 3일 전에 이러한 시정 조치를 처리하도록 애플리케이션을 업데이트해야 할 수 있습니다.
EU 정치 광고 자체 선언을 위한 API 지원
Google Ads API 및 Google Ads 스크립트에 캠페인에 EU 정치 광고가 포함되어 있는지 여부를 직접 선언하는 기능이 추가되었습니다. 여기에서 EU 정치 광고의 정의를 알아보세요. API 버전 v19.2, v20.1, v21에는 Campaign 객체에 contains_eu_political_advertising 라는 새 필드가 포함되어 있습니다. 가능한 값과 그 의미는 아래 표에 나와 있습니다.
| 값 | 의미 |
CONTAINS_EU_POLITICAL_ADVERTISING
|
캠페인에 EU 정치 광고가 있습니다. |
DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
|
캠페인에 EU 정치 광고가 없습니다. |
UNSPECIFIED
|
캠페인에 EU 정치 광고에 관한 자체 신고가 누락되었습니다. |
GoogleAdsService의 Search 또는 SearchStream 메서드를 사용하여 다음 쿼리를 실행하면 Google Ads API에서 캠페인의 자체 선언 상태를 가져올 수 있습니다. Google Ads 스크립트의 경우 AdsApp.search 또는 AdsApp.report 메서드를 사용합니다.
select campaign.id, campaign.contains_eu_political_advertising from campaign
Google Ads API 클라이언트 라이브러리를 사용하는 경우 API 버전 v19 및 v20에서 이 기능을 사용하려면 최신 라이브러리 버전을 다운로드해야 할 수 있습니다.
API 유효성 검사 및 시행 변경사항
2025년 9월 3일부터 Google Ads API 및 Google Ads 스크립트는 API 버전 v19 및 v20에서 다음 검사를 시행합니다.
- Google Ads API 또는 Google Ads 스크립트를 통해 생성된 모든 새 캠페인은
contains_eu_political_advertising필드를 설정해야 합니다. 이 필드가 설정되지 않은 경우CampaignService.MutateCampaigns를 사용하여 새 캠페인을 만드는 API 호출이FieldError.REQUIRED오류와 함께 실패합니다. Google Ads 스크립트는AdsApp.mutate또는AdsApp.mutateAll메서드를 사용하여 캠페인을 만들 때 이러한 검사를 시행합니다. - 기존의 모든 캠페인은 캠페인 또는 광고 그룹 수준에서
proximity, location,또는location_group타겟팅을 변경하기 전에contains_eu_political_advertising필드를 설정해야 합니다. 캠페인이 자체 선언을 완료하지 않은 경우 기존 캠페인에CampaignCriterionService.MutateCampaignCriteria메서드를 사용하여 이러한 캠페인 기준을 만들거나 업데이트하는 API 호출이CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION오류와 함께 실패합니다. 캠페인이 자체 선언을 완료하지 않은 경우AdGroupCriterionService.MutateAdGroupCriteria를 사용하여 이러한 광고 그룹 기준을 만들거나 업데이트하는 API 호출도 유사한 방식으로 실패합니다. Google Ads 스크립트는AdsApp.mutate,AdsApp.mutateAll,AdsApp.Campaign.addProximity,AdsApp.Campaign.addLocation메서드를 사용하여 타겟팅을 변경하려고 할 때 이러한 검사를 시행합니다. - 이러한 시정 조치는 일괄 작업을 실행하고
GoogleAdsService.Mutate메서드를 사용하여 항목을 만들고 업데이트하는 등 캠페인을 만드는 데 사용할 수 있는 다른 메커니즘에도 적용됩니다. - 실험 초안 캠페인에
contains_eu_political_advertising declaration가 누락된 경우ExperimentService.ScheduleExperiment메서드를 사용하여 새 실험을 예약하려고 하면ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION오류가 발생합니다. - Google Ads 스크립트에서 일괄 업로드 기능을 사용하는 경우 제품 문서를 확인하여 이 변경사항의 일부로 필요한 스프레드시트 템플릿 변경사항에 대해 자세히 알아보세요.
이러한 검사는 Google Ads API 버전 v21에서 이미 시행되고 있습니다.
캠페인 게재에 어떤 영향을 미치나요?
contains_eu_political_advertising를 true(으)로 설정하여 EU 정치 광고를 선언한 캠페인은 2025년 9월 22일.에 EU에서 광고 게재가 중단됩니다. 자세한 내용은 고객센터를 참고하세요.
선언이 없는 기존 캠페인은 당분간 영향을 받지 않습니다. 가능한 한 빨리 계정의 기존 캠페인을 적절한 선언으로 업데이트하는 것이 좋습니다. GoogleAdsService의 Search 또는 SearchStream 메서드를 사용하는 다음 GAQL 쿼리를 사용하여 선언 없이 캠페인을 가져올 수 있습니다.
select campaign.id, campaign.contains_eu_political_advertising
from
campaign
where
campaign.contains_eu_political_advertising NOT IN
(
'CONTAINS_EU_POLITICAL_ADVERTISING',
'DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING'
)어떤 조치를 취해야 하나요?
애플리케이션에서 Google Ads API 또는 Google Ads 스크립트를 사용하여 캠페인을 만들거나 관리하는 경우 2025년 9월 3일 전에 이러한 시정 조치를 처리하도록 애플리케이션을 업데이트해야 합니다.
도움을 받으려면 어떻게 해야 하나요?
이 변경사항에 대해 궁금한 점이 있으면 Google Ads API 지원 또는 Google Ads 스크립트 지원 채널에 문의하세요.
- 아나시 P. , Google Ads API팀