출시 노트

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

2026-07-30 v1.8

  • 지정된 사용자 목록의 모든 잠재고객 구성원을 삭제하거나 대체하기 위해 IngestionService에 RemoveAllAudienceMembers 메서드를 추가했습니다.
    • 시작하려면 특정 통합의 잠재고객에서 모든 구성원을 삭제하는 방법에 관한 가이드를 검토하세요. 예를 들어 Google Ads 또는 Display & Video 360의 고객 매치 타겟팅 가이드를 참조하세요.
  • 이벤트 및 잠재고객 수집 중에 상세 경고를 반환하는 기능이 추가되었습니다.
    • FieldWarning 객체 목록이 포함된 IngestEventsResponse 및 IngestAudienceMembersResponse에 field_warnings 필드를 추가했습니다.
    • reason(WarningReason), description, field 경로를 포함하는 FieldWarning 리소스가 추가되었습니다.
    • 장바구니 데이터에 맞춤 변수가 사용 설정되지 않았거나 판매자 ID가 누락된 경우와 같은 경고 이유를 정의하는 WarningReason enum이 추가되었습니다.
  • Google 애널리틱스 이벤트 수집을 위해 추가 주소 필드를 전송하는 기능이 추가되었습니다.
    • address_line, city, administrative_area 필드를 AddressInfo (UserData에서 사용됨)에 추가했습니다.
  • ErrorReason enum에 INVALID_REMOVE_AS_OF_TIME 및 REQUIRED_PREREQUISITE_LINK_MISSING 오류 이유가 추가되었습니다.

2026-05-28 v1.7

2026-05-07 v1.6

  • IngestEventsRequest를 사용하여 Google Ads 매장 판매 전환을 ��송하는 기능이 추가되었습니다. 이 기능을 사용하려면 Google Ads 계정이 특정 자격 요건을 충족해야 합니다.
    • Event에 event_location 필드를 추가했습니다. 이 필드는 실제 store_id. 제공을 지원합니다.
    • Event에 third_party_user_data 필드를 추가하여 처리된 데이터가 서드 파티 소유로 명시적으로 표시될 수 있도록 했습니다.
    • Item 리소스에 다음 필드가 추가되었습니다.
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables (ItemCustomVariable 객체 목록 허용)
    • 시작하려면 다음 가이드를 확인하세요.
  • 예약된 이벤트가 아닌 웹 또는 앱 이벤트를 Google 애널리틱스로 전송하는 기능이 추가되었습니다.
  • 태그 또는 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에 새 값을 추가했습니다.
  • SizeInfo 리소스에 youtube_members_count 및 gmail_members_count 필드를 추가했습니다.

2026-03-26

2026-02-17 v1.5

이제 Data Manager API는 잠재고객 생성, 수집, 검색을 포함하여 잠재고객을 관리하는 전체 엔드 투 엔드 워크플로를 지원합니다.

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
    • UserProperties에 additional_user_properties을(를) 추가했습니다.

    Google 애널리틱스 purchase 이벤트 전송 및 Google 애널리틱스 이벤트 매개변수와 사용자 속성을 Data Manager API에 상응하는 항목에 매핑하는 방법에 관한 자세한 내용은 이벤트 가이드를 참고하세요.

  • AWS Key Management Service의 암호화 키 사용을 지원하기 위해 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을 사용하세요.

  • IngestAudienceMembersRequest에서 각 AudienceMember의 destination를 지정하는 기능이 추가되었습니다. 이 기능을 사용하면 단일 요청으로 잠재고객 데이터를 여러 개의 개별 대상으로 전송할 수 있습니다.

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

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

2025-04-02 v1.0

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