출시 노트

각 Data Manager API 출시에서 변경된 사항을 확인할 수 있습니다.

2026-03-26

• ErrorReason enum에 EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED를 추가했습니다.

  Google은 유럽연합 정치 광고 규정 (EU PAR)을 준수하기 위해, 모든 고객에게 광고가 EU PAR에 따라 정치 광고로 간주되는지를 자체 선언하도록 요구하고 있습니다. EU 정치 광고의 정의와 EU 정치 광고에 대한 Google의 제한사항을 알아보세요.

  2026년 4월 1일부터 이 선언이 없는 계정에서 다음 작업이 제한되거나 오류와 함께 실패할 수 있습니다. EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED

  • UserListService (create, update, and delete)
  • IngestionService (ingestAudienceMembers)

  오류를 해결하려면 광고주가 Google Ads UI에서 필수 선언을 제공해야 합니다. 계정을 확인하는 방법을 자세히 알아보세요.

• ErrorReason enum에 INVALID_MERCHANT_ID를 추가했습니다.

2026-02-17 v1.5

이제 Data Manager API에서 잠재고객 생성, 수집, 검색을 비롯한 잠재고객 관리의 전체 엔드 투 엔드 워크플로를 지원합니다.

• 사용자 목록을 만들고, 검색하고, 업데이트하고, 삭제할 수 있도록 UserList 리소스와 UserListService를 추가했습니다.
  • Data Manager API를 사용하여 고객 일치 타겟팅 잠재고객을 만들고, 채우고, 확인하는 방법에 관한 엔드 투 엔드 안내는 Google Ads 또는 Display & Video 360 가이드를 참고하세요.
  • 이전 단계는 Google Ads 또는 Display & Video 360 업그레이드 가이드를 참고하세요.
• 잠재고객 구성원 수집을 통해 사용자 ID 전송을 지원하여 고객 일치 타겟팅과 함께 Google Ads에서 사용할 수 있도록 했습니다.
  • AudienceMember에 UserIdData를 추가했습니다.
  • RetrieveRequestStatus 메서드에서 반환되는 상태에 IngestUserIdDataStatus 및 RemoveUserIdDataStatus를 추가했습니다. 이러한 필드를 사용하여 사용자 ID 수집 및 삭제에 관한 진단 정보를 검색합니다.
• PartnerLink 리소스와 PartnerLinkService를 추가하여 광고주와 데이터 파트너 계정 간의 링크를 만들고 관리할 수 있도록 했습니다.
  • 시작하려면 파트너 링크 가이드 를 참고하세요.

2026-02-10

이제 모든 Google Ads 계정에서 여러 데이터 소스를 사용하여 전환을 전송하여 실적과 데이터 강도를 높일 수 있습니다.

이 기능은 여전히 허용 목록에 있는 Google 애널리틱스 속성에서만 사용할 수 있습니다. 허용 목록에 Google 애널리틱스 속성을 추가하는 데 관심이 있다면양식을 작성하세요.

2025-11-05 v1.4

• 광고 상호작용 신호를 극대화하고 데이터와 전반적인 실적을 강화하기 위해 Google 애널리틱스 purchase 이벤트를 태그 전환의 추가 데이터 소스로 전송하는 기능을 지원하도록 했습니다.

  • AccountType enum에 GOOGLE_ANALYTICS_PROPERTY를 추가했습니다.
  • Event에 여러 필드를 추가했습니다:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • UserProperties에 additional_user_properties를 추가했습니다.

  Google 애널리틱스 purchase 이벤트 전송 및 Google 애널리틱스 이벤트 매개변수와 사용자 속성을 이벤트 가이드의 Data Manager API에 상응하는 항목에 매핑하는 방법을 자세히 알아보세요.

• AWS 키 관리 서비스의 암호화 키 사용을 지원하기 위해 AwsWrappedKeyInfo 을(를) 추가했습니다.

• ErrorReason에 다음 enum 값을 추가했습니다.

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

• 이제 모든 사용자가 Data Manager API를 사용할 수 있습니다.

  여러 데이터 소스를 사용하여 전환을 전송하여 실적과 데이터 강도를 높이는 기능은 여전히 허용 목록에 있는 계정에서만 사용할 수 있습니다. 계정을 추가하는 데 관심이 있다면 양식을 작성하세요.

  데이터 파트너가 되는 데 관심이 있다면 파트너 요청서 를 작성하세요.

• 이벤트 및 잠재고객 수집 요청에 관한 진단 정보를 검색하기 위해 RetrieveRequestStatus 메서드를 추가했습니다.

• ProductAccount의 product 필드와 Product enum이 지원 중단되었습니다. 대신 account_type 필드와 새로운 AccountType enum을 사용하세요.

• 각 AudienceMember의 destination을 IngestAudienceMembersRequest에서 지정하는 기능을 지원하도록 했습니다. 이 기능을 사용하여 단일 요청으로 여러 개의 고유한 대상에 잠재고객 데이터를 전송합니다.

• API로 수집된 잠재고객은 구성원이 100명 이상이면 타겟팅할 수 있습니다. 이전에는 구성원 기준이 1, 000명이었습니다.

• transaction_id의 Event 은 이제 오프라인 전환 또는 리드 확보용 향상된 전환을 전송할 때 선택사항입니다. 실적과 데이터 강도를 높이기 위해 오프라인 전환을 추가 데이터 소스로 전송할 때는 여전히 transaction_id가 필요합니다.

2025-08-06 v1.2

• `IngestEvents` 메서드를 사용하여 오프라인 전환 및 리드 확보용 향상된 전환을 Google Ads 대상으로 전송하는 기능을 지원하도록 했습니다. 이러한 전환의 암호화를 구성하는 방법은 업데이트된 암호화 가이드를 참고하세요.
• EventSource enum에 APP, IN_STORE, PHONE, OTHER 값을 추가했습니다. 오프라인 전환 및 리드 확보용 향상된 전환에는 event_source가 필요합니다.
• Event에 user_properties 필드를 추가했습니다. 이 필드를 UserProperties 객체로 설정하여 이벤트가 발생했을 때 사용자에 관한 광고주 평가 정보를 추가합니다.
• CustomVariable에 destination_references 반복 필드를 추가했습니다. 이 필드를 사용하여 Event의 대상 하위 집합에만 맞춤 변수 값을 적용합니다.
• 오프라인 전환 및 리드 확보용 향상된 전환에 다음 오류를 추가했습니다.
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

• IngestionService에 IngestEvents 메서드를 추가했습니다. 광고 상호작용 신호를 극대화하고 데이터와 전반적인 실적을 강화하기 위해 IngestEvents를 태그 전환의 추가 데이터 소스로 사용합니다.

2025-04-02 v1.0

• Google Ads 및 Display & Video 360으로 잠재고객 데이터를 전송하는 기능을 지원하는 Data Manager API의 첫 번째 출시입니다.
• gRPC 및 REST 지원을 추가했습니다.
• 다음 데이터 유형을 사용하여 잠재고객 구성원을 관리하기 위해 IngestAudienceMembers 및 RemoveAudienceMembers 메서드가 포함된 IngestionService를 추가했습니다.
  • 연락처 정보
  • 모바일 ID
  • PAIR ID
• Data Manager API를 사용하여 관리되는 잠재고객은 구성원이 1,000명 이상인 경우에만 타겟팅할 수 있습니다.