Campaign Manager 360 API의 유럽연합 정치 광고 규정 지원을 위한 v5 출시 및 변경사항 발표

2025년 9월 2일 화요일

변경되는 사항

작년에 발표한 바와 같이, Google은 2025년 10월에 새로운 규정이 시행되기에 앞서 유럽연합에서 정치 광고 게재를 중단할 예정입니다. 오늘 이 변경사항을 지원하기 위해 Campaign Manager 360 API v4 업데이트를 출시합니다. v5 출시도 발표합니다.

euPoliticalAdsDeclaration 관련 변경사항에 관한 자세한 내용은 이 게시물을 계속 읽어보세요. 기타 모든 변경사항과 v5 버전에 관한 자세한 내용은 출시 노트를 참고하세요.

v4 지원 중단 및 종료 알림

Google의 지원 중단 일정에 따라 v5 출시와 함께 v4의 지원 중단 기간이 시작되며, v4는 2026년 2월 26일에 지원이 종료됩니다. 이 날짜 이후에는 v4에 대한 요청에서 오류가 반환됩니다.

자세한 내용은 이전 가이드를 참고하세요. 대부분의 경우 선호하는 클라이언트 라이브러리의 최신 버전으로 업그레이드하기만 하면 됩니다. 출시 노트를 검토하여 알아야 할 중요한 변경사항을 확인하는 것이 좋습니다.

이 문제 또는 Campaign Manager 360 API와 관련된 다른 문제가 있는 경우 지원 포럼을 통해 문의해 주세요.

배경

Campaign Manager 360에서는 EU 정치 광고에 대한 자체 선언이 필요합니다. 캠페인을 만들 때 캠페인에 EU 정치 광고가 포함되어 있는지 여부를 선언해야 합니다.

광고주 전체에 대해 이 선언을 할 수도 있습니다. 이 선언에는 광고주의 캠페인에 EU 정치 광고가 포함되어 있는지 여부가 명시됩니다. Campaign Manager 360 API를 사용하거나 Campaign Manager 360 UI의 광고주 속성 설정에서 광고주 수준으로 선언하는 것이 좋습니다.

Campaign Manager 360 API v4 및 v5는 캠페인에 EU 정치 광고가 포함되어 있는지 선언하는 기능을 지원합니다.

Campaign Manager 360 API

Campaign Manager 360에서는 새 캠페인과 기존 캠페인에 새 게재위치, 광고 또는 광고 소재를 추가할 때 선언을 요구하기 시작합니다.

Campaign Manager 360 API v5에서는 새 게재위치, 광고 또는 광고 소재를 추가할 때 새 캠페인 리소스와 기존 캠페인 리소스에 euPoliticalAdsDeclaration 필드가 필요합니다.

euPoliticalAdsDeclaration 필드가 v4 및 v5의 다음 API 객체에 추가되어 다양한 리소스 수준에서 자체 선언을 표시합니다.

  • 캠페인 수준에서 선언을 가져오고 설정하는 Campaign 객체입니다.
  • Advertiser: 광고주 수준에서 선언을 가져오고 설정합니다.

다음 표에는 광고주 리소스에서 이 필드에 설정할 수 있는 값이 나와 있습니다.

값
ADVERTISER_PLANS_TO_SERVE_EU_POLITICAL_ADS
ADVERTISER_DOES_NOT_PLAN_TO_SERVE_EU_POLITICAL_ADS

다음 표에는 캠페인 리소스에서 이 필드에 설정할 수 있는 값이 나와 있습니다.

값
CONTAINS_EU_POLITICAL_ADS
DOES_NOT_CONTAIN_EU_POLITICAL_ADS

상위 광고주의 euPoliticalAdsDeclaration 필드를 ADVERTISER_DOES_NOT_PLAN_TO_SERVE_EU_POLITICAL_ADS로 설정하면 기존 캠페인의 필드가 일치하도록 백필되고, 생성 시 다른 값이 설정되지 않은 경우 새 캠페인에서 해당 값을 사용합니다.

어떤 조치를 취해야 하나요?

광고주 수준에서 선언하는 것이 좋습니다. advertisers.insert, advertisers.patch 또는 advertisers.update 메서드를 호출할 때 API를 사용하여 euPoliticalAdsDeclaration 필드를 설정하거나 Campaign Manager 360 UI의 광고주 속성 설정에서 이 작업을 수행할 수 있습니다.

광고주 수준에서 선언할 수 없거나 광고주가 EU 정치 광고를 게재할 수 있다고 선언한 경우 다음 API 메서드 사용을 업데이트하여 캠페인 수준에서 선언해야 합니다.

  • campaigns.insert 요청을 할 때 새 캠페인 리소스에서 euPoliticalAdsDeclaration 필드를 설정하거나 campaigns.update 또는 campaigns.patch 요청을 할 때 기존 캠페인 리소스에서 필드를 설정합니다.

캠페인 게재에 어떤 영향을 미치나요?

이 선언이 광고 게재에 미치는 영향에 대해 자세히 알아보려면 Campaign Manager 360 고객센터 도움말을 참고하세요.

자세히 알아보기

Campaign Manager 360 API의 모든 새 버전과 마찬가지로 출시 노트의 모든 변경사항을 주의 깊게 검토하시기 바랍니다. 바로 시작하려는 경우 업데이트된 클라이언트 라이브러리를 지금 사용할 수 있습니다. 이제 막 시작하는 경우 시작 가이드를 참고하면 빠르게 시작하고 실행하는 데 도움이 됩니다.

사용해 보시고 궁금한 점이 있으면 알려주세요.

라벨: campaign-manager-360-api, release