Enviar para análise um destino produzido criado no Destination SDK

Visão geral overview

Antes que seu destino possa ser publicado na catálogo de destinos Experience Platform, você deve fornecer ao Adobe determinadas informações sobre o destino e os testes realizados, para garantir que os usuários desfrutem da melhor experiência possível ao ativar dados na sua plataforma.

Esta página lista todas as informações que você precisa fornecer ao enviar ou atualizar um destino criado usando o Adobe Experience Platform Destination SDK. Para enviar um destino no Adobe Experience Platform com sucesso, envie um email para aepdestsdk@adobe.com que inclui:

Você pode encontrar informações detalhadas sobre cada item nas seções abaixo:

Descrição do caso de uso use-case-description

Forneça uma descrição dos casos de uso que seu destino resolve para clientes do Experience Platform. Suas descrições podem ser semelhantes aos casos de uso de parceiros existentes:

Motivo da atualização reason-for-update

Forneça uma breve descrição do problema que seu envio resolve para o destino existente. Por exemplo, seu envio pode atualizar o nome, a descrição e o logotipo do seu destino conforme você muda da versão beta para a disponível geral. Ou o envio pode corrigir um erro descoberto na configuração de destino.

Resultados do teste após usar a API de destino de teste testing-api-response

Fornecer resultados de teste após o uso de API de destino de teste para executar uma chamada HTTP para o seu destino. Isso inclui:

Por exemplo, sua solicitação e resposta podem ser semelhantes às amostras abaixo:

Solicitação

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"
            }
         }
      }
   ]
}'

Resposta

{
   "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"
            }
         }
      }
   ]
}

Requisitos adicionais para destinos baseados em arquivo additional-file-based-destination-requirements

Para destinos baseados em arquivo, você deve fornecer prova adicional de que configurou corretamente o destino. Certifique-se de incluir os itens abaixo:

Teste de resposta da API testing-api-response-file-based

Inclua uma solicitação e uma amostra de resposta após usar a API de teste para teste seu destino baseado em arquivo com perfis de amostra.

Anexar arquivo exportado attach-exported-file

No seu email de envio, anexe um arquivo CSV que foi exportado para o local de armazenamento pelo destino que você configurou.

Prova de assimilação bem-sucedida proof-of-successful-ingestion

Por fim, você deve fornecer alguma forma de prova de que os dados foram assimilados com êxito em seu sistema após serem exportados para o local de armazenamento fornecido. Forneça qualquer um dos itens abaixo:

Prova de que você enviou uma solicitação de publicação de destino destination-publishing-request-proof

Depois de testar o destino com êxito, você deve usar o API de publicação de destino para enviar o destino ao Adobe para revisão e publicação.

Forneça a ID da solicitação de publicação para o destino. Para obter informações sobre como recuperar a ID da solicitação de publicação, leia como recuperar solicitações de publicação de destino.

PR (pull request) da documentação de destino para integrações produzidas documentation-pr

Se você for um ISV (Independent Software Vendor, Fornecedor independente de software) ou um SI (System Integrator, integrador de sistemas), crie um integração produtiva, você deve usar o processo de documentação de autoatendimento para criar uma página de documentação do produto para o seu destino. Como parte do processo de envio, forneça a solicitação de pull (PR) para sua documentação de destino.

Logotipo para o seu destino logo

O catálogo de destinos inclui um logotipo para cada cartão de destino. No email de envio, inclua uma imagem com o logotipo do seu destino.

Os requisitos de imagem são:

Baixar email de amostra download-sample-email

Baixar um email de amostra com todas as informações que você precisa fornecer ao Adobe.