traits
보류 중인 요청의 쿼리 문자열에 SID를 추가합니다.
함수 서명: traits:function (sids){}
매개 변수
이름 | 유형 | 설명 |
---|---|---|
sids | 배열 | 배열의 트레이트 세그먼트 ID. |
응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
로그
보류 중인 요청의 로그 파일에 데이터를 추가합니다.
함수 서명: logs: function {key1:value1, key2:value2}
응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
제출
DIL 인스턴스에 대해 보류 중인 모든 데이터를 Audience Manager에 제출합니다.
함수 서명: submit: function () {}
%20
, 세미콜론은 %3B
형식으로 인코딩됩니다.응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
afterResult
기본 대상 게시 콜백 후에 실행되는 함수입니다.
함수 서명: afterResult: function (fn) {}
매개 변수
이름 | 유형 | 설명 |
---|---|---|
fn | 함수로 플러그인 호출 | JSON 후에 실행할 함수는 대상 게시를 처리하는 기본 콜백에 의해 처리됩니다. |
응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
clearData
보류 중인 요청의 모든 데이터를 지웁니다.
함수 서명: clearData: function () {}
응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
customQueryParams
데이터 수집 서버에서 명시적으로 정의하지 않은 사용자 지정 쿼리 매개 변수를 보류 중인 요청에 추가합니다.
함수 서명: customQueryParams: function (obj) {}
예약된 요청 키
다음 요청 키는 예약되어 있으며 이 메서드로 덮어쓸 수 없습니다.
sids
pdata
logdata
callback
postCallbackFn
useImageRequest
응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
getContainerNSID
DIL 인스턴스에 대한 컨테이너 NSID 값을 반환합니다. 디버깅 및 문제 해결에 유용합니다.
함수 서명: dil.api.getContainerNSID: function () {}
샘플 코드
getEventLog
연대순으로 정렬된 이벤트 로그 데이터를 문자열 배열로 반환합니다. 디버깅 및 문제 해결에 유용합니다.
함수 서명: dil.api.getEventLog: function () {}
샘플 코드
getPartner
DIL 인스턴스에 대한 파트너 이름을 반환합니다. 디버깅 및 문제 해결에 유용합니다.
함수 서명: dil.api.getPartner: function () {}
샘플 코드
getState
현재 DIL 인스턴스의 상태를 반환합니다. 디버깅 및 문제 해결에 유용합니다.
함수 서명: dil.api.getState: function () {}
샘플 코드
idSync
데이터 파트너가 사용자와 Audience Manager 간에 사용자 ID를 교환하고 동기화할 수 있는 두 가지 기능으로 구성됩니다.
함수 서명:
DIL 버전 2.10 및 3.1 이상에서 작동합니다.
코드 | 사용자 ID 동기화 |
---|---|
dil.Instance.api.idSync(initConfig) |
다양한 데이터 파트너와 Audience Manager 간 예를 들어 파트너 x는 이 기능을 사용하여 Audience Manager ID를 파트너 y와 동기화한 다음 사용자에게 보냅니다. 중요: 이 메서드는 사용되지 않습니다. Adobe Experience Platform ID 서비스 인스턴스의 |
dil.Instance.api.aamIdSync(initConfig) |
Audience Manager ID를 이미 알고 있고 사용자에게 보내고자 하는 경우. 중요: 이 메서드는 사용되지 않습니다. Adobe Experience Platform ID 서비스 인스턴스의 |
idSync 요소
idSync
은(는) 다음과 같이 구성될 수 있습니다.
이름 | 유형 | 설명 |
---|---|---|
dpid | 문자열 | Audience Manager가 할당한 데이터 제공업체 ID입니다. |
dpuuid | 문자열 | 사용자에 대한 데이터 제공업체의 고유한 ID입니다. |
minutesToLive | 숫자 | (선택 사항) 쿠키 만료 시간을 설정하며 정수여야 합니다. 기본값은 20160분(14일)입니다. |
url | 문자열 | 대상 URL. |
매크로
idSync
이(가) 다음 매크로를 허용합니다.
%TIMESTAMP%
: 타임스탬프를 생성합니다(밀리초 단위). 캐시 무효화에 사용됩니다.%DID%
: 사용자의 Audience Manager ID를 삽입합니다.%HTTP_PROTO%
: 페이지 프로토콜(http
또는https
)을 설정합니다.
응답
성공하면 두 함수 모두 Successfully queued
을(를) 반환합니다. 실패한 경우 오류 메시지 문자열을 반환합니다.
샘플 코드
dilInstance.api.idSync(initConfig)
dilInstance.api.aamIdSync(initConfig)
결과
JSON을 수신하는 콜백을 보류 중인 요청에 추가합니다.
함수 서명: result: function (callback) {}
이 콜백은 대상 게시를 처리하는 기본 콜백을 대체합니다.
매개 변수
이름 | 유형 | 설명 |
---|---|---|
callback | 함수로 플러그인 호출 | JSONP 콜백에서 실행된 JavaScript 함수입니다. |
응답
현재 DIL 인스턴스의 API 개체를 반환합니다.
샘플 코드
보안 데이터 수집
secureDataCollection
은(는) DIL이(가) Data Collection Servers (DCS) 및 Akamai를 호출하는 방법을 제어하는 부울 매개 변수입니다.
-
secureDataCollection= true
(기본값)이면 DIL은(는) 항상 보안 HTTPS 호출을 수행합니다. -
secureDataCollection= false
에서 DIL은(는) 페이지에서 설정한 보안 프로토콜을 따라 HTTP 또는 HTTPS를 호출합니다.
secureDataCollection= false
을(를) 설정하십시오. 아래 코드 샘플을 참조하십시오.useCORSOnly
useCORSOnly
은(는) 브라우저가 다른 도메인에서 리소스를 요청하는 방법을 제어하는 부울 true/false 매개 변수입니다.
개요
useCORSOnly
은(는) 기본적으로 false입니다. False는 브라우저가 CORS 또는 JSONP로 리소스 확인을 수행할 수 있음을 의미합니다. 그러나 DIL은(는) 항상 먼저 CORS를 사용하여 리소스를 요청하려고 합니다. ID 서비스는 CORS를 지원하지 않는 오래된 브라우저에서는 JSONP로 되돌립니다. 보안 요구 사항이 높은 사이트에서와 같이 브라우저에서 CORS만 사용해야 하는 경우 useCORSOnly:true
을(를) 설정합니다.
코드 샘플
- 사이트 방문자에게 이 기능을 지원하는 브라우저가 있는 경우에만
useCORSOnly: true
을(를) 설정하는 것이 좋습니다. useCORSOnly: true
일 때 DIL은(는) Internet Explorer 버전 9 이상에서 ID를 호출하지 않습니다.