Show Menu
화제×

Declared IDs

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

Declared ID 타겟 지정

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

타깃팅 Declared ID 목적

일부 브라우저 및 대부분의 모바일 장치에서는 타사 브라우저가 허용되지 않습니다 cookies. 따라서 사이트 방문자에 대한 정보를 유지하거나 영구 ID를 할당하기가 어렵습니다. 이 문제를 해결하려면 이벤트 호출 Audience Manager 에 DIL 합격할 수 있도록 declared IDs 사용합니다. 또한, a는 의 모든 솔루션에서 동일한 사용자에게 적용되는 범용 ID로 작동할 declared ID 수 Experience Cloud있습니다. 다음 표에서는 ID 타깃팅/일치 프로세스에 대해 설명합니다.
프로세스 설명
이벤트 호출
이 작업을 수행하려면 페이지에 DIL Adobe Experience Platform ID 서비스 코드가 있어야 합니다. DIL은 Adobe Experience Platform ID 서비스 가 제공하는 기능에서 Audience Manager에 대한 setVisitorID 전달되는 선언된 ID를 가져옵니다.
일치 ID
Audience Manager은 클라이언트 및 방문자 ID와 시스템의 해당 ID를 일치시킵니다. 일치하는 ID가 없는 경우 Audience Manager은 새 ID를 만들어 클라이언트 및 방문자 ID와 연결합니다.
참고: 가장 최근 매핑은 ID가 두 개 이상의 Audience Manager ID에 매핑되는 경우에 사용됩니다.
반환 ID
Audience Manager은 동기화된 ID를 클라이언트 도메인 또는 애플리케이션의 퍼스트 파티 쿠키(또는 기타 주소 지정 가능 저장소 공간)에 기록합니다.
후속 이벤트 호출
추가 이벤트 호출은 클라이언트의 도메인에서 Audience Manager ID를 읽은 후 Audience Manager으로 전송합니다.
시작하려면 데이터 수집에 사용할 사이트 Experience Cloud DIL 의 페이지와 ID 서비스를 구성해야 합니다. DIL 생성 선언된 ID 변수를 참조하십시오 .

옵트아웃 통화

