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.
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.
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.
authenticationRule
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âmetroauthenticationId
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
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
instanceId
do servidor de destino para o qual você deseja exportar dados.deliveryMatchers.type
- 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
- 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.
{
"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.
- Definir
destinationDelivery.authenticationRule
como"PLATFORM_AUTHENTICATION"
na configuração de destino - Criar o objeto de credencial.
- Defina o parâmetro
authenticationId
para o valorinstanceId
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:
- Autenticação do cliente
- Autorização OAuth2
- Atributos da interface
- Campos de dados do cliente
- Configuração do esquema
- Configuração do namespace de identidade
- Configurações de mapeamento compatíveis
- Configuração de metadados de público
- Política de agregação
- Configuração em lote
- Qualificações do perfil histórico