Criar e configurar sequências de dados

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

Acessar o espaço de trabalho Datastreams workspace

Você pode criar e gerenciar sequências de dados na Interface da Coleção de Dados ou na Interface do Usuário do Adobe Experience Platform selecionando Sequências de Dados na navegação à esquerda.

Guia Fluxos de dados na Interface da Coleção de Dados.

A guia Datastreams exibe uma lista de datastreams existentes, incluindo seu nome amigável, ID e 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 de 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, comece selecionando Nova sequência de dados.

Selecionar 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 Web SDK, também deverá selecionar um Esquema de Mapeamento. Use um esquema do Experience Data Model (XDM) baseado em eventos para representar os dados que você planeja assimilar.

Configuração básica para 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

Selecionar Cidade, Latitude ou Longitude fornece coordenadas com até dois pontos 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 desses campos para a coleta de dados, defina corretamente a propriedade de matriz context ao configurar o Web SDK.

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 pela Adobe ao esquema.

Configurar pesquisa de dispositivo geolocation-device-lookup

Use as configurações de Pesquisa de Dispositivo para selecionar as informações específicas de 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 desses campos para a coleta de dados, defina corretamente a propriedade de matriz context ao configurar o Web SDK.

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 pela Adobe ao esquema.

Configurar opções avançadas advanced-options

Para acessar as opções de configuração avançada, 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.

Painel de opções de configuração avançada de sequência de dados mostrando ofuscação de IP, Cookie de ID primário e outras configurações.

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 de 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 configuradas da Adobe. 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 do fluxo de dados. A ofuscação de IP ocorre antes que os eventos sejam enviados para qualquer serviço downstream, como o Preparo de dados.

Opções disponíveis:

  • Nenhum: 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
  • Total: 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 no Audience Manager, a todos os endereços IP presentes na solicitação. Qualquer pesquisa de localização geográfica feita pelo Audience Manager é afetada pela opção de ofuscação de IP nível de 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.
  • Adobe Advertising: quando a ofuscação de IP no nível de sequência de dados é definida como Parcial ou Completa, os relatórios geográficos e os recursos (incluindo medição e remarketing) estão desabilitados no Advertising DSP, exceto para anúncios de TV conectados.
Cookie da ID própria
Quando habilitada, esta configuração informa o Edge Network a fazer referência a um cookie especificado ao procurar uma ID de dispositivo próprio, em vez de procurar 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 do Contêiner de Sincronização de ID de Terceiros
A ID numérica do contêiner a ser usada para sincronização de ID de terceiros.

Observação: A sequência de dados faz referência à ID de Contêiner padrão do Audience Manager, que é 0. Se você tiver várias IDs de contêiner de sincronização da Audience Manager ID, trabalhe com seu consultor da Audience Manager para identificar e resolver corretamente a configuração da sincronização de ID.
Substituições de ID de Contêiner
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 esta opção é selecionada, o Edge Network aceita solicitações autenticadas e não autenticadas. Selecione esta opção quando você planeja usar o Web SDK ou o SDK móvel, juntamente com a API do Edge Network.
  • Somente autenticados: quando esta opção é selecionada, o Edge Network aceita somente solicitações autenticadas. Selecione essa opção quando planejar usar somente a API do Edge Network e quiser impedir que solicitações não autenticadas sejam processadas pela Edge Network.
Análise de mídia
Habilita o processamento de dados de rastreamento de streaming para a integração do Edge Network por meio de SDKs do Experience Platform ou da API do Media Edge. Saiba mais sobre o Media Analytics na documentação.

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

NOTE
Depois de salvar as alterações em uma configuração de sequência de dados, aguarde até 35 minutos para que as alterações se propaguem pela Edge Network. Durante essa janela de propagação, as solicitações ainda podem ser atendidas com a configuração anterior.

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 uma opção Habilitada que é ativada automaticamente quando o serviço é selecionado. Para desabilitar o serviço selecionado para esta sequência de dados, selecione Habilitado novamente.

Configurações do Adobe Advertising advertising

Este serviço é necessário para a integração de Adobe Advertising com Customer Journey Analytics.

Configurações do Adobe Analytics analytics

Use este serviço para enviar dados a Adobe Analytics.

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

