Criar e configurar sequências de dados

Este documento aborda as etapas para configurar uma sequência de dados na interface.

Acesse o espaço de trabalho Sequências de dados

Você pode criar e gerenciar sequências de dados na interface da coleção de dados ou da Experience Platform selecionando Sequências de dados na navegação à esquerda.

Guia Sequências de dados na interface da coleção de dados

A guia Sequências de dados exibe uma lista de sequências de dados existentes, incluindo o nome amigável, a ID e a data da última modificação. Para exibir seus detalhes e configurar serviços, selecione o nome de uma sequência de dados.

Para revelar mais opções para uma sequência de dados específica, selecione o ícone "mais" (). Para atualizar a configuração básica da sequência de dados, selecione Editar. Para remover a sequência de dados, selecione Excluir.

Opções para editar ou excluir uma sequência de dados existente

Criar um fluxo de dados create

Para criar uma sequência de dados, selecione Nova sequência de dados.

Selecione nova sequência de dados

O fluxo de trabalho de criação de sequência de dados é exibido, iniciando na etapa de configuração. Aqui, você deve fornecer um nome e uma descrição opcional para a sequência de dados.

Se você configurar uma sequência de dados para uso no Experience Platform e também usar o SDK da Web, também deverá selecionar um esquema do Experience Data Model (XDM) baseado em eventos para representar os dados que você planeja assimilar.

Configuração básica de uma sequência de dados

Configurar localização geográfica e pesquisa de rede geolocation-network-lookup

As configurações de geolocalização e pesquisa de rede ajudam a definir o nível de granularidade dos dados geográficos e de nível de rede que você deseja coletar.

Expanda a seção Geolocalização e pesquisa de rede para definir as configurações descritas abaixo.

Tela de configuração da sequência de dados com as configurações de geolocalização e pesquisa de rede realçadas.

Configuração
Descrição
Pesquisa geográfica

Habilita pesquisas de geolocalização para as opções selecionadas com base no endereço IP do visitante. As opções disponíveis incluem:

  • País: Popula xdm.placeContext.geo.countryCode
  • Código Postal: Preenche xdm.placeContext.geo.postalCode
  • Estado/Província: Popula xdm.placeContext.geo.stateProvince
  • DMA: preenche xdm.placeContext.geo.dmaID
  • Cidade: Popula xdm.placeContext.geo.city
  • Latitude: preenche xdm.placeContext.geo._schema.latitude
  • Longitude: Preenche xdm.placeContext.geo._schema.longitude

As opções Cidade, Latitude e Longitude fornecem coordenadas com até duas casas decimais, independentemente de quais outras opções estão selecionadas. Esta é considerada granularidade no nível da cidade.

Se nenhuma opção for selecionada, as pesquisas de geolocalização serão desabilitadas. A geolocalização ocorre antes de Ofuscação de IP, o que significa que não é afetada pela configuração Ofuscação de IP.

Pesquisa de rede

Ativa pesquisas de rede para as opções selecionadas com base no endereço IP do visitante. As opções disponíveis incluem:

  • Operadora De Celular: Preenche xdm.environment.carrier
  • Domínio: Popula xdm.environment.domain
  • ISP: preenche xdm.environment.ISP
  • Tipo de Conexão: Popula xdm.environment.connectionType

Se você habilitar qualquer um dos campos acima para coleta de dados, certifique-se de definir corretamente a propriedade de matriz context ao configurar o SDK da Web.

Os campos de pesquisa de localização geográfica usam a cadeia de caracteres de matriz context "placeContext", enquanto os campos de pesquisa de rede usam a cadeia de caracteres de matriz context "environment".

Além disso, verifique se cada campo XDM desejado existe no esquema. Caso contrário, você pode adicionar o grupo de campos Environment Details fornecido por Adobe ao esquema.

Configurar pesquisa de dispositivo geolocation-device-lookup

As configurações de Pesquisa de Dispositivo permitem que você selecione as informações específicas do dispositivo que deseja coletar.

Expanda a seção Pesquisa de Dispositivo para definir as configurações descritas abaixo.

Tela de configuração da sequência de dados com as configurações de pesquisa do dispositivo realçadas.

IMPORTANT
As configurações mostradas na tabela abaixo são mutuamente exclusivas. Você não pode selecionar as informações do agente do usuário e dados de pesquisa do dispositivo ao mesmo tempo.
Configuração
Descrição
Manter cabeçalhos de agente do usuário e dicas do cliente
Selecione esta opção para coletar apenas as informações armazenadas na sequência de agente do usuário. Essa configuração é selecionada por padrão. Popula xdm.environment.browserDetails.userAgent
Use a pesquisa de dispositivo para coletar as seguintes informações

