Data Manager API를 사용하여 Google 애널리틱스 추천 및 맞춤 이벤트를 전송합니다.
Google 애널리틱스 측정 프로토콜에서 업그레이드하는 경우 측정 프로토콜에서 Data Manager API로 업그레이드에서 안내를 확인하세요.
워크플로 개요
Data Manager API로 이벤트 데이터를 전송하려면 다음 단계를 완료하세요.
대상 준비: 수집 요청의
destinations필드에 대한Destination객체를 정의하여 타겟 계정 및 전환 또는 이벤트 대상을 지정합니다. 자세한 내용은 대상 준비를 참고하세요.이벤트 데이터 및 식별자 준비: 이벤트 세부정보 및
Event필수 식별자 (예: 광고 클릭, 클라이언트 또는 앱 인스턴스 식별자)로 필드를 채웁니다. `userData`에 사용자 연락처 정보를 포함하는 경우 형식 지정 가이드라인에 따라 식별자를 정규화 하고 SHA-256 해싱한 후 선택적으로 암호화합니다.userData자세한 내용은 이벤트 데이터 준비를 참고하세요.수집 요청 빌드 및 전송:
userData를 암호화한 경우destinations,Event레코드,encryptionInfo가 포함된events.ingest요청을 제출합니다.validateOnly: true를 사용하여 프로덕션 데이터를 전송하기 전에 페이로드에서 빠른 실패 오류 를 테스트합니다. 필드 요구사항 및 코드 샘플은 이벤트 전송을 참고하세요.진단 확인: 비동기 처리 진단을 가져오고 수집 상태를
requestStatus.retrieve로 확인합니다.
사용 사례
다음은 Data Manager API로 추천 이벤트와 맞춤 이벤트를 전송하는 몇 가지 사용 사례입니다.
온라인 사용자로부터 발생한 오프라인 전환을 유도합니다.
클라이언트 측 상호작용 및 서버 측 상호작용을 측정합니다.
일반 사용자 상호작용 외부에서 발생하는 이벤트(예: 오프라인 전환)를 전송합니다.
자동 수집을 이용할 수 없는 경우(예: 키오스크, 시계) 기기 및 앱에서 이벤트를 전송합니다.
사용자 제공 데이터
해싱된 이메일 주소, 전화번호
, 실제 주소와 같은 퍼스트 파티 고객 데이터를 userData 필드에 전송할 수 있습니다Event. 이를 통해 Google 애널리틱스에서 전환 측정, 기여 분석, 잠재고객 구축을 개선할 수 있습니다.
사용자 제공 데이터를 전송할 때는 다음 사항에 유의하세요.
이벤트와 함께 전송: Data Manager API에서 사용자 제공 데이터는
Event의 일부로 전송되어야 합니다. 이벤트가 없는 독립형 업로드는 지원되지 않습니다.형식 지정 및 해싱: 개인 식별자 (예: 이메일 주소, 전화번호, 이름, 상세 주소)는 업로드 전에 정규화되고 SHA-256을 사용하여 해싱되어야 합니다. 기타 필드 (예: 도시, 주 또는 도, 우편번호, 국가 코드)는 정규화되지만 해싱되지는 않습니다. 구체적인 요구사항은 사용자 데이터 형식 지정 가이드 를 참고하세요.
암호화: 선택적으로 해싱된 사용자 데이터를 암호화할 수 있습니다.
사용자 ID: 일관된 사용자 식별자를 사용할 수 있는 경우
userData와 함께userId를 제공하는 것이 좋습니다.구현: 요청 구성에 관한 안내는 사용자 제공 데이터 추가를 참고하세요.
통합 고려사항
Data Manager API를 사용할 때는 다음 고려사항에 유의하세요.
리마케팅
Google 애널리틱스는 Google 신호 데이터를 사용 설정하면 동일 기기 리마케팅을 지원합니다. 교차 기기 리마케팅의 경우
userId가 필요합니다.
또한 사용자 제공 데이터를 전송하여 퍼스트 파티 잠재고객 매칭을 사용 설정할 수 있습니다.
광고 ID
Google 애널리틱스는 광고 ID (예: GBRAID 또는 WBRAID)
를 사용하여 온라인 상호작용 중에 수집된 Data Manager API 이벤트와 자동으로 조인합니다.
clientId 또는 appInstanceId.
개인 정보 보호 설정
Google 애널리틱스는
clientId 또는 appInstanceId를 사용하여 Data Manager API 이벤트를 온라인 상호작용과 조인하여
"개인 맞춤이 아닌 광고" 및 "광고 추적 제한"과 같은 사용자 개인 정보 보호 설정을 채택합니다.
`
consent` 객체를 사용하여 각 이벤트에서 사용자 동의 설정을 직접 지정할 수도 있습니다.
지리 정보 및 기기 정보
Google 애널리틱스는 태그 지정의 최신 지리 정보 및 기기 정보
를 Data Manager API 이벤트와 자동으로 조인합니다. 이때 clientId 또는 appInstanceId를 사용합니다.
이렇게 하면 지리 정보 및 기기 측정기준이 포함된 보고서에 Data Manager API 이벤트가 반영됩니다.
`clientId` 또는 `appInstanceId`의 최신 정보 대신 특정 세션의 지리 정보 및 기기 정보를 Data Manager API 이벤트에 반영하려면 additionalEventParameters에 parameterName이 session_id로 설정되고 value이 특정 세션의 ID로 설정된 항목을 포함하고 세션 시작 후 24시간 이내에 이벤트를 전송합니다.clientIdappInstanceId
Data Manager API를 사용하여 이벤트의 지리 정보 및 기기 정보를 제공할 수 있습니다.
완전한 서버 간
Data Manager API를 통해서만 Google 애널리틱스에 이벤트를 전송할 수 있으며, 부분 보고서만 이용할 수 있습니다. Data Manager API의 목적은 gtag, 태그 관리자, Firebase를 통해 수집되는 기존 이벤트를 늘리는 것입니다. 일부 이벤트와 매개변수 이름은 자동 수집을 통해 사용할 수 있도록 예약되며 Data Manager API를 통해 전송할 수 없습니다.
이벤트 생성 또는 이름 바꾸기
Data Manager API로 전송된 이벤트는 이벤트 생성 또는 이름 바꾸기 규칙을 트리거하지 않습니다. 애플리케이션은 Google 애널리틱스 UI에서 구성된 규칙과 유사하게 Data Manager API를 통해 맞춤 이벤트를 전송하는 로직을 구현해야 합니다.