ID 네임스페이스 구성

Experience Platform은 id 네임스페이스를 사용하여 특정 id 유형을 설명합니다. 예를 들어 이라는 ID 네임스페이스 Email 는 과 같은 값을 식별합니다. name@email.com 이메일 주소로 사용하십시오.

Destination SDK을 통해 실시간(스트리밍) 대상을 만들 때 및 파트너 스키마 구성 사용자가 프로필 속성 및 id를에 매핑할 수 있으려면 대상 플랫폼에서 지원하는 id 네임스페이스도 정의해야 합니다. 예를 들어 대상 플랫폼에서 해시된 이메일 및 IDFA, 다음과 같이 이 두 ID를 정의해야 합니다. 이 문서의 뒷부분에 설명되어 있다.

대상자를 스트리밍 대상으로 활성화할 때, 사용자는 타겟 프로필 속성 외에 타겟 ID도 매핑해야 합니다. 그렇지 않으면 대상자가 대상 플랫폼에 활성화되지 않습니다.

Destination SDK을 통해 파일 기반 대상을 만들 때 ID 네임스페이스 구성은 선택 사항입니다.

Experience Platform의 ID 네임스페이스에 대한 자세한 내용은 id 네임스페이스 설명서.

대상에 대해 ID 네임스페이스를 구성할 때 다음과 같이 대상에서 지원하는 대상 ID 매핑을 미세 조정할 수 있습니다.

  • 사용자가 XDM 속성을 ID 네임스페이스에 매핑할 수 있습니다.
  • 사용자가 매핑할 수 있도록 허용 표준 id 네임스페이스 고유한 id 네임스페이스에 대해 설명합니다.
  • 사용자가 매핑할 수 있도록 허용 사용자 정의 id 네임스페이스 고유한 id 네임스페이스에 대해 설명합니다.

이 구성 요소가 Destination SDK으로 만든 통합에 어디에 맞는지 이해하려면 의 다이어그램을 참조하십시오. 구성 옵션 설명서 또는 방법에 대한 안내서 참조 Destination SDK을 사용하여 파일 기반 대상 구성.

다음을 통해 지원되는 ID 네임스페이스를 구성할 수 있습니다. /authoring/destinations 엔드포인트. 이 페이지에 표시된 구성 요소를 구성할 수 있는 자세한 API 호출 예는 다음 API 참조 페이지를 참조하십시오.

이 문서에서는 대상에 사용할 수 있는 지원되는 모든 ID 네임스페이스 구성 옵션에 대해 설명하고 고객이 Platform UI에서 보게 되는 내용을 보여줍니다.

IMPORTANT
Destination SDK에서 지원하는 모든 매개변수 이름 및 값은 다음과 같습니다. 대소문자 구분. 대소문자 구분 오류를 방지하려면 설명서에 표시된 대로 매개 변수 이름과 값을 정확히 사용하십시오.

지원되는 통합 유형 supported-integration-types

이 페이지에 설명된 기능을 지원하는 통합 유형에 대한 자세한 내용은 아래 표를 참조하십시오.

통합 유형
기능 지원
실시간(스트리밍) 통합
예(필수)
파일 기반 (일괄 처리) 통합
예(선택 사항)

지원되는 매개 변수 supported-parameters

대상이 지원하는 타겟 ID를 정의할 때 아래 표에 설명된 매개 변수를 사용하여 해당 동작을 구성할 수 있습니다.

매개변수
유형
필수/선택적
설명
acceptsAttributes
부울
선택 사항입니다
고객이 표준 프로필 속성을 구성 중인 ID에 매핑할 수 있는지 여부를 나타냅니다.
acceptsCustomNamespaces
부울
선택 사항입니다
고객이 사용자 정의 ID 네임스페이스를 구성 중인 ID 네임스페이스에 매핑할 수 있는지 여부를 나타냅니다.
acceptedGlobalNamespaces
-
선택 사항입니다
다음 항목을 나타냅니다. 표준 id 네임스페이스 (예: IDFA) 고객은 구성 중인 id에 매핑할 수 있습니다.
transformation
문자열
선택 사항입니다
다음을 표시합니다. 변환 적용 소스 필드가 XDM 속성이나 사용자 지정 ID 네임스페이스인 경우 Platform UI의 확인란 이 옵션을 사용하여 사용자가 내보낼 때 소스 속성을 해시할 수 있도록 합니다. 이 옵션을 활성화하려면 값을 로 설정합니다. sha256(lower($)).
requiredTransformation
문자열
선택 사항입니다
고객이 이 소스 ID 네임스페이스를 선택하면 변환 적용 이 확인란은 매핑에 자동으로 적용되며 고객은 이 확인란을 비활성화할 수 없습니다. 이 옵션을 활성화하려면 값을 로 설정합니다. sha256(lower($)).
"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

다음을 나타내야 합니다. Platform id 고객은 대상으로 내보낼 수 있습니다. 몇 가지 예는 다음과 같습니다 Experience Cloud ID, 해시된 이메일, 장치 ID(IDFA, GAID). 이 값은 다음과 같습니다 Platform 고객이 대상에서 id 네임스페이스에 매핑할 수 있는 id 네임스페이스.

ID 네임스페이스는 다음 사이에 1:1 대응이 필요하지 않습니다. Platform 목적지도요
예를 들어 고객은 를 매핑할 수 있습니다. Platform IDFA 네임스페이스를 다음에 추가 IDFA 대상에서 네임스페이스를 매핑하거나 동일한 네임스페이스를 Platform IDFA 네임스페이스 대상 Customer ID 네임스페이스를 대상에 추가합니다.

에서 ID에 대해 자세히 알아보기 id 네임스페이스 개요.

매핑 고려 사항

고객이 소스 ID 네임스페이스를 선택하고 대상 매핑을 선택하지 않으면 Platform은 자동으로 대상 매핑을 동일한 이름의 속성으로 채웁니다.

선택적 소스 필드 해시 구성

Experience Platform 고객은 데이터를 해시된 형식 또는 일반 텍스트로 Platform에 수집하도록 선택할 수 있습니다. 대상 플랫폼에서 해시된 데이터와 해시되지 않은 데이터를 모두 허용하는 경우 고객에게 대상으로 내보낼 때 소스 필드 값을 Platform에서 해시할지 여부를 선택하는 옵션을 제공할 수 있습니다.

아래 구성은 옵션을 활성화합니다. 변환 적용 매핑 단계의 Platform UI 옵션입니다.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

해시되지 않은 소스 필드를 사용할 때 이 옵션을 선택하면 Adobe Experience Platform에서 활성화 시 해당 필드를 자동으로 해시할 수 있습니다.

해시되지 않은 소스 속성을 대상이 해시할 것으로 예상하는 타겟 속성에 매핑할 때(예: email_lc_sha256 또는 phone_sha256), 다음을 확인합니다. 변환 적용 활성화 시 Adobe Experience Platform이 소스 속성을 자동으로 해시하도록 하는 옵션입니다.

필수 소스 필드 해시 구성

대상에서 해시된 데이터만 허용하는 경우 내보낸 속성을 Platform에서 자동으로 해시하도록 구성할 수 있습니다. 아래 구성은 변환 적용 옵션 EmailPhone id가 매핑됩니다.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

다음 단계 next-steps

이 문서를 읽은 후에는 Destination SDK으로 빌드된 대상에 대해 ID 네임스페이스를 구성하는 방법을 더 잘 이해할 수 있어야 합니다.

다른 대상 구성 요소에 대한 자세한 내용은 다음 문서를 참조하십시오.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6