DIL 생성 방법

DIL 만들기

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

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

initConfig 요소

중요

visitorService 속성은 항상 필요합니다. 여기에 나열된 기타 속성은 별도로 명시되지 않는 한 선택 사항입니다.

initConfig 다음 요소를 수락합니다.

이름 유형 설명

containerNSID

정수

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

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

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

idSyncContainerID도 참조하십시오 .

declaredId

개체

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

  • dpid :Audience Manager에 의해 사용자에게 할당된 데이터 파트너 ID .
  • dpuuid :사용자의 고유 ID.

중요: ID에 대해 인코딩되지 않은 값만 사용하십시오. 인코딩하면 이중으로 인코딩된 식별자가 생성됩니다.

참고: Adobe Experience Platform ID 서비스 를 사용하는 경우 DIL 대신 setCustomerIDs 방법으로 고객 ID를 설정합니다 . See Customer IDs and Authentication States .

delayAllUntilWindowLoad

부울

true이면 이벤트가 발생할 때까지 모든 요청(IFRAME, 이벤트 호출, ID 동기화 및 대상)을 Page Load 제거합니다. 기본값은 false 입니다.

disableDeclaredUUIDCookie

부울

False 기본적으로 Audience Manager은 파트너 도메인에 쿠키를 설정합니다(퍼스트 파티 쿠키 설정).

disableDestinationPublishingIframe

부울

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

이 경우 true 는 대상 게시 IFRAME을 DOM이나 화재 대상에 연결하지 않습니다. 기본값은 false 입니다.

disableIDSyncs

부울

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

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

enableErrorReporting

부울

페이지의 모든 DIL 인스턴스 true 에 대한 오류 보고를 활성화하도록 설정합니다. Boolean에서만 true 작동합니다.

iframeAkamaiHTTPS

부울

중요: 이 요소는 DIL 버전 8.0에서 더 이상 사용되지 않습니다(2018년 8월 릴리스). Adobe Experience Platform ID 서비스 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를 가진 쿠키를 설정합니다 . uuid 쿠키 속성을 참조하십시오 .

visitorService

개체

DIL 6.2 이상 버전이 필요한 경우 필요합니다.

DIL은 setCustomerIDs Adobe Experience Platform ID 서비스 의 기능을 사용하여 선언된 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 The cookie name ( aam_did is default).
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" 
    } 
});

이 페이지에서는