Selecione esta opção se quiser coletar uma ou mais das seguintes informações específicas do dispositivo:

  • Informações sobre Dispositivo:

    • Fabricante do dispositivo: preenche xdm.device.manufacturer
    • Modelo do dispositivo: preenche xdm.device.modelNumber
    • Nome do marketing: preenche xdm.device.model
  • Informações de Hardware:

    • Tipo de hardware: preenche xdm.device.type
    • Altura de exibição: preenche xdm.device.screenHeight
    • Largura de exibição: preenche xdm.device.screenWidth
    • Intensidade de cor de exibição: preenche xdm.device.colorDepth
  • Informações de Navegador:

    • Fornecedor do navegador: preenche xdm.environment.browserDetails.vendor
    • Nome do navegador: preenche xdm.environment.browserDetails.name
    • Versão do navegador: preenche xdm.environment.browserDetails.version
  • Informações sobre Sistema operacional:

    • Fornecedor do sistema operacional: preenche xdm.environment.operatingSystemVendor
    • Nome do sistema operacional: preenche xdm.environment.operatingSystem
    • Versão do sistema operacional: preenche xdm.environment.operatingSystemVersion

As informações de pesquisa de dispositivo não podem ser coletadas junto com o agente do usuário e as dicas do cliente. Optar por coletar informações do dispositivo desativa a coleta de agentes do usuário e dicas do cliente, e vice-versa.

Não coletar informações sobre o dispositivo
Selecione esta opção se não quiser coletar informações de pesquisa de dispositivo. Nenhum dado de dispositivo, hardware, navegador, sistema operacional, agente do usuário ou dica do cliente é coletado.

Se você habilitar qualquer um dos campos acima para coleta de dados, certifique-se de definir corretamente a propriedade de matriz context ao configurar o SDK da Web.

As informações de dispositivo e hardware usam a cadeia de caracteres de matriz "device", enquanto as informações do navegador e do sistema operacional usam a cadeia de caracteres de matriz context "environment".context

Além disso, verifique se cada campo XDM desejado existe no esquema. Caso contrário, você pode adicionar o grupo de campos Environment Details fornecido por Adobe ao esquema.

Configurar opções avançadas @advanced-options

Para revelar as opções avançadas de configuração, selecione Opções Avançadas. Aqui, você pode definir configurações adicionais de sequência de dados, como ofuscação de IP, cookies de ID primária e muito mais.

Opções de configuração avançada

IMPORTANT
Você é responsável por garantir que obteve todas as permissões, consentimentos, autorizações e autorizações necessários, exigidos pelas leis e regulamentos aplicáveis, para coletar, processar e transmitir dados pessoais, incluindo informações precisas de geolocalização.
A seleção de ofuscação do endereço IP não afeta o nível de informações de geolocalização derivadas do endereço IP e enviadas para as soluções de Adobe configuradas. As pesquisas de geolocalização devem ser limitadas ou desabilitadas separadamente.
Configuração
Descrição
Ofuscação de IP

Indica o tipo de ofuscação de IP a ser aplicada à sequência de dados. Qualquer processamento baseado no IP do cliente é afetado pela configuração de ofuscação de IP. Isso inclui todos os serviços da Experience Cloud que recebem dados de sua sequência de dados.

Opções disponíveis:

  • Nenhuma: desabilita a ofuscação de IP. O endereço IP completo do usuário é enviado por meio do fluxo de dados.

  • Parcial: para endereços IPv4, ofusca o último octeto do endereço IP do usuário. Para endereços IPv6, ofusca os últimos 80 bits do endereço.

    Exemplos:

    • ipv4: 1.2.3.4 -> 1.2.3.0
    • ipv6: 2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 2001:0db8:1345:0000:0000:0000:0000:0000
  • Completa: ofusca todo o endereço IP.

    Exemplos:

    • ipv4: 1.2.3.4 -> 0.0.0.0
    • ipv6: 2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 0:0:0:0:0:0:0:0

