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 속성은 always ​이어야 합니다. 여기에 나열된 다른 속성은 달리 표시되지 않는 한 선택 사항입니다.

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

이름
유형
설명
containerNSID
정수

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

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

  • 각 사이트에 대해 containerNSID idSyncContainerID 에서 동일한 컨테이너 ID를 설정하십시오.
  • DIL 과(와) ID 서비스가 모두 데이터 수집 iFrame으로 ID 동기화를 보냅니다. 그러나 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로 쿠키를 설정합니다. uuidCookie 속성을(를) 참조하십시오.
visitorService
개체

DIL 6.2 이상에는 필수입니다.

DIL은 선언된 ID를 Audience Manager 에 전달하기 위해 Adobe Experience Platform ID 서비스 의 setCustomerIDs 함수를 사용합니다. 자세한 내용은 고객 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