이 페이지에서

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

티알륨

이 문서는 Amplitude의 Tealium 연동을 설정하고 사용하는 방법에 대한 안내서입니다.

Tealium의 두 가지 주요 제품은 엔터프라이즈 태그 관리 서비스인 Tealium iQ와 실시간 통합 마케팅 플랫폼인 Tealium AudienceStream입니다.

고객이 Amplitude에 데이터를 전송할 수 있는 방법은 두 가지가 있습니다.

  1. Tealium iQ 및 태그 관리(TIQ)
  2. Tealium AudienceStream 및 범용 데이터 허브(Tealium은 TIQ에서 Amplitude로 데이터를 전송함)

Tealium은 이 연동을 유지합니다. 이 연동에 관한 전체 질문은 Tealium 지원팀에 문의하십시오.

Tealium iQ 및 태그 관리(TIQ)

Tealium IQ는 페이지의 모든 요소에 대해 UDO(Universal Data Object)를 생성하는 범용 JavaScript 라이브러리입니다. Tealium은 먼저 이 데이터를 데이터 계층으로 전송한 다음 태그와 함께 타사 공급업체(Amplitude 포함)에게 전송할 수 있습니다.

Tealium iQ를 웹사이트에 통합하는 방법에는 두 가지가 있습니다. Tealium의 태그 관리자 또는 Tealium의 JavaScript 라이브러리를 사용하는 방법입니다. 이 섹션에서는 Tealium iQ(태그 관리자)를 사용하여 Amplitude로 데이터를 전송하는 방법에 대해 설명합니다.

연동 설정

Tealium과 Amplitude를 통합하려면 다음 단계를 따르십시오.

  1. Tealium 작업 공간에서 애플리케이션을 위한 데이터 레이어를 생성하세요. 여기에서 필요한 변수를 정의할 수 있습니다. 자세한 내용은 다음 섹션을 참조하십시오.

  2. Amplitude에서 데이터를 위한 프로젝트를 생성하세요. 이를 통해 API 키가 생성됩니다.

  3. Tealium의 태그 탭에서 Amplitude를 추가합니다. 태그 구성에 Amplitude API 키를 입력할 수 있습니다. 여기에서 로드 규칙과 데이터 매핑을 생성할 수도 있습니다.

  4. Tealium에서 오른쪽 상단 모서리의 드롭다운 메뉴에서 찾을 수 있는 코드 센터로 이동합니다. 여기에서 앱에 붙여넣을 JavaScript 스니펫을 찾을 수 있습니다.

  5. 앱에서 여는 body 태그 뒤에 코드 조각을 붙여넣습니다. 환경을 지정하고 태그를 동기식으로 로드할지 비동기식으로 로드할지 여부를 지정합니다. 비동기식으로 로드하면 페이지 로딩 속도가 빨라집니다. Amplitude의 JavaScript SDK 역시 비동기적으로 로드됩니다.

    js
    <script type="text/javascript">  
var utag_data = {  
    "page_type": "home",  
    "customer_id": "t: feb-27"  
};  
</script>  
<!-- Loading script asynchronously -->  
<script type="text/javascript">  
    (function(a,b,c,d){  
    a='//tags.tiqcdn.com/utag/sbx-amplitud/main/prod/utag.js';  
    b=document;c='script';d=b.createElement(c);d.src=a;d.type='text/java'+c;d.async=true;  
    a=b.getElementsByTagName(c)[0];a.parentNode.insertBefore(d,a);  
    })();  
</script>

  6. 계측 코드에 추가하려는 모든 변수가 데이터 계층 탭에 정의되어 있는지 확인하십시오. 그런 다음 추적하려는 이벤트에 대해 Amplitude 공급업체 태그를 추가하십시오. 태그에는 동일한 목적지에 매핑된 여러 변수가 있을 수 없습니다. 동일한 페이지 로드에서 여러 이벤트를 전송하려면 각 이벤트에 대해 별도의 공급업체 태그를 구성하십시오. 대상은 Amplitude로 전송할 수 있는 다양한 형태의 데이터를 나타냅니다.

데이터 계층

Tealium iQ는 기업의 디지털 제품에서 흐르는 데이터의 사양인 데이터 계층을 사용하며 특정 이벤트 속성을 포함하는 이벤트를 식별합니다. 데이터 계층을 정의한 후에는 모든 디지털 제품에 이를 설치할 수 있으며 해당 데이터를 Amplitude와 같은 태그 공급업체 구성에 사용할 수 있습니다. 데이터 계층은 공급업체에 중립적이므로 데이터 계층을 계측한 다음 이를 여러 공급업체 태그로 전송할 수 있습니다.

앱의 모든 데이터 계층 변수를 데이터 계층 탭에 포함시킵니다.

