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 delivery 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 suportados pelo Destination SDK fazem distinção entre maiúsculas e minúsculas. 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 Platform deve se conectar ao seu destino. Valores compatíveis:

  • CUSTOMER_AUTHENTICATION: use esta opção se os clientes da 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 o seu destino e o cliente do Platform não precisar fornecer nenhuma credencial 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.
  • NONE: use essa opção se nenhuma autenticação for necessária para enviar dados para a plataforma de destino.
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}}"
      }
   ]
}

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