Entrega de destino

Para oferecer mais controle sobre onde os dados exportados chegam ao seu destino, o Destination SDK permite especificar as configurações de entrega de destino.

A seção delivery de destino indica para onde os dados exportados vão e qual regra de autenticação é usada no local onde os dados serão direcionados.

Para entender onde esse componente se encaixa em uma integração criada com o Destination SDK, consulte o diagrama na documentação das opções de configuração ou consulte as seguintes páginas de visão geral da configuração de destino:

Você pode definir as configurações de entrega de destino por meio do ponto de extremidade /authoring/destinations. Consulte as seguintes páginas de referência de API para obter exemplos detalhados de chamadas de API, onde é possível configurar os componentes mostrados nesta página.

Este artigo descreve todas as opções de entrega de destino compatíveis que você pode usar para o seu destino.

IMPORTANT
Todos os nomes e valores de parâmetros com suporte do Destination SDK diferenciam maiúsculas de minúsculas 1}. Para evitar erros de diferenciação entre maiúsculas e minúsculas, use os nomes e valores dos parâmetros exatamente como mostrado na documentação.

Tipos de integração compatíveis supported-integration-types

Consulte a tabela abaixo para obter detalhes sobre quais tipos de integrações suportam a funcionalidade descrita nesta página.

Tipo de integração
Suporte à funcionalidade
Integrações em tempo real (streaming)
Sim
Integrações baseadas em arquivo (lote)
Sim

Parâmetros compatíveis supported-parameters

Ao definir as configurações do delivery de destino, você pode usar os parâmetros descritos na tabela abaixo para definir para onde os dados exportados devem ser enviados.

Parâmetro
Tipo
Descrição
authenticationRule
String

Indica como Experience Platform deve se conectar ao seu destino. Valores compatíveis:

  • CUSTOMER_AUTHENTICATION: use esta opção se os clientes da Experience Platform fizerem logon no sistema por meio de qualquer um dos métodos de autenticação descritos aqui.
  • PLATFORM_AUTHENTICATION: use esta opção se houver um sistema de autenticação global entre o Adobe e seu destino e o cliente do Experience Platform não precisar fornecer credenciais de autenticação para se conectar ao seu destino. Nesse caso, você deve criar um objeto de credenciais usando a configuração da API de credenciais e definir o parâmetro authenticationId como o valor da ID do objeto de credencial.
  • NONE: use essa opção se nenhuma autenticação for necessária para enviar dados para a plataforma de destino.
authenticationId
String
O instanceId da ID de configuração do objeto de credencial a ser usada para autenticação. Esse parâmetro só é necessário quando você precisa especificar uma configuração de credenciais específica.
destinationServerId
String
O instanceId do servidor de destino para o qual você deseja exportar dados.
deliveryMatchers.type
String
  • Ao configurar a entrega de destino para destinos baseados em arquivo, sempre defina como SOURCE.
  • Ao configurar a entrega de destino para um destino de streaming, a seção deliveryMatchers não é necessária.
deliveryMatchers.value
String
  • Ao configurar a entrega de destino para destinos baseados em arquivo, sempre defina como batch.
  • Ao configurar a entrega de destino para um destino de streaming, a seção deliveryMatchers não é necessária.

Configurações de entrega de destino para destinos de streaming destination-delivery-streaming

O exemplo abaixo mostra como as configurações de delivery de destino devem ser definidas para um destino de streaming. Observe que a seção deliveryMatchers não é necessária para destinos de streaming.

recommendation-more-help
{
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Configurações de entrega de destino para destinos baseados em arquivo destination-delivery-file-based

O exemplo abaixo mostra como as configurações de entrega de destino devem ser definidas para um destino baseado em arquivo. Observe que a seção deliveryMatchers é necessária para destinos baseados em arquivos.

{
   "destinationDelivery":[
      {
         "deliveryMatchers":[
            {
               "type":"SOURCE",
               "value":[
                  "batch"
               ]
            }
         ],
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"{{destinationServerId}}"
      }
   ]
}

Configuração de autenticação de plataforma platform-authentication

Ao usar PLATFORM_AUTHENTICATION, você deve especificar o parâmetro authenticationId para vincular sua configuração de destino à configuração de credenciais.

  1. Definir destinationDelivery.authenticationRule como "PLATFORM_AUTHENTICATION" na configuração de destino
  2. Criar o objeto de credencial.
  3. Defina o parâmetro authenticationId para o valor instanceId do objeto de credencial.

Exemplo de configuração com PLATFORM_AUTHENTICATION:

{
   "destinationDelivery":[
      {
         "authenticationRule":"PLATFORM_AUTHENTICATION",
         "authenticationId":"<string-here>",
         "destinationServerId":"<string-here>"
      }
   ]
}

Próximas etapas next-steps

Depois de ler este artigo, você deverá entender melhor como configurar os locais onde seu destino deve exportar dados, para destinos com base em arquivo e transmissão.

Para saber mais sobre os outros componentes de destino, consulte os seguintes artigos:

7f4d1967-bf93-4dba-9789-bb6b505339d6