Impacto da ofuscação de IP em outros produtos da Adobe:

  • Adobe Target: a ofuscação de IP no nível de sequência de dados é aplicada antes da ofuscação de IP executada no Adobe Target, a todos os endereços IP presentes na solicitação. Por exemplo, se a opção de ofuscação de IP no nível de sequência de dados estiver definida como Completa e a opção de ofuscação de IP do Adobe Target estiver definida como Última ofuscação de octeto, o Adobe Target receberá um IP totalmente ofuscado. ​ Se a opção de ofuscação de IP nível de sequência de dados estiver definida como Partial e a opção de ofuscação de IP do Adobe Target estiver definida como Full, o Adobe Target receberá um IP parcialmente ofuscado e aplicará a ofuscação completa a ele. A ofuscação de IP do Adobe Target é gerenciada independentemente da sequência de dados. Consulte a documentação do Adobe Target sobre ofuscação de IP e geolocalização para obter mais detalhes.
  • Audience Manager: a configuração ofuscação de IP no nível de sequência de dados é aplicada antes da ofuscação de IP executada em Audience Manager, a todos os endereços IP presentes na solicitação. Qualquer pesquisa de geolocalização feita pelo Audience Manager é afetada pela opção de ofuscação de IP no nível da sequência de dados. Uma pesquisa de geolocalização no Audience Manager, com base em um IP totalmente ofuscado, resulta em uma região desconhecida e quaisquer segmentos baseados nos dados de geolocalização resultantes não são realizados. Consulte a documentação do Audience Manager sobre ofuscação de IP para obter mais detalhes.
  • Adobe Analytics: se a configuração de ofuscação de IP no nível de sequência de dados estiver definida como Full, a Adobe Analytics tratará o endereço IP como em branco. Isso afeta qualquer processamento do Analytics que dependa do endereço IP, como pesquisas de geolocalização e filtragem de IP. Para que o Analytics receba endereços IP não ofuscados ou parcialmente ofuscados, defina a configuração de ofuscação de IP como Parcial ou Nenhum. Endereços IP parcialmente ofuscados e não ofuscados podem ser ofuscados no Analytics. Consulte a documentação do Adobe Analytics para obter detalhes sobre como habilitar a ofuscação de IP no Analytics. Se o endereço IP estiver totalmente ofuscado e a ocorrência da página não tiver ECID nem VisitorID, o Analytics descartará a ocorrência, em vez de gerar uma ID de Fallback, que é parcialmente baseada no endereço IP.
Cookie de ID próprio
Quando habilitada, essa configuração orienta a rede de borda a buscar um cookie específico ao procurar uma ID de dispositivo primária, em vez de pesquisar esse valor no mapa de identidade.

Ao habilitar esta configuração, você deve fornecer o nome do cookie que deve armazenar a ID.
Sincronização de ID de terceiros
As sincronizações de ID podem ser agrupadas em containers para permitir que diferentes sincronizações de ID sejam executadas em momentos diferentes. Quando habilitada, essa configuração permite especificar qual container de sincronizações de ID é executado para essa sequência de dados.
ID de container de sincronização de ID de terceiros
A ID numérica do container a ser usada para a sincronização de ID de terceiros.
Substituições de ID de container
Nesta seção, é possível definir IDs adicionais de contêiner de sincronização de ID de terceiros que você pode usar para substituir o padrão.
Tipo de acesso

Define o tipo de autenticação que a rede de borda aceita para a sequência de dados.

  • Autenticação mista: quando essa opção é selecionada, a rede de borda aceita solicitações autenticadas e não autenticadas. Selecione esta opção quando desejar usar o SDK da Web ou SDK móvel juntamente com a API do servidor.
  • Somente autenticado: quando essa opção é selecionada, a rede de borda aceita somente solicitações autenticadas. Selecione essa opção quando desejar usar somente a API do servidor e quiser impedir que qualquer solicitação não autenticada seja processada pela rede de borda.
Media Analytics
Habilita o processamento de dados de rastreamento de streaming para integração de Edge Network por meio de SDKs Experience Platform ou da API do Media Edge. Saiba mais sobre o Media Analytics na documentação.

Agora, se você estiver configurando a sequência de dados para a Experience Platform, siga o tutorial em Preparo de dados para a coleção de dados para mapear seus dados em um esquema de evento da Platform antes de retornar a este guia. Caso contrário, selecione Salvar e continue para a próxima seção.

Exibir detalhes da sequência de dados view-details

Depois de configurar uma nova sequência de dados ou selecionar uma existente para exibir, a página de detalhes dessa sequência de dados é exibida. Aqui você pode encontrar mais informações sobre a sequência de dados, incluindo a ID.

Página de detalhes da sequência de dados.

Na tela de detalhes da sequência de dados, é possível adicionar serviços para habilitar recursos dos produtos da Adobe Experience Cloud aos quais você tem acesso. Também é possível editar a configuração básica da sequência de dados, atualizar as regras de mapeamento, copiar a sequência de dados ou excluí-la completamente.

