각 데이터 관리 도구 API 출시에서 변경된 사항을 확인할 수 있습니다.
2026-05-28 v1.7
IngestEventsRequest을 사용하여 Campaign Manager 360, Search Ads 360, Display & Video 360을 비롯한 Google Marketing Platform 제품에 오프라인 전환 이벤트 전송 지원이 추가되었습니다.- 플러드라이트 대상을 지원하기 위해
AccountTypeenum에FLOODLIGHT_CONFIG이 추가되었습니다. AdIdentifiers에dclid,impression_id,match_id,encrypted_user_ids필드가 추가되었습니다.- 전환 수량 추적을 지원하기 위해
Event리소스에conversion_count필드가 추가되었습니다.
이벤트 전송 가이드를 확인하여 시작하거나 Campaign Manager 360 API에서 업그레이드하는 방법을 알아보세요.
- 플러드라이트 대상을 지원하기 위해
CompositeData객체를 허용하고UserData,IpData등 여러 유형의 식별자를 결합할 수 있는composite_data필드를AudienceMember리소스에 추가했습니다. 자세한 내용은 복합 데이터를 참고하세요.CompositeData를 사용하는 시청자 회원 요청의 진단 (record_count및data_type_counts)을 포함하는 새 상태IngestCompositeDataStatus및RemoveCompositeDataStatus이 추가되었습니다.
복합 데이터에서
IpData를 전송하여 Google Ads 고객 일치 타겟팅의 IP 주소 수집을 지원합니다.ErrorReasonenum에 새로운 오류 이유FIELD_VALUE_TOO_SHORT,TOO_FEW_ELEMENTS,BASELINE_LOCATION_AUTO_DETECTION_FAILED,INSIGHTS_MISSING_FOR_DIMENSION가 추가되었습니다.이벤트 수집 중 오류에 대한 더 세부적인 의견을 제공하기 위해
ProcessingErrorReason에 새로운 진단 값을 추가했습니다.
2026-05-07 v1.6
IngestEventsRequest를 사용하여 Google Ads 오프라인 매장 판매 전환을 전송하는 지원이 추가되었습니다. 이 기능을 사용하려면 Google Ads 계정이 특정 자격 요건을 충족해야 합니다.- 물리적
store_id.제공을 지원하는Event에event_location필드를 추가했습니다. Event에third_party_user_data필드를 추가하여 수집된 데이터가 서드 파티 소유임을 명시적으로 표시할 수 있습니다.- 이 필드는 데이터 파트너만 채울 수 있습니다.
Item리소스에 다음 필드가 추가되었습니다.merchant_idmerchant_feed_labelmerchant_feed_language_codeconversion_valuecustom_variables(ItemCustomVariable객체 목록을 허용함)
- 시작하려면 다음 가이드를 확인하세요.
- 물리적
- 예약된 이벤트가 아닌 웹 또는 앱 이벤트를 Google 애널리틱스로 전송하는 기능이 추가되었습니다.
Event리소스에app_instance_id필드를 추가했습니다.- 사용자 기기에 관한 메타데이터를 제공하기 위해
DeviceInfo에 필드가 추가되었습니다. - AdIdentifiers에
mobile_device_id필드를 추가했습니다. city,subdivision_code,region_code,subcontinent_code,continent_code과 같은 필드를 캡처하기 위해Event에event_location필드를 추가했습니다.- 시작하려면 다음 가이드를 확인하세요.
- 태그 또는 Firebase용 Google 애널리틱스(GA4F) SDK 구현의 추가 데이터 소스로 웹 및 앱 데이터 스트림 모두에 거래 ID가 있는 모든 이벤트를 전송하는 지원이 추가되었습니다.
- 이 기능은 허용 목록에 있는 Google 애널리틱스 속성으로 제한됩니다. 속성을 허용 목록에 추가하려면 이 양식을 작성하세요.
- Google Ads 및 Google 애널리틱스로 전송되는 이벤트에 대해 장바구니에 적용된 모든 쿠폰 코드를 추적하기 위해
CartData에coupon_codes필드가 추가되었습니다.- Google Ads의 쿠폰 사용 사례의 경우
OFFLINE_PROMOTION_REDEMPTION전환 유형을 사용하세요.
- Google Ads의 쿠폰 사용 사례의 경우
- 파트너 링크 생성, 검색, 삭제와 관련된 메서드를 위한 새 OAuth 범위
https://www.googleapis.com/auth/datamanager.partnerlink를 추가했습니다. - 매장 판매 및 Google 애널리틱스 이벤트 수집에 대한 자세한 유효성 검사를 지원하기 위해
ErrorReasonenum에 새 값을 추가했습니다. SizeInfo리소스에youtube_members_count및gmail_members_count필드를 추가했습니다.
2026-03-26
ErrorReasonenum에EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED가 추가되었습니다.유럽연합 정치 광고 규정 (EU PAR)을 준수하기 위해 Google에서는 모든 고객이 광고가 EU PAR에 따라 정치 광고로 간주되는지 여부를 직접 선언하도록 요구합니다. EU 정치 광고의 정의와 EU 정치 광고에 대한 Google의 제한사항을 알아보세요.
2026년 4월 1일부터 이 선언이 없는 계정에서 다음 작업이 제한되거나
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED오류와 함께 실패할 수 있습니다.이 오류를 해결하려면 광고주가 Google Ads UI에서 필수 선언을 제공해야 합니다. 계정에서 확인하는 방법 자세히 알아보기
ErrorReasonenum에INVALID_MERCHANT_ID가 추가되었습니다.
2026-02-17 v1.5
이제 Data Manager API에서 잠재고객 생성, 수집, 검색을 비롯한 잠재고객 관리의 전체 엔드 투 엔드 워크플로를 지원합니다.
- 사용자 목록을 생성, 검색, 업데이트, 삭제할 수 있도록
UserList리소스와UserListService이 추가되었습니다.- 데이터 관리 도구 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이벤트를 전송하는 기능이 추가되었습니다.AccountTypeenum에GOOGLE_ANALYTICS_PROPERTY가 추가되었습니다.Event에 여러 필드가 추가되었습니다.event_nameclient_iduser_idadditional_event_parameters
UserProperties에additional_user_properties가 추가되었습니다.
Google 애널리틱스
purchase이벤트 전송 및 Google 애널리틱스 이벤트 매개변수와 사용자 속성을 데이터 관리 도구 API에 매핑하는 방법에 관한 자세한 내용은 이벤트 가이드를 참고하세요.AWS 키 관리 서비스의 암호화 키 사용을 지원하기 위해
AwsWrappedKeyInfo가 추가되었습니다.다음 열거형 값을
ErrorReason에 추가했습니다.EVENT_TIME_INVALIDFIELD_VALUE_TOO_LONGINVALID_EVENT_NAMEINVALID_PROPERTY_TYPEINVALID_REQUEST_IDINVALID_STREAM_TYPELINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNTMULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENTNOT_ALLOWLISTEDOPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCHRESERVED_NAME_USEDTOO_MANY_ELEMENTSUNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNERUNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER
2025-10-06 v1.3
이제 모든 사용자가 데이터 관리 도구 API를 사용할 수 있습니다.
실적과 데이터 강도를 높이기 위해 여러 데이터 소스를 사용하여 전환을 전송하는 기능은 허용 목록에 있는 계정에서만 사용할 수 있습니다. 계정 추가에 관심이 있으면 양식을 작성하세요.
파트너 관심분야 양식을 작성하여 데이터 파트너가 되는 데 관심이 있음을 알려주세요.
이벤트 및 잠재고객 수집 요청의 진단 정보 가져오기를 위한
RetrieveRequestStatus메서드를 추가했습니다.ProductAccount의product필드와Productenum이 지원 중단되었습니다. 대신account_type필드와 새로운AccountTypeenum을 사용하세요.IngestAudienceMembersRequest에서 각AudienceMember의destination를 지정하는 지원이 추가되었습니다. 이 기능을 사용하여 단일 요청으로 여러 개의 개별 대상에 잠재고객 데이터를 전송합니다.API로 수집된 잠재고객은 이제 회원이 100명 이상이면 타겟팅할 수 있습니다. 이전에는 회원 기준이 1, 000명이었습니다.
이제 오프라인 전환 또는 리드 확보용 향상된 전환을 전송할 때
Event의transaction_id이 선택사항입니다. 실적과 데이터 강도를 높이기 위해 오프라인 전환을 추가 데이터 소스로 전송하는 경우transaction_id가 여전히 필요합니다.
2025년 8월 6일 v1.2
IngestEvents메서드를 사용하여 Google Ads 대상에 오프라인 전환 및 리드 확보용 향상된 전환을 전송하는 기능이 추가되었습니다. 이러한 전환에 대한 암호화를 구성하는 방법은 업데이트된 암호화 가이드를 참고하세요.EventSource열거형에APP,IN_STORE,PHONE,OTHER값을 추가했습니다. 오프라인 전환 및 리드 확보용 향상된 전환에는event_source이 필요합니다.Event에user_properties필드를 추가했습니다. 이 필드를UserProperties객체로 설정하여 이벤트가 발생했을 때 사용자에 관한 광고주 평가 정보를 추가합니다.CustomVariable에destination_references반복 필드를 추가했습니다. 이 필드를 사용하여Event의 일부 대상에만 맞춤 변수 값을 적용합니다.- 오프라인 전환 및 리드 확보용 향상된 전환에 다음 오류가 추가되었습니다.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADSDESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONSDESTINATION_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가 추가되었습니다. - Data Manager API를 사용하여 관리되는 잠재고객은 구성원이 1,000명 이상인 경우에만 타겟팅할 수 있습니다.