2026년 7월 30일 목요일
최신 버전의 Data Manager API에는 잠재고객 관리를 간소화하고, 필드 수준 경고를 통해 수집 워크플로를 개선하며, Google 애널리틱스에 더 세분화된 사용자 제공 데이터를 지원하는 기능이 도입되었습니다.
모든 잠재고객 구성원 삭제
새로운
RemoveAllAudienceMembers
메서드를 사용하여 단일 작업으로 지정된 사용자 목록에서 모든 구성원을 삭제합니다.
선택사항인 removeAsOfTime 매개변수를 사용하면 특정 타임스탬프 이전에 추가된 구성원만 타겟팅할 수 있습니다.
이는 잠재고객 데이터를 완전히 새로고침('모두 바꾸기')해야 할 때 특히 유용하며, 기존 목록을 지우고 새 사용자 집합으로 채울 수 있습니다.
수집 필드 경고
이제 Data Manager API 수집 응답에 선택사항 필드의 유효성 검사 문제에 관한 자세한 필드 수준 경고가 포함됩니다. API가 선택적 필드에서 검증 문제를 감지하면 수집 요청이 성공하고 나머지 수집 데이터가 계속 처리됩니다. 필수 입력란의 유효성 검사 실패는 빠른 실패 모델에 따라 전체 요청을 계속 실패하게 합니다.
제공한 옵션 필드가 잘못된 경우 IngestEventsRequest 또는 IngestAudienceMembersRequest의 응답에 FieldWarning 객체 목록이 있는 field_warnings 필드가 포함됩니다. 각 경고는 구체적인 이유(WarningReason), 설명 메시지, 요청에서 문제가 발생한 필드의 위치를 제공합니다.
Google 애널리틱스 이벤트의 추가 주소 데이터
이제 이벤트를 Google 애널리틱스 대상으로 수집할 때 추가 사용자 주소 정보를 제공할 수 있습니다. given_name, family_name, region_code, postal_code 필드와 함께 AddressInfo 리소스는 이제 다음을 지원합니다.
address_line(상세 주소)cityadministrative_area(주 또는 도)
또한 이제 기존 사용자 제공 데이터(user_data) 필드를 사용하여
웹 데이터 스트림으로 전송되는
다중 소스 이벤트의 식별자 요구사항을 충족할 수 있습니다. 이렇게 하면 다중 소스 이벤트에 대한 ad_identifiers.gclid, user_id 또는 client_id가 없는 경우 다른 옵션을 사용할 수 있습니다.
시작하기
-
워크플로에 새
RemoveAllAudienceMembers메서드를 구현하는 방법을 알아보세요. - 응답에서 경고를 확인하는 방법은 API 오류 이해 가이드의 수집 경고 섹션을 참고하세요.
- Data Manager API를 사용하여 Google 애널리틱스로 이벤트 전송을 시작합니다.
AI 에이전트 기술로 더 빠르게 빌드: 최근에 통합 속도를 높이는 데 도움이 되는 새로운 Data Manager API 에이전트 기술을 도입했습니다. Google Skills GitHub 저장소에서 새로운 기술을 살펴보고 AI 지원 코딩 환경 내에서 더 정확하고 효율적인 안내를 직접 받아보세요.
궁금한 점이 있거나 이 게시물에 관해 논의하고 싶다면 'Google Advertising and Measurement Community' Discord 서버를 통해 문의해 주세요. API에 문제가 있거나 도움이 필요한 경우 지원 페이지를 통해 문의할 수도 있습니다.
데이터 파트너가 되고 싶다면 파트너 신청 양식을 작성하세요.
- Data Manager API팀, 린지 볼타