대상 구성

개요

이 구성을 사용하면 대상 이름, 카테고리, 설명 등과 같은 필수 정보를 표시할 수 있습니다. 또한 이 구성의 설정은 Experience Platform 사용자가 대상을 인증하는 방법, Experience Platform 사용자 인터페이스에 표시되는 방법 및 대상으로 내보낼 수 있는 ID를 결정합니다.

또한 이 구성에서는 대상이 작동하는 데 필요한 다른 구성(대상 서버 및 대상 메타데이터)도 이 구성에 연결합니다. 에서 두 구성을 참조할 수 있는 방법을 읽어 보십시오 아래의 섹션.

이 문서에 설명된 기능을 /authoring/destinations API 엔드포인트. 읽기 대상 API 끝점 작업 전체 작업 목록을 보려면 종단점에서 수행할 수 있습니다.

예제 구성

아래는 가공의 대상인 무비테르의 구성 예입니다. 무비스타르는 전세계적으로 4개 지역에 종단점이 있습니다. 대상은 모바일 대상 카테고리에 속합니다. 아래 섹션에서는 이 구성을 구성하는 방법을 자세히 설명합니다.

{
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointsInstance",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"http://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
               
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   },
   "schemaConfig":{
      "profileRequired":false,
      "segmentRequired":true,
      "identityRequired":true
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "aggregation":{
      "aggregationType":"CONFIGURABLE_AGGREGATION",
      "configurableAggregation":{
         "splitUserById":true,
         "maxBatchAgeInSecs":0,
         "maxNumEventsInBatch":0,
         "aggregationKey":{
            "includeSegmentId":true,
            "includeSegmentStatus":true,
            "includeIdentity":true,
            "oneIdentityPerGroup":false,
            "groups":[
               {
                  "namespaces":[
                     "IDFA",
                     "GAID"
                  ]
               },
               {
                  "namespaces":[
                     "EMAIL"
                  ]
               }
            ]
         }
      }
   },
   "backfillHistoricalProfileData":true
}
매개 변수 유형 설명
name 문자열 Experience Platform 카탈로그에서 대상의 제목을 나타냅니다.
description 문자열 Experience Platform 대상 카탈로그에서 대상 카드에 대한 설명을 제공합니다. 4-5개 이하의 문장을 목표로 하라.
status 문자열 대상 카드의 라이프사이클 상태를 나타냅니다. 허용되는 값은 TEST, PUBLISHEDDELETED입니다. 사용 TEST 대상을 처음 구성할 때 사용합니다.

고객 인증 구성

대상 구성의 이 섹션에서는 새 대상 구성 Experience Platform 사용자 인터페이스의 페이지입니다. 여기서 사용자는 대상에 있는 계정에 Experience Platform을 연결합니다. 에서 지정하는 인증 옵션에 따라 authType 필드에서는 다음과 같이 사용자에 대해 Experience Platform 페이지가 생성됩니다.

베어러 인증

bearer 인증 유형을 구성할 때 사용자는 대상에서 가져오는 bearer 토큰을 입력해야 합니다.

베어러 인증을 사용하여 UI 렌더링

OAuth 2 인증

사용자가 선택 대상에 연결 twitter 맞춤형 대상 아래 예와 같이 OAuth 2 인증 흐름을 대상으로 트리거합니다. 대상 종단점에 대한 OAuth 2 인증 구성에 대한 자세한 내용은 전용 을 참조하십시오 대상 SDK OAuth 2 인증 페이지.

OAuth 2 인증을 사용하여 UI 렌더링

매개 변수 유형 설명
customerAuthenticationConfigurations 문자열 서버에 Experience Platform 고객을 인증하는 데 사용되는 구성을 나타냅니다. 자세한 내용은 authType 아래에 나열된 값을 반환합니다.
authType 문자열 허용되는 값은 다음과 같습니다 OAUTH2, BEARER.

고객 데이터 필드

이 섹션에서는 사용자 정의 필드를 도입할 수 있습니다. 위의 예제 구성에서는 customerDataFields 를 사용하려면 사용자가 인증 흐름에서 종단점을 선택하고 대상이 있는 고객 ID를 표시해야 합니다. 구성은 아래와 같이 인증 흐름에 반영됩니다.

사용자 지정 필드 인증 흐름

매개 변수 유형 설명
name 문자열 도입하는 사용자 정의 필드의 이름을 입력합니다.
type 문자열 도입하는 사용자 지정 필드의 유형을 나타냅니다. 허용되는 값은 다음과 같습니다 string, object, integer.
title 문자열 Experience Platform 사용자 인터페이스에서 고객이 볼 수 있는 필드의 이름을 나타냅니다.
description 문자열 사용자 지정 필드에 대한 설명을 입력합니다.
isRequired 부울 대상 설정 워크플로우에서 이 필드가 필요한지 여부를 나타냅니다.
enum 문자열 사용자 지정 필드를 드롭다운 메뉴로 렌더링하고 사용자가 사용할 수 있는 옵션을 나열합니다.
pattern 문자열 필요한 경우 사용자 지정 필드에 패턴을 적용합니다. 패턴을 적용하려면 정규 표현식을 사용합니다. 예를 들어 고객 ID에 숫자나 밑줄이 포함되지 않은 경우 을 입력합니다 ^[A-Za-z]+$ 을 입력합니다.

