DIL 사용 사례 및 코드 샘플

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

Audience Manager이(가) 있는 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 캡처

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

코드 샘플

코드는 다음과 비슷합니다.

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

캡처 검색 엔진 유형 및 키워드 검색 용어

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

지원되는 검색 엔진

기본적으로 DIL.getSearchReferrer은 이러한 검색 엔진에서 검색을 인식합니다(국제 변형 포함).

• AOL
• Ask
• Bing
• Google
• Yahoo!

설명

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

기본 코드

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

var search_referrer = DIL.tools.getSearchReferrer();

나열된 검색 엔진 코드 샘플

이 경우 사용자가 Google 캐나다( www.google.ca)에서 "homes"라는 용어를 검색했다고 가정합니다. 코드가 필요한 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에서 "homes"라는 용어를 검색했다고 가정합니다. 기본적으로 Dogpile은(는) 지원되지 않으므로 이 검색 엔진을 인식할 수 있도록 DIL을 구성하고 검색어를 Audience Manager으로 반환할 수 있습니다. 코드는 다음과 비슷합니다.

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(); 
}

키 값을 다른 키에 매핑

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

설명

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

예를 들어 특정 사이트에서 ZIP 코드 데이터를 수집하지만 모든 Audience Manager 속성에 타깃팅하려는 경우가 있습니다. 플랫폼 수준에서 ZIP 코드를 사용할 수 있도록 하려면 고객이 정의한 ZIP 코드 키(예: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

GTM 태그로 DIL 설정 및 제공

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

GTM의 dil.js 파일에 트래픽을 표시하려면:

1. 새 컨테이너를 만들거나 기존 컨테이너를 엽니다.

2. 컨테이너에 새 태그를 추가합니다.

3. 태그를 열고 다음을 수행합니다.

   • 태그 이름을 지정합니다.
   • Tag Type 드롭다운 목록에서 Custom HTML Tag​을 선택합니다.
   • HTML 필드에 스크립트 태그 <script>DIL code</script> 내에 DIL 코드(라이브러리 + 사용자 지정 코드)를 배치합니다.
   • 클릭 Save.

4. 컨테이너를 게시합니다.

5. 컨테이너 태그 코드를 생성하여 인벤토리에 배치합니다.