Adicionar serviços a uma sequência de dados add-services

Na página de detalhes de uma sequência de dados, selecione Adicionar serviço para começar a adicionar os serviços disponíveis para essa sequência de dados.

Selecione Adicionar Serviço para continuar.

Na próxima tela, use o menu suspenso para selecionar um serviço a ser configurado para essa sequência de dados. Somente os serviços aos quais você tem acesso são mostrados nesta lista.

Selecione um serviço na lista.

Selecione o serviço desejado, preencha as opções de configuração exibidas e selecione Salvar para adicionar o serviço à sequência de dados. Todos os serviços adicionados aparecem nos detalhes da sequência de dados.

Serviços adicionados a uma sequência de dados

As subseções abaixo descrevem as opções de configuração para cada serviço.

NOTE
Cada configuração de serviço contém um botão Habilitado que é ativado automaticamente quando o serviço é selecionado. Para desabilitar o serviço selecionado para essa sequência de dados, clique no botão Habilitado novamente.

Configurações do Adobe Analytics analytics

Esse serviço controla se e como os dados são enviados para o Adobe Analytics. Consulte Enviando dados para o Adobe Analytics.

Configurações de sequência de dados do Adobe Analytics.

Configuração
Descrição
ID de conjunto de relatórios
(Obrigatório) A ID do conjunto de relatórios do Analytics para o qual você deseja enviar dados. Essa ID pode ser encontrada na interface do Adobe Analytics em Admin > Conjuntos de relatórios. Se vários conjuntos de relatórios forem especificados, os dados serão copiados para cada um deles.
Namespace de ID do visitante
(Opcional) O namespace que você deseja usar para a Adobe Analytics visitorID. Ao enviar um evento com um valor especificado para esse namespace, ele será usado automaticamente como o visitorID no Analytics.
Substituições do conjunto de relatórios
Nesta seção, você pode adicionar outras IDs de conjunto de relatórios que podem ser usadas para substituir a padrão.

Configurações do Adobe Audience Manager audience-manager

Esse serviço controla se e como os dados são enviados para o Adobe Audience Manager. Tudo o que é necessário para enviar dados ao Audience Manager é habilitar esta seção. As outras configurações são opcionais, mas são incentivadas.

configurações de fluxo de dados do Adobe Audience Manager.

Configuração
Descrição
Destinos de cookies habilitados
Permite que o SDK compartilhe informações de segmento por meio dos destinos de cookies do Audience Manager.
Destinos de URL habilitados
Permite que o SDK compartilhe informações de segmento por meio dos destinos de URL do Audience Manager.

Configurações da Adobe Experience Platform aep

IMPORTANT
Ao habilitar uma sequência de dados para a Platform, observe a sandbox da Platform que você está usando no momento, conforme exibida na faixa superior da interface.
Sandbox selecionada
As sandboxes são partições virtuais na Adobe Experience Platform que permitem isolar os dados e as implementações de outras pessoas em sua organização. Depois que uma sequência de dados é criada, sua sandbox não pode ser alterada. Para obter mais detalhes sobre a função das sandboxes na Experience Platform, consulte a documentação das sandboxes.

Esse serviço controla se e como os dados são enviados para a Adobe Experience Platform.

Configurações de sequência de dados do Adobe Experience Platform.

Configuração
Descrição
Conjunto de dados do evento
(Obrigatório) Selecione o conjunto de dados da Platform para o qual os dados do evento de cliente serão transmitidos. Este esquema deve usar a classe XDM ExperienceEvent. Para adicionar outros conjuntos de dados, selecione Adicionar conjunto de dados do evento.
Conjunto de dados do perfil
Selecione o conjunto de dados da Platform para o qual os dados do atributo de cliente serão enviados. Este esquema deve usar a classe de perfil individual XDM.
Offer Decisioning
Habilita o Offer Decisioning para implementações do SDK da Web. Consulte o guia sobre uso do Offer Decisioning com o SDK da Web para obter mais detalhes sobre implementação.

Para obter mais informações sobre os recursos do Offer Decisioning, consulte a documentação do Adobe Journey Optimizer.
Segmentação de borda
Habilita a segmentação de borda para esta sequência de dados. Quando o SDK da Web ou a API do Servidor de Edge Network envia dados por meio de uma sequência de dados com segmentação de borda habilitada, todas as associações de público-alvo atualizadas para o perfil em questão são enviadas de volta na resposta.