UI 속성

이 섹션은 Adobe Experience Platform 사용자 인터페이스에서 Adobe이 대상에 사용해야 하는 위의 구성의 UI 요소를 참조합니다. 아래를 참조하십시오.

매개 변수 유형 설명
documentationLink 문자열 에서 설명서 페이지를 참조합니다. 대상 카탈로그 목적지에 대해 지정합니다. 사용 http://www.adobe.com/go/destinations-YOURDESTINATION-en, 위치 YOURDESTINATION 은 대상의 이름입니다. Moviestar라는 대상의 경우 http://www.adobe.com/go/destinations-moviestar-en
category 문자열 Adobe Experience Platform에서 대상에 지정된 카테고리를 나타냅니다. 자세한 내용은 대상 카테고리. 다음 값 중 하나를 사용합니다. adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments.
connectionType 문자열 Server-to-server 은 현재 사용 가능한 유일한 옵션입니다.
frequency 문자열 Streaming 은 현재 사용 가능한 유일한 옵션입니다.

매핑 단계의 스키마 구성

매핑 단계 활성화

에서 매개 변수 사용 schemaConfig 대상 활성화 워크플로우의 매핑 단계를 활성화하려면 아래 설명된 매개 변수를 사용하여 Experience Platform 사용자가 프로필 속성 및/또는 ID를 대상 측에서 원하는 스키마에 매핑할 수 있는지 확인할 수 있습니다.

매개 변수 유형 설명
profileFields 어레이 위의 구성 예는 표시되지 않습니다. 사전 정의된 profileFields, Experience Platform 사용자에게는 플랫폼 속성을 대상 측의 사전 정의된 속성에 매핑하는 옵션이 있습니다.
profileRequired 부울 사용 true 위의 예제 구성에 표시된 대로 사용자가 Experience Platform의 프로필 속성을 대상의 사용자 지정 속성에 매핑할 수 있어야 합니다.
segmentRequired 부울 항상 사용 segmentRequired:true.
identityRequired 부울 사용 true 사용자가 Experience Platform의 ID 네임스페이스를 원하는 스키마에 매핑할 수 있어야 합니다.

ID 및 속성

이 섹션의 매개 변수는 대상이 수락하는 ID를 결정합니다. 이 구성은 또한 매핑 단계 ID와 속성을 XDM 스키마에서 대상의 스키마에 매핑하는 Experience Platform 사용자 인터페이스 수입니다.

어떤 것을 표시해야 합니다 Platform id 고객은 대상으로 내보낼 수 있습니다. 몇 가지 예는 다음과 같습니다 Experience Cloud ID, 해시된 이메일, 장치 ID (IDFA, GAID). 이러한 값은 Platform 고객이 대상의 ID 네임스페이스에 매핑할 수 있는 ID 네임스페이스입니다. 고객이 사용자 지정 네임스페이스를 대상이 지원하는 ID에 매핑할 수 있는지 여부를 나타낼 수도 있습니다.

ID 네임스페이스에는 1-1의 서신이 필요하지 않습니다 Platform 및 대상을 선택합니다.
예를 들어 고객이 Platform IDFA 네임스페이스에 IDFA 대상의 네임스페이스이거나, 동일한 네임스페이스를 매핑할 수 있습니다 Platform IDFA 네임스페이스 Customer ID 네임스페이스가 대상에 있습니다.

자세한 내용은 ID 네임스페이스 개요.

UI에서 대상 ID 렌더링

매개 변수 유형 설명
acceptsAttributes 부울 대상이 표준 프로필 속성을 수락하는지 여부를 나타냅니다. 일반적으로 이러한 속성은 파트너의 설명서에서 강조 표시됩니다.
acceptsCustomNamespaces 부울 고객이 대상에서 사용자 지정 네임스페이스를 설정할 수 있는지 여부를 나타냅니다.
allowedAttributesTransformation 문자열 예제 구성에 표시되지 않음. 예를 들어 Platform 고객은 일반 이메일 주소를 특성으로 사용하고 플랫폼에서는 해시된 이메일만 허용합니다. 이 개체에서는 적용해야 하는 변형을 적용할 수 있습니다(예: 이메일을 소문자로 변환한 다음 해시). 예를 보려면 requiredTransformation 에서 대상 구성 API 참조.
acceptedGlobalNamespaces - 플랫폼에서 표준 id 네임스페이스 (예: IDFA)가 있으므로 Platform 사용자가 이러한 ID 네임스페이스를 선택하도록 제한할 수 있습니다.

대상 게재

