DIL 만들기 메서드

마지막 업데이트: 2023-08-02
경고

2023년 7월부터 Adobe은 의 개발을 중단했습니다. Data Integration Library (DIL) 및 DIL 확장명.

기존 고객은 DIL 구현. 그러나 Adobe은 개발되지 않습니다 DIL 이 점을 넘어서는 것입니다. 고객은 다음을 평가하는 것이 좋습니다. Experience Platform Web SDK 을 참조하십시오.

2023년 7월 이후 새로운 데이터 수집 통합을 구현하려는 고객은 Experience Platform Web SDK 대신,

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 다음에 해당 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 변수를 채우는 방법에 따라 페이지를 순서대로 표시합니다. 이 변수는 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"
    }
});

이 페이지에서는