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 ID 서비스 에서 속성 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 ID 서비스 를 사용하는 경우 DIL 대신 setCustomerIDs 메서드로 고객 ID를 설정합니다. 고객 ID 및 인증 상태 를 참조하십시오.

delayAllUntilWindowLoad

부울

true이면 Page Load 이벤트가 발생할 때까지 모든 요청(IFRAME, 이벤트 호출, ID 동기화 및 대상)이 실행되지 않습니다. 기본값은 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 으로 설정합니다. 부울 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은 Adobe Experience Platform ID 서비스 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" 
    } 
});

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now