전송처 - Google Analytics 4 Measurement Protocol
    • PDF

    전송처 - Google Analytics 4 Measurement Protocol

    • PDF

    기사 요약

    개요

    Google Analytics 4 Measurement Protocol로 데이터를 전송하는 설정 도움말 페이지입니다.

    • 임의의 전송 소스에서 데이터를 추출하여 Measurement Protocol (Google Analytics 4)에 대해 전송할 수 있습니다.
    • Measurement Protocol의 형식에 맞는 형태로 전송 설정 작성 시 TROCCO에서 컬럼 이름과 타입을 매핑해 주셔야 합니다.

    제약조건

    • API의 제한 사항이 있습니다.
    • 한 줄의 입력에 대해 하나의 이벤트가 생성됩니다.
      • 여러 개의 입력을 모아 여러 개의 이벤트를 생성할 수 없습니다.

    보충자료

    전송처인 Google Analytics 4 Measurement Protocol은 연결 정보를 이용하지 않습니다.

    설정 항목

    STEP1 기본 설정

    품목명필수기본값내용
    API 시크릿----------------------------------------------------------------------------------------------.데이터 스트림의 API 시크릿을 입력합니다.
    확인 방법은 측정 ID 및 API 시크릿 확인 방법을 참조하세요.
    측정 ID----------------------------------------------------------------------------------------------.데이터 스트림의 측정 ID를 입력합니다.
    확인 방법은 측정 ID 및 API 시크릿 확인 방법을 참조하세요.
    요청 확인유효활성화를 선택하면 Measurement Protocol 검증 서버에서 전송 대상 이벤트의 형식이 올바른지 검증합니다.
    이때 요청에 잘못된 형식의 이벤트가 포함된 경우 TROCCO의 전송 작업은 Error로 처리됩니다.
    또한, 활성화 또는 비활성화를 선택하더라도 올바른 형식의 이벤트에 대해서는 전송이 이루어집니다.

    STEP2 세부 설정

    컬럼 매핑

    TROCCO의 STEP2의 컬럼 정의에서 컬럼 이름과 타입을 매핑하여 Google Analytics 4 Measurement Protocol에 데이터를 전송할 수 있습니다.
    컬럼 이름과 타입을 아래 표와 같이 일치시켜야 합니다.
    기타 컬럼에 대한 자세한 내용은 API 문서를 참고하세요.

    칼럼명型(형)필수
    client_idstring
    events.namestring
    events.params.${파라미터 이름}임의의 유형No
    events.params.items.${매개변수 이름}임의의 유형No
    user_properties.${매개변수 이름}임의의 유형No

    입력 예시

    • 아래 입력 예시에서는 2개의 offline_purchase 이벤트와 1개의 search 이벤트가 생성됩니다.
      • client_id: x 의 이벤트가 두 개 있지만, 입력 한 줄에 대해 하나의 이벤트가 생성됩니다.
    • 이벤트 및 사용자 속성에 대한 자세한 내용은 API 문서를 참고하세요.
    client_ide valueevents.params.search_termevents.params.items.item_idevents.params.items.item_nameuser_properties.customer_tieruser_properties.age
    xoffline_purchaseUSD100nullSKU_12345스탠과 친구들 티표준null
    xoffline_purchaseUSD200nullSKU_67890pN and Friends Tee표준null
    y검색nullnull티셔츠nullnull프리미엄30

    측정 ID 및 API 시크릿 확인 방법

    아래 절차에 따라 확인할 수 있습니다.

    1. Google Analytics 4 홈 화면에서 관리를 클릭합니다.
      이미지

    2. 원하는 속성을 선택하고 데이터 스트림을 클릭합니다.
      이미지

    3. 원하는 데이터 스트림을 클릭
      이미지

      측정 ID를 확인할 수 있습니다.

    4. Measurement Protocol API secret 클릭
      이미지

      API 시크릿 값을 확인할 수 있습니다.
      이미지


    이 문서가 도움이 되었습니까?