Criar um esquema do XDM

Última atualização: 5 de maio de 2025
  • Tópicos:

Criado para:

  • Iniciante
  • Intermediário
  • Desenvolvedor

Saiba como criar um esquema XDM para eventos de aplicativos móveis.

A padronização e a interoperabilidade são os principais conceitos por trás da Adobe Experience Platform. O Experience Data Model (XDM), orientado pelo Adobe, é um esforço para padronizar os dados de experiência do cliente e definir esquemas para o gerenciamento da experiência do cliente.

O que são esquemas XDM?

O XDM é uma especificação documentada publicamente projetada para melhorar o potencial das experiências digitais. Ela fornece estruturas e definições comuns que permitem que qualquer aplicativo se comunique com os serviços da plataforma. Seguindo os padrões XDM, todos os dados de experiência do cliente podem ser incorporados a uma representação comum que pode fornecer insights de maneira mais rápida e integrada. Você obtém insights valiosos das ações do cliente, define públicos do cliente por meio de segmentos e usa atributos do cliente para fins de personalização.

O Experience Platform usa esquemas para descrever a estrutura dos dados de forma consistente e reutilizável. Ao definir os dados de forma consistente em todos os sistemas, fica mais fácil manter o significado e, portanto, obter valor dos dados.

Antes que os dados possam ser assimilados na Platform, um esquema deve ser composto para descrever a estrutura dos dados e fornecer restrições ao tipo de dados que podem estar contidos em cada campo. Os esquemas consistem em uma classe base e zero ou mais grupos de campos de esquema.

Para obter mais informações sobre o modelo de composição de esquema, incluindo princípios de design e práticas recomendadas, consulte as noções básicas da composição de esquema ou a lista de reprodução Modelar os dados de experiência do cliente com o XDM.

DICA
Se você estiver familiarizado com a Referência de design de solução (SDRs) do Analytics, poderá considerar um esquema como um SDR mais robusto. Consulte Criar e manter um Documento de Referência de Design de Solução (SDR) para obter mais informações.

Pré-requisitos

Para concluir a lição, você deve ter permissão para criar um esquema de Experience Platform.

Objetivos de aprendizagem

Nesta lição, você vai:

  • Criar um esquema na interface da Coleção de dados
  • Adicionar um grupo de campos padrão ao esquema
  • Criar e adicionar um grupo de campos personalizado ao esquema

  1. Faça logon na Adobe Experience Cloud.

  2. Verifique se você está na sandbox do Experience Platform que está usando para este tutorial.

  3. Abra o alternador de aplicativos Alternador de aplicativos (na parte superior direita),

  4. Selecione Coleção de dados no menu.

    Logon no Experience Cloud

    OBSERVAÇÃO
    Os clientes de aplicativos baseados em plataforma, como o Real-Time CDP, devem usar uma sandbox de desenvolvimento para este tutorial. Outros clientes usam a sandbox de produção padrão.

  5. Selecione Esquemas em Gerenciamento de dados no painel esquerdo.

    tela inicial das marcas

Agora você está na página principal de esquemas e uma lista dos esquemas existentes é apresentada a você. Você também pode ver guias correspondentes aos blocos de construção principais de um schema:

  • Grupos de campos são componentes reutilizáveis que definem um ou mais campos para capturar dados específicos, como detalhes pessoais, preferências de hotel ou endereço.
  • Classes definem os aspectos comportamentais dos dados que o esquema contém. Por exemplo: XDM ExperienceEvent captura séries temporais, dados de evento e XDM Individual Profile captura dados de atributo sobre um indivíduo.
  • Os tipos de dados são usados como tipos de campo de referência em classes ou grupos de campos da mesma forma que os campos literais básicos.

As descrições acima são uma visão geral de alto nível. Para obter mais detalhes, consulte o vídeo Blocos de construção de esquema ou leia Noções básicas sobre a composição de esquema na documentação do produto.

Neste tutorial, você usa o grupo de campos Evento de experiência do consumidor e cria um personalizado para demonstrar o processo.

OBSERVAÇÃO
O Adobe continua a adicionar mais grupos de campos padrão e eles devem ser usados sempre que possível, pois esses campos são implicitamente compreendidos pelos serviços do Experience Platform e fornecem maior consistência quando usados nos componentes da plataforma. O uso de grupos de campo padrão fornece benefícios tangíveis, como o mapeamento automático nos recursos do Analytics e IA na Platform.

Arquitetura de esquema do aplicativo Luma

Em um cenário real, o processo de design do schema pode ser semelhante a:

  • Colete os requisitos de negócios.
  • Localize grupos de campos pré-criados para atender ao máximo de requisitos possível.
  • Crie grupos de campos personalizados para qualquer lacuna.

