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" 
    } 
});

이 페이지에서는