Declared IDs declared-ids

declared IDs의 작동 방식, 프로시저, 코드 예제 및 변수를 설정합니다.

Declared ID 타겟 지정 declared-id-targeting

타사 cookies과(와) 같이 영구 저장소 메커니즘을 사용하거나 허용하지 않는 장치 또는 브라우저에서 사용자 ID를 Audience Manager과(와) 교환하고 동기화합니다.

Declared ID 타깃팅의 목적 declared-id-targeting-purpose

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

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

옵트아웃 호출 opt-out-calls

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

데이터 수집 옵트아웃에 대한 자세한 내용은 데이터 개인 정보을 참조하세요.

Declared ID 옵트아웃 예 opt-out-examples

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

CID 및 CID_IC (으)로 옵트아웃

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

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

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

Declared IDs에 대한 변수 및 구문 variables-and-syntax

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

각 키-값 쌍에서:

샘플 이벤트 호출 sample-event-calls

이러한 키-값 쌍과 필요한 구문이 주어지면 아래와 같이 이벤트를 호출하게 됩니다.

Declared ID 변수 declared-id-variables

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

DIL이(가) Adobe Experience Platform Identity Service을(를) 사용하여 Declared IDs을(를) 전달합니다. dil-id-service-pass-declared-ids

Adobe Experience Platform ID 서비스와 함께 사용하는 경우 더 이상 사용되지 않는 dpid 및 dpuuid 변수를 사용하여 declared IDs을(를) 전달할 필요가 없습니다. 대신 현재 버전의 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 섹션에서 찾을 수 있습니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. 관리: 핵심 서비스를 참조하십시오.

더 이상 사용되지 않는 함수 deprecated-functions

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

DPID 및 DPUUID

Audience Manager은(는) 결합된 DPID과(와) DPUUID을(를) 비교하여 시스템의 해당 사용자 ID와 일치시킵니다. ID가 없으면 Audience Manager에서 새 사용자 ID를 만들어 DPID/DPUUID 조합에 동기화합니다. Audience Manager이(가) 사용자 ID(UUID)와 일치하거나 만들면 클라이언트의 도메인(자사 cookie) 또는 다른 로컬 저장소에 있는 cookie에 대한 JSON 응답에서 해당 ID를 반환합니다.

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

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

DIL이(가) 인스턴스화된 후 ID 전달

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

타겟 및 옵트아웃 호출 안 함 do-not-target

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