출시 노트

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

2026-07-30 v1.8

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

2026-05-28 v1.7

2026-05-07 v1.6

  • Google Ads 매장 판매 전환 을(를) IngestEventsRequest을(를) 사용하여 전송하는 지원이 추가되었습니다. 이 기능을 사용하려면 Google Ads 계정이 특정 자격 요건을 충족해야 합니다.
    • event_location 필드를 Event에 추가하여 실제 store_id.를 제공할 수 있도록 지원합니다.
    • third_party_user_data 필드를 Event에 추가하여 수집된 데이터가 서드 파티 소유임을 명시적으로 표시할 수 있도록 지원합니다.
    • Item 리소스에 다음 필드를 추가했습니다.
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • custom_variables (ItemCustomVariable 객체 목록을 허용함)
    • 시작하려면 다음 가이드를 참고하세요.
  • 예약된 이벤트 가 아닌 웹 또는 앱 이벤트를 Google 애널리틱스로 전송하는 지원이 추가되었습니다.
  • 태그 또는 Firebase용 Google 애널리틱스 (GA4F) SDK 구현의 추가 데이터 소스로 거래 ID가 있는 모든 이벤트 를 웹 및 앱 데이터 스트림 모두에 전송하는 지원이 추가되었습니다.
    • 이 기능은 허용 목록에 있는 Google 애널리틱스 속성으로 제한됩니다. 이 양식을 작성하여 속성을 허용 목록에 추가하는 데 관심이 있다면
  • coupon_codes 필드를 CartData에 추가하여 Google Ads 및 Google 애널리틱스로 전송된 이벤트의 장바구니에 적용된 모든 쿠폰 코드를 추적할 수 있도록 지원합니다.
    • 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

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

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

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

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

    • 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 지원이 추가되었습니다.
  • 다음 데이터 유형을 사용하여 잠재고객 구성원을 관리하기 위한 IngestionService와 IngestAudienceMembers 및 RemoveAudienceMembers 메서드가 추가되었습니다.
  • Data Manager API를 사용하여 관리되는 잠재고객은 구성원이 1,000명 이상인 경우에만 타겟팅할 수 있습니다.