DIL 생성 방법

DIL 만들기

파트너별 DIL 인스턴스를 만듭니다.

함수 서명: DIL.create: function (initConfig) {}

initConfig 요소

중요

visitorService 속성은 항상​입니다. 별도로 지정하지 않는 한 여기에 나열된 다른 속성은 선택 사항입니다.

initConfig 는 다음 요소를 허용합니다.

이름 유형 설명

containerNSID

정수

이 속성은 ID 동기화를 위해 Audience Manager에서 사용하는 컨테이너 ID를 설정합니다. 여러 사이트에 DIL 를 배포했으면 containerNSID 을 설정합니다. 이러한 각 사이트에는 고유한 컨테이너 ID와 ID 동기화가 있습니다. 사이트가 1개만 있는 경우 컨테이너 ID는 기본적으로 0이며 제대로 설정할 필요가 없습니다. 사이트 및 컨테이너 ID 목록을 알려면 컨설턴트에게 문의하십시오.

Adobe Experience Platform Identity 서비스 에서 속성 idSyncContainerID DIL containerNSID 에 해당합니다. 여러 사이트에서 DIL 을 사용하는 경우 다음을 참고하십시오.

  • 각 사이트에 대해 containerNSID idSyncContainerID 에서 동일한 컨테이너 ID를 설정하십시오.
  • DIL 와 ID 서비스는 모두 ID 동기화를 데이터 수집 iFrame에 보내려고 시도합니다. 그러나 iFrame에서는 DIL 에서 ID 동기화를 실행하지 않도록 합니다. 이렇게 하면 중복이 방지됩니다.
  • DIL URL 대상 에 데이터를 보냅니다.

또한, idSyncContainerID 도 참조하십시오.

declaredId

개체

declaredId 는 다음 중 하나를 전달하는 데 사용됩니다.

  • dpid : Audience Manager 가 자신에게 할당한 데이터 파트너 ID입니다.
  • dpuuid : 사용자의 고유 ID입니다.

중요 사항: ID에 대해 인코딩이 해제된 값만 사용하십시오. 인코딩은 이중으로 인코딩된 식별자를 생성합니다.

참고: Adobe Experience Platform Identity 서비스 를 사용하는 경우 DIL 대신 setCustomerIDs 메서드로 고객 ID를 설정하십시오. 고객 ID 및 인증 상태 를 참조하십시오.

delayAllUntilWindowLoad

부울

true이면 Page Load 이벤트가 실행될 때까지 모든 요청(IFRAME, 이벤트 호출, ID 동기화 및 대상)이 실행되지 않습니다. 기본값은 false 입니다.

disableDeclaredUUIDCookie

부울

False 기본적으로, 즉 Audience Manager 은 파트너의 도메인에 쿠키를 설정합니다(자사 쿠키 설정).

disableDestinationPublishingIframe

부울

중요 사항: 이 요소는 DIL 버전 8.0에서 더 이상 사용되지 않습니다(2018년 8월 릴리스). 대신 Adobe Experience Platform Identity 서비스에서 visitor.disableIdSyncs 함수 를 사용하십시오.

true 에서 대상 게시 IFRAME을 DOM이나 실행 대상에 연결하지 않습니다. 기본값은 false 입니다.

disableIDSyncs

부울

중요 사항: 이 요소는 DIL 버전 8.0에서 더 이상 사용되지 않습니다(2018년 8월 릴리스). 대신 Adobe Experience Platform Identity 서비스에서 visitor.disableIdSyncs 함수 를 사용하십시오.

ID 동기화를 사용하지 않도록 설정합니다. DIL v6.2+ 및 방문자 ID 서비스를 사용할 때 ID 동기화를 비활성화해야 합니다. visitorService 함수(아래 샘플 코드 참조)가 이 작업을 처리합니다.

enableErrorReporting

부울

페이지의 모든 DIL 인스턴스에 대해 오류 보고를 사용하도록 설정하려면 true 로 설정하십시오. 부울 true 에서만 작동합니다.

