DIL 모듈

DIL.modules 네임스페이스의 메서드를 설명합니다. 이러한 모듈을 사용하면 프로그래밍 방식으로 데이터를 수집하고 Audience Manager 개체를 사용하여 작업할 수 있습니다.

siteCatalyst.init

DIL과 함께 Analytics 태그 요소(변수, prop, eVar 등)를 보냅니다. 를 Audience Manager에 추가합니다. 데이터를 쉼표로 구분된 목록으로 반환합니다. 버전 2.6에서 사용 가능합니다.

함수 서명: DIL.modules.siteCatalyst.init(siteCatalystReportingSuite, dilInstance, trackVars, options)

노트

s.t(); 함수 앞에 페이지에 이 코드를 배치해야 합니다.

매개 변수

이름 유형 설명
names 문자열

pageName , channel , campaign , product 등과 같은 열거되지 않은 Analytics 변수가 포함된 문자열 배열입니다.

iteratedNames 개체

prop 및 evar와 같은 Analytics 변수를 열거한 개체(예: prop1 , prop2 , evar3 , evar4 ).

maxIndex 정수

반환할 반복 이름의 수를 나타냅니다. 예를 들어 2개의 prop 또는 evar를 반환하려면 maxIndex:2 을 설정합니다.

siteCatalystReportingSuite 개체

Analytics 개체를 나타내는 객체입니다.

dilInstance 개체

DIL 을 나타내는 객체입니다.

options 개체

추가 옵션:

  • replaceContextDataPeriodsWith

    다른 항목을 지정하지 않으면 마침표가 기본 밑줄( _ )로 바뀝니다.

    예를 들어 s.contextData = {abc.def = '123'} 은 이벤트 호출 쿼리 문자열에 c_contextData_abc_def=123 이 됩니다.

    이 옵션은 DIL 버전 5.0 이상에서만 사용할 수 있습니다.

  • filterFromContextVariables

    예를 들어 filterFromContextVariables: ['email', 'zip', 'accountNumber'] 은 컨텍스트 데이터의 데이터 수집에서 문자열 배열을 필터링합니다. 이 옵션은 PII(개인 식별 정보)를 제외합니다.

siteCatalyst.init에서 캡처한 데이터

이 함수는 다음 Analytics 속성에 대한 세부 사항을 반환합니다.

  • pageName
  • channel
  • campaign
  • products
  • events
  • eVar (1~250)
  • prop (1 - 75)
  • pe
  • pev1
  • pev2
  • pev3

샘플 코드

이 코드는 Analytics 이벤트(prop, eVar 등)의 쉼표로 구분된 목록을 만듭니다. 에 대한 값이 있는 경우

// Get the Site Catalyst object instance: 
var s = s_gi(s_account); 
  
// Instantiate DIL code: 
var scDil = DIL.create({ 
        partner: 'adobe', 
        containerNSID: 5 
}); 
 
// Use the module: 
DIL.modules.siteCatalyst.init(s, scDil, { 
        //Specify the Site Catalyst variables you want to capture: 
        names: ['pageName', 'channel', 'campaign'], 
        //Use this to create iterated variable names: 
        iteratedNames: [{ 
               name: 'eVar', 
               maxIndex: 75 
        }, { 
               name: 'prop', 
               maxIndex: 75 
        }] 
});

위에 표시된 추가 함수 없이 모니터된 모든 Analytics 데이터 포인트를 추적하려면 다음과 같이 siteCatalyst.init을(를) 직접 호출합니다.

DIL.modules.siteCatalyst.init(s, scDil);

GA.submitUniversalAnalytics

GA.submitUniversalAnalytics(); 함수는 Google의 [!DNL Universal Analytics]에서 Audience Manager으로 데이터를 보냅니다. 이 [!UICONTROL DIL] 함수는 Google [!DNL Universal Analytics]에 대한 최신 코드 라이브러리인 analytics.js과 함께 작동하도록 디자인되었습니다.

중요
  • Audience Manager 은 Google analytics.js 코드 라이브러리에 대한 통찰력이나 제어 기능이 없습니다. Google이 analytics.js의 새 버전을 출시하는 경우 또는 해당 시점에 DIL 데이터 수집이 여전히 작동하는지 확인해야 합니다.

  • Google의 기존 분석 추적 코드(예: ga.js 또는 dc.js)를 계속 사용하고 있는 경우에는 GA.submitUniversalAnalytics();을(를) 사용할 수 없습니다. 대신 GA.init을 참조하십시오.

함수 서명: DIL.modules.GA.submitUniversalAnalytics(gaObject, dilInstance, internalPropertyName);

속성

GA.submitUniversalAnalytics(); 함수는 다음 속성을 허용합니다.

속성 설명

gaObject

Google Analytics 인스턴스에 대한 전역 변수입니다. Google Analytics 코드를 사용자 지정하지 않은 경우 기본적으로 ga 입니다.

dilInstance

DIL 의 인스턴스를 나타내는 변수입니다.

internalPropertyName

(선택 사항) 라이브러리에서 analytics.js internal 속성은 축소된 변수입니다 'b' . 이 변수는 Google Analytics 데이터를 보유합니다.

