Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

출시 노트

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

2026-05-07 v1.6

Google Ads 매장 판매 전환 을(를) IngestEventsRequest을(를) 사용하여 전송하는 지원이 추가되었습니다. 이 기능을 사용하려면 Google Ads 계정이 특정 자격 요건을 충족해야 합니다.
- 실제 store_id.를 제공할 수 있도록 event_location 필드를 Event에 추가했습니다.
- 가져온 데이터가 서드 파티 소유임을 명시적으로 표시할 수 있도록 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에 추가했습니다.

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에서 필수 선언을 제공해야 합니다. 계정을 확인하는 방법을 자세히 알아보세요.
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 암호화 키를 추가했습니다. AWS Key Management Service
다음 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 메서드가 포함된 IngestionService를 추가했습니다.
Data Manager API를 사용하여 관리되는 잠재고객은 구성원이 1,000명 이상인 경우에만 타겟팅할 수 있습니다.

출시 노트 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.