DCS API 호출에 지원되는 특성 supported-attributes-for-dcs-api-calls

Data Collection Servers (DCS)에 전달할 수 있는 구문 및 지원되는 특성(또는 키-값 쌍)을 나열하고 설명합니다. 이 정보는 DCS 요청의 형식을 지정하고 이 시스템에서 반환된 매개 변수를 이해하는 데 도움이 됩니다.

속성 접두사 attribute-prefixes

DCS은(는) 키-값 쌍의 키에 추가된 특정 접두사를 사용하여 전달하는 데이터의 유형을 분류합니다.

키 접두사
예약 대상
c_
고객 정의 속성.
d_
Audience Manager 특성입니다.
h_
HTTP 헤더 데이터.
p_

비공개, 고객 정의 속성.

키에 p_ 접두사가 있으면 DCS가 사용자의 개인 데이터를 허용합니다. 개인 데이터는 트레이트 평가에 사용되지만 시스템에 기록되거나 저장되지 않습니다. 예를 들어 트레이트가 customers = p_age<25(으)로 정의되어 있고 이벤트 호출에서 p_age=23을(를) 전달한다고 가정해 보겠습니다. 이러한 조건이 주어지면 연령 기반 자격 기준을 충족하는 Audience Manager은 트레이트를 받을 수 있지만, 키-값 쌍은 요청을 받은 후에 삭제되고 기록되지 않습니다.

d_ 특성 d-attributes

DCS의 응답을 원하지 않는 한 이 모든 옵션은 선택 사항입니다. DCS이(가) 응답을 반환하도록 하려면 d_rtbd=json이(가) 필요합니다.

특성
설명
d_caller
DCS API를 호출하는 호출자를 식별하는 데 사용됩니다.
d_cb
DCS 응답을 콜백 함수의 함수 매개 변수로 사용하여 실행할 JavaScript 함수를 지정합니다.
d_cid

Audience Manager이(가) 할당한 데이터 공급자 ID( DPID)와 데이터 공급자 사용자 ID( DPUUID) 쌍을 하나 이상 포함합니다. DPID과(와) DPUUID의 쌍을 여러 개 사용하는 경우 인쇄되지 않는 문자 %01을(를) 사용하여 각 쌍을 구분하십시오. 예: DPID%01DPUUUID.

d_cid 은(는) 더 이상 사용되지 않지만 계속 지원되는 d_dpidd_dpuuid을(를) 대체합니다. CID가 DPID 및 DPUUID을(를) 대체합니다.

d_cid_ic

단일 키-값 쌍에 통합 코드 및 관련 고유 사용자 ID를 포함합니다.

d_cid_ic 은(는) 더 이상 사용되지 않지만 계속 지원되는 d_dpidd_dpuuid을(를) 대체합니다. CID가 DPID 및 DPUUID을(를) 대체합니다.

d_coppa
하위 보호 규정을 준수하기 위해 서드파티 쿠키 사용을 비활성화합니다. 이 매개 변수는 Adobe Adobe Experience Platform Identity 서비스에 의해 동적으로 설정되며 idSyncDisable3rdPartySyncing 구성에 따라 다릅니다. Adobe Experience Platform ID 서비스에서 COPPA 지원을 참조하십시오.

d_cts=1

d_cts=2

선택 사항. 고객 요청에 대해 활성화됩니다. Adobe Audience Manager 컨설턴트나 고객 지원에 문의하십시오.

JSON 응답 내에서 트레이트 및 세그먼트를 반환해야 함을 나타냅니다.

  • d_cts=1 세그먼트에 대한 개의 기존 세그먼트 ID을(를) 반환합니다.

  • d_cts=2 세그먼트에 대한 세그먼트 ID를 반환합니다.

샘플 응답은 아래 응답과 비슷합니다.

{     "stuff": [],     "uuid": "07955261652886032950143702505894272138",     "dcs_region": 7,     "traits": [420020, 5421506],     "segments": [984263, 985264],     "tid": "ss3OTqPiQp0=" }

d_dpid
삭제 예정. d_cidd_cid_ic을(를) 참조하십시오.
d_dpuuid
삭제 예정. d_cidd_cid_ic을(를) 참조하십시오.
d_dst=1
JSON 응답에서 URL 대상 데이터를 반환합니다.
d_dst_filter