Configuração
Descrição
ID do Conjunto de Relatórios
(Obrigatório) A ID do conjunto de relatórios Analytics para o qual você deseja enviar dados. Esta ID pode ser encontrada na interface do usuário do Adobe Analytics em Admin > ReportSuites. 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. Quando você envia um evento com um valor especificado para este namespace, ele é automaticamente usado como o visitorID em Analytics.
Quando o campo é preenchido, a sequência de dados envia o valor visitorID para Adobe Analytics. Independentemente de a ID do visitante estar incluída no identityMap, o ECID ainda será gerado e incluído com solicitações de saída. Analytics dá suporte à inclusão de várias IDs. As IDs são avaliadas na ordem descrita nesta página: Ordem de operações de identificação do Adobe 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.

Consulte Implementar o Adobe Analytics com o Edge Network no guia de implementação Analytics para obter mais informações.

Configurações do Adobe Audience Manager audience-manager

Habilite este serviço para enviar dados para Adobe Audience Manager. 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
Habilita a SDK a compartilhar informações de segmento via destinos de cookies de Audience Manager.
Destinos de URL Habilitados
Habilita a SDK a compartilhar informações de segmento via destinos de URL de Audience Manager.

Configurações da Adobe Experience Platform aep

IMPORTANT
Ao ativar um fluxo de dados para o Experience Platform, anote a sandbox da Experience Platform que você está usando no momento, como exibida na faixa superior da interface do usuário.
O nome da sandbox selecionada exibido na faixa superior da interface do usuário do Adobe Experience Platform.
As sandboxes são partições virtuais em Adobe Experience Platform que isolam seus dados e 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.

Use este serviço para enviar dados 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 do Experience Platform para o qual os dados do evento do 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 de perfil
Selecione o conjunto de dados do Experience Platform que será usado para enviar atributos do cliente de consentimento, tokens de push e região de atividade do usuário. Este esquema deve usar a classe de perfil individual XDM.
Offer Decisioning
Habilita a Gestão de decisões (antigo Offer Decisioning) para implementações do Web SDK. Consulte a documentação do Gerenciamento de decisões para obter detalhes sobre a implementação.
Segmentação do Edge
Habilita a segmentação de borda para esta sequência de dados. Quando o Web SDK ou a API do Edge Network envia dados por meio de uma sequência de dados com a 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, Gerenciamento de Decisões, Adobe Target ou Adobe Journey Optimizer.
Destinos de personalização
Habilita o Personalization personalizado para esta sequência de dados. Quando o Web SDK ou a API do Edge Network envia dados por meio de uma sequência de dados com destinos de personalização habilitados, as associações de público-alvo e os atributos de perfil mapeados (somente para solicitações autenticadas da API do Edge Network) para o perfil em questão são enviados de volta na resposta.
Adobe Journey Optimizer
Habilita Adobe Journey Optimizer para esta sequência de dados.

Habilitar esta opção permite que a sequência de dados retorne conteúdo personalizado de campanhas de entrada baseadas na Web e no aplicativo em Adobe Journey Optimizer.

Esta opção requer que o conjunto de dados selecionado use um esquema que inclua o Evento de Experiência - Interações de Apresentação grupo de campos. Este grupo de campos é usado para registrar todas as interações do usuário com Adobe Journey Optimizer campanhas e experiências.

Configurações do Adobe Target target

Use este serviço para enviar dados a 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 usuário Adobe Target em Configuração > Propriedades.
ID do Ambiente de Destino
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 sequência de dados do dev, stage e prod para evitar erros de configuração. No entanto, se você já tiver Adobe Target ambientes 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.
Substituições de 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 event-forwarding

Use este serviço para enviar dados para encaminhamento de eventos.

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

Configuração
Descrição
Iniciar propriedade
(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
Você pode selecionar 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. Não é possível copiar um fluxo de dados de uma sandbox para outra.

Na página principal do espaço de trabalho Fluxos de dados, selecione as reticências () para a sequência de dados em questão, 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 da 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 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 Fluxos de dados reaparece com o novo fluxo de dados listado.

Próximas etapas next-steps

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 Web SDK após configurar uma sequência de dados, consulte Introdução à Web SDK extensão de tag.

recommendation-more-help
experience-platform-help-datastreams