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 os detalhes e configurar serviços, selecione o nome de um fluxo de dados.

Para revelar mais opções para um determinado fluxo de dados, selecione o ícone "mais" (). Para atualizar o configuração básica para o fluxo de dados, selecione Editar. Para remover o fluxo 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 um fluxo 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 Localização geográfica e pesquisa de rede para definir as configurações descritas abaixo.

Tela de configuração de 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: Popula xdm.placeContext.geo.postalCode
  • Estado/Província: Popula xdm.placeContext.geo.stateProvince
  • DMA: Popula xdm.placeContext.geo.dmaID
  • Cidade: Popula xdm.placeContext.geo.city
  • Latitude: Popula xdm.placeContext.geo._schema.latitude
  • Longitude: Popula 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. Essa é considerada granularidade no nível da cidade.

Não selecionar nenhuma opção desativa pesquisas de geolocalização. A geolocalização ocorre antes de Ofuscação de IP, o que significa que não será afetado pelo Ofuscação de IP configuração.

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: Popula xdm.environment.carrier
  • Domínio: Popula xdm.environment.domain
  • ISP: Popula xdm.environment.ISP

Se você ativar qualquer um dos campos acima para a coleta de dados, defina corretamente a variável context propriedade de matriz ao configurar o SDK da Web.

Os campos de pesquisa de geolocalização usam o context sequência de caracteres de matriz "placeContext", enquanto os campos de pesquisa de rede usam a variável context sequência de caracteres de matriz "environment".

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

Configurar pesquisa de dispositivo geolocation-device-lookup

A variável Pesquisa de dispositivo As configurações do permitem selecionar informações específicas do dispositivo que você deseja coletar.

Expanda a 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 de dispositivo realçadas.

IMPORTANT
As configurações mostradas na tabela abaixo são mutuamente exclusivas. Não é possível selecionar as duas informações do agente do usuário e dados de pesquisa do dispositivo ao mesmo tempo.
Configuração
Descrição
Manter cabeçalhos do agente do usuário e das 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. Preenche 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:

  • Dispositivo informações:

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

    • Tipo de hardware: Popula xdm.device.type
    • Altura da exibição: Popula xdm.device.screenHeight
    • Largura da exibição: Popula xdm.device.screenWidth
    • Exibir intensidade de cor: Popula xdm.device.colorDepth
  • Navegador informações:

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

    • Fornecedor do sistema operacional: Popula xdm.environment.operatingSystemVendor
    • Nome do sistema operacional: Popula xdm.environment.operatingSystem
    • Versão do sistema operacional: Popula 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 do 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ê ativar qualquer um dos campos acima para a coleta de dados, defina corretamente a variável context propriedade de matriz ao configurar o SDK da Web.

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

Além disso, verifique se cada campo XDM desejado existe no esquema. Caso contrário, você pode adicionar o plug-in fornecido pela Adobe Environment Details grupo de campos ao seu 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çadas

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: o nível do fluxo de dados Ofuscação de IP é aplicado antes de Ofuscação de IP executado no Adobe Target, a todos os endereços IP presentes na solicitação. Por exemplo, se o nível de fluxo de dados Ofuscação de IP está definida como Completo e a opção de ofuscação de IP do Adobe Target estiver definida como Ofuscação do último octeto, o Adobe Target recebe um IP totalmente ofuscado. Se o nível do fluxo de dados Ofuscação de IP está definida como Parcial e a opção de ofuscação de IP do Adobe Target estiver definida como Completo, o Adobe Target recebe um IP parcialmente ofuscado e aplica 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: o nível do fluxo de dados Ofuscação de IP é aplicada antes da variável Ofuscação de IP executado no Audience Manager, para 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 Completo, o Adobe Analytics trata 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 Adobe Analytics documentação para obter detalhes sobre como ativar a ofuscação de IP no Analytics. Se o endereço IP for totalmente ofuscado e a ocorrência da página não tiver uma ECID nem uma VisitorID, o Analytics descarta a ocorrência em vez de gerar uma ID de Fallback, que se baseia parcialmente 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 ativar essa 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 transmissão para integração da Rede de borda por meio de SDKs do Experience Platform ou API do Media Edge. Saiba mais sobre o Media Analytics no 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 do fluxo 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 Envio de 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 da ID de visitante
(Opcional) O namespace que você deseja usar para o 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 sequência 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 utilização do Offer Decisioning com o SDK da Web para obter mais detalhes sobre a 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 segmentação de borda para esse fluxo de dados. Quando o SDK envia dados por meio de uma sequência de dados habilitada para segmentação de borda, todas as associações de segmento atualizadas do perfil em questão são enviadas de volta na resposta.

Essa opção pode ser usada em combinação com os destinos de personalização para casos de uso de personalização da próxima página.
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 esse fluxo 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 Segmentação de borda 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 O 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. 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 Encaminhamento de eventos da tela de configuração do fluxo 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 do fluxo 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 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 um fluxo 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