DIL 모듈

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

siteCatalyst.init

DIL을 사용하여 Analytics 태그 요소(변수, props, eVars 등)를 전송하고 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 정수

반환할 반복 이름 수를 나타냅니다. 예를 들어, 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 이벤트 목록(props, eVars 등)을 만듭니다. 값에 대한 값이 있는 경우.

// 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의 Universal Analytics에서 Audience Manager으로 데이터를 보냅니다. 이 DIL 함수는 Google Universal Analytics에 대한 최신 코드 라이브러리인 analytics.js에서 작동하도록 디자인되었습니다.

중요
  • Audience Manager 는 Google analytics.js 코드 라이브러리에 대한 통찰력이나 제어 권한이 없습니다. Google에서 analytics.js 새 버전을 릴리스할 때 또는 DIL 데이터 수집이 계속 작동하는지 확인해야 합니다.

  • Google의 기존 Analytics 추적 코드(예: 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 내부 속성은 축소된 변수입니다 '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의 이전 analytics 추적 코드 ga.js 또는 dc.js에서만 작동합니다. Google Universal Analytics에 대한 최신 코드 라이브러리인 analytics.js을 사용하는 경우에는 이 DIL 함수를 호출할 수 없습니다. Audience Manager 을 사용하는 고객 DIL 과 Universal Analytics 는 GA.submitUniversalAnalytics를 봐야 합니다 .

함수 서명: 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

이 페이지에서는