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 no 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 delivery de destino por meio da /authoring/destinations terminal. 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 compatíveis com o Destination SDK são diferencia maiúsculas de 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 essa 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 seu destino e a variável Platform O cliente não precisa fornecer credenciais de autenticação para se conectar ao seu destino. Nesse caso, você deve criar um objeto de credenciais usando o API de credenciais configuração.
  • NONE: use essa opção se nenhuma autenticação for necessária para enviar dados para a plataforma de destino.
destinationServerId
String
A variável 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 o delivery de destino para um destino de transmissão, a variável deliveryMatchers seção não é necessária.
deliveryMatchers.value
String
  • Ao configurar a entrega de destino para destinos baseados em arquivo, sempre defina como batch.
  • Ao configurar o delivery de destino para um destino de transmissão, a variável deliveryMatchers seção 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 deliveryMatchers A seção 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 deliveryMatchers é necessária para destinos baseados em arquivo.

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