Criar uma conexão de origem e um fluxo de dados de Marketo Engage na interface do usuário
Este tutorial fornece etapas para a criação de um conector de origem Marketo Engage (a seguir denominado "Marketo") na interface do usuário para trazer dados B2B para o Adobe Experience Platform.
Introdução
Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:
- Utilitário de geração automática de esquemas e namespaces B2B: o utilitário de geração automática de esquemas e namespaces B2B permite usar Postman para gerar valores automaticamente para seus esquemas e namespaces B2B. Você deve concluir seus namespaces e esquemas B2B primeiro, antes de criar uma conexão de origem e um fluxo de dados do Marketo.
- Fontes: o Experience Platform permite que os dados sejam assimilados de várias fontes e, ao mesmo tempo, fornece a capacidade de estruturar, rotular e aprimorar os dados recebidos usando os serviços da plataforma.
- Experience Data Model (XDM): a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Criar e editar esquemas na interface: saiba como criar e editar esquemas na interface.
- Namespaces de identidade: os namespaces de identidade são um componente de Identity Service que serve como indicadores do contexto ao qual uma identidade está relacionada. Uma identidade totalmente qualificada inclui um valor de ID e um namespace.
- Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
- Sandboxes: o Experience Platform fornece sandboxes virtuais que particionam uma única instância da Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.
Coletar credenciais necessárias
Para acessar sua conta do Marketo no Experience Platform, você deve fornecer os seguintes valores:
munchkinIdclientIdclientSecretPara obter mais informações sobre como adquirir esses valores, consulte o Marketo guia de autenticação.
Depois de obter as credenciais necessárias, você poderá seguir as etapas da próxima seção.
Conectar sua conta do Marketo
Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.
Na categoria aplicativos de Adobe, selecione Marketo Engage e Adicionar dados.
A página Conectar conta Marketo Engage é exibida. Nesta página, você pode usar uma nova conta ou acessar uma conta existente.
Para criar uma nova conta, selecione Nova conta e forneça um nome, uma descrição opcional e suas credenciais.
Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.
Para usar uma conta existente, selecione Conta existente e a conta que deseja usar no catálogo de contas existente.
Selecione Avançar para continuar.
Selecionar um conjunto de dados
Depois de criar sua conta do Marketo, a próxima etapa fornece uma interface para você explorar conjuntos de dados do Marketo.
A metade esquerda da interface é um navegador de diretório, que exibe os 10 conjuntos de dados do Marketo. Uma conexão de origem Marketo totalmente funcional requer a assimilação dos nove conjuntos de dados diferentes. Se você também estiver usando o recurso de marketing baseado em conta (ABM) do Marketo, será necessário criar um décimo fluxo de dados para assimilar o conjunto de dados Contas nomeadas.
Selecione o conjunto de dados que você deseja assimilar. Isso atualiza a interface para exibir uma visualização do conjunto de dados. Quando terminar, selecione Próximo.
Fornecer detalhes do conjunto de dados e do fluxo de dados provide-dataset-and-dataflow-details
Em seguida, você deve fornecer informações sobre seu conjunto de dados e seu fluxo de dados.
Detalhes do conjunto de dados dataset-details
Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, normalmente uma tabela, que contém um esquema (colunas) e campos (linhas). Os dados assimilados com sucesso no Experience Platform são armazenados no data lake como conjuntos de dados. Durante essa etapa, você pode criar um novo conjunto de dados ou usar um conjunto de dados existente.
Para usar um novo conjunto de dados, selecione Novo conjunto de dados e forneça um nome e uma descrição opcional para seu conjunto de dados. Você também deve selecionar um esquema do Experience Data Model (XDM) ao qual seu conjunto de dados adere.
Se você já tiver um conjunto de dados existente, selecione Conjunto de dados existente e use a opção Pesquisa avançada para exibir uma janela de todos os conjuntos de dados na sua organização, incluindo seus respectivos detalhes, como se eles estão habilitados para assimilação no Perfil do cliente em tempo real ou não.
Configurações de fluxo de dados dataflow-configurations
Se o seu conjunto de dados estiver habilitado para o Perfil de cliente em tempo real, durante essa etapa você poderá alternar para o conjunto de dados do perfil para habilitar seus dados para assimilação de perfil. Você também pode usar esta etapa para habilitar o Diagnóstico de erro e a Assimilação parcial.
- Diagnóstico de erro: selecione Diagnóstico de erro para instruir a origem a produzir o diagnóstico de erro que você poderá consultar posteriormente ao monitorar a atividade do conjunto de dados e o status do fluxo de dados.
- Assimilação parcial: Assimilação parcial de lotes é a capacidade de assimilar dados que contêm erros, até um determinado limite configurável. Esse recurso permite assimilar com sucesso todos os seus dados precisos no Experience Platform, enquanto todos os seus dados incorretos são armazenados em lote separadamente com informações sobre por que são inválidos.
Durante esta etapa, você pode habilitar o Fluxo de dados de amostra para limitar a assimilação de dados e evitar custos adicionais decorrentes da assimilação de todos os dados históricos, incluindo identidades de pessoa.
Guia rápido sobre como usar o fluxo de dados de exemplo
O fluxo de dados de exemplo é uma configuração que você pode definir para seu fluxo de dados Marketo para limitar sua taxa de assimilação e, em seguida, experimentar recursos de Experience Platform sem precisar assimilar grandes quantidades de dados.
- Ative o fluxo de dados de amostra para limitar os dados históricos, assimilando até 100 mil (da maior ID de registro) registros ou até os últimos 10 dias de atividade durante o trabalho de preenchimento retroativo.
- Ao usar a configuração de fluxo de dados de amostra para todas as entidades B2B, você deve considerar que é possível que alguns registros relacionados possam estar ausentes, pois todo o histórico dos dados de origem não é assimilado.
Além disso, se estiver assimilando dados do conjunto de dados das empresas, você pode habilitar Excluir contas não solicitadas para excluir contas não solicitadas da assimilação.
Quando indivíduos preenchem um formulário, Marketo cria um registro de conta fantasma com base no Nome da Empresa que não contém outros dados. Para novos fluxos de dados, a alternância para excluir contas não solicitadas é habilitada por padrão. Para fluxos de dados existentes, você pode ativar ou desativar o recurso, com alterações aplicáveis a dados recém-assimilados e a dados não existentes.
Mapear os campos de origem do conjunto de dados Marketo para campos XDM de destino
A etapa Mapeamento é exibida, fornecendo uma interface para mapear os campos de origem do esquema de origem para os campos XDM de destino apropriados no esquema de destino.
Cada conjunto de dados Marketo tem suas próprias regras de mapeamento específicas a serem seguidas. Consulte o seguinte para obter mais informações sobre como mapear conjuntos de dados do Marketo para XDM:
Com base nas suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem para derivar valores calculados ou calculados. Para obter etapas abrangentes sobre como usar a interface de mapeamento, consulte o guia da interface de Preparo de Dados.
Quando os conjuntos de mapeamento estiverem prontos, selecione Avançar e aguarde alguns minutos para criar o novo fluxo de dados.
Revisar seu fluxo de dados
A etapa Revisão é exibida, permitindo que você revise seu novo fluxo de dados antes de ele ser criado. Os detalhes são agrupados nas seguintes categorias:
- Conexão: mostra o tipo de origem, o caminho relevante da entidade de origem escolhida e a quantidade de colunas nessa entidade de origem.
- Atribuir campos de conjunto de dados e mapa: mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados pertence.
Depois de revisar o fluxo de dados, selecione Salvar e assimilar e aguarde algum tempo para que o fluxo de dados seja criado.
Monitorar seu fluxo de dados
Depois que o fluxo de dados for criado, você poderá monitorar os dados que estão sendo assimilados por meio dele para ver informações sobre taxas de assimilação, sucesso e erros. Para obter mais informações sobre como monitorar fluxos de dados, consulte o tutorial sobre monitoramento de fluxos de dados na interface.
Excluir seus atributos
Os atributos personalizados em conjuntos de dados não podem ser ocultos ou removidos retroativamente. Se quiser ocultar ou remover um atributo personalizado de um conjunto de dados existente, você deverá criar um novo conjunto de dados sem esse atributo personalizado, um novo esquema XDM e configurar um novo fluxo de dados para o novo conjunto de dados criado. Você também deve desativar ou excluir o fluxo de dados original que consiste no conjunto de dados com o atributo personalizado que deseja ocultar ou remover.
Excluir seu fluxo de dados
Você pode excluir fluxos de dados que não são mais necessários ou que foram criados incorretamente usando a função Excluir disponível no espaço de trabalho Fluxos de Dados. Para obter mais informações sobre como excluir fluxos de dados, consulte o tutorial sobre exclusão de fluxos de dados na interface.
Próximas etapas
Ao seguir este tutorial, você criou com êxito um fluxo de dados para assimilar dados B2B da sua origem Marketo Engage para o Experience Platform.
Apêndice appendix
As seções a seguir fornecem diretrizes adicionais que você pode seguir ao usar a origem Marketo.
Mensagens de erro na interface error-messages
As seguintes mensagens de erro são exibidas na interface do usuário quando o Platform detecta problemas com sua configuração:
Munchkin ID não está mapeado para a organização apropriada
A autenticação será negada se seu Munchkin ID não estiver mapeado para a organização de plataforma que você está usando. Configure o mapeamento entre o Munchkin ID e sua organização usando a Marketo interface.
Identidade principal ausente
Um fluxo de dados não será salvo e assimilado se uma identidade principal estiver ausente. Verifique se existe uma identidade primária dentro do esquema XDM, antes de tentar configurar um fluxo de dados.
