Crie um Marketo Engage conector de origem na interface do usuário

IMPORTANTE

Antes de criar um Marketo Engage conexão de origem e um fluxo de dados, primeiro verifique se você tem mapeada a ID da organização do Adobe IMS em Marketo. Além disso, você também deve garantir que tenha concluído o preencher automaticamente Marketo Espaços de nomes e esquemas B2B antes de criar uma conexão de origem e um fluxo de dados.

Este tutorial fornece etapas para criar um Marketo Engage (a seguir designado por "Marketo") conector de origem 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:

  • Namespaces B2B e utilitário de geração automática de esquema: Os namespaces B2B e o utilitário de geração automática de schema permitem usar Postman para gerar valores automaticamente para seus namespaces e esquemas B2B. Você deve concluir seus namespaces e esquemas B2B primeiro, antes de criar um Marketo conexão de origem e fluxo de dados.
  • Fontes: O Experience Platform permite que os dados sejam assimilados de várias fontes, fornecendo 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 do Identity Service que servem como indicadores do contexto a que uma identidade se refere. Uma identidade totalmente qualificada inclui um valor de ID e um namespace.
  • Real-time Customer Profile: Fornece um perfil de consumidor unificado e 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.

Obter credenciais necessárias

Para acessar o Marketo na 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 de cliente exclusiva do seu Marketo instância.
clientSecret O segredo de cliente exclusivo de seu Marketo instância.

Para obter mais informações sobre a aquisição desses valores, consulte Marketo guia de autenticação.

Depois de coletar suas credenciais necessárias, siga as etapas da próxima seção.

Conecte seu Marketo account

Na interface do usuário da plataforma, selecione Fontes na barra de navegação esquerda para acessar o Fontes espaço de trabalho. O Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.

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 barra de pesquisa.

Em Aplicativos Adobe categoria , selecione Marketo Engage. Em seguida, selecione Adicionar dados para criar um novo Marketo fluxo de dados.

catálogo

O Conta do Marketo Engage Connect será exibida. Nesta página, você pode usar uma nova conta ou acessar uma conta existente.

Conta existente

Para criar um fluxo de dados com uma conta existente, selecione Conta existente e selecione o Marketo conta que deseja usar. Selecionar Próximo para continuar.

existente

Nova conta

Se estiver criando uma nova conta, selecione Nova conta. No formulário de entrada exibido, forneça um nome de conta, uma descrição opcional e Marketo credenciais de autenticação. Quando terminar, selecione Conectar-se à origem e, em seguida, permitir que a nova conexão seja estabelecida.

novo

Selecionar um conjunto de dados

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

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

OBSERVAÇÃO

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

Selecione o conjunto de dados que deseja assimilar primeiro e, em seguida, selecione Próximo.

select-data

Fornecer detalhes do fluxo de dados

O Detalhes do fluxo de dados permite selecionar se deseja usar um conjunto de dados existente ou um novo conjunto de dados. Durante esse processo, também é possível definir as configurações para Conjunto de dados de perfil, Diagnóstico de erros, Ingestão parciale Alertas.

detalhes do fluxo de dados

Usar um conjunto de dados existente

Para assimilar dados em um conjunto de dados existente, selecione Conjunto de dados existente. Você pode recuperar um conjunto de dados existente usando o Pesquisa avançada ou percorrendo a lista de conjuntos de dados existentes no menu suspenso. Depois de selecionar um conjunto de dados, forneça um nome e uma descrição para o seu fluxo de dados.

conjunto de dados existente

Usar um novo conjunto de dados

Para assimilar em um novo conjunto de dados, selecione Novo conjunto de dados e, em seguida, forneça um nome de conjunto de dados de saída e uma descrição opcional. Em seguida, selecione um esquema para mapear usando o Pesquisa avançada ou rolando pela lista de schemas existentes no menu suspenso. Depois de selecionar um esquema, forneça um nome e uma descrição para o seu fluxo de dados.

novo conjunto de dados

Habilitar Profile e diagnóstico de erros

Em seguida, selecione o Conjunto de dados de perfil alternar para ativar o conjunto de dados para Profile. Isso permite criar uma visualização holística dos atributos e comportamentos de uma entidade. Dados de todos Profile-conjuntos de dados habilitados serão incluídos em Profile As alterações e são aplicadas quando você salva o fluxo de dados.

Diagnóstico de erros permite a geração detalhada de mensagens de erro para qualquer registro incorreto que ocorra no seu fluxo de dados, enquanto Ingestão parcial O permite assimilar dados contendo erros, até um determinado limite definido manualmente. Consulte a visão geral da ingestão parcial de lote para obter mais informações.

IMPORTANTE

O Marketo O conector usa a assimilação em lote para assimilar todos os registros históricos e usa a assimilação de streaming para atualizações em tempo real. Isso permite que o conector continue o streaming ao assimilar qualquer registro incorreto. Ative o Ingestão parcial e, em seguida, defina a Limite de erros % como máximo para impedir que o fluxo de dados falhe.

profile-and-errors

Ativar alertas

Você pode habilitar alertas para receber notificações sobre o status do seu fluxo de dados. 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, consulte o guia sobre inscrever-se em alertas de origens usando a interface do usuário.

Quando terminar de fornecer detalhes do fluxo de dados, selecione Próximo.

alertas

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

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

Com base em suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem em valores calculados ou calculados. Para obter etapas abrangentes sobre o uso da interface de mapeamento, consulte o Guia da interface do usuário de preparação de dados.

mapeamento

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

Revisar o fluxo de dados

O Revisão é exibida, permitindo que você revise o novo fluxo de dados antes de criá-lo. 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 dentro dessa 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 permitir que o fluxo de dados seja criado.

revisão

Monitorar o 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 ingestão, sucesso e erros. Para obter mais informações sobre como monitorar fluxos de dados, consulte o tutorial em monitoramento de fluxos de dados na interface do usuário.

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, será necessário 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 que você criar. 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 os fluxos de dados que não são mais necessários ou foram criados incorretamente usando o Excluir disponível na função Fluxos de dados espaço de trabalho. Para obter mais informações sobre como excluir fluxos de dados, consulte o tutorial em exclusão de fluxos de dados na interface do usuário.

Próximas etapas

Ao seguir este tutorial, você criou com sucesso um fluxo de dados para trazer Marketo dados. Os dados recebidos agora podem ser usados por serviços downstream da plataforma, como Real-time Customer Profile e Data Science Workspace. Consulte os seguintes documentos para obter mais detalhes:

Nesta página