구글 데이터 매니저 API 업데이트 — 오디언스 전체 삭제와 필드 단위 경고

구글이 데이터 매니저 API를 업데이트해 새 오디언스 관리 도구, 더 유연한 데이터 수집, 이용자 제공 주소 데이터 지원 확대를 추가했다. 고객 매칭(Customer Match) 리스트 유지와 데이터 품질 개선이 쉬워지고, 인제스천 요청 전체를 실패시키지 않고도 데이터 문제를 파악할 수 있게 하는 것이 목적이다.

무엇이 추가됐나

가장 눈에 띄는 추가는 RemoveAllAudienceMembers 메서드다. 오디언스 리스트 전체를 한 번의 작업으로 비울 수 있다. 선택적 타임스탬프 파라미터를 쓰면 지정한 날짜 이전에 추가된 멤버만 제거할 수 있어 전체 오디언스 갱신이 훨씬 쉬워진다.

필드 단위 인제스천 경고도 도입됐다. 선택 필드에 잘못된 데이터가 있을 때 요청 전체를 실패시키는 대신, API가 유효한 레코드는 처리하면서 문제가 된 필드와 검증 실패 이유를 설명하는 상세 경고를 반환한다.

구글 애널리틱스 목적지로 보낼 수 있는 주소 정보도 확장됐다. 기존의 이름·우편번호·지역에 더해 도로명 주소, 도시, 주 또는 지방을 포함할 수 있다. 또한 다른 식별자를 쓸 수 없는 특정 멀티소스 이벤트에서 이용자 제공 데이터가 식별자 요건을 충족할 수 있게 됐다.

구글은 AI 지원 코딩 환경에서 데이터 매니저 API 연동을 더 효율적으로 구축할 수 있도록 구글 스킬스 깃허브 저장소에 새 AI 에이전트 스킬도 공개했다.

왜 중요한가

이번 업데이트는 1차 데이터를 관리하는 개발자의 마찰 지점을 여러 개 없앤다. 오디언스 갱신이 단순해지고, 인제스천 문제를 워크플로 중단 없이 진단할 수 있으며, 확장된 주소 필드로 구글 애널리틱스에 데이터를 보낼 때의 유연성이 커진다. 결과적으로 구글 애즈, 디스플레이 & 비디오 360, 구글 애널리틱스에 걸친 고객 데이터 관리가 효율화된다.

실무 적용

첫째, 전체 삭제 메서드는 정기 갱신 파이프라인을 단순하게 만든다. 기존에는 이전 멤버 목록을 별도로 추적해 제거해야 했지만, 이제 타임스탬프 기준으로 오래된 멤버만 걷어내는 방식으로 바꿀 수 있다.

둘째, 필드 단위 경고 도입으로 검증 로그를 다시 설계할 필요가 있다. 요청 실패가 아니라 부분 성공 + 경고가 기본 응답이 되므로, 경고를 무시하지 않고 수집·모니터링하는 절차가 없으면 데이터 품질 저하를 놓치게 된다.

셋째, 주소 필드 확장은 매칭률을 올릴 여지를 주지만 수집 근거와 동의 범위를 먼저 확인해야 한다. 보낼 수 있게 됐다는 것과 보내도 된다는 것은 다른 문제다.

API 접근 권한 자체를 조이는 흐름은 구글 애즈 API에 허용 목록이 생긴다 — 관리자 계정용 보안 파일럿에서, 이커머스 회원 데이터를 마케팅 도구와 자동 동기화하는 사례는 스티비가 아임웹과 실시간 연동 — 쇼핑몰 회원이 주소록으로 자동 동기화에서 볼 수 있다.