Sua conexão de destino

Última atualização em 2023-11-04
  • Tópicos
  • Destinations
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader

À medida que passa por esse 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 tags à sua documentação depois que você enviá-la.

IMPORTANTE
  • 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, verifique se você baixou o versão mais recente do modelo.

Visão geral

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.

IMPORTANTE

Esse conector de destino e a página de documentação são criados e mantidos pelo SeuDestino equipe. Para qualquer consulta ou solicitação de atualização, entre em contato diretamente em Inserir link ou endereço de email no qual você pode ser contatado para obter atualizações, por exemplo support@YourDestination.com.

Casos de uso

Para ajudá-lo a entender melhor como e quando você deve usar o SeuDestino destino, aqui estão exemplos de casos de uso que os clientes do Adobe Experience Platform podem resolver usando esse destino.

Caso de uso #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 procuraram um aluguel anteriormente.

Caso de uso #2

Para plataformas de rede social:

Uma marca de vestuário esportivo quer alcançar clientes existentes por meio de suas contas de mídia social. 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

Adicione informações nesta seção sobre qualquer coisa que os clientes precisem saber antes de começar a configurar o destino na interface do usuário do Adobe Experience Platform. Isso pode se referir a:

  • que precisam ser adicionados a uma lista de permissões
  • requisitos para hash de email
  • quaisquer detalhes específicos da 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 para os clientes.

Identidades suportadas

Adicione informações nesta seção sobre as identidades compatíveis com seu destino. Preenchemos previamente a tabela com alguns valores padrão. Exclua os valores que não se aplicam ao seu destino e quaisquer valores que não sejam pré-preenchidos.

SeuDestino O oferece suporte à ativação das identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino Descrição Considerações
GAID ID de publicidade do Google Selecione a identidade de destino GAID quando a identidade de origem for um namespace GAID.
IDFA Apple ID para anunciantes Selecione a identidade de destino do IDFA quando a identidade de origem for um namespace do IDFA.
ECID Experience Cloud ID Um namespace que representa a ECID. Esse namespace também pode ser referenciado pelos seguintes aliases: "Adobe Marketing Cloud ID", "Adobe Experience Cloud ID", "Adobe Experience Platform ID". Leia o seguinte documento em ECID para obter mais informações.
phone_sha256 Números de telefone com hash com o algoritmo SHA256 Os números de telefone com hash SHA256 e texto sem formatação são compatíveis com o Adobe Experience Platform. Quando o campo de origem contiver atributos sem hash, verifique a Aplicar transformação opção, para ter Platform coloque automaticamente os dados em hash na ativação.
email_lc_sha256 Endereços de email com hash com o algoritmo SHA256 O Adobe Experience Platform oferece suporte tanto para texto simples quanto para endereços de email com hash SHA256. Quando o campo de origem contiver atributos sem hash, verifique a Aplicar transformação opção, para ter Platform coloque automaticamente os dados em hash na ativação.
extern_id IDs de usuário personalizadas Selecione esta identidade de destino quando sua identidade de origem for um namespace personalizado.

Públicos-alvo compatíveis

Adicione informações nesta seção sobre os públicos-alvo compatíveis com o seu destino. Preenchemos previamente a tabela com alguns valores padrão. Use o e X caracteres para marcar se o tipo de público-alvo é compatível com este destino.

Esta seção descreve que tipo de público-alvo você pode exportar para esse destino.

Origem do público Suportado Descrição
Segmentation Service Públicos-alvo gerados pelo Experience Platform Serviço de segmentação.
Uploads personalizados X Públicos-alvo importado para o Experience Platform de arquivos CSV.

Tipo e frequência de exportação

Na tabela, mantenha somente as linhas que correspondem ao 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.

Item Tipo Notas
Tipo de exportação Exportação de público Você está exportando todos os membros de um público-alvo com os identificadores (nome, número de telefone ou outros) usados no SeuDestino destino.
Tipo de exportação Baseado em perfil Você está exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), conforme escolhido na tela selecionar atributos de perfil da workflow de ativação de destino.
Tipo de exportação Exportação do conjunto de dados Você está exportando conjuntos de dados brutos, que não são agrupados ou estruturados por interesses ou qualificações de público-alvo.
Frequência de exportação Streaming Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que um perfil é atualizado em Experience Platform com base na avaliação do público-alvo, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de transmissão.
Frequência de exportação Lote Os destinos em lote exportam arquivos para plataformas downstream em incrementos de três, seis, oito, doze ou vinte e quatro horas. Leia mais sobre destinos baseados em arquivo em lote.

Conectar ao destino

IMPORTANTE

Para se conectar ao destino, você precisa da variável Gerenciar destinos permissão de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Para se conectar a esse 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

Adicione os campos que os clientes devem preencher ao autenticar em 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.

Captura de tela de exemplo mostrando como autenticar no destino

  • Token de portador: Preencha o token do portador para autenticar no destino.

Preencher detalhes do destino

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.

Captura de tela de amostra mostrando como preencher detalhes para o seu destino

  • Nome: um nome pelo qual você reconhecerá esse destino no futuro.
  • Descrição: uma descrição que ajudará você a identificar esse destino no futuro.
  • ID da conta: Seu SeuDestino ID da conta.

Ativar alertas

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 no assinatura de alertas de destinos usando a interface do.

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino

IMPORTANTE

Exclua conforme apropriado - Se estiver documentando um novo destino de transmissão, 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.

Ler Ativar perfis e públicos para destinos de exportação de público de transmissão para obter instruções sobre como ativar públicos-alvo para esse destino.

Ler Ativar dados do 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.

Ler (Beta) Exportar conjuntos de dados para obter instruções detalhadas sobre como exportar conjuntos de dados para esse destino.

Mapear atributos e identidades

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

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

Todos Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, leia o Visão geral da governança de dados.

Recursos adicionais

Você pode fornecer links adicionais para a documentação do seu produto ou quaisquer outros recursos que considere importantes para o sucesso do cliente.

Nesta página