d_dst_filter 는 Adobe Analytics과 Audience Manager 간의 통합에 사용되는 예약된 속성입니다.

예약된 속성을 사용하는 트레이트는 만들지 않는 것이 좋습니다. Adobe은 언제든지 예약된 속성을 변경할 수 있습니다.

d_jsonv=1|0
응답에 사용할 JSON 버전을 나타냅니다. 일반적으로 이를 d_jsonv=1(으)로 설정해야 합니다. d_jsonv=0을(를) 설정하면 ID 동기화가 비활성화됩니다.
d_mid
Experience Cloud ID 서비스에서 사용되고 있는 Experience Cloud ID 집합을 지정합니다. ECID에 대한 자세한 내용은 쿠키 및 Experience Cloud ID 서비스를 참조하십시오.
d_nsid
이름 공간 ID. 사용되는 JavaScript 컨테이너를 나타냅니다. ID 동기화를 위해 DIL에서 사용됩니다.
d_ptfm

Audience Manager이 모바일 요청을 데스크탑 요청과 구분할 수 있도록 합니다. 지원되는 값은 다음과 같습니다.

  • ios
  • android
  • browser
  • all
d_rs

삭제 예정. d_rs은(는) Adobe Analytics과(와) Audience Manager 간의 레거시 통합에서 사용되는 예약된 특성입니다.

예약된 속성을 사용하는 트레이트는 만들지 않는 것이 좋습니다. Adobe은 언제든지 예약된 속성을 변경할 수 있습니다.

d_rtbd=json

DCS의 JSON 응답을 원하는 경우 필요합니다.

  • 이를 생략하면 DCS이(가) 헤더의 픽셀을 반환합니다.
  • 이 항목을 포함하면 DCS이(가) 응답 본문에 JSON 개체를 반환합니다. 아래 예를 참조하십시오. 응답이 더 복잡할 수 있습니다.

{     "stuff": [],     "uuid": "22920112968019678612904394744954398990",     "dcs_region": 7,     "tid": "ss3OTqPiQp0=" }

d_sid
SID 은(는) 점수 ID을(를) 나타냅니다. 트레이트 또는 세그먼트에 대한 고유 ID입니다.
d_tdpid

트레이트 평가를 위해 데이터 소스를 전달합니다. 이 데이터 소스의 트레이트만 평가됩니다.

예를 들어 다음과 같은 항목이 있다고 가정합니다.

  • 다음을 포함한 트레이트 T1:
  • 트레이트 규칙: " key1 == val1"
  • 데이터 Source( DPID): 1
  • DPID 통합 코드: ic1
  • 다음을 포함한 트레이트 T2:
  • 트레이트 규칙: " key2 == val2"
  • 데이터 Source(DPID): 2
  • DPID 통합 코드: ic2

샘플 호출 yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid=1에서는 특성 T1만 반환됩니다.

d_tdpid_ic

목적은 위에서 설명한 d_tdpid 매개 변수와 동일합니다. 그러나 이 경우 통합 코드를 사용하여 데이터 소스가 전달됩니다.

위에서 설명한 트레이트를 유지하려면 샘플 호출을 고려하십시오.

yourcompany.demdex.net/event?key1=val1&key2=val2&d_tdpid_ic=ic2의 경우 트레이트 T2만 반환됩니다.

d_uuid
고유 사용자 ID. 쿠키에서 이 값을 사용할 수 없는 경우 방문자를 식별합니다.

h_ 속성

이러한 헤더에는 HTTP 호출의 데이터 및 응답에 대한 요청과 같은 정보가 포함되어 있습니다.

특성
설명
h_host
클라이언트의 특정 데이터 수집 호스트 이름으로 설정됩니다. host name .demdex.net(으)로 표시됩니다. Demdex 도메인에 대한 호출 이해를 참조하십시오.
h_user-agent
User-Agent 헤더 값으로 설정합니다.
h_accept-language
Accept-Language 헤더 값으로 설정합니다.
h_referer
Referer 헤더 값으로 설정합니다.
h_referrer
Referrer 헤더 값으로 설정합니다.
h_date
Date 헤더 값으로 설정합니다.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695