Declared IDs

declared IDs의 작동 방식, 설정 절차, 코드 예제 및 변수.

Declared ID 타겟 지정

타사 cookies 같은 지속적인 스토리지 메커니즘을 사용하거나 수락하지 않는 디바이스 또는 브라우저에서 사용자 ID를 Audience Manager과 교환하고 동기화합니다.

Declared ID 타깃팅 목적

일부 브라우저와 대부분의 모바일 장치는 타사 cookies을(를) 수락하지 않습니다. 따라서 사이트 방문자에 대한 정보를 유지하거나 영구 ID를 할당하기가 어렵습니다. 이 문제를 해결하려면 Audience Manager은 DIL을(를) 사용하여 이벤트 호출에서 declared IDs을(를) 전달할 수 있습니다. 또한 declared ID은 Experience Cloud의 모든 솔루션에서 동일한 사용자에게 적용되는 범용 ID로 작동할 수 있습니다. 다음 표에서는 ID 타깃팅/일치 프로세스에 대해 설명합니다.

시작하려면 데이터 수집에 사용할 사이트의 페이지에 Experience Cloud ID 서비스와 DIL을 구성해야 합니다. DIL 만들기 및 선언된 ID 변수를 참조하십시오.

옵트아웃 호출

declared ID 프로세스에서는 웹 사이트에서 타깃팅한 Audience Manager을(를) 옵트아웃하기 위해 사이트 방문자 기본 설정을 적용합니다. Audience Manager이(가) 옵트아웃 요청을 받으면 DCS에서 반환되는 JSON에 Audience Manager 사용자 ID 대신 Encountered opt out tag 메시지와 함께 오류 코드 171이 포함됩니다.

• Audience Manager 옵트아웃이 declared ID 옵트아웃에 Audience Manager UUID 들어갈 수 URL있습니다.
• declared ID 옵트아웃은 Profile Cache Server (PCS)에 파트너별로 저장됩니다. declared IDs을(를) 사용하는 플랫폼 수준 옵트아웃이 없습니다. 또한 Audience Manager은 사용자를 가장자리 상의 특정 지역에서 옵트아웃합니다(옵트아웃은 DCS 영역을 교차하지 않음).

데이터 수집 제외에 대한 자세한 내용은 데이터 개인 정보를 참조하십시오.

Declared ID 옵트아웃 예

d_cid 및 d_cid_ic 키-값 쌍으로 [!UICONTROL declared ID] 옵트아웃 요청을 만들 수 있습니다. d_dpid 및 d_dpuuid와 같은 기존 매개 변수는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다. CID가 DPID 및 DPUUID 대체를 참조하십시오. 예에서 기울임꼴​은 가변 자리 표시자를 나타냅니다.

CID 및 CID_IC 포함 옵트아웃

설명 및 구문이 필요하면 선언된 ID에 대한 URL 변수 및 구문을 참조하십시오.

DPID, DPUUID 및 UUID 포함 옵트아웃(더 이상 사용되지 않음)

이러한 메서드는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다. 이 정보는 이전 목적 및 참조 자료로 제공됩니다. 기존 옵트아웃에는 다음이 포함됩니다.

Declared IDs의 변수 및 구문

다음 표에는 Audience Manager 데이터 공급자 ID 및 사용자 ID 또는 통합 코드를 전달하는 키-값 쌍(사용되는 경우)이 나와 있습니다. 참고: 기울임체​는 변수 자리 표시자를 나타냅니다. 이렇게 쉽게 읽을 수 있도록 공백이 추가되었습니다.

각 키-값 쌍에서:

• = 기호는 키와 관련 값을 구분합니다.
• 인쇄되지 않는 ASCII 문자 %01는 값을 구분합니다.

샘플 이벤트 호출

이러한 키-값 쌍 및 필수 구문이 주어지면 아래와 같이 이벤트를 호출합니다.

Declared ID 변수

declared IDs - DIL을(를) Audience Manager.에 전달하는 데 사용되는 구성 변수에 대해 설명합니다.

DIL 를 Adobe Experience Platform Identity Service 사용하여 Declared IDs

Adobe Experience Platform ID 서비스와 함께 사용할 때 더 이상 더 이상 declared IDs에 더 이상 사용되지 않는 dpid 및 dpuuid 변수와 함께 전달하지 않아도 됩니다. 대신, DIL의 현재 버전은 visitorService 함수에 의존하여 Adobe Experience Platform Identity Service의 setCustomerIDs 함수에서 declared IDs를 가져옵니다. 자세한 내용은 고객 ID 및 인증 상태를 참조하십시오. 아래와 같이 DIL.create에서 visitorService을(를) 호출합니다.

var vDil = DIL.create({
  partner:"partner name",
  visitorService:{
    namespace:"INSERT-MCORG-ID-HERE"
  }
});

namespace 키-값 쌍에서 MCORG은 Experience Cloud 조직 ID입니다. 이 ID가 없는 경우 Experience Cloud 대시보드의 Administration 섹션에서 찾을 수 있습니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. 관리 참조:핵심 서비스.

사용되지 않는 함수

최신 버전의 DIL (6.2+)에서는 이러한 키-값 쌍을 사용하여 declared IDs에 전달할 필요가 없습니다. 이는 이제 DIL이(가) 위의 코드 샘플에 표시된 visitorService 함수에 의존하기 때문입니다. 이 함수는 Adobe Experience Platform Identity Service에서 declared IDs을 가져옵니다. 하지만 이전 및 이전 목적을 위해 이 변수를 여기에서 참조합니다. declared ID에서 DIL.create을(를) 받으려면 아래 코드를 참조하십시오.
Visitor ID Service
다음 표에서는 declaredId 개체에서 사용하는 기존 변수에 대해 설명합니다.

DPID 및 DPUUID

Audience Manager 시스템의 해당 사용자 ID DPID 와 조합된 DPUUID ID를 비교하여 일치시킵니다. ID가 없는 경우 Audience Manager은 새 사용자 ID를 만들고 이를 DPID/DPUUID 조합에 동기화합니다. Audience Manager이 사용자 ID와 일치하거나 사용자 ID(UUID)를 만들면 클라이언트 도메인(퍼스트 파티 cookie)의 cookie 응답에서 해당 ID가 반환됩니다.JSON

DIL v6.1 또는 이전 버전을 사용하는 경우 이 함수를 호출합니다. 그러나 이 함수는 Adobe Experience Platform Identity Service에서 declared IDs을 가져오는 새 버전 대신 사용되지 않습니다.

DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

인스턴스화 후 ID 전달DIL

DIL.getDil('partner name').api.signals({...}).declaredId({
  dpuuid : dpuuid
  dpid : dpid
}).submit();

요청/응답 예

요청은 데이터 공급자 및 사용자 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 및 옵트아웃 호출 안 함

declared ID 프로세스에서는 웹 사이트에서 타깃팅한 Audience Manager을(를) 옵트아웃하기 위해 사이트 방문자 기본 설정을 적용합니다. Audience Manager이(가) 옵트아웃 요청을 받으면 DCS은 Audience Manager 사용자 ID 대신 빈 JSON 개체를 반환합니다.