대상 SDK를 사용하여 스트리밍 대상을 구성하는 방법

개요

이 페이지에서는에서 정보를 사용하는 방법을 설명합니다. 대상 SDK의 구성 옵션 및 를 사용하여 다음을 구성할 수 있습니다 스트리밍 대상. 단계는 아래의 순차적 순서로 수행됩니다.

노트

대상 SDK를 통한 배치 대상 구성은 현재 지원되지 않습니다.

전제 조건

아래 표시된 단계로 이동하기 전에 다음을 참조하십시오. 대상 SDK 시작하기 대상 SDK API에서 사용할 필수 Adobe I/O 인증 자격 증명 및 기타 사전 요구 사항을 가져오는 방법에 대한 자세한 내용은 페이지를 참조하십시오.

대상 SDK의 구성 옵션을 사용하여 대상을 설정하는 절차

대상 SDK 엔드포인트를 사용하는 단계 설명

1단계: 서버 및 템플릿 구성 만들기

먼저 을 사용하여 서버 및 템플릿 구성을 만듭니다. /destinations-server 엔드포인트(읽기 API 참조). 서버 및 템플릿 구성에 대한 자세한 내용은 서버 및 템플릿 사양 참조 섹션에 있습니다.

다음은 구성 예입니다. 메시지 변환 템플릿은 requestBody.value 매개 변수는 3, 변형 템플릿 만들기.

POST platform.adobe.io/data/core/activation/authoring/destination-servers

{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.region}}/items"
      }
   },
   "httpTemplate":{
      "httpMethod":"POST",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"insert after you create a template in step 3"
      },
      "contentType":"application/json"
   }
}

2단계: 대상 구성 만들기

아래에 표시된 것은 를 사용하여 작성된 대상 템플릿에 대한 구성 예입니다. /destinations API 엔드포인트. 이 템플릿에 대한 자세한 내용은 대상 구성.

1단계의 서버 및 템플릿 구성을 이 대상 구성에 연결하려면 서버 및 템플릿 구성의 인스턴스 ID를 destinationServerId 여기 있습니다.

POST platform.adobe.io/data/core/activation/authoring/destinations
 
{
   "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":""
      }
   ],
   "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
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   },
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },   
   "aggregation":{
      "aggregationType":"CONFIGURABLE_AGGREGATION",
      "configurableAggregation":{
         "aggregationPolicyId":null,
         "aggregationKey":{
            "includeSegmentId":true,
            "includeSegmentStatus":true,
            "includeIdentity":true,
            "oneIdentityPerGroup":true,
            "groups":null
         },
         "splitUserById":true,
         "maxBatchAgeInSecs":360,
         "maxNumEventsInBatch":100
      }
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ]
}

3단계: 메시지 변환 템플릿 만들기 - 템플릿 언어를 사용하여 메시지 출력 형식을 지정합니다

대상이 지원하는 페이로드를 기준으로 하여 내보낸 데이터의 형식을 Adobe XDM 포맷에서 대상에서 지원하는 형식으로 변환하는 템플릿을 만들어야 합니다. 섹션에서 템플릿 예 를 참조하십시오 ID, 속성 및 세그먼트 멤버십 변환에 템플릿 언어 사용 그리고 템플릿 작성 도구 Adobe에서 제공합니다.

적합한 메시지 변환 템플릿을 만들었으면 1단계에서 만든 서버 및 템플릿 구성에 추가하십시오.

4단계: 대상 메타데이터 구성 만들기

일부 대상의 경우, 대상 SDK를 사용하려면 대상의 대상을 프로그래밍 방식으로 만들거나, 업데이트하거나, 삭제하도록 대상 메타데이터 구성을 구성해야 합니다. 을(를) 참조하십시오. 대상 메타데이터 관리 이 구성을 설정해야 하는 시점 및 이 작업을 수행하는 방법에 대한 자세한 정보를 제공합니다.

대상 메타데이터 구성을 사용하는 경우 이 구성을 2단계에서 만든 대상 구성에 연결해야 합니다. 대상 메타데이터 구성의 인스턴스 ID를 대상 구성에 다음으로 추가합니다. audienceTemplateId.

5단계: 자격 증명 구성 만들기 / 인증 설정

지정 여부에 따라 "authenticationRule": "CUSTOMER_AUTHENTICATION" 또는 "authenticationRule": "PLATFORM_AUTHENTICATION" 위의 대상 구성에서는 /destination 또는 /credentials 엔드포인트.

  • 가장 일반적인 사례: 선택한 경우 "authenticationRule": "CUSTOMER_AUTHENTICATION" 대상 구성에서 대상이 OAuth 2 인증 방법을 지원하고 있습니다. OAuth 2 인증.
  • 선택한 경우 "authenticationRule": "PLATFORM_AUTHENTICATION"를 참조하려면 자격 증명 구성 를 참조하십시오.

6단계: 대상 테스트

이전 단계의 구성 끝점을 사용하여 대상을 설정한 후에는 대상 테스트 도구 Adobe Experience Platform과 대상 간의 통합을 테스트하려면 다음을 수행하십시오.

대상을 테스트하는 프로세스의 일부로, Experience Platform UI를 사용하여 세그먼트를 만들어 대상에 대해 활성화해야 합니다. Experience Platform에서 세그먼트를 만드는 방법에 대한 지침은 아래 두 리소스를 참조하십시오.

7단계: 대상 게시

대상을 구성하고 테스트한 후 대상 게시 API 검토를 위해 Adobe에 구성을 제출합니다.

8단계: 대상을 문서화합니다.

ISV(Independent Software Vendor) 또는 SI(System Integrator)가 제품 통합를 사용하려면 셀프 서비스 설명서 프로세스 에서 대상에 대한 제품 설명서 페이지를 만들려면 Experience League 대상 카탈로그.

이 페이지에서는