DIL 사용 사례 및 코드 샘플 dil-use-cases-and-code-samples

특정 DIL 사용 사례에 대한 코드 샘플 및 설명.

DIL을 사용하여 Audience Manager에 데이터 요소 보내기 send-data-elements-dil

Audience Manager 요소에 대한 정보를 페이지로 전송하는 개체 변수를 만듭니다. 이 기능은 일반 데이터 수집에 유용하거나 Analytics 변수로 데이터를 수집하는 것에 대한 대안으로 사용됩니다.

설명

다음 코드는 페이지 데이터를 수집하여 DIL을(를) 사용하여 Audience Manager으로 보내는 방법을 보여 줍니다. 이러한 예제에서는 변수를 사용하여 데이터 요소를 플랫 목록 또는 배열에 보관합니다. 변수를 키-값 쌍(으)로 전달하십시오. 또한 키-값 쌍의 키 앞에 c_ 접두사를 메모하십시오. 이 필수 접두사은(는) 정보를 사용자 정의 데이터로 식별합니다. 첫 번째 예에서는 c_을(를) 키에 수동으로 추가해야 합니다. 두 번째 예제에서는 DIL이(가) 자동으로 수행합니다.

값 속성을 일관되게 유지

데이터를 전달할 때 값 속성을 동일하게 유지해야 합니다. 예를 들어, 값이 다른 동일한 키가 두 개 있는 경우 마지막 키-값 쌍의 값이 이전 값 개체보다 우선합니다. 예를 들어 color:blue 및 color:red을(를) 전달하면 반환된 값이 빨간색으로 설정됩니다(파란색을 덮어씀).

예제 1: 데이터를 키-값 쌍으로 보내기

이 기본 예는 색상 및 가격 데이터를 키-값 쌍의 형태로 Audience Manager에 보냅니다. 코드는 다음과 유사할 수 있습니다.

var sample_dil = DIL.create({partner:"partner name"});
sample_dil.api.signals({
   c_color:"blue",
   c_price:"900"
});
sample_dil.api.submit();

예 2: 개체에 데이터 보내기

이 고급 예에서는 개체의 데이터를 Audience Manager으로 보내는 방법을 보여 줍니다. 이 메서드로 작업할 때 DIL을(를) 사용하면 개체를 함수 매개 변수로 signals() 메서드에 전달할 수 있습니다. DIL 코드가 다음과 유사할 수 있습니다.

var my_object = {
   color : "blue",
   price : "900"
};

var sample_dil = DIL.create({ partner : "partner name" });
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager.
sample_dil.api.signals(my_object,"c_").submit();

예 3: 배열에 페이지 데이터 보내기

이 경우 my_object 변수는 배열을 사용하여 데이터를 유지합니다. 이 예제는 위의 권장 방법으로 전달된 정보를 기반으로 하지만 제품 유형 및 모델을 수용하기 위해 추가 레이어를 추가합니다. 코드는 다음과 유사할 수 있습니다.

var my_objects = [{
   color : "blue",
   price : "900"
}, {
   type : "acura",
   model : "tl"
}];

var sample_dil = DIL.create({ partner : "partner name" });

for (var i = 0; i < my_objects.length; i++)
//Load the object and append "c_" to all the keys in the key-value pairs.
{
    sample_dil.api.signals(my_objects[i], "c_");
}
sample_dil.api.submit();

참조 URL 캡처 capture-referring-url

참조 URL을 캡처하여 Audience Manager으로 보냅니다.

코드 샘플

코드는 다음과 유사할 수 있습니다.

var adobe_dil = DIL.create({ partner : "partner name" });
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

검색 엔진 유형 및 키워드 검색어 캡처 capture-search-engine-types

검색 엔진 유형 및 키워드 검색에 대한 정보를 Audience Manager으로 보냅니다.

지원되는 검색 엔진

기본적으로 DIL.getSearchReferrer은(는) 다음 검색 엔진에서 검색을 인식합니다(국가별 변형 포함).

설명

다음 코드는 지원되는 검색 엔진에 대한 검색 레퍼러를 가져오는 방법을 보여 줍니다. 이 경우 사용자가 Google 캐나다(www.google.ca)에서 "홈"이라는 용어로 검색했다고 가정해 보겠습니다. 이 코드는 이러한 검색어를 캡처하여 Audience Manager으로 전송하는 데 도움이 됩니다.

기본 코드

검색 레퍼러를 가져오기 위한 기본 코드(예: google.com에서)는 다음과 같습니다.

var search_referrer = DIL.tools.getSearchReferrer();

나열된 검색 엔진 코드 샘플

이 경우 사용자가 Google 캐나다(www.google.ca)에서 "홈"이라는 용어를 검색했다고 가정해 보겠습니다. 코드 접두사가 필요한 c_ 매개 변수를 검색 엔진(c_se) 및 검색어(c_st)에 어떻게 추가하는지 확인하십시오. c_은(는) Audience Manager 시 고객 정의 변수로 식별하는 필수 접두사입니다.

var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer();

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

목록에 없는 검색 엔진 코드 샘플

이 경우 사용자가 dogpile.com에서 "홈"이라는 용어를 검색했다고 가정해 보겠습니다. Dogpile은(는) 기본적으로 지원되지 않으므로 이 검색 엔진을 인식하고 검색어를 Audience Manager으로 반환하도록 DIL을 구성할 수 있습니다. 코드는 다음과 유사할 수 있습니다.

var adobe_dil = DIL.create({partner:"partner name"});
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {
    hostPattern:/dogpile\./,
    queryParam:"q"
});

if (search_referrer && search_referrer.valid) {
  adobe_dil.api.signals({
    c_se : se.name,
    c_st : se.keywords
  }).submit();
}

다른 키에 키 값 매핑 map-key-values

키-값 쌍의 값을 다른 키에 연결합니다.

설명

키-값 쌍에서 키에 추가된 c_ 접두사는 신호를 고객 정의 데이터로 식별합니다. 고객 정의 데이터는 이벤트 호출 시 데이터를 전달한 특정 사이트에서의 타겟팅에 사용됩니다. 그러나 경우에 따라 Audience Manager 계정의 모든 속성에서 이 정보를 사용할 수 있게 해야 합니다. 이렇게 하려면 c_ 키-값 쌍의 값을 플랫폼 수준 키에 매핑합니다. 플랫폼 수준 키의 접두사로 d_이(가) 사용되고 계정의 모든 속성에서 신호를 타깃팅할 수 있게 됩니다.

예를 들어 특정 사이트에서 우편 번호 데이터를 수집하지만 모든 Audience Manager 속성에 타겟팅하려고 합니다. 플랫폼 수준에서 우편 번호를 사용할 수 있도록 하기 위해 아래와 같이 고객이 정의한 우편 번호 키(예: c_zip)를 플랫폼 정의 키에 매핑할 수 있습니다.

코드 샘플

코드는 다음과 유사할 수 있습니다.

var adobe_dil = DIL.create({
    partner : "adobe",
    mappings : {
        c_zip : 'd_zip',
        d_key2 : 'h_dil_key2'
    }
});
adobe_dil.api.signals({c_zip : '10010'}).submit();
// Request will look like /event?c_zip=10010&d_zip=10010

GTM(Google Tag Manager)의 트래픽 DIL traffic-dil-gtm

GTM 태그를 사용하여 DIL을 설정하고 제공합니다.

이 절차에서는 사용자가 Google Tag Manager 계정과 해당 제품에 대한 일부 작업 지식과 Audience Manager dil.js 파일을 가지고 있다고 가정합니다.

GTM에서 dil.js 파일을 트래픽하려면 다음을 수행하십시오.