提交以Destination SDK撰寫的生產目的地,以供複查
概觀 overview
-
此處記錄的程式僅適用於提交生產(公用)目的地的合作夥伴。 如果您要建立私人目的地供您自用,則不需要製作這些資料並與Adobe分享。
-
Adobe審閱目的地發佈要求的標準回應時間為5個工作日。
-
如果Adobe團隊要求您在初次提交後對設定進行任何更新,則您必須在進行更新後提交另一個目的地發佈請求。
-
即使您的目的地在Experience Platform目錄中上線後,如果您需要對設定進行任何更新,則必須提交新的目的地發佈請求,才能將更新反映在設定中。
-
對於您正在更新的新目的地和現有目的地,檢閱時間軸和所需的人工因素都相同。
在將您的目的地發佈至Experience Platform目的地目錄之前,您必須向Adobe提供有關目的地以及您執行之測試的特定資訊,以確保使用者在將資料啟用至您的平台時享有最佳體驗。
此頁面列出提交或更新您使用Adobe Experience Platform Destination SDK編寫的目的地時,所需的所有資訊。 若要在Adobe Experience Platform中成功提交目的地,請傳送電子郵件至aepdestsdk@adobe.com,包括:
-
目的地解決的使用案例說明。 只有在您提交新的目的地設定時,才需要執行此作業。
-
目的地提交原因的說明。 只有在更新現有的目的地設定時,才需要此專案。
-
使用測試目的地API端點對您的目的地執行HTTP呼叫後的測試結果。 請與Adobe共用對您的目的地端點發出的API呼叫,以及從您的目的地端點接收的API回應。
-
檔案型目的地的其他需求:
- 使用測試API共用要求與回應範例,以使用範例設定檔🔗測試您的檔案型目的地。
- 附加目的地產生的範例檔案,並匯出至儲存位置。
- 提交一些形式的證明,證明您已成功將匯出的檔案從儲存位置擷取到系統中。
-
證明您已使用目的地發佈API提交目的地的目的地發佈要求。
-
檔案PR (提取要求),遵循自助服務檔案程式中所述的指示。
-
影像檔,會顯示為Experience Platform目的地目錄中目的地卡片的標誌。
您可以在下列各節中找到有關每個專案的詳細資訊:
使用案例說明 use-case-description
提供目的地為Experience Platform客戶解決的使用案例說明。 您的說明可與現有合作夥伴的使用案例類似:
- Pinterest:從您的客戶清單、造訪過您網站的人,或已在Pinterest上與您的內容互動的人,建立對象。
- Yahoo Data X: DataX API可供廣告商使用,這些廣告商想要鎖定在Verizon Media (VMG)中以電子郵件地址作為輸入的特定受眾群組,以便快速建立新受眾,並使用VMG的近乎即時API推送所需的受眾群組。
更新原因 reason-for-update
提供您提交解決現有目的地問題的簡短說明。 例如,當您從Beta版移至一般可用性時,您提交的內容可能會更新目的地的名稱、說明和標誌。 或者,您的提交可能會修正目的地設定中發現的錯誤。
使用測試目的地API後的測試結果 testing-api-response
使用測試目的地API端點對您的目的地執行HTTP呼叫後,提供測試結果。 其中包括:
- 使用測試API對您的目的地端點提出完整API請求(標頭和內文)。
- 從您的目的地端點接收的API回應。
例如,您的請求和回應可能會如以下範例所示:
要求
curl --location --request POST 'https://platform.adobe.io/data/core/activation/authoring/testing/destinationInstance/3e0ac39c-ef14-4101-9fd9-cf0909814510' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'x-api-key: {API_KEY}' \
--header 'Authorization: Bearer {ACCESS_TOKEN}' \
--header 'x-gw-ims-org-id: {ORG_ID}' \
--header 'x-sandbox-name: {SANDBOX_NAME}' \
--data-raw '{
"profiles":[
{
"segmentMembership":{
"ups":{
"374a9a6c-c719-4cdb-a660-155a2838e6d6":{
"lastQualificationTime":"2021-05-13T12:16:27.248585Z",
"status":"realized"
},
"896f8776-9498-47b4-b994-51cb3f61c2c5":{
"lastQualificationTime":"2021-05-13T12:16:27.248605Z",
"status":"realized"
}
}
},
"identityMap":{
"Email":[
{
"id":"Email-iIyJc"
}
],
"IDFA":[
{
"id":"IDFA-viPAW"
}
],
"GAID":[
{
"id":"GAID-Bc6LE"
}
],
"Email_LC_SHA256":[
{
"id":"Email_LC_SHA256-gEOdj"
}
]
},
"attributes":{
"key":{
"value":"string"
}
}
}
]
}'
回應
{
"results":[
{
"aggregationKey":{
"destinationInstanceId":"string",
"segmentId":"string",
"segmentStatus":"realized",
"identityNamespaces":[
[
"email",
"phone"
]
]
},
"httpCalls":[
{
"traceId":"a06fec2d-a886-4219-8975-4e4b7ed26539",
"request":{
"body":"{ \"attributes\": [ { \"external_id\": \"external_id-h29Fq\" , \"AdobeExperiencePlatformSegments\": { \"add\": [ \"Nirvana fans\" , \"RHCP fans\" ], \"remove\": [ ] } , \"key\": \"string\" } ] }",
"headers":[
{
"Content-Type":"application/json"
}
],
"method":"POST",
"uri":"https://api.moviestar.com/users/track"
},
"response":{
"body":"{\"status\": \"success\"}",
"code":"200",
"headers":[
{
"Connection":"keep-alive"
},
{
"Content-Type":"application/json"
},
{
"Server":"nginx"
},
{
"Vary":"Origin,Accept-Encoding"
},
{
"transfer-encoding":"chunked"
}
]
}
}
]
}
],
"inputProfiles":[
{
"segmentMembership":{
"ups":{
"03fb9938-8537-4b4c-87f9-9c4d413a0ee5":{
"lastQualificationTime":"2021-06-17T12:25:12.872039Z",
"status":"realized"
},
"27e05542-d6a3-46c7-9c8e-d59d50229530":{
"lastQualificationTime":"2021-06-17T12:25:12.872042Z",
"status":"realized"
}
}
},
"personalEmail":{
"address":"john.smith@abc.com"
},
"identityMap":{
"Email":[
{
"id":"Email-iIyJc"
}
],
"IDFA":[
{
"id":"IDFA-viPAW"
}
],
"GAID":[
{
"id":"GAID-Bc6LE"
}
],
"Email_LC_SHA256":[
{
"id":"Email_LC_SHA256-gEOdj"
}
]
},
"person":{
"name":{
"firstName":"string"
}
}
}
]
}
檔案型目的地的其他需求 additional-file-based-destination-requirements
針對以檔案為基礎的目的地,您必須提供其他證明,證明您已正確設定目的地。 請務必加入下列專案:
測試API回應 testing-api-response-file-based
使用測試API來使用範例設定檔🔗測試您的檔案型目的地之後,加入請求和回應範例。
附加匯出的檔案 attach-exported-file
在您的提交電子郵件中,附加您設定的目的地匯出至儲存位置的CSV檔案。
成功擷取的證明 proof-of-successful-ingestion
最後,您必須提供某種形式的證明,證明資料匯出至您提供的儲存位置後,已成功擷取至您的系統。 請提供以下任何專案:
- 熒幕擷取畫面或簡短的熒幕擷取視訊,讓您從儲存位置手動擷取檔案,並將其擷取至您的系統中。
- 熒幕擷取畫面或簡短的熒幕擷取視訊,其中系統的UI會確認Experience Platform產生的檔案名稱已成功擷取至系統中。
- 來自您系統的記錄行,該Adobe可以與檔案名稱或從Experience Platform產生的資料相關聯。
證明您已提交目的地發佈請求 destination-publishing-request-proof
成功測試目的地之後,您必須使用目的地發佈API將目的地提交給Adobe進行檢閱和發佈。
提供目的地之發佈要求的ID。 如需如何擷取發佈要求ID的詳細資訊,請閱讀如何擷取目的地發佈要求。
適用於產品化整合的目的地檔案PR (提取請求) documentation-pr
如果您是建立產品化整合的獨立軟體廠商(ISV)或系統整合商(SI),您必須使用自助服務檔案程式,為您的目的地建立產品檔案頁面。 在提交程式中,請為目的地檔案提供提取請求(PR)。
您目的地的標誌 logo
目的地目錄包含每個目的地卡片的標誌。 在您的提交電子郵件中,加入含有目的地標誌的影像。
影像需求如下:
- 格式:
SVG
- 大小:小於2MB
下載範例電子郵件 download-sample-email
下載範例電子郵件,其中包含您需要提供以供Adobe的所有資訊。