Criar uma conexão de origem e um fluxo de dados Marketo Engage para dados de atividade personalizados na interface
Além das atividades padrão, você também pode usar a fonte Marketo para trazer dados de atividades personalizadas para a Adobe Experience Platform. Este documento fornece etapas sobre como criar uma conexão de origem e um fluxo de dados para dados de atividade personalizados usando a origem Marketo na interface.
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.
Recupere os detalhes de sua atividade personalizada
A primeira etapa para trazer dados de atividade personalizados do Marketo para o Experience Platform é recuperar o nome da API e o nome de exibição da sua atividade personalizada.
Faça logon em sua conta usando a interface Marketo. Na navegação à esquerda, em Database Management, selecione Atividades personalizadas do Marketo.
A interface é atualizada para uma exibição de suas atividades personalizadas, incluindo informações sobre seus respectivos nomes de exibição e nomes de API. Você também pode usar o painel direito para selecionar e exibir outras atividades personalizadas da sua conta.
Selecione Campos no cabeçalho superior para exibir os campos associados à sua atividade personalizada. Nesta página, você pode exibir os nomes, os nomes das APIs, as descrições e os tipos de dados dos campos na atividade personalizada. Detalhes sobre campos individuais serão usados em uma etapa posterior, ao criar um esquema.
Configurar grupos de campos para atividades personalizadas no esquema de atividades B2B
No painel Esquemas da interface do usuário do Experience Platform, selecione Procurar e selecione Atividade B2B da lista de esquemas.
Criar um novo grupo de campos para uma atividade personalizada
Em seguida, adicione um novo grupo de campos ao esquema B2B Activity. Este grupo de campos deve corresponder à atividade personalizada que você deseja assimilar e deve usar o nome para exibição da atividade personalizada que você recuperou anteriormente.
Para adicionar um novo grupo de campos, selecione + Adicionar ao lado do painel Grupos de campos em Composição.
A janela Adicionar grupos de campos é exibida. Selecione Criar novo grupo de campos e forneça o mesmo nome para exibição para a atividade personalizada que você recuperou em uma etapa anterior e forneça uma descrição opcional para seu novo grupo de campos. Quando terminar, selecione Adicionar grupos de campos.
Depois de criado, seu novo grupo de campos para atividade personalizada aparece no catálogo Grupos de campos.
Adicionar um novo campo à estrutura do esquema
Em seguida, adicione um novo campo ao esquema. Este novo campo deve ser definido como type: object e conterá os campos individuais da atividade personalizada.
Para adicionar um novo campo, selecione o sinal de adição (+) ao lado do nome do esquema. Uma entrada para Campo sem título | Tipo é exibido. Em seguida, configure as propriedades do campo usando o painel Propriedades do campo. Defina o nome do campo como o nome da API da atividade personalizada e defina o nome de exibição como o nome de exibição da atividade personalizada. Em seguida, defina o tipo como object e atribua o grupo de campos ao grupo de campos de atividade personalizado criado na etapa anterior. Quando terminar, selecione Aplicar.
O novo campo aparece no esquema.
Adicionar subcampos ao campo de objeto add-sub-fields-to-the-object-field
A última etapa na preparação do esquema é adicionar campos individuais dentro do campo criado na etapa anterior.
Criar um fluxo de dados
Com a configuração do esquema concluída, agora é possível prosseguir para criar um fluxo de dados para seus dados de atividade personalizados.
Na interface da Platform, selecione Fontes na barra de navegação esquerda para acessar o espaço de trabalho Fontes. A tela 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.
Na categoria Adobe applications, selecione Marketo Engage. Em seguida, selecione Adicionar dados para criar um novo fluxo de dados Marketo.
Selecionar dados
Selecione Atividades da lista de Marketo conjuntos de dados e selecione Próximo.
Detalhes do fluxo de dados
Em seguida, forneça informações para o fluxo de dados, incluindo nomes e descrições para o conjunto de dados e o fluxo de dados, o esquema que você usará e as configurações para assimilação Profile, diagnóstico de erros e assimilação parcial.
Mapeamento
Os mapeamentos para campos de atividade padrão são preenchidos automaticamente, mas os campos de atividade personalizados devem ser mapeados manualmente para os campos de destino correspondentes.
Para começar a mapear os campos de atividade personalizados, selecione Novo tipo de campo e Adicionar novo campo.
Navegue pela estrutura de dados de origem e localize o campo de atividade personalizado que você deseja assimilar. Quando terminar, selecione Selecionar.
Para adicionar um campo de destino, selecione o ícone de esquema
Repita as etapas para adicionar o restante dos campos de mapeamento de atividade personalizados. Quando terminar, selecione Próximo.
Revisar
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.
Adicionar atividades personalizadas a um fluxo de dados de atividades existente add-to-existing-dataflows
Para adicionar dados de atividade personalizados a um fluxo de dados existente, modifique os mapeamentos de um fluxo de dados de atividades existente com os dados de atividade personalizados que deseja assimilar. Isso permite assimilar atividades personalizadas no mesmo conjunto de dados de atividades existente. Para obter mais informações sobre como atualizar os mapeamentos de um fluxo de dados existente, leia o manual sobre atualização de fluxos de dados na interface.
Usar Query Service para filtrar atividades para atividades personalizadas query-service-filter
Depois que o fluxo de dados for concluído, você poderá usar o Serviço de consulta para filtrar atividades para seus dados de atividade personalizados.
Quando atividades personalizadas são assimiladas na Platform, o nome da API da atividade personalizada automaticamente se torna seu eventType. Use eventType={API_NAME} para filtrar por dados de atividade personalizados.
SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'
Use a cláusula IN para filtrar várias atividades personalizadas:
SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')
A imagem abaixo mostra um exemplo de instrução SQL no Editor de Consulta que filtra os dados de atividade personalizados.
Próximas etapas
Seguindo este tutorial, você configurou um esquema da Platform para Marketo dados de atividade personalizados e criou um fluxo de dados para trazer esses dados para a Platform. Para obter informações gerais sobre a origem Marketo, leia a Marketo visão geral da origem.