Declared IDs declared-ids
방법 declared IDs 작업, 프로시저 설정, 코드 예제 및 변수.
Declared ID 타겟 지정 declared-id-targeting
사용자 ID를 와 교환 및 동기화 Audience Manager 타사 제품과 같이 영구 스토리지 메커니즘을 사용하거나 허용하지 않는 디바이스 또는 브라우저에서 cookies.
목적 Declared ID 타겟팅 declared-id-targeting-purpose
일부 브라우저 및 대부분의 모바일 장치는 서드파티를 허용하지 않습니다 cookies. 따라서 사이트 방문자에 대한 정보를 유지하거나 영구 ID를 할당하는 것이 어렵습니다. 이 문제를 해결하려면 Audience Manager 사용 DIL 지나가게 해주십시오 declared IDs 이벤트 호출 시. 또한 declared ID 은 의 모든 솔루션에서 동일한 사용자에게 적용되는 범용 ID로 작동합니다 Experience Cloud. 다음 표에서는 ID 타겟팅/일치 프로세스에 대해 설명합니다.
setVisitorID
에서 제공하는 함수 Adobe Experience Platform ID 서비스 를 로 전달합니다. Audience Manager .Audience Manager은 클라이언트 및 방문자 ID를 시스템의 해당 ID와 일치시키려고 시도합니다. 일치하는 ID가 없으면 Audience Manager은 새 ID를 만들어 클라이언트 및 방문자 ID와 연결합니다.
참고: ID가 둘 이상의 Audience Manager ID에 매핑되는 경우 가장 최근 매핑이 사용됩니다.
시작하려면 다음을 구성해야 합니다. Experience Cloud ID 서비스 DIL 를 추가합니다. 다음을 참조하십시오 DIL 만들기 및 선언된 ID 변수.
옵트아웃 호출 opt-out-calls
다음 declared ID 에서 옵트아웃하도록 사이트 방문자 환경 설정 적용 Audience Manager 웹 사이트별 타기팅. 날짜 Audience Manager 옵트아웃 요청을 수신합니다. JSON 에 의해 반환됨 DCS 오류 코드 171을 포함합니다. Encountered opt out tag
, 대신 Audience Manager 사용자 ID.
- Audience Manager 다음을 전달할 수 있음: declared ID 와 함께 옵트아웃 Audience Manager UUID 다음에서 URL.
- 다음 declared ID 옵트아웃은에 저장됩니다 Profile Cache Server (PCS)을 참조하십시오. 을 사용하는 플랫폼 수준 옵트아웃은 없습니다. declared IDs. 또한, Audience Manager 는 가장자리에 있는 특정 영역에서 사용자를 옵트아웃합니다(옵트아웃은 교차하지 않음) DCS 지역).
다음을 참조하십시오 데이터 개인 정보 보호 데이터 수집을 옵트아웃하는 방법에 대한 자세한 정보입니다.
Declared ID 옵트아웃 예 opt-out-examples
다음을 수행할 수 있습니다. declared ID 을 사용한 옵트아웃 요청 d_cid
및 d_cid_ic
키-값 쌍입니다. d_dpid
및 d_dpuuid
와 같은 기존 매개 변수는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다. CID가 DPID 및 DPUUID 대체를 참조하십시오. 예에서 기울임꼴 은 가변 자리 표시자를 나타냅니다.
옵트아웃 CID 및 CID_IC
설명 및 구문이 필요하면 선언된 ID에 대한 URL 변수 및 구문을 참조하십시오.
https://domain name/demoptout.jpg?d_cid=123%01987...
https://domain name/demoptout?d_cid_ic=456%01321...
d_cid
및 d_cid_ic
키-값 쌍입니다.https://domain name/demoptout?d_cid=123%01987&d_cid_ic=456%01321...
옵트아웃 DPID, DPUUID, 및 UUID (사용하지 않음)
이러한 메서드는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다. 이 정보는 레거시 목적 및 참조를 위해 제공됩니다. 레거시 옵트아웃에는 다음이 포함됩니다.
d_uuid
https://domain/demoptout.jpg?d_uuid=AAM ID
https://demoptout.jpg?d_dpuuid= user ID&d_dpid= data provider ID
파트너 수준 옵트아웃은 이 의 최신 매핑을 위해 저장됩니다. dpid
+ dpuuid
AAM UUID에 연결 이전에 존재하는 매핑이 없는 경우 Audience Manager은 요청에 쿠키에 AAM UUID가 포함되어 있는지 확인하고 포함되어 있으면 를 사용하여 옵트아웃을 저장합니다. 그렇지 않으면 Audience Manager은 새 AAM UUID를 생성하고 그 아래에 옵트아웃을 저장합니다.
d_dpuuid
+ d_dpid
및 명시적 d_uuid
https://domain/demoptout.jpg?d_uuid= user ID&d_dpuuid= data provider's user ID&d_dpid=data provider ID
d_uuid
항상 우선입니다. 다음과 같은 경우 dpid
+ dpuuid
조합이 다른 AAM UUID에 매핑되면 옵트아웃은 요청에서 전달된 AAM UUID 아래에 저장됩니다( d_uuid
).
변수 및 구문 Declared IDs variables-and-syntax
다음 표에는 를 전달하는 키-값 쌍이 나와 있습니다 Audience Manager 데이터 공급자 ID 및 사용자 ID 또는 통합 코드(사용되는 경우). 참고, 기울임체 변수 자리 표시자를 나타냅니다. 읽기 쉽도록 공백이 추가되었습니다.
각 키-값 쌍에서:
- 다음
=
기호는 키를 관련 값에서 분리합니다. - 인쇄되지 않는 ASCII 문자
%01
는 값을 구분합니다.
d_cid =data provider ID %01user ID
d_cid
바꾸기 d_dpid
및 d_dpuuid
: 더 이상 사용되지 않는 것으로 간주되지만 계속 지원됩니다. CID가 DPID 및 DPUUID 대체를 참조하십시오 .d_cid_ic =integration code %01user ID
d_cid_ic
바꾸기 d_dpid
및 d_dpuuid
: 더 이상 사용되지 않지만 계속 지원됩니다. CID가 DPID 및 DPUUID 대체를 참조하십시오 .샘플 이벤트 호출 sample-event-calls
이러한 키-값 쌍과 필요한 구문이 주어지면 아래와 같이 이벤트를 호출하게 됩니다.
https://domain name/event?d_cid=123%01987...
https://domain name/event?d_cid_ic=456%01321...
d_cid
및 d_cid_ic
키-값 쌍입니다.https://domain name/event?d_cid=123%01987&d_cid_ic=456%01321...
Declared ID 변수 declared-id-variables
전달에 사용되는 구성 변수를 설명합니다. declared IDs 에서 DIL 끝 Audience Manager.
DIL 를 사용합니다. Adobe Experience Platform Identity Service 전달 Declared IDs dil-id-service-pass-declared-ids
와 함께 사용할 경우 Adobe Experience Platform ID 서비스, 더 이상 전달할 필요가 없습니다. declared IDs 더 이상 사용되지 않는 dpid
및 dpuuid
변수를 채우는 방법에 따라 페이지를 순서대로 표시합니다. 대신 의 현재 버전은 DIL 다음에 의존 visitorService
함수 가져오기 declared IDs 다음에서 setCustomerIDs
의 함수 Adobe Experience Platform Identity Service. 자세한 내용은 고객 ID 및 인증 상태. 다음을 호출할 수 있습니다. visitorService
위치: DIL.create
아래와 같이 표시됩니다.
var vDil = DIL.create({
partner:"partner name",
visitorService:{
namespace:"INSERT-MCORG-ID-HERE"
}
});
다음에서 namespace
키-값 쌍, MCORG
본인 Experience Cloud 조직 ID. 이 ID가 없으면 Administration 의 섹션 Experience Cloud 대시보드입니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. 다음을 참조하십시오 관리: 핵심 서비스.
더 이상 사용되지 않는 함수 deprecated-functions
최신 버전의 DIL (6.2+), 이러한 키-값 쌍을 사용하여 전달할 필요가 없습니다 declared IDs. 그 이유는 DIL 은(는) 이제 visitorService
위의 코드 샘플에 표시된 함수입니다. 이 함수는 declared IDs 다음에서 Adobe Experience Platform Identity Service. 하지만 여기에서는 이러한 변수를 기록 및 레거시 목적으로 참조하고 있습니다. 구성 방법에 대한 예는 아래 코드를 참조하십시오 DIL.create
을(를) 받으려면 declared ID 다음에서 Visitor ID Service.
다음 표에서는 declaredId
개체:
dpid
dpuuid
DPID 및 DPUUID
Audience Manager 결합된 를 비교하고 일치시킵니다. DPID
및 DPUUID
을 입력합니다. ID가 없는 경우 Audience Manager 새 사용자 ID를 만들어 와 동기화합니다. DPID/DPUUID
결합. 한 번 Audience Manager 사용자 ID(와 일치하거나 사용자 ID를 만듭니다. UUID
)에서 해당 ID를 반환합니다 JSON 에 대한 응답 cookie 클라이언트의 도메인(자사) cookie) 또는 다른 로컬 저장소입니다.
을(를) 사용할 때 이 함수 호출 DIL v6.1 이하 그러나 이 함수는 다음과 같은 새 버전을 위해 더 이상 사용되지 않습니다. declared IDs 다음에서 Adobe Experience Platform Identity Service.
DIL.create({
partner : "partner name",
declaredId : {
dpuuid : dpuuid,
DPID : dpid
}
});
d_dpuuid
및 d_dpid
키.다음 시간 후에 ID 전달 DIL 인스턴스화
declaredID
조합, 새 조합은 해당 호출에만 사용됩니다. 이후 일반 이벤트 호출에서는 원본을 사용합니다. DIL.create
declaredID
결합.DIL.getDil('partner name').api.signals({...}).declaredId({
dpuuid : dpuuid
dpid : dpid
}).submit();
요청/응답 예 request-response-examples
이 요청은에 데이터 공급자와 사용자 ID를 보냅니다. Audience Manager:
https://my_domain.net/event?d_rtbd=json&d_cb=myCallback&key=val&d_dpuuid=1234&d_dpid=5678
응답은 Audience Manager ID를 반환합니다(예: UUID
): 페이지 도메인의 자사 쿠키에 작성됩니다.
myCallback({
...
"uuid":"abc123"
})
Target 및 옵트아웃 호출 안 함 do-not-target
다음 declared ID 에서 옵트아웃하도록 사이트 방문자 환경 설정 적용 Audience Manager 웹 사이트별 타기팅. 날짜 Audience Manager 옵트아웃 요청을 수신합니다. DCS 빈 을 반환합니다. JSON 개체 대신 Audience Manager 사용자 ID.