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

This tutorial provides steps for creating a Marketo Engage (hereinafter referred to as "Marketo") source connector in the UI to bring B2B data into Adobe Experience Platform.

Introdução

Este tutorial requer uma compreensão funcional dos seguintes componentes do Adobe Experience Platform:

  • 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): The standardized framework by which Experience Platform organizes customer experience data.
  • Identity namespaces: Identity namespaces are a component of Identity Service that serve as indicators of the context to which an identity relates. Uma identidade totalmente qualificada inclui um valor de ID e um namespace.
  • Real-time Customer Profile: Provides a unified, real-time consumer profile based on aggregated data from multiple sources.
  • 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.

Gather required credentials

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.

For more information on acquiring these values, refer to the Marketo authentication guide.

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 Ligar ao Marketo Engage será exibida. Nesta página, você pode usar uma nova conta ou acessar uma conta 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. When finished, select Connect to source and then allow some time for the new connection to establish.

nova conta

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

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 Contas Nomeadas 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

Map Marketo schemas to Platform

O Mapeamento é exibida, fornecendo uma interface para mapear Marketo esquemas para a Platform.

Escolha um conjunto de dados para os dados de entrada que serão assimilados. Você pode usar um conjunto de dados existente ou criar um novo conjunto de dados.

Usar um conjunto de dados existente

Para assimilar dados em um conjunto de dados existente, selecione Conjunto de dados existente e selecione o ícone do conjunto de dados.

conjunto de dados existente

O Selecionar conjunto de dados será exibida. Find the dataset with the appropriate schema you wish to use, select it, then select Confirm.

select-existing-dataset

Usar um novo conjunto de dados

Para assimilar dados em um novo conjunto de dados, selecione Novo conjunto de dados e insira um nome e uma descrição para o conjunto de dados nos campos fornecidos.

Você pode procurar um esquema inserindo seu nome na variável Selecionar esquema barra de pesquisa. Você também pode selecionar o ícone suspenso para ver uma lista de schemas existentes. Como alternativa, você pode selecionar Pesquisa avançada para acessar a página dos esquemas existentes, incluindo seus respectivos detalhes.

Ative o Conjunto de dados de perfil para ativar seu conjunto de dados de destino para Profile, permitindo 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.

create-new-dataset

Depois de selecionar um esquema, role para baixo para exibir a caixa de diálogo de mapeamento para começar a mapear Marketo campos do conjunto de dados para seus campos XDM de destino apropriados.

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

Each Marketo dataset has its own specific mapping rules to follow. See the following for more information on how to map Marketo datasets to XDM:

Select Preview data to see mapping results based on your selected dataset.

mapping

The Preview popover provides you an interface to explore mapping results of up to 100 rows of sample data from the selected dataset.

preview

Depois que os campos de origem forem mapeados para os campos de destino apropriados, selecione Fechar.

Fornecer detalhes do fluxo de dados

The Dataflow detail step appears, allowing you to provide a name and a brief description about your new dataflow.

detalhe do fluxo de dados

Ative o Diagnóstico de erros alternar para permitir a geração detalhada de mensagens de erro para lotes recém-assimilados, que podem ser baixados usando a API. Para obter mais informações, consulte o tutorial em recuperação de diagnósticos de erros de assimilação de dados.

erros

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.

Ingestão parcial O oferece a capacidade de assimilar dados que contenham erros até um determinado limite. Para obter mais informações, consulte o visão geral da ingestão parcial de lote.

Depois de fornecer os detalhes do fluxo de dados e definir o limite de erro como máximo, selecione Próximo.

ingestão parcial

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 Concluir 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