Google이 내부 변수의 이름을 변경하지 않는 한 이 속성을 설정할 필요가 없으므로 이 속성은 선택 사항입니다. 예를 들어 이 축소 변수가 'a' 으로 변경된 경우 다음과 같이 GA.submitUniversalAnalytics(); 을(를) 호출합니다.

DIL.modules.GAsubmitUniversalAnalytics(ga, DilInstance, 'a');

DIL 및 GA.submitUniversalAnalytics();을(를) 호출하기 전에 먼저 Google Analytics ga 개체를 정의해야 합니다. 코드는 다음과 비슷합니다.

//Instantiate DIL 
var dilInstance = DIL.create({ 
     partner:"adobe" 
}); 
 
//Call the DIL Universal Analytics function 
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init

GA.init() 함수는 Google Analytics의 기존/더 이상 사용되지 않는 버전에서 Audience Manager으로 데이터를 보냅니다.

중요

GA.init() Google의 기존 분석 추적 코드에만 사용할 수 ga.js 있습니다 dc.js. Google Universal Analytics에 대한 최신 코드 라이브러리인 analytics.js을 사용하는 경우 이 DIL 함수를 호출할 수 없습니다. Audience Manager GA.submitUniversalAnalytics DIL 를 사용하고 Universal Analytics 있어야 하는 고객.

함수 서명: DIL.modules.GA.init(_gaq, dilInstance, trackVars);

매개 변수

이름 유형 설명
_gaq 배열 GA 명령이 포함된 배열입니다.
dilInstance 개체 DIL 인스턴스를 포함하는 객체입니다.
trackVars 개체 (선택 사항) 속성으로 구성된 names 객체입니다. 이 속성은 추적할 GA 명령 이름의 배열입니다.

지원되는 GA 함수 호출

기본적으로 GA.init은(는) 다음 함수의 데이터를 캡처합니다.

  • _setCustomVar
  • _addItem
  • _addTrans
  • _setAccount
  • _trackSocial

DIL에서 GA 데이터에 대한 키를 만듭니다.

Audience Manager은 키-값 쌍 형태의 데이터를 허용하는 반면 GA는 배열의 항목과 함께 작동합니다. GA 데이터로 작업하려면 DIL이(가) 키-값 쌍을 자동으로 만들고 다음과 같은 키를 구성합니다.c_ <key name>. 또한 GA 배열의 항목은 특정 순서로 표시됩니다. 따라서 데이터가 없는 경우에도 모든 매개 변수를 해당 순서로 제공해야 합니다. DIL 다음 GA 메서드에 대한 매핑 키:

// Tracking Social Interactions 
_gaq.push(['_trackSocial', 
    'facebook',                        // c_socialNetwork 
    'like',                            // c_socialAction 
    'https://www.adobe.com/cool.php',   // c_socialTarget 
    '/cool.php'                        // c_socialPagePath 
]);  
 
// Tracking a Transaction 
_gaq.push(['_addTrans', 
   '1234',           // c_transOrderId 
   'Womens Apparel', // c_transAfflication 
   '28.28',          // c_transTotal 
   '1.29',           // c_tranTax 
   '15.00',          // c_transShipping 
   'San Jose',       // c_transCity 
   'California',     // c_transState 
   'USA'             // c_transCountry 
]); 
 
// Tracking an item 
_gaq.push(['_addItem', 
   '1234',           // c_itemOrderId=1234 
   'DD44',           // c_itemSku 
   'T-Shirt',        // c_itemName 
   'Olive Medium',   // c_itemCategory 
   '11.99',          // c_itemPrice 
   '1'               // c_itenQuantity 
]);

샘플 코드

// DIL JavaScript library needs to be loaded and executed here 
var dilInstance = DIL.create({ 
    partner : "adobe" 
}); 
 
// Assume ga.js has not loaded 
var _gaq = _gaq || []; 
_gaq.push( 
  ['_setAccount', 'UA-XXXXX-X'], 
  ['_setDomainName', 'example.com'], 
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3], 
  ['_trackPageview'] 
); 
_gaq.push([ 
  '_addItem', 
  '1234',         // order ID - necessary to associate item with transaction 
  'DD44',         // SKU/code - required 
  'T-Shirt',      // product name - necessary to associate revenue with product 
  'Olive Medium', // category or variation 
  '11.99',        // unit price - required 
  '1'             // quantity - required 
]); 

위에 표시된 추가 함수 없이 모니터된 모든 GA 지표를 추적하려면 다음과 같이 GA.init을(를) 자체적으로 호출합니다.

DIL.modules.GA.init(_gaq, dilInstance).submit();

샘플 이벤트 호출

Audience Manager에 대한 URL 이벤트 호출은 다음과 비슷합니다.

https://adobe.demdex.com/event?...c_accountId=UA-XXXXX-X&c_Section=Life%20%26%20Style &c_itemOrderId=1234&c_itemSku=DD44&c_itemName=T-Shirt&c_itemCategory=Olive%20Medium& c_itemPrice=11.99&c_itemQuantity=1

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now