데이터 계층에서 다음과 같은 변수 유형을 정의할 수 있습니다.

  • UDO 변수: UDO에 정의된 변수입니다. UDO는 웹사이트의 JavaScript 객체입니다. 각 페이지와 방문자를 설명하는 동적 값이 포함되어 있습니다.
js
<script type="text/javascript">  
    var utag_data={
        "country_code": "US",
        "currency_code": "USD",
        "page_name": "Cart: View Shopping Bag",
        "page_type": "cart",
        "product_id": ["PROD123", "PROD456"],
        "product_name": ["Red Shoes", "Black Socks"],
        "product_category": ["Footwear", "Apparel"],
        "product_quantity": ["1", "2"],
        "product_unit_price": ["65.00", "4.75"],
        "cart_total_items": "3",
        "cart_subtotal": "74.00"
    };
</script>
  • 쿼리 문자열 매개 변수: URL에서 매개 변수를 캡처합니다. 예를 들어 URL이 http://example.com/path/file.html?sortOrder=price인 경우 Tealium의 변수 이름은 sortOrder입니다.
  • 자사 쿠키: 귀하의 도메인에 설정된 쿠키의 참조 값입니다. 쿠키 변수를 생성할 때 Tealium 쿠키, utag_main, 또는 표준 쿠키를 지정할 수 있습니다. 또한 utag_main 쿠키에 사용자 정의 값을 추가할 수도 있습니다.utag.js 라이브러리는 utag_main 라는 단일 쿠키를 생성하고 유지관리합니다. 그 안에는 방문자 세션을 추적하는 몇 가지 기본 제공 값이 있습니다.
    • ses_id： 세션의 고유 식별자입니다.
    • _st: 밀리초 단위의 유닉스/에포크 타임스탬프입니다.
    • v_id: 각 방문자에 대한 고유 식별자입니다.
    • _ss: 표시된 페이지가 세션에서 첫 페이지인지 여부를 나타내는 부울값입니다. 값 1은 예를 의미하고 0은 아니오를 의미합니다.
    • _pn: 현재 세션 중에 본 페이지 수입니다.
    • _sn: 이 방문자의 세션 수입니다.
  • JavaScript 변수: utag_data 이외의 웹 페이지에서 JavaScript 변수를 참조하려면 이 옵션을 선택합니다.
  • 메타데이터 요소: 페이지에 있는 메타 태그의 콘텐츠를 참조하십시오.
  • AudienceStream 속성: 배지, 메트릭 및 AudienceStream에 정의된 속성과 같은 속성입니다. AudienceStream은 Tealium의 다른 제품(Universal Data Hub)으로 유입되는 데이터를 가져와 사용자 참여의 가장 중요한 속성을 나타내는 방문자 프로필을 생성합니다.

로드 규칙

로드 규칙은 태그를 로드할 시기와 위치를 정의하는 조건입니다. 이러한 조건은 Amplitude가 태그를 로드하기 전에 통과해야 하는 논리적 조건으로 구성됩니다. 예를 들어 특정 도메인에 특정 태그만 로드되도록 설정할 수 있습니다. AND/OR 논리 또는 시간/날짜 기반 조건을 사용하여 태그를 로드할 수 있습니다.

로드 규칙이 더 이상 유용하지 않을 경우 이를 삭제하거나, 나중에 다시 사용할 수 있다고 생각되는 경우 이를 비활성화할 수 있습니다.

관찰

  • Amplitude 라이브러리 및 장치 ID: Device ID 는 Amplitude의 JavaScript SDK에 의해 설정된 임의로 생성된 UUID로 설정됩니다.Library = 'amplitude-js'
  • 를 로드하기 전에 변수를 설정한 경우 선언 블록 외부의 UDO 값을 업데이트할 수 있습니다utag.js. 그렇지 않으면 Tealium은 이를 무시합니다. 다음은 초기 페이지 로드에서의 UDO 예제입니다.
js
<script type="text/javascript">  
var utag_data = {  
    "page_type": "landing", // page type
    "page_name": "Home Page", // page name
    "event_name": "",
    "customer_id": "t: mar-20",
    "button_counter": "0"  
};  
</script>

사용자가 페이지의 버튼을 클릭할 때 다른 이벤트를 트리거하고 매번 button_counter 변수를 1씩 증가시키려면:

js
<script type = "text/javascript">
    document.addEventListener("DOMContentLoaded", function () {
        document.querySelectorAll(".amp-track").forEach(function (element) {
            element.addEventListener("click", function () {
                var eventName = element.dataset.event;
                if (eventName == "resume") {
                    utag.link({
                        "button_counter": "1",
                        "event_name": "t: button clicked"
                    });
                }
            });
        });
    });
</script>

변수를 사용 가능한 대상에 매핑하여 다양한 SDK 설정을 구성할 수 있습니다.

이 내용이 도움이 되었나요?