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