Para fins de aprendizado, você usa grupos de campos pré-criados e personalizados.

  • Evento de experiência do consumidor: grupo de campos pré-criado que tem muitos campos comuns.
  • Informações do aplicativo: grupo de campos personalizado criado para imitar os conceitos do TrackState/TrackAction Analytics.

Criar um esquema

  1. Selecione Criar Esquema.

  2. Na etapa Selecionar uma classe do assistente Criar esquema, selecione Evento de experiência abaixo de Selecione uma classe base para este esquema.

  3. Selecione Próximo.

    Classe base do Assistente de Esquema

  4. Na etapa Nome e revisão do assistente Criar esquema, insira um Nome para exibição do esquema, por exemplo Luma Mobile Event Schema e uma Descrição, por exemplo Schema for Luma mobile app experience events.

    OBSERVAÇÃO
    Se você estiver assistindo a este tutorial com várias pessoas em uma única sandbox ou se estiver usando uma conta compartilhada, considere anexar ou anexar uma identificação como parte de suas convenções de nomenclatura. Por exemplo, em vez de Luma Mobile App Event Schema, use Luma Mobile App Event Schema - Joe Smith. Consulte também a observação em Visão geral.

  5. Selecione Concluir para concluir o assistente.

    Nome e revisão do esquema

  6. Selecione Mais Adicionar ao lado de Grupos de campos.

    Adicione um grupo de campos

  7. Pesquisar por Consumer Experience Event.

  8. Selecione Visualizar para visualizar os campos e/ou ler a descrição para obter mais detalhes antes de selecionar um grupo de campos.

  9. Selecione Evento de experiência do consumidor.

  10. Selecione Adicionar grupos de campos.

    Selecionando grupo de campos

    Você é redirecionado à tela principal de composição do esquema, onde é possível ver todos os campos disponíveis.

  11. Selecione Salvar.

OBSERVAÇÃO
Lembre-se de que não é necessário usar todos os campos em um grupo. Também é possível remover campos para ajudar a manter o esquema conciso e compreensível. Se for útil, você pode considerar um esquema como uma camada de dados vazia. No aplicativo, você preenche os valores relevantes no momento apropriado.

O grupo de campos Evento de Experiência do Consumidor tem um tipo de dados chamado Informações da Web, que descreve eventos como exibição de página e cliques em links. No momento da escrita, não há uma paridade de aplicativo móvel para este recurso, portanto, você vai criar o seu próprio.

Criar um tipo de dados personalizado

Você começa criando um tipo de dados personalizado que descreve os dois eventos:

  • Exibição de tela
  • Interação do aplicativo

  1. Selecione a guia Tipos de dados.

  2. Selecione Criar tipo de dados.

    Selecionar menu de tipo de dados

  3. Forneça um Nome de exibição e uma Descrição, por exemplo App Information e Custom data type describing "Screen Views" & "App Actions"

    Fornecendo nome e descrição

    DICA
    Sempre use nomes para exibição descritivos e legíveis para seus campos personalizados, pois essa prática os torna mais acessíveis aos profissionais de marketing quando os campos são exibidos em serviços downstream, como o construtor de segmentos.

  4. Para adicionar um campo, selecione o botão De adição .

  5. Este campo é um objeto de contêiner para interação com o aplicativo, portanto, forneça um camel-case Nome do campo appInteraction, Nome de exibição App Interaction e selecione Object na lista Tipo.

  6. Selecione Aplicar.

    Adicionando novo evento de ação do aplicativo

  7. Para medir com que frequência uma ação ocorreu, adicione um campo selecionando o botão Mais ao lado do objeto appInteraction que você criou.

  8. Dê a ele um camel-case Nome do campo appAction, Nome de exibição de App Action e Tipo Measure.

    Esta etapa seria equivalente a um evento bem-sucedido no Adobe Analytics.

  9. Selecione Aplicar.

    Adicionando campo de nome da ação

  10. Adicione um campo descrevendo o tipo de interação selecionando o botão Plus ao lado do objeto appInteraction.

  11. Dê a ele um Nome do campo name, Nome de exibição de Name e Tipo String.

    Esta etapa é equivalente a uma dimensão no Adobe Analytics.

    Selecionando aplicar

  12. Role para baixo do painel direito e selecione Aplicar.

  13. Para criar um objeto appStateDetails contendo um campo Measure chamado screenView e dois campos String chamados screenName e screenType, siga as mesmas etapas usadas ao criar o objeto appInteraction.

  14. Selecione Salvar.

    Estado final do tipo de dados