Criar um Marketo Engage conexão de origem e fluxo de dados na interface do

IMPORTANT
Antes de criar uma Marketo Engage conexão de origem e um fluxo de dados, primeiro verifique se você tem ID da organização do Adobe mapeada in Marketo. Além disso, você também deve garantir que concluiu preenchimento automático Marketo Namespaces e esquemas B2B antes de criar uma conexão de origem e um fluxo de dados.

Este tutorial fornece etapas para a criação de um Marketo Engage (a seguir designado por "Marketo") conector de origem na interface do 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 automaticamente valores para seus namespaces e esquemas B2B. Você deve concluir os namespaces e esquemas B2B primeiro, antes de criar um Marketo conexão de origem e fluxo de dados.
  • Origens: 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.
  • Namespaces de identidade: os namespaces de identidade são um componente de Identity Service que servem 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 seu Marketo conta no Experience Platform, você deve fornecer os seguintes valores:

Credencial
Descrição
munchkinId
A ID do Munchkin é o identificador exclusivo de um Marketo instância.
clientId
A ID exclusiva do cliente do Marketo instância.
clientSecret
O segredo exclusivo do cliente do Marketo instância.

Para 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.

Conecte seu Marketo account

Na interface do usuário da Platform, selecione Origens na navegação à esquerda, para acessar a Origens espaço de trabalho. 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.

No aplicativos Adobe categoria, selecione Marketo Engage e selecione Adicionar dados.

TIP
As origens no catálogo de origens exibem a variável Configurar opção quando uma determinada fonte ainda não tiver uma conta autenticada. Quando uma conta autenticada existir, essa opção será alterada para Adicionar dados.

O catálogo de origens com a origem de Marketo Engage selecionada.

A variável Conectar conta Marketo Engage é exibida. Nesta página, você pode usar uma nova conta ou acessar uma conta existente.

Criar uma nova conta

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 estabelecer a nova conexão.

A nova interface de conta para autenticar uma nova conta do Marketo.

Usar uma conta existente

Para usar uma conta existente, selecione Conta existente e selecione a conta que deseja usar no catálogo de contas existente.

Selecione Próximo para continuar.

A interface de conta existente, onde é possível selecionar uma conta existente do Marketo.

Selecionar um conjunto de dados

Depois de criar o Marketo conta, a próxima etapa fornece uma interface para você explorar Marketo conjuntos de dados.

A metade esquerda da interface é um navegador de diretórios, exibindo as 10 Marketo conjuntos de dados. Um sistema de Marketo a conexão de origem requer a assimilação dos nove conjuntos de dados diferentes. Se você também estiver usando a variável Marketo de marketing baseado em conta (ABM), você também deverá criar um 10º fluxo de dados para assimilar a Contas Nomeadas conjunto de dados.

NOTE
Para fins de brevidade, o tutorial a seguir usa Oportunidades exemplo, mas as etapas descritas abaixo aplicam-se a qualquer um dos 10 Marketo conjuntos de dados.

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óxima.

A interface de visualização

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.

Usar um novo conjunto de dados

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.

A nova interface de seleção do conjunto de dados.

Usar um conjunto de dados existente

Se você já tiver um conjunto de dados, selecione Conjunto de dados existente e, em seguida, use o Pesquisa avançada opção para exibir uma janela de todos os conjuntos de dados em 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.

A interface de seleção do conjunto de dados existente.

Configurações de fluxo de dados dataflow-configurations

IMPORTANT
A variável Marketo A origem usa a assimilação em lote para assimilar todos os registros históricos e a assimilação por transmissão para atualizações em tempo real. Isso permite que a origem continue a transmitir enquanto assimila registros incorretos. Ativar o Assimilação parcial alterne e defina o Limite de erro % ao máximo para evitar a falha do fluxo de dados.

Se o conjunto de dados estiver ativado para o Perfil de cliente em tempo real, durante essa etapa é possível alternar Conjunto de dados Perfil para ativar seus dados para assimilação de perfis. Você também pode usar esta etapa para habilitar Diagnóstico de erro e Assimilação parcial.

  • Diagnóstico de erro: Selecionar Diagnóstico de erro para instruir a origem a produzir diagnósticos 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 lote é 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 essa etapa, é possível ativar Fluxo de dados de exemplo limitar a assimilação de dados e evitar custos adicionais decorrentes da assimilação de todos os dados históricos, incluindo identidades de pessoa.

recommendation-more-help

Guia rápido sobre como usar amostra de fluxo de dados

A amostra de fluxo de dados é uma configuração que pode ser definida para o seu Marketo fluxo de dados para limitar a taxa de assimilação e experimentar os 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.

A seção de configurações do fluxo de dados da página de detalhes do fluxo de dados.

Além disso, se estiver assimilando dados do conjunto de dados das empresas, você pode ativar Excluir contas não solicitadas para excluir da assimilação contas não solicitadas.

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.

Excluir contas não solicitadas

Mapeie seu Marketo campos de origem do conjunto de dados para campos XDM de destino

A variável 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.

Each Marketo O conjunto de dados tem suas próprias regras de mapeamento específicas a serem seguidas. Consulte o seguinte para obter mais informações sobre como mapear Marketo conjuntos de dados 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 Guia da interface de preparação de dados.

A interface de mapeamento dos dados do Marketo.

Quando os conjuntos de mapeamento estiverem prontos, selecione Próxima e aguarde alguns instantes para que o novo fluxo de dados seja criado.

Revisar seu fluxo de dados

A variável 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 conjunto de dados e mapear campos: mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados adere.

Depois de revisar o fluxo de dados, selecione Salvar e assimilar e aguarde algum tempo para criar o fluxo de dados.

A página de revisão onde é possível confirmar os detalhes do fluxo de dados antes da assimilação.

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 do.

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

É possível excluir fluxos de dados que não são mais necessários ou que foram criados incorretamente usando o Excluir disponível na Fluxos de dados espaço de trabalho. 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 sucesso um fluxo de dados para assimilar dados B2B de suas Marketo Engage origem para Experience Platform.

Apêndice appendix

As seções a seguir fornecem diretrizes adicionais que você pode seguir ao usar o Marketo origem.

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 o Munchkin ID não está mapeado para a organização de plataforma que você está usando. Configure o mapeamento entre as Munchkin ID e sua organização usando o Marketo interface.

Uma mensagem de erro que exibe que a instância do Marketo não está mapeada corretamente para a organização Adobe.

Identidade principal ausente

Um fluxo de dados não será salvo e assimilado se uma identidade principal estiver ausente. Assegure que existe uma identidade primária em seu esquema XDM, antes de tentar configurar um fluxo de dados.

Uma mensagem de erro que exibe que a identidade principal está ausente do esquema XDM.

337b99bb-92fb-42ae-b6b7-c7042161d089