iframeAkamaiHTTPS

부울

중요 사항: 이 요소는 DIL 버전 8.0에서 더 이상 사용되지 않습니다(2018년 8월 릴리스). 대신 Adobe Experience Platform Identity 서비스에서 visitor.idSyncSSLUseAkamai 함수 를 사용하십시오.

대상 게시 템플릿이 HTTPS 연결에 대해 Akamai를 사용하는지를 지정합니다. 파트너 기준으로 설정됩니다.

mappings

개체

한 키-값 쌍의 값을 다른 키-값 쌍에 연결합니다. 키 값을 다른 키 에 매핑 을 참조하십시오. v2.4와 함께 출시되었습니다.

namespace

문자열

필수 여부.

namespace 키-값 쌍에는 Experience Cloud 조직 ID가 포함되어 있습니다. 이 ID가 없는 경우 Experience Cloud 대시보드의 관리 섹션에서 찾을 수 있습니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. 제품 기능 FAQ 관리 - 사용자 관리 및 FAQ 를 참조하십시오.

partner

문자열

필수 여부.

Audience Manager 에서 제공한 파트너 이름입니다.

removeFinishedScriptsAndCallbacks

부울

스크립트 및 콜백을 제거합니다. 기본값은 False 입니다. 현재 DIL 인스턴스에만 적용됩니다. v3.3과 함께 출시되었습니다.

uuidCookie

개체

Audience Manager 에서 반환된 고유 사용자 ID를 사용하는 쿠키를 설정합니다. uuidCookie 속성 을 참조하십시오.

visitorService

개체

DIL 6.2 이상에서 필요합니다.

DIL은 Adobe Experience Platform Identity 서비스 에서 setCustomerIDs 함수를 사용하여 선언된 ID를 Audience Manager 에 전달합니다. 자세한 내용은 고객 ID 및 인증 상태를 참조하십시오.

샘플 코드

샘플 DIL 호출은 다음과 유사할 수 있습니다.

var partnerObject1 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-ORGANIZATION-ID-HERE" 
  }, 
  containerNSID: 3, 
  uuidCookie:{ 
    name:'ad_uuid', 
    days:200, 
    path:'/test', 
    domain:'adobe.com', 
    secure:true 
  } 
}); 
 
var partnerObject2 = DIL.create({ 
  partner: "partner name", 
  visitorService:{ 
    namespace: "INSERT-MCORG-ID-HERE" 
  }, 
  containerNSID: 3 
}); 

성공한 응답은 DIL 인스턴스를 반환합니다. 코드가 잘못 구성되어 있거나 오류가 발생할 때마다 오류 개체(throw되지 않음)가 반환됩니다.

uuidCookie 속성

uuidCookie 변수에 사용되는 속성을 정의합니다. 이 변수는 DIL.create 메서드의 일부입니다.

uuidCookie 에는 다음 속성이 있습니다.

이름 설명
name 쿠키 이름( aam_did 은 기본값)입니다.
days 쿠키 라이프타임(100일은 기본값)
path 쿠키 경로(예: '/test' ( / 은 기본값)).
domain 쿠키가 설정된 도메인(예: 'adobe.com' ( '.'+document.domain 은 기본값)).
secure HTTPS 연결을 통해서만 데이터를 전송하도록 플래그를 설정합니다.

visitorService 속성

visitorService 변수에 사용되는 속성을 정의합니다. 이 변수는 DIL.create 메서드의 일부입니다.

visitorService 에는 다음 속성이 있습니다.

이름 유형 설명
namespace 문자열 필수. Experience Cloud 조직 ID를 나타냅니다. Experience Cloud 핵심 서비스 기능에 필요합니다. 방문자 ID 기능을 인스턴스화하는 데 사용되는 것과 동일한 매개 변수입니다.

코드 샘플:

var vDil = DIL.create({ 
    partner: 'demofirst', 
    visitorService: { 
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE" 
    } 
});

이 페이지에서는