매개 변수 유형 설명
authenticationRule 문자열 방법을 나타냅니다. Platform 고객이 대상에 연결합니다. 허용되는 값은 다음과 같습니다 CUSTOMER_AUTHENTICATION, PLATFORM_AUTHENTICATION, NONE.
  • 사용 CUSTOMER_AUTHENTICATION 플랫폼 고객이 사용자 이름과 암호, 베어러 토큰 또는 다른 인증 방법을 통해 시스템에 로그인하는 경우. 예를 들어, 이 옵션을 선택한 경우에도 이 옵션을 선택합니다 authType: OAUTH2 또는 authType:BEARER in customerAuthenticationConfigurations.
  • 사용 PLATFORM_AUTHENTICATION Adobe과 대상 및 대상 사이에 글로벌 인증 시스템이 있는 경우 Platform 고객은 대상에 연결하기 위해 인증 자격 증명을 제공할 필요가 없습니다. 이 경우 자격 증명 구성.
  • 사용 NONE 대상 플랫폼으로 데이터를 전송하는 데 인증이 필요하지 않은 경우
destinationServerId 문자열 다음 instanceId대상 서버 구성 이 대상에 사용됩니다.

세그먼트 매핑 구성

세그먼트 매핑 구성 섹션

대상 구성의 이 섹션에서는 세그먼트 이름 또는 ID와 같은 세그먼트 메타데이터를 Experience Platform과 대상 간에 공유하는 방법에 대해 설명합니다.

사용 audienceTemplateId이 섹션은 이 구성과 대상 메타데이터 구성.

위의 구성에 표시된 매개 변수는 대상 끝점 API 참조.

집계 정책

구성 템플릿의 집계 정책

이 섹션에서는 데이터를 대상으로 내보낼 때 Experience Platform이 사용해야 하는 집계 정책을 설정할 수 있습니다.

집계 정책은 내보낸 프로필이 데이터 내보내기에서 결합되는 방법을 결정합니다. 사용 가능한 옵션은 다음과 같습니다.

  • 최상의 노력 집계
  • 구성 가능한 합계(위의 구성에 표시)

다음 섹션 읽기 템플릿 사용 그리고 집계 키 예 선택한 집계 정책을 기반으로 메시지 변환 템플릿에 집계 정책을 포함하는 방법을 이해합니다.

최상의 노력 집계

API 엔드포인트가 API 호출당 100개 미만의 프로필을 허용하는 경우 이 옵션을 사용합니다.

이 옵션은 요청당 프로필 수를 줄이고, 데이터가 많은 요청이 적은 것보다 적은 데이터로 더 많은 요청을 받는 대상에 가장 적합합니다.

를 사용하십시오 maxUsersPerRequest 매개 변수를 사용하여 대상에서 요청에 사용할 수 있는 최대 프로필 수를 지정합니다.

구성 가능한 집계

이 옵션은 동일한 호출에서 수천 개의 프로필을 사용하여 일괄 처리를 수행하려는 경우에 가장 적합합니다. 또한 이 옵션을 사용하면 복잡한 집계 규칙을 기반으로 내보낸 프로필을 집계할 수 있습니다.

이 옵션을 사용하면 다음 작업을 수행할 수 있습니다.

  • 대상에 API 호출이 수행되기 전에 집계할 최대 프로필 수 및 최대 프로필 수를 설정합니다.
  • 다음을 기반으로 대상에 매핑된 내보낸 프로필을 집계합니다.
    • 세그먼트 ID;
    • 세그먼트 상태;
    • ID 또는 그룹

합계 매개 변수에 대한 자세한 내용은 대상 API 끝점 작업 참조 페이지. 여기서 각 매개 변수는 설명되어 있습니다.

내역 프로필 자격

를 사용할 수 있습니다 backfillHistoricalProfileData 대상 구성의 매개 변수로 이전 프로필 자격을 대상으로 내보내야 하는지 여부를 결정합니다.

매개 변수 유형 설명
backfillHistoricalProfileData 부울 세그먼트가 대상으로 활성화될 때 이전 프로필 데이터를 내보내지 여부를 제어합니다.
  • true: Platform 세그먼트가 활성화되기 전에 세그먼트에 대해 자격이 있는 내역 사용자 프로필을 보냅니다.
  • false: Platform 세그먼트가 활성화된 후에 세그먼트에 대한 자격이 되는 사용자 프로필만 포함합니다.

이 구성이 대상에 필요한 모든 정보를 연결하는 방법

일부 대상 설정은 대상 서버 또는 대상 메타데이터 구성. 여기에 설명된 대상 구성은 다음과 같이 다른 두 구성을 참조하여 이러한 모든 설정을 연결합니다.

  • 를 사용하십시오 destinationServerId 대상 서버 및 대상에 대해 설정된 템플릿 구성을 참조하려면 다음을 수행하십시오.
  • 를 사용하십시오 audienceMetadataId 대상에 대해 설정된 대상 메타데이터 구성을 참조하려면 다음을 수행하십시오.

이 페이지에서는