DIL 모듈 dil-modules

WARNING
2023년 7월부터 Adobe은 의 개발을 중단했습니다. Data Integration Library (DIL) 및 DIL 확장명.
기존 고객은 DIL 구현. 그러나 Adobe은 개발되지 않습니다 DIL 이 점을 넘어서는 것입니다. 고객은 다음을 평가하는 것이 좋습니다. Experience Platform Web SDK 을 참조하십시오.
2023년 7월 이후 새로운 데이터 수집 통합을 구현하려는 고객은 Experience Platform Web SDK 대신,

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

siteCatalyst.init sitecat-init

와 함께 작동 DIL 보내기 Analytics 태그 요소(변수, prop, eVar 등) Audience Manager. 쉼표로 구분된 목록으로 데이터를 반환합니다. 버전 2.6에서 사용할 수 있습니다.

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

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

매개 변수

이름
유형
설명
names
문자열
열거되지 않은 문자열을 포함하는 문자열 배열 분석 다음과 같은 변수 pageName , channel , campaign , product
iteratedNames
개체
열거된 항목이 포함된 개체 배열 분석 prop 및 evar와 같은 변수(예: prop1 , prop2 , evar3 , evar4 ).
maxIndex
정수
반환할 반복된 이름의 수를 나타냅니다. 예를 들어 두 개의 prop 또는 evar를 반환하려면 다음을 설정합니다. maxIndex:2 .
siteCatalystReportingSuite
개체
다음을 나타내는 개체 분석 개체.
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 event (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-submit-universal-analytics

다음 GA.submitUniversalAnalytics(); 함수가 Google에서 데이터를 Universal Analytics Audience Manager. 이 DIL 함수는 analytics.js: Google의 최신 코드 라이브러리입니다 Universal Analytics.

IMPORTANT
  • Audience Manager 은(는) Google에 대한 통찰력이나 제어 권한이 없습니다. analytics.js 코드 라이브러리. 다음을 확인해야 합니다. DIL Google이 새 버전의 를 릴리스할 경우 또는 릴리스할 때 데이터 수집이 여전히 작동합니다. analytics.js.

  • 다음을 사용할 수 없습니다. GA.submitUniversalAnalytics(); Google의 기존 analytics 추적 코드로 작업하는 경우(예: ga.js 또는 dc.js). 다음을 참조하십시오 GA.init 대신,

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

속성

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

속성
설명
gaObject
인스턴스에 대한 전역 변수입니다. Google Analytics . 일반적으로 다음과 같습니다 ga 을(를) 사용자 지정하지 않은 경우 기본적으로 Google Analytics 코드.
dilInstance
인스턴스를 나타내는 변수입니다. DIL .
internalPropertyName

(선택 사항) 다음에서 analytics.js 라이브러리, 내부 속성은 축소된 변수입니다. 'b' . 이 변수는 다음과 같습니다. Google Analytics 데이터.

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

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

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

//Instantiate DIL
var dilInstance = DIL.create({
     partner:"adobe"
});

//Call the DIL Universal Analytics function
DIL.modules.GA.submitUniversalAnalytics(ga, dilInstance);

GA.init ga-init

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

IMPORTANT
GA.init() Google의 기존 analytics 추적 코드에서만 작동합니다. ga.js 또는 dc.js. 호출할 수 없습니다. DIL 함수(를 사용하는 경우) analytics.js: Google의 최신 코드 라이브러리입니다 Universal Analytics. 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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695