Documentação Experience Platform Guia de destinos

Entrega de destino

Last update: Mon Aug 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Destinos

Criado para:

Administrador
Usuário

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

style

shade-box

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

style

shade-box

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.

Definir destinationDelivery.authenticationRule como "PLATFORM_AUTHENTICATION" na configuração de destino
Criar o objeto de credencial.
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>"
      }
   ]
}

style

shade-box

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