Opções de configuração no Destination SDK
O serviço de destinos no Adobe Experience Platform usa endpoints de configuração para vários componentes que criam a funcionalidade de destinos.
Combinados, esses componentes permitem que o Experience Platform se conecte às plataformas de destino, envie mensagens personalizadas, exporte arquivos personalizados e ative dados de perfil no ecossistema digital.
O diagrama abaixo mostra uma visão geral de alto nível dos componentes que você pode configurar por meio do Destination SDK para criar seu próprio destino. Esses componentes são descritos mais abaixo.
Configuração do servidor server-configuration
A configuração do servidor de destino vincula as informações sobre as especificações do servidor e o modelo usado pelo Adobe para entregar payloads ao seu destino.
Por exemplo, é aqui que você especifica os endpoints de API do seu lado aos quais o Experience Platform precisa se conectar, bem como os cabeçalhos e o formato das chamadas de API que o Platform fará.
Para destinos baseados em arquivo, essa configuração também inclui a formatação de arquivo e os formatos de compactação compatíveis com seu destino. Você pode configurar as funcionalidades descritas abaixo por meio do ponto de extremidade de servidores de destino.
- Especificações do servidor: um modelo de configuração que contém informações sobre o local de armazenamento ou o ponto de extremidade HTTP para o qual os dados são enviados.
- Especificações do modelo: neste modelo, você pode definir como estruturar a solicitação de API HTTP para o seu ponto de extremidade, incluindo como transformar campos de atributo de perfil entre o esquema XDM e o formato compatível com a sua plataforma. Use essas informações junto com a documentação de formato de mensagem.
- Formato de mensagem: esta seção aborda informações detalhadas sobre idiomas de modelo com suporte, formatos de mensagem e as informações necessárias para o Adobe configurar a integração com sua plataforma. Use essas informações junto com a documentação de especificações do modelo.
- Especificações do arquivo: um modelo de configuração que inclui as opções de compactação e formatação de arquivo para o destino do lote.
Configuração de destino destination-configuration
Esse endpoint de configuração contém informações básicas e avançadas sobre o destino. Por exemplo, é aqui que você especifica os tipos de identidade que seu destino pode suportar, o formato desejado de arquivos exportados (para destinos baseados em arquivos) e vários atributos de interface do usuário para seu cartão de destino na interface do usuário do Adobe Experience Platform.
Consulte a documentação abaixo para obter detalhes sobre cada um dos componentes da configuração de destino. Você pode configurar as funcionalidades descritas abaixo por meio do endpoint de destinos.
- Configuração de autenticação do cliente: selecione o mecanismo de autenticação que o Experience Platform deve usar para se conectar ao seu destino. Essa configuração gera a página Configurar novo destino na interface de usuário do Experience Platform, onde os usuários conectam o Experience Platform às contas que têm com seu destino.
- Autorização OAuth2: saiba mais sobre todos os fluxos de autenticação OAuth2 com suporte no Destination SDK e obtenha instruções para configurar a autenticação OAuth2 para o seu destino.
- Campos de dados do cliente: saiba como criar campos de entrada na interface do usuário do Experience Platform que permitem que seus usuários especifiquem várias informações relevantes para como se conectar e exportar dados para seu destino.
- Atributos da interface: saiba como configurar os atributos da interface do usuário, como o link da documentação, a categoria do cartão de destino, o tipo e a frequência da conexão de destino, para destinos compilados com Destination SDK.
- Configuração de esquema: saiba como definir o esquema de destino para o qual os usuários podem mapear atributos e identidades de perfil.
- Configuração do namespace de identidade: saiba como configurar as identidades suportadas pelo seu destino. Essa configuração preenche as identidades de destino na etapa de mapeamento da interface do usuário do Experience Platform, em que os usuários mapeiam identidades e atributos de seus esquemas XDM para o esquema em seu destino.
- Entrega de destino: saiba como configurar para onde vão exatamente os dados exportados e qual regra de autenticação é usada no local onde os dados serão direcionados.
- Configuração de metadados de público-alvo: saiba como os metadados de público-alvo, como nomes de público-alvo ou IDs, devem ser compartilhados entre o Experience Platform e o seu destino.
- Política de agregação: saiba como configurar uma política de agregação para determinar como as solicitações HTTP para o seu destino devem ser agrupadas e em lote.
- Configuração em lote: defina várias configurações de nomenclatura de arquivos e de agendamento de exportação disponíveis para os usuários ao se conectarem ao seu destino na interface de usuário do Experience Platform.
- Qualificações de perfil histórico: saiba mais sobre as qualificações de perfil histórico compatíveis com destinos criados com o Destination SDK.
Configuração de metadados de público audience-metadata-configuration
Esse componente permite configurar como os públicos-alvo são criados, atualizados ou excluídos de forma programática no destino. Para destinos baseados em arquivo, permite configurar uma notificação sempre que os arquivos forem entregues com êxito ao destino. Você pode configurar esta funcionalidade por meio do endpoint de templates de público-alvo.
Próximas etapas next-steps
Após a leitura deste artigo, você tem uma visão geral da funcionalidade fornecida pelo Destination SDK e quais páginas devem ser lidas para obter mais informações sobre configurações específicas. Em seguida, você pode ler os guias que incluem todas as etapas para configurar um streaming ou um destino baseado em arquivo usando o Destination SDK.