설명서 Audience Manager Audience Manager 사용 안내서

Declared IDs

2025년 5월 5일

주제:

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

Declared ID 타겟 지정

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

Declared ID 타깃팅의 목적

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

프로세스	설명
이벤트 호출	작업을 수행하려면 페이지에 DIL 과(와) Adobe Experience Platform Identity 서비스코드가 필요합니다. DIL 은(는) Adobe Experience Platform Identity 서비스 에서 제공하는 `setVisitorID` 함수에서 개의 선언된 ID 을(를) 가져와서 Audience Manager 에 전달합니다.
일치 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 ID 서비스와 DIL을(를) 구성해야 합니다. DIL 만들기 및 선언된 ID 변수를 참조하십시오.

옵트아웃 호출

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

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

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

Declared ID 옵트아웃 예

d_cid 및 d_cid_ic 키-값 쌍으로 declared ID 옵트아웃을 요청할 수 있습니다. 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

파트너 수준 옵트아웃

옵트아웃(더 이상 사용되지 않음)	코드 샘플
`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에 매핑되는 경우 옵트아웃은 요청( `d_uuid` )에서 전달된 AAM UUID 아래에 저장됩니다.

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에 매핑되는 경우 옵트아웃은 요청( d_uuid )에서 전달된 AAM UUID 아래에 저장됩니다.

Declared IDs에 대한 변수 및 구문

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

각 키-값 쌍에서:

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

변수

설명

d_cid =data provider ID %01user ID

단일 키-값 쌍에 데이터 공급자 ID와 관련 고유 사용자 ID를 포함합니다. d_cid 은(는) 더 이상 사용되지 않는 것으로 간주되지만 여전히 지원되는 d_dpid 및 d_dpuuid 을(를) 대체합니다. CID Replaces DPID 및 DPUUID을(를) 참조하십시오.

d_cid_ic =integration code %01user ID

단일 키-값 쌍에 통합 코드 및 관련 고유 사용자 ID를 포함합니다. d_cid_ic 은(는) 더 이상 사용되지 않지만 여전히 지원되는 d_dpid 및 d_dpuuid 을(를) 대체합니다. CID Replaces 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 변수

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

DIL이(가) Adobe Experience Platform Identity Service을(를) 사용하여 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 섹션에서 찾을 수 있습니다. 이 대시보드를 보려면 관리자 권한이 필요합니다. Experience Cloud 서비스 시작을 참조하세요.

더 이상 사용되지 않는 함수

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

이름

유형

설명

dpid

문자열

Audience Manager에서 할당한 데이터 파트너 ID.

dpuuid

문자열

사용자에 대한 데이터 제공업체의 고유한 ID입니다.

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

NOTE

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

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

NOTE

다른 declaredID 조합으로 API 호출을 수행하면 해당 호출에만 새 조합이 사용됩니다. 이후 일반 이벤트 호출에서는 원래 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"
})

타겟 및 옵트아웃 호출 안 함

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

recommendation-more-help