출시 노트

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

2026-05-28 v1.7

• 오프라인 전환 이벤트 전송을 비롯하여 Campaign Manager 360, Search Ads 360, Display & Video 360을 포함한 Google Marketing Platform 제품에 IngestEventsRequest를 사용하여 지원이 추가되었습니다.

  • 플러드라이트 대상을 지원하기 위해 AccountType enum에 FLOODLIGHT_CONFIG가 추가되었습니다.
  • AdIdentifiers에 dclid, impression_id, match_id, 및 encrypted_user_ids 필드가 추가되었습니다.
  • 전환 수 추적을 지원하기 위해 Event 리소스에 conversion_count 필드가 추가되었습니다.

  시작하려면 이벤트 전송 가이드를 확인하거나 Campaign Manager 360 API에서 업그레이드하는 방법을 알아보세요.

• AudienceMember 리소스에 composite_data 필드가 추가되었습니다. 이 필드는 CompositeData 객체를 허용하고 IpData 및 UserData와 같은 여러 유형의 식별자를 결합할 수 있습니다. 자세한 내용은 복합 데이터를 참고하세요.

  • 새 상태 IngestCompositeDataStatus 및 RemoveCompositeDataStatus 가 추가되었습니다. 여기에는 CompositeData을 사용하는 잠재고객 구성원 요청에 대한 진단 (record_count 및 data_type_counts)이 포함됩니다.

• 복합 데이터에서 IpData를 전송하여 Google Ads 고객 일치 타겟팅의 IP 주소 수집을 지원합니다.

• ErrorReason enum에 새 오류 사유 FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, and INSIGHTS_MISSING_FOR_DIMENSION이 추가되었습니다.

• 이벤트 수집 중 오류에 대한 더 세분화된 의견을 제공하기 위해 ProcessingErrorReason에 새로운 진단 값이 추가되었습니다.

2026-05-07 v1.6

• Google Ads 매장 판매 전환 을(를) IngestEventsRequest을(를) 사용하여 전송하는 지원이 추가되었습니다. 이 기능을 사용하려면 Google Ads 계정이 특정 자격 요건을 충족해야 합니다.
  • 실제 store_id. 제공을 지원하는 Event에 event_location 필드가 추가되었습니다.
  • 수집된 데이터가 서드 파티 소유로 명시적으로 플래그 지정될 수 있도록 third_party_user_data 필드가 Event에 추가되었습니다.
    • 이 필드는 데이터 파트너만 채울 수 있습니다.
  • Item 리소스에 다음 필드가 추가되었습니다.
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (ItemCustomVariable 객체 목록을 허용함)
  • 시작하려면 다음 가이드를 확인하세요.
    • Google Ads에서 업그레이드
    • 이벤트 전송
• 예약된 이벤트가 아닌 웹 또는 앱 이벤트를 Google 애널리틱스로 전송하는 지원이 추가되었습니다.
  • app_instance_id 필드가 Event 리소스에 추가되었습니다.
  • 사용자의 기기에 관한 메타데이터를 제공하기 위해 DeviceInfo에 필드가 추가되었습니다.
  • mobile_device_id 필드가 AdIdentifiers에 추가되었습니다.
  • city, subdivision_code, region_code, subcontinent_code, continent_code와 같은 필드를 캡처하기 위해 event_location 필드가 Event 에 추가되었습니다.
  • 시작하려면 다음 가이드를 확인하세요.
    • 추천 이벤트 및 맞춤 이벤트 전송
    • 측정 프로토콜에서 업그레이드
    • 추천 이벤트 참조
• 태그 또는 Firebase용 Google 애널리틱스 (GA4F) SDK 구현의 추가 데이터 소스로 거래 ID가 있는 모든 이벤트 를 웹 및 앱 데이터 스트림 모두에 전송하는 지원이 추가되었습니다.
  • 이 기능은 허용 목록에 있는 Google 애널리틱스 속성으로 제한됩니다. 이 양식을 작성하여 속성을 허용 목록에 추가하는 데 관심이 있다면
• Google Ads 및 Google 애널리틱스로 전송되는 이벤트의 장바구니에 적용된 모든 쿠폰 코드를 추적하기 위해 CartData에 coupon_codes 필드가 추가되었습니다.
  • Google Ads의 쿠폰 사용 사례에는 OFFLINE_PROMOTION_REDEMPTION 전환 유형을 사용하세요.
• 파트너 링크 생성, 검색, 삭제와 관련된 메서드를 위한 새 OAuth 범위 https://www.googleapis.com/auth/datamanager.partnerlink가 추가되었습니다.
• 매장 판매 및 Google 애널리틱스 이벤트 수집에 대한 세부 검증을 지원하기 위해 ErrorReason enum에 새 값이 추가되었습니다.
• youtube_members_count 및 gmail_members_count 필드가 SizeInfo 리소스에 추가되었습니다.

2026-03-26

• EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED가 ErrorReason enum에 추가되었습니다.

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

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

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

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

• INVALID_MERCHANT_ID가 ErrorReason enum에 추가되었습니다.

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에서 고객 매치 타겟팅에 사용할 수 있도록 했습니다.
  • UserIdData가 AudienceMember에 추가되었습니다.
  • IngestUserIdDataStatus 및 RemoveUserIdDataStatus가 상태에 추가되었습니다.RetrieveRequestStatus 이러한 필드를 사용하여 사용자 ID 수집 및 삭제에 관한 진단 정보를 검색합니다.
• 광고주와 데이터 파트너 계정 간의 링크를 생성하고 관리하기 위해 PartnerLink 리소스와 PartnerLinkService가 추가되었습니다.
  • 시작하려면 파트너 링크 가이드 를 확인하세요.

2026-02-10

실적과 데이터 강도를 높이기 위해 여러 데이터 소스를 사용하여 전환을 전송하는 기능이 이제 모든 Google Ads 계정에서 정식 버전으로 제공됩니다.

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

2025-11-05 v1.4

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

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

  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 대상으로 전송하는 지원이 추가되었습니다. 이러한 전환의 암호화를 구성하는 방법은 업데이트된 암호화 가이드를 참고하세요.
• APP, IN_STORE, PHONE, OTHER 값이 EventSource enum에 추가되었습니다. 오프라인 전환 및 리드 확보용 향상된 전환에는 event_source가 필요합니다.
• user_properties 필드가 Event에 추가되었습니다. 이 필드를 UserProperties 객체로 설정하여 광고주가 평가한 사용자 정보를 추가합니다.
• destination_references 반복 필드가 CustomVariable에 추가되었습니다. 이 필드를 사용하여 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

• IngestEvents 메서드가 IngestionService에 추가되었습니다. 광고 상호작용 신호를 극대화하고 데이터와 전반적인 실적을 강화하기 위해 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명 이상인 경우에만 타겟팅할 수 있습니다.