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

IMPORTANTE

A fonte Marketo Engage está atualmente em beta. O recurso e a documentação estão sujeitos a alterações. Além disso, é necessário garantir que você esteja usando uma sandbox de não produção ao usar o conector durante o programa beta. Para obter mais informações sobre sandboxes, consulte a documentação sobre sandboxes.

Este tutorial fornece etapas para criar um conector de origem Marketo Engage (a seguir chamado "Marketo") na interface do usuário para trazer dados do consumidor para o 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.
  • Modelo de dados de experiência (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 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 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 sua conta Marketo no Platform, você deve fornecer os seguintes valores:

Credencial Descrição
munchkinId A ID do Munchkin é o identificador exclusivo de uma instância Marketo específica.
clientId A ID de cliente exclusiva da sua instância Marketo.
clientSecret O segredo de cliente exclusivo da sua instância Marketo.

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

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

Conecte sua conta Marketo

Na interface do usuário da plataforma, selecione Sources na barra de navegação esquerda para acessar o espaço de trabalho Sources. A tela Catalog 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.

Na categoria Adobe applications, selecione Marketo Engage. Em seguida, selecione Add data para criar um novo fluxo de dados Marketo.

catálogo

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

Nova conta

Se estiver criando uma nova conta, selecione New account. No formulário de entrada exibido, forneça um nome de conta, uma descrição opcional e suas credenciais de autenticação Marketo. Quando terminar, selecione Connect to source e aguarde algum tempo para que a nova conexão seja estabelecida.

nova conta

Conta existente

Para criar um fluxo de dados com uma conta existente, selecione Existing account e selecione a conta Marketo que deseja usar. Selecione Next para continuar.

existente

Selecionar um conjunto de dados

Depois de criar sua conta 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 os 10 conjuntos de dados Marketo. Uma conexão de origem Marketo que funcione totalmente requer a assimilação dos nove conjuntos de dados diferentes. Se você também estiver usando o recurso de Marketo marketing baseado em conta (ABM), também deverá criar um 10º fluxo de dados para assimilar o conjunto de dados Named Accounts.

OBSERVAÇÃO

Por motivos de brevidade, o tutorial a seguir usa Named Accounts como exemplo, mas as etapas descritas abaixo se aplicam a qualquer um dos 10 conjuntos de dados Marketo.

Selecione o conjunto de dados que deseja assimilar primeiro e selecione Next.

select-data

Mapear esquemas Marketo para a plataforma

A etapa Mapping é exibida, fornecendo uma interface para mapear Marketo esquemas para a Plataforma.

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 Existing dataset e selecione o ícone do conjunto de dados.

conjunto de dados existente

A caixa de diálogo Select dataset é exibida. Encontre o conjunto de dados com o schema apropriado que deseja usar, selecione-o e, em seguida, selecione Confirm.

select-existing-dataset

Usar um novo conjunto de dados

Para assimilar dados em um novo conjunto de dados, selecione New dataset 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 barra de pesquisa Select schema. Você também pode selecionar o ícone suspenso para ver uma lista de schemas existentes. Como alternativa, você pode selecionar Advanced search para acessar a página de esquemas existentes, incluindo seus respectivos detalhes.

Alterne o botão Profile dataset para ativar o conjunto de dados de destino para Profile, permitindo criar uma exibição holística dos atributos e comportamentos de uma entidade. Os dados de todos os conjuntos de dados habilitados para Profile serão incluídos em Profile e as alterações serão aplicadas quando você salvar 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 os campos do conjunto de dados Marketo para os campos XDM de destino apropriados.

Mapear os campos de origem do conjunto de dados Marketo para campos XDM 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 Marketo para XDM:

Selecione Preview data para ver os resultados do mapeamento com base no conjunto de dados selecionado.

mapeamento

A Preview janela fornece uma interface para explorar os resultados do mapeamento de até 100 linhas de dados de amostra do conjunto de dados selecionado.

visualização

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

Fornecer detalhes do fluxo de dados

A etapa Dataflow detail é exibida, permitindo que você forneça um nome e uma breve descrição sobre o novo fluxo de dados.

detalhe do fluxo de dados

Ative a opção Error diagnostics para permitir a geração detalhada de mensagens de erro para lotes recém-assimilados, que pode ser baixada usando a API . Para obter mais informações, consulte o tutorial em recuperar diagnósticos de erro de assimilação de dados.

erros

O conector Marketo 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 botão Partial ingestion e defina o Error threshold % como máximo para impedir que o fluxo de dados falhe.

Partial ingestion O oferece a capacidade de assimilar dados que contenham erros até um determinado limite. Para obter mais informações, consulte a 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 Next.

ingestão parcial

Revisar o fluxo de dados

A etapa Review é exibida, permitindo que você revise o novo fluxo de dados antes de ele ser criado. Os detalhes são agrupados nas seguintes categorias:

  • Connection: Mostra o tipo de origem, o caminho relevante da entidade de origem escolhida e a quantidade de colunas dentro dessa entidade de origem.
  • Assign dataset & map fields: 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 Finish e aguarde algum tempo para 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 monitorando 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

Você pode excluir fluxos de dados que não são mais necessários ou foram criados incorretamente usando a função Delete disponível no espaço de trabalho Dataflows. Para obter mais informações sobre como excluir fluxos de dados, consulte o tutorial em excluir fluxos de dados na interface do usuário.

Próximas etapas

Ao seguir este tutorial, você criou com êxito 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

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now