使用Destination SDK配置流目標

總覽

本頁介紹如何使用中的資訊 目標SDK中的配置選項 和其他Destination SDK功能和API參考文檔中 流目標。 這些步驟按如下順序排列。

先決條件

在前進到下面所示的步驟之前,請閱讀 Destination SDK入門 頁,以獲取使用Adobe I/OAPI的必要Destination SDK身份驗證憑據和其他先決條件。

使用Destination SDK中的配置選項設定目標的步驟

使用Destination 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 給。

重要

要建立正確配置的目標,請 必須 在中添加至少一個目標標識 identityNamespaces,如下所示。 如果未配置目標標識,則用戶將無法通過 映射步驟 的子菜單。

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":2400,
         "maxNumEventsInBatch":5000
      }
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ]
}

第3步:建立消息轉換模板 — 使用模板語言指定消息輸出格式

您必鬚根據目標支援的負載建立模板,將導出資料的格式從AdobeXDM格式轉換為目標支援的格式。 請參閱一節中的模板示例 使用模板語言進行身份、屬性和段成員身份轉換 並使用 模板創作工具 由Adobe提供。

編製適合您的消息轉換模板後,將其添加到您在步驟1中建立的伺服器和模板配置中。

第4步:建立受眾元資料配置

對於某些目標,Destination SDK要求您配置訪問群體元資料配置,以寫程式方式在目標中建立、更新或刪除訪問群體。 請參閱 受眾元資料管理 有關您何時需要設定此配置以及如何進行配置的資訊。

如果使用訪問群體元資料配置,則必須將其連接到您在步驟2中建立的目標配置。 將受眾元資料配置的實例ID添加到目標配置中,作為 audienceTemplateId

第5步:設定身份驗證

取決於是否指定 "authenticationRule": "CUSTOMER_AUTHENTICATION""authenticationRule": "PLATFORM_AUTHENTICATION" 在上面的目標配置中,您可以使用 /destination/credentials 端點。

  • 最常見的案例:如果已選擇 "authenticationRule": "CUSTOMER_AUTHENTICATION" 在目標配置中,並且目標支援OAuth 2身份驗證方法,請閱讀 OAuth 2身份驗證
  • 如果已選擇 "authenticationRule": "PLATFORM_AUTHENTICATION",請參閱 驗證配置

步驟6:Test目標

使用前面步驟中的配置端點設定目標後,可以使用 目標測試工具 testAdobe Experience Platform和你目的地的融合。

在test目標的過程中,必須使用Experience PlatformUI建立段,您將激活這些段到目標。 有關如何在Experience Platform中建立段的說明,請參閱以下兩種資源:

第7步:發佈目標

配置和測試目標後,使用 目標發佈API 將您的配置提交給Adobe以供審閱。

第8步:記錄目標

如果您是獨立軟體供應商(ISV)或系統整合商(SI),則 產品化整合,使用 自助文檔處理 為目標建立產品文檔頁面 Experience Platform目標目錄

本頁內容