스트리밍 대상 구성

개요

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

이 구성은 또한 대상이 작동하는 데 필요한 다른 구성(대상 서버 및 대상 메타데이터)을 이 구성에 연결합니다. 의 두 구성을 참조하는 방법 읽기 추가 하위 섹션.

다음을 사용하여 이 문서에 설명된 기능을 구성할 수 있습니다. /authoring/destinations API 엔드포인트. 읽기 대상 API 엔드포인트 작업 엔드포인트에서 수행할 수 있는 전체 작업 목록입니다.

스트리밍 구성 예

이는 지구상의 4개 위치에 엔드포인트가 있는 가상의 스트리밍 도착지 Moviestar의 예제 구성입니다. 대상이 모바일 대상 범주에 속합니다.

{
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointRegion",
         "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":2400,
         "maxNumEventsInBatch":5000,
         "aggregationKey":{
            "includeSegmentId":true,
            "includeSegmentStatus":true,
            "includeIdentity":true,
            "oneIdentityPerGroup":true,
            "groups":[
               {
                  "namespaces":[
                     "IDFA",
                     "GAID"
                  ]
               },
               {
                  "namespaces":[
                     "EMAIL"
                  ]
               }
            ]
         }
      }
   },
   "backfillHistoricalProfileData":true
}

고객 인증 구성

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

전달자 인증

전달자 인증 유형을 구성할 때 사용자는 대상에서 얻은 전달자 토큰을 입력해야 합니다.

OAuth 2 인증

사용자 선택 대상에 연결 사용자 지정 대상 Twitter 대상에 대해 아래 예에 표시된 대로 대상에 대한 OAuth 2 인증 흐름을 트리거합니다. 대상 끝점에 대한 OAuth 2 인증 구성에 대한 자세한 내용은 전용 을 참조하십시오 Destination SDK OAuth 2 인증 페이지.

고객 데이터 필드

이 섹션을 사용하여 Experience Platform UI에서 대상에 연결할 때 사용자에게 대상에 대한 사용자 정의 필드를 입력하도록 요청합니다. 구성은 아래와 같이 인증 흐름에 반영됩니다.

UI 속성

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

매핑 단계의 스키마 구성

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

ID 및 속성

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

다음을 나타내야 합니다. Platform id 고객은 대상으로 내보낼 수 있습니다. 몇 가지 예는 다음과 같습니다 Experience Cloud ID, 해시된 이메일, 장치 ID(IDFA, GAID). 이 값은 다음과 같습니다 Platform 고객이 대상에서 id 네임스페이스에 매핑할 수 있는 id 네임스페이스. 또한 고객이 사용자 정의 네임스페이스를 대상에서 지원하는 ID에 매핑할 수 있는지 여부를 나타낼 수도 있습니다(acceptsCustomNamespaces: true) 및 고객이 표준 XDM 속성을 대상에서 지원하는 ID에 매핑할 수 있는 경우(acceptsAttributes: true).

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

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

대상 게재

세그먼트 매핑 구성

대상 구성의 이 섹션은 Experience Platform 이름 또는 ID와 같은 세그먼트 메타데이터를 세그먼트와 대상 간에 공유하는 방식과 관련이 있습니다.

다음을 통해 audienceTemplateId, 이 섹션은 또한 이 구성을 대상 메타데이터 구성.

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

집계 정책

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

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

• 최상의 작업 집계
• 구성 가능한 합계 (위의 구성에 표시됨)

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

최상의 작업 집계

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

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

구성 가능한 집계

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

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

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

합계 매개변수에 대한 자세한 설명은 다음을 참조하십시오. 대상 API 엔드포인트 작업 각 매개 변수에 대해 설명하는 참조 페이지입니다.

과거 프로필 자격 요건

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

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

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

• 사용 destinationServerId 대상 서버 및 대상에 대해 설정된 템플릿 구성을 참조합니다.
• 사용 audienceMetadataId 대상에 대해 설정된 대상 메타데이터 구성을 참조합니다.

Business.Adobe.com 리소스