Sua conexão de destino your-destination
Conforme você passar por este modelo, substitua ou exclua todos os parágrafos em itálico (começando por este).
Comece atualizando os metadados (título e descrição) na parte superior da página. Ignore todas as instâncias de UICONTROL nesta página. Essa é uma tag que ajuda nossos processos de tradução automática a traduzir corretamente a página para os vários idiomas compatíveis. Adicionaremos marcas à sua documentação após você enviá-la.
- Preencha todas as seções neste modelo, na ordem em que estão descritas no modelo.
- Esse modelo é atualizado com pouca frequência, com base no feedback do parceiro. Antes de começar a criar a documentação para o seu destino, baixe a última versão do modelo.
Visão geral overview
Forneça uma breve visão geral da sua empresa, incluindo o valor que ela oferece aos clientes. Inclua um link para a página inicial da documentação do produto para leitura adicional.
support@YourDestination.com
.Casos de uso use-cases
Para ajudá-lo a entender melhor como e quando você deve usar o destino YourDestination, veja a seguir exemplos de casos de uso que os clientes da Adobe Experience Platform podem resolver usando esse destino.
Caso de uso #1 use-case-1
Para plataformas de mensagens móveis:
Uma plataforma de vendas e aluguel de residências deseja enviar notificações móveis para os dispositivos Android e iOS dos clientes para que eles saibam que há 100 listas atualizadas na área em que eles pesquisaram anteriormente por um aluguel.
Caso de uso #2 use-case-2
Para plataformas de rede social:
Uma marca de vestuário esportivo deseja alcançar clientes existentes por meio de suas contas de redes sociais. A marca de vestuário pode assimilar endereços de email de seu próprio CRM para o Adobe Experience Platform, criar públicos a partir de seus próprios dados offline e enviar esses públicos para o Seu Destino, para exibir anúncios nos feeds de redes sociais de seus clientes.
Pré-requisitos prerequisites
Adicione nesta seção informações sobre qualquer item que os clientes precisem saber antes de começar a configurar o destino na interface do Adobe Experience Platform. Isso pode ser sobre:
- que precisa ser adicionado a uma lista de permissões
- requisitos para hash de email
- qualquer especificação de conta da sua parte
- como obter uma chave de API para se conectar à sua plataforma
Você pode vincular à sua documentação relevante, se isso for útil aos clientes.
Identidades suportadas supported-identities
Adicione informações nesta seção sobre as identidades suportadas pelo seu destino. Preenchemos previamente a tabela com alguns valores padrão. Exclua os valores que não se aplicam ao seu destino e/ou adicione quaisquer valores que não estejam pré-preenchidos.
YourDestination oferece suporte à ativação das identidades descritas na tabela abaixo. Saiba mais sobre identidades.
Públicos-alvo compatíveis supported-audiences
Adicione informações nesta seção sobre os públicos-alvo com suporte do seu destino. Preenchemos previamente a tabela com alguns valores padrão. Use os caracteres ✓
e X
para marcar se o tipo de público-alvo é suportado por este destino.
Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.
Tipo e frequência de exportação export-type-frequency
Na tabela, mantenha somente as linhas que correspondem ao seu destino. Você deve ter uma linha para o Tipo de exportação e uma linha para a Frequência de exportação. Exclua os valores que não se aplicam ao seu destino.
Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.
Conectar ao destino connect
Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.
Autenticar para o destino authenticate
Adicione os campos que os clientes devem preencher ao autenticar no seu destino. Esses campos são específicos do destino e dependem da configuração no Destination SDK. Os campos de destino podem não ser os mesmos listados abaixo. Inclua também uma captura de tela semelhante à captura de tela de exemplo mostrada abaixo.
Para autenticar no destino, preencha os campos obrigatórios e selecione Conectar ao destino.
- Token do portador: preencha o token do portador para autenticar no destino.
Preencher detalhes do destino destination-details
Adicione os campos que os clientes devem preencher ao configurar um novo destino. Esses campos são específicos do destino e dependem da configuração no Destination SDK. Os campos de destino podem não ser os mesmos listados abaixo. Inclua também uma captura de tela semelhante à captura de tela de exemplo mostrada abaixo.
Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.
- Nome: um nome pelo qual você reconhecerá este destino no futuro.
- Descrição: uma descrição que ajudará você a identificar este destino no futuro.
- ID da Conta: Seu SeuDestino ID da conta.
Ativar alertas enable-alerts
Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, leia o manual sobre assinatura de alertas de destinos usando a interface.
Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.
Ativar públicos-alvo para esse destino activate
-
Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.
-
Para exportar identidades, você precisa da permissão Exibir Gráfico de Identidade controle de acesso.
{width="100" modal="regular"}
Exclua conforme apropriado - Se estiver documentando um novo destino de streaming, mantenha o primeiro parágrafo abaixo. Se estiver documentando um novo destino baseado em arquivo, mantenha o segundo parágrafo. Se você estiver documentando um destino que exporta conjuntos de dados, mantenha o terceiro parágrafo.
Leia Ativar perfis e públicos-alvo para destinos de exportação de público-alvo de streaming para obter instruções sobre como ativar públicos-alvo para este destino.
Leia Ativar dados de público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar públicos-alvo para esse destino.
Leia (Beta) Exportar conjuntos de dados para obter instruções detalhadas sobre como exportar conjuntos de dados para este destino.
Mapear atributos e identidades map
Adicione informações sobre mapeamentos compatíveis entre campos de origem e destino na etapa Mapeamento do fluxo de trabalho de ativação. O destino pode oferecer suporte à exportação de atributos de perfil, namespaces de identidade ou ambos. Alguns campos podem ser obrigatórios. Os atributos do Target podem ser predefinidos ou personalizados. Enfatize os avisos importantes e use exemplos, preferencialmente com capturas de tela. Dois exemplos de páginas de destino que você pode usar como referência são:
Dados exportados / Validar exportação de dados exported-data
Adicione um parágrafo sobre como os dados são exportados para o seu destino. Isso ajudaria o cliente a garantir que ele se integrou corretamente ao seu destino. Por exemplo, você pode fornecer uma amostra de JSON como a abaixo. Ou você pode fornecer capturas de tela e informações da interface do destino que mostram como os clientes devem esperar que os públicos-alvo sejam preenchidos na plataforma de destino.
{
"person": {
"email": "yourstruly@adobe.com"
},
"segmentMembership": {
"ups": {
"7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
"lastQualificationTime": "2020-05-25T21:24:39Z",
"status": "exited"
},
"59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
"lastQualificationTime": "2020-05-25T23:37:33Z",
"status": "realized"
}
}
},
"identityMap": {
"ecid": [
{
"id": "14575006536349286404619648085736425115"
},
{
"id": "66478888669296734530114754794777368480"
}
],
"email_lc_sha256": [
{
"id": "655332b5fa2aea4498bf7a290cff017cb4"
},
{
"id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
}
]
}
}
Uso e governança de dados data-usage-governance
Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform fiscaliza a governança de dados, leia a Visão geral da Governança de Dados.
Recursos adicionais additional-resources
Você pode fornecer mais links para a documentação do produto ou qualquer outro recurso que considere importante para o sucesso do cliente.