이 declared ID 프로세스는 웹 사이트별 타깃팅 Audience Manager 을 옵트아웃하기 위해 사이트 방문자 기본 설정을 적용합니다. 옵트아웃 요청을 Audience Manager 받은 경우, 이 JSON 에서 반환되는 오류 코드 171에 사용자 ID 대신 메시지 DCS 가 포함된 오류 코드가 Encountered opt out tag Audience Manager 포함됩니다.
  • Audience Manager 옵트아웃이 declared ID 옵트아웃으로 Audience Manager 들어올 수 UUID URL있습니다.
  • 옵트아웃은 declared ID 파트너별로 프로필 캐시 서버(PCS)에 저장됩니다. 사용하는 플랫폼 수준 옵트아웃은 없습니다 declared IDs. 또한, Audience Manager 사용자를 가장자리에서 특정 영역에서 옵트아웃합니다(옵트아웃은 [DCS 지역을 넘지 않음).
데이터 수집 제외에 대한 자세한 내용은 데이터 개인 정보를 참조하십시오.

Declared ID 옵트아웃 예

You can make a declared ID opt-out requests with the d_cid and d_cid_ic key-value pairs. d_dpid d_dpuuid 와 같은 기존 매개 변수는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다. CID가 DPID 및 DPUUID 대체 를 참조하십시오. 예에서 기울임꼴 ​은 가변 자리 표시자를 나타냅니다.

및 CID CID_IC

설명 및 구문이 필요하면 선언된 ID에 대한 URL 변수 및 구문 을 참조하십시오.
옵트아웃에 사용하는 값 코드 샘플
데이터 공급자 ID 및 사용자 ID.
https:// domain name /demoptout.jpg?d_cid=123%01987...
통합 코드 및 사용자 ID.
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 + 쌍의 최신 매핑을 AAM UUID에 dpuuid 위해 저장됩니다. 이전에 기존 매핑이 없는 경우 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 조합이 다른 AAM UUID에 매핑되면 옵트아웃은 요청에서 전달된 AAM UUID 아래에 저장됩니다( dpuuid d_uuid ).

변수 및 구문 Declared IDs

다음 표에는 데이터 공급자 ID와 사용자 ID 또는 통합 코드를 전달하는 키-값 쌍(사용되는 경우)이 나와 있습니다. Audience Manager Note, italics indicates a variable placeholder. 이렇게 쉽게 읽을 수 있도록 공백이 추가되었습니다.
각 키-값 쌍에서:
  • 심볼은 키와 관련 값을 구분합니다. =
  • 인쇄되지 않는 ASCII 문자는 값을 %01 구분합니다.
변수 설명
d_cid = data provider ID %01 user ID
하나의 키-값 쌍에 데이터 공급자 ID와 연결된 고유 사용자 ID가 들어 있습니다. d_cid 교체 d_dpid d_dpuuid 를 참조하십시오. CID가 DPID 및 DPUUID 대체 를 참조하십시오 .
d_cid_ic = integration code %01 user ID
단일 키-값 쌍에 통합 코드와 관련 고유 사용자 ID가 들어 있습니다. d_cid_ic 교체 d_dpid d_dpuuid 더 이상 사용되지 않지만 여전히 지원됩니다. CID가 DPID 및 DPUUID 대체 를 참조하십시오 .

샘플 이벤트 호출

이러한 키-값 쌍 및 필수 구문이 주어지면 아래와 같이 이벤트를 호출합니다.
이벤트 호출 포함 코드 샘플
데이터 공급자 ID 및 사용자 ID.
https:// domain name /event?d_cid=123%01987...
통합 코드 및 사용자 ID.
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 IDs 를 DIL 설명합니다. Audience Manager.

DIL 에서 Adobe Experience Platform Identity Service 로 Declared IDs

Adobe Experience Platform ID 서비스 와 함께 사용할 때 더 이상 사용되지 않는 declared IDs 변수와 dpid 함께 전달하지 않아도 dpuuid 됩니다. 대신, 현재 버전의 Flash Player는 DIL 함수 visitorService 에서 Flash Player declared IDs 를 가져오는 기능을 setCustomerIDs Adobe Experience Platform Identity Service사용합니다. For more information, see Customer IDs and Authentication States . 아래 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 에서 찾을 수 있습니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. See Administration: Core Services .

사용되지 않는 함수

최신 버전의 DIL (6.2 이상)에서는 이러한 키-값 쌍을 사용하여 전달할 필요가 없습니다 declared IDs. 이는 DIL 이제 위의 코드 샘플에 표시된 visitorService 함수에 의존하기 때문입니다. 이 함수 declared IDs Adobe Experience Platform Identity Service는 하지만 이전 및 이전 목적을 위해 이 변수를 여기에서 참조합니다. Adobe Experience Manager Forms에서 JavaScript를 가져오는 방법 DIL.create 에 대한 예는 아래 코드 declared ID 를 참조하십시오 Visitor ID Service. 다음 표에서는 개체가 사용하는 기존 변수에 대해 declaredId 설명합니다.
이름 유형 설명
dpid 문자열
Audience Manager에서 지정한 데이터 파트너 ID.
dpuuid 문자열
사용자에 대한 데이터 제공업체의 고유한 ID입니다.

DPID 및 DPUUID

Audience Manager 시스템의 해당 사용자 ID DPID DPUUID 를 조합하여 일치시킵니다. ID가 없는 경우 새 사용자 ID를 Audience Manager 만들고 이 ID를 조합에 DPID/DPUUID 동기화합니다. 사용자 ID와 일치하거나 사용자 ID를 만들면( Audience Manager ) 클라이언트의 도메인(퍼스트 파티) 또는 기타 로컬 저장소 UUID 에 있는 JSON 응답에서 해당 ID를 반환합니다 cookie cookie.
v6.1 이전 버전을 사용하는 경우 이 함수를 DIL 호출합니다. 그러나 이 함수는 더 이상 사용되지 않으며 대신 URL에서 가져오는 새 버전 declared IDs 을 사용합니다 Adobe Experience Platform Identity Service.
DIL.create({
    partner : "partner name",
    declaredId : {
       dpuuid : dpuuid,
       DPID : dpid
    }
 });

키와 키의 ID 값을 제공하는 코드를 프로그래밍 방식으로 개발해야 d_dpuuid 합니다 d_dpid .

인스턴스화한 후 ID DIL 전달

다른 조합으로 API 호출을 하는 경우 새로운 declaredID 조합이 해당 호출에 대해서만 사용됩니다. 추가적인 일반 이벤트 호출에서는 원래 DIL.create 조합을 declaredID 사용합니다.
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 사용자 ID 대신 빈 DCS 개체를 JSON Audience Manager 반환합니다.