Você pode usar esta opção em combinação com Destinos do Personalization para casos de uso de personalização de mesma página e próxima página por meio de destinos de borda ou Offer Decisioning.
Destinos de personalização
Ao habilitar essa opção após marcar a caixa de seleção Segmentação de borda, ela permite que a sequência de dados se conecte a destinos de personalização, como a personalização individual.

Consulte a documentação de destinos para obter etapas específicas sobre configuração de destinos de personalização.
Adobe Journey Optimizer
Habilita Adobe Journey Optimizer para esta sequência de dados.

Habilitar essa opção permite que a sequência de dados retorne conteúdo personalizado de campanhas de entrada baseadas na Web e em aplicativos no Adobe Journey Optimizer. Esta opção exige que a Segmentação de borda esteja ativa. Se a Segmentação do Edge estiver desmarcada, essa opção ficará esmaecida.

Configurações do Adobe Target target

Esse serviço controla se e como os dados são enviados para o Adobe Target.

Configurações de sequência de dados do Adobe Target.

Configuração
Descrição
Token de propriedade
Target permite que os clientes controlem permissões usando propriedades. Para obter mais informações sobre propriedades, consulte o guia de configuração de permissões empresariais na documentação do Target.

O token de propriedade pode ser encontrado na interface do Adobe Target em Configuração > Propriedades.
ID de ambiente do Target
Os ambientes do Adobe Target ajudam você a gerenciar a implementação em todos os estágios de desenvolvimento. Essa configuração especifica qual ambiente você usará com essa sequência de dados.

A prática recomendada é definir isso de forma diferente para cada um dos ambientes de dev, stage e prod da sequência de dados, a fim de simplificar as coisas. No entanto, se você já tiver ambientes do Adobe Target definidos, poderá usá-los.
Namespace da ID de terceiros do Target
O namespace de identidade do mbox3rdPartyId que você deseja usar para esta sequência de dados. Se você usar uma integração do Customer Attributes com o Adobe Target ou usar o thirdPartyId para atualizar ou criar perfis por meio da API de Perfis do Adobe Target, deverá fornecer um valor de namespace de sua escolha. Você deve usar esse namespace na seção IdentityMap do esquema XDM para enviar o customerID ou thirdPartyId usado em seus carregamentos de arquivo de Atributos do cliente ou em suas chamadas de API de Atualização de perfil. Consulte o guia de implementação do mbox3rdPartyId com o SDK da Web para obter mais informações.
Substituições do token de propriedade
Nesta seção, você pode definir tokens de propriedade adicionais que podem ser usados para substituir o padrão.

Configurações de encaminhamento de eventos

Este serviço controla se e como os dados são enviados para o encaminhamento de eventos.

Seção de encaminhamento de eventos da tela de configuração da sequência de dados.

Configuração
Descrição
Propriedade de inicialização
(Obrigatório) A propriedade de encaminhamento de eventos para a qual você deseja enviar dados.
Ambiente de inicialização
(Obrigatório) O ambiente na propriedade selecionada para o qual você deseja enviar dados.
NOTE
É possível selecionar a opção Inserir IDs manualmente para digitar os nomes da propriedade e do ambiente em vez de usar os menus suspensos.

Copiar uma sequência de dados copy

É possível criar uma cópia de uma sequência de dados existente e alterar seus detalhes conforme necessário.

NOTE
As sequências de dados só podem ser copiadas na mesma sandbox. Em outras palavras, não é possível copiar uma sequência de dados de uma sandbox para outra.

Na página principal do espaço de trabalho Sequências de dados, clique no ícone de reticências () da sequência de dados em questão e selecione Copiar.

Imagem mostrando a opção Copiar selecionada na exibição de lista da sequência de dados.

Como alternativa, você pode selecionar Copiar sequência de dados na exibição de detalhes de uma determinada sequência de dados.

Opção de cópia sendo selecionada na exibição de detalhes da sequência de dados.

Uma caixa de diálogo de confirmação é exibida, solicitando que você forneça um nome exclusivo para a nova sequência de dados a ser criada, juntamente com detalhes sobre as opções de configuração que serão copiadas. Quando tudo estiver pronto, selecione Copiar.

Caixa de diálogo de confirmação para copiar uma sequência de dados.

A página principal do espaço de trabalho Sequências de dados será exibida novamente com a nova sequência de dados listada.

Próximas etapas

Este manual abordou como gerenciar sequências de dados na interface da coleção de dados. Para obter mais informações sobre como instalar e configurar o SDK da Web após configurar uma sequência de dados, consulte o Manual da coleção de dados E2E.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac