URL 또는 데이터 소스별 ID 동기화

마지막 업데이트: 2024년 7월 17일

주제:

작성 대상:

개발자
사용자
관리자
기본

ID 서비스 함수 idSyncByURL 및 idSyncByDataSource를 사용하면 대상 게시 iFrame에서 ID 동기화를 수동으로 구현할 수 있습니다. VisitorAPI.js 버전 1.10 이상에서 사용할 수 있습니다.

구문, 속성 및 매크로

구문

코드	사용자 ID 동기화
visitor.idSyncByURL();	사용자 지정 동기화 URL을 사용하여 다양한 데이터 파트너와 Audience Manager 간에 동기화
visitor.idSyncByDataSource();	이미 DPID 및 DPUUID를 알고 있으며 표준 ID 동기화 URL 포맷으로 Audience Manager로 해당 ID를 전송하려고 할 때

속성

다음 표는 두 함수 모두에서 사용할 수 있는 속성을 나열하고 정의합니다.

이름	유형	설명
dpid	문자열	Audience Manager에서 지정한 데이터 공급자 ID.
dpuuid	문자열	사용자에 대한 데이터 공급자의 고유 ID입니다.
minutesToLive	숫자	(선택 사항) 쿠키 만료 시간을 설정합니다. 정수여야 합니다. 기본값은 20160분(14일)입니다.
url	문자열	대상 URL.

매크로

두 함수 모두 다음 매크로를 허용합니다.

%TIMESTAMP%: 타임스탬프를 생성합니다(밀리초 단위). 캐시 무효화에 사용됩니다.
%DID%: 사용자의 Audience Manager ID를 삽입합니다.
%HTTP_PROTO%: 통신 프로토콜(http 또는 https)을 설정합니다.

샘플 코드 및 출력

성공하면 두 함수 모두 Successfully queued를 반환합니다. 실패한 경우 오류 메시지 문자열을 반환합니다.

visitor.idSyncByURL

샘플 코드

   //Instatiate Visitor
    var visitor = Visitor.getInstance
    ("MARKETING-CLOUD-ORG-ID-HERE",{});
   // Fires url with macros replaced
    visitor.idSyncByURL({
    dpid: '24', // must be a string
    url: '//su.addthis.com/red/usync?pid=16&puid=%DID%&url=%HTTP_PROTO%://
    dpm.demdex.net/ibs:dpid=420&dpuuid={{uid}}',
    minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

샘플 출력

http://su.addthis.com/red/usync?pid=16&puid=28777806459181003670799219185178493848&url=http%3A%2F%2Fdpm.demdex.net%2Fibs%3Adpid%3D420%26dpuuid%3D%7B%7Buid%7D%7D

visitor.idSyncByDataSource

샘플 코드

  //Instantiate Visitor
   var visitor = Visitor.getInstance
   ("MARKETING-CLOUD-ORG-ID-HERE",{});
  // Fires 'http:/https:' + '//dpm.demdex.net/ibs:dpid=&dpuuid='
   visitor.idSyncByDataSource({
     dpid: '24', // must be a string
     dp     minutesToLive: 20160 // optional, defaults to 20160 minutes (14 days) });

샘플 출력

http://dpm.demdex.net/ibs:dpid=24&dpuuid=98765

recommendation-more-help