DIL 만들기 메서드 dil-create

WARNING
2023년 7월부터 Adobe은 의 개발을 중단했습니다. Data Integration Library (DIL) 및 DIL 확장명.
기존 고객은 DIL 구현. 그러나 Adobe은 개발되지 않습니다 DIL 이 점을 넘어서는 것입니다. 고객은 다음을 평가하는 것이 좋습니다. Experience Platform Web SDK 을 참조하십시오.
2023년 7월 이후 새로운 데이터 수집 통합을 구현하려는 고객은 Experience Platform Web SDK 대신,

DIL 만들기 dil-create-new

파트너별 만들기 DIL 인스턴스.

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

initConfig 요소

IMPORTANT
다음 visitorService 속성은 입니다. 항상 필수. 여기에 나열된 다른 속성은 달리 표시되지 않는 한 선택 사항입니다.

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

이름
유형
설명
containerNSID
정수

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

다음에서 Adobe Experience Platform ID 서비스, 속성 idSyncContainerID 다음에 해당 containerNSID 위치: DIL . 을 사용하는 경우 다음 사항을 참고하십시오. DIL 여러 사이트에서 ID 서비스:

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

다음을 참조하십시오. idSyncContainerID.

declaredId
개체

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

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

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

참고: Adobe Experience Platform ID 서비스, 고객 ID 설정 setCustomerIDs 대신 메서드 DIL . 다음을 참조하십시오 고객 ID 및 인증 상태.

delayAllUntilWindowLoad
부울
true인 경우 은 (이)가 다음을 실행할 때까지 모든 요청(IFRAME, 이벤트 호출, ID 동기화 및 대상)의 실행을 지연합니다. Page Load 이벤트가 실행됩니다. 기본값은 false 입니다.
disableDeclaredUUIDCookie
부울
False 기본적으로 Audience Manager 파트너의 도메인에 쿠키를 설정합니다(자사 쿠키 설정).
disableDestinationPublishingIframe
부울

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

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

disableIDSyncs
부울

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

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

enableErrorReporting
부울
다음으로 설정 true 모든 항목에 대한 오류 보고를 활성화하려면 DIL 페이지의 인스턴스. 부울을 사용한 작업 true 만 해당.
iframeAkamaiHTTPS
부울

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

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

mappings
개체
한 키-값 쌍의 값을 다른 키-값 쌍에 연결합니다. 다음을 참조하십시오 다른 키에 키 값 매핑. v2.4와 함께 릴리스되었습니다.
namespace
문자열

필수 여부.

다음 namespace 키-값 쌍에 Experience Cloud 조직 ID. 이 ID가 없으면 관리 의 섹션 Experience Cloud 대시보드입니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. 다음을 참조하십시오. 제품 및 기능 FAQ관리 - 사용자 관리 및 FAQ.

partner
문자열

필수 여부.

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

removeFinishedScriptsAndCallbacks
부울
스크립트 및 콜백을 제거합니다. 기본값은 False 입니다. 현재 항목에 적용 DIL 인스턴스만. v3.3과 함께 릴리스되었습니다.
uuidCookie
개체
에서 반환된 고유 사용자 ID로 쿠키를 설정합니다. Audience Manager . 다음을 참조하십시오 uuidCookie 속성.
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-props

에서 사용하는 속성을 정의합니다. uuidCookie 변수를 채우는 방법에 따라 페이지를 순서대로 표시합니다. 이 변수는 DIL.create 메서드를 사용합니다.

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

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

visitorService 속성 visitor-service-props

에서 사용하는 속성을 정의합니다. visitorService 변수를 채우는 방법에 따라 페이지를 순서대로 표시합니다. 이 변수는 DIL.create 메서드를 사용합니다.

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

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

코드 샘플:

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695