Comportamento de exportação de perfil para diferentes tipos de destino

Última atualização em 2023-08-18
  • Tópicos
  • Destinations
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader

Há vários tipos de destino no Experience Platform, conforme mostrado no diagrama abaixo. Esses destinos têm padrões de exportação ligeiramente diferentes no que diz respeito ao que desencadeia uma exportação de destino e ao que está incluído numa exportação, tal como descrito nas seções mais adiante.

IMPORTANTE

Esta página de documentação descreve apenas o comportamento de exportação do perfil das conexões destacadas na parte inferior do diagrama.

Tipos de diagrama de destinos

Agregação de mensagens em destinos de streaming

Antes de mergulhar em informações específicas por tipo de destino, é importante entender o conceito de agregação de mensagens para destinos de transmissão.

Os destinos Experience Platform exportam dados para integrações baseadas em API, como chamadas HTTPS. Assim que o serviço de destinos for notificado por outros serviços upstream de que os perfis foram atualizados como resultado da assimilação em lote, assimilação por streaming, segmentação em lote, segmentação por streaming ou alterações no gráfico de identidade, os dados serão exportados e enviados para destinos de streaming.

Os perfis são agregados em mensagens HTTPS antes de serem despachados para endpoints da API de destino.

Pegue o Destino do facebook com um agregação configurável política como exemplo - os dados são enviados de forma agregada, em que o serviço de destinos pega todos os dados recebidos do serviço de perfil upstream e os agrega por um dos itens a seguir, antes de enviá-los para o Facebook:

  • Número de registros (máximo de 10.000) ou
  • Intervalo da janela de tempo (300 segundos)

Qualquer que seja o limite acima atingido primeiro aciona uma exportação para o Facebook. Assim, no Facebook Custom Audiences , você poderá ver públicos-alvo vindos do Experience Platform em incrementos de 10.000 registros. Você pode estar vendo 10.000 registros a cada 2-3 minutos porque os dados são processados e agregados mais rapidamente do que o intervalo de exportação de 300 segundos e são enviados mais rapidamente, portanto, aproximadamente a cada 2-3 minutos até que todos os registros tenham sido processados. Se não houver registros suficientes para compor um lote de 10.000, o número atual de registros será enviado como está quando o limite da janela de tempo for atingido, portanto, você também poderá ver lotes menores enviados para o Facebook.

Como outro exemplo, considere Destino da API HTTP, que tem um agregação de melhor esforço política, com maxUsersPerRequest: 10. Isso significa que no máximo dez perfis serão agregados antes que uma chamada HTTP seja disparada para esse destino, mas o Experience Platform tenta despachar perfis para o destino assim que o serviço de destinos recebe informações de reavaliação atualizadas de um serviço upstream.

A política de agregação é configurável e os desenvolvedores de destino podem decidir como configurar a política de agregação para melhor atender às limitações de taxa dos endpoints da API downstream. Leia mais sobre política de agregação na documentação do Destination SDK.

Destinos de exportação (corporativos) de perfil de transmissão

IMPORTANTE

Os destinos corporativos estão disponíveis somente para Adobe Real-time Customer Data Platform Ultimate clientes.

A variável destinos corporativos no Experience Platform estão o Amazon Kinesis, os Hubs de eventos do Azure e a API HTTP.

O Experience Platform otimiza o comportamento de exportação de perfis para o destino da sua empresa, a fim de exportar dados somente para o endpoint da API quando atualizações relevantes para um perfil tiverem ocorrido após a qualificação de público-alvo ou outros eventos significativos. Os perfis são exportados para seu destino nas seguintes situações:

  • A atualização do perfil foi determinada por uma alteração no associação de público para pelo menos um dos públicos-alvo mapeados para o destino. Por exemplo, o perfil se qualificou para um dos públicos mapeados para o destino ou saiu de um dos públicos mapeados para o destino.
  • A atualização do perfil foi determinada por uma alteração no mapa de identidade. Por exemplo, um perfil que já se qualificou para um dos públicos-alvo mapeados para o destino recebeu uma nova identidade no atributo de mapa de identidade.
  • A atualização do perfil foi determinada por uma alteração nos atributos de pelo menos um dos atributos mapeados para o destino. Por exemplo, um dos atributos mapeados para o destino na etapa de mapeamento é adicionado a um perfil.

Em todos os casos descritos acima, somente os perfis em que ocorreram atualizações relevantes são exportados para o seu destino. Por exemplo, se um público-alvo mapeado para o fluxo de destino tiver cem membros e cinco novos perfis se qualificarem para o segmento, a exportação para o destino será incremental e incluirá apenas os cinco novos perfis.

Observe que todos os atributos mapeados são exportados para um perfil, independentemente de onde estejam as alterações. Portanto, no exemplo acima, todos os atributos mapeados para esses cinco novos perfis serão exportados mesmo se os atributos em si não tiverem sido alterados.

O que determina uma exportação de dados e o que está incluído na exportação

Em relação aos dados exportados para um determinado perfil, é importante entender os dois conceitos diferentes de o que determina uma exportação de dados para o destino da sua empresa e quais dados estão incluídos na exportação.

O que determina uma exportação de destino O que está incluído na exportação de destino
  • Atributos e públicos mapeados servem como indicação para uma exportação de destino. Isso significa que, se qualquer público mapeado alterar os estados (de null para realized ou de realized para exiting) ou qualquer atributo mapeado for atualizado, uma exportação de destino será iniciada.
  • Como as identidades não podem ser mapeadas para destinos corporativos no momento, as alterações em qualquer identidade em um determinado perfil também determinam as exportações de destino.
  • Uma alteração em um atributo é definida como qualquer atualização no atributo, seja ou não o mesmo valor. Isso significa que uma substituição em um atributo é considerada uma alteração, mesmo que o valor em si não tenha sido alterado.
  • A variável segmentMembership o objeto inclui o público-alvo mapeado no fluxo de dados de ativação, para o qual o status do perfil foi alterado após um evento de qualificação ou de saída de público-alvo. Observe que outros públicos não mapeados para os quais o perfil se qualificou podem fazer parte da exportação de destino, se esses públicos pertencerem à mesma política de mesclagem como o público mapeado no fluxo de dados de ativação.
  • Todas as identidades na identityMap Os objetos também estão incluídos (no momento, o Experience Platform não oferece suporte ao mapeamento de identidade no destino corporativo).
  • Somente os atributos mapeados são incluídos na exportação de destino.
IMPORTANTE

Destinos corporativos transmitem dados de preenchimento retroativo ao ativar perfis para um destino. Isso significa que a primeira exportação de dados após a configuração de um fluxo de trabalho de ativação para um destino incluirá perfis que se qualificaram para o público-alvo ativado antes que o público-alvo seja mapeado para o destino.

Por exemplo, considere esse fluxo de dados para um destino HTTP, onde três públicos-alvo são selecionados no fluxo de dados e quatro atributos são mapeados para o destino.

fluxo de dados de destino corporativo

Uma exportação de perfil para o destino pode ser determinada por um perfil qualificado para ou que sai de um dos três segmentos mapeados. No entanto, na exportação de dados, no campo segmentMembership , outros públicos-alvo não mapeados poderão ser exibidos se esse perfil específico for membro deles e se eles compartilharem a mesma política de mesclagem que o público-alvo que acionou a exportação. Se um perfil se qualificar para a variável Cliente com DeLorean Cars público-alvo, mas também é membro da Assistiu ao filme "De volta ao futuro" e Fãs de ficção científica segmentos, esses outros dois públicos-alvo também estarão presentes na segmentMembership objeto da exportação de dados, mesmo que não estejam mapeados no fluxo de dados, se compartilharem a mesma política de mesclagem com o Cliente com DeLorean Cars segmento.

Do ponto de vista dos atributos de perfil, qualquer alteração nos quatro atributos mapeados acima determinará uma exportação de destino e qualquer um dos quatro atributos mapeados presentes no perfil estará presente na exportação de dados.

DICA

Você pode ver exemplos de dados exportados para vários destinos corporativos na Amazon Kinesis, Hubs de Eventos do Azure, e API HTTP páginas de documentação de destino.

Destinos baseados em API de streaming

O comportamento de exportação de perfil para destinos de transmissão, como Facebook, Trade Desk e outras integrações baseadas em API, é muito semelhante ao comportamento descrito acima para destinos corporativos.

Exemplos de destinos de transmissão são os destinos pertencentes à categorias sociais e de publicidade no catálogo.

O Experience Platform otimiza o comportamento de exportação de perfil para seu destino de streaming, para exportar dados somente para destinos baseados em API de streaming quando atualizações relevantes para um perfil tiverem ocorrido após a qualificação de público-alvo ou outros eventos significativos. Os perfis são exportados para seu destino nas seguintes situações:

  • A atualização do perfil foi determinada por uma alteração no associação de público para pelo menos um dos públicos-alvo mapeados para o destino. Por exemplo, o perfil se qualificou para um dos públicos mapeados para o destino ou saiu de um dos públicos mapeados para o destino.
  • A atualização do perfil foi determinada por uma alteração no mapa de identidade para um namespace de identidade marcado para exportação para esta instância de destino. Por exemplo, um perfil que já se qualificou para um dos públicos-alvo mapeados para o destino recebeu uma nova identidade no atributo de mapa de identidade.
  • A atualização do perfil foi determinada por uma alteração nos atributos de pelo menos um dos atributos mapeados para o destino. Por exemplo, um dos atributos mapeados para o destino na etapa de mapeamento é adicionado a um perfil.
  • O consentimento é alterado para um perfil quando a imposição de consentimento automatizada é configurada e um perfil é recusado. A aplicação automática de consentimento enviará um evento de saída de público-alvo para o destino para que o perfil não seja incluído em nenhum direcionamento no destino.

Em todos os casos descritos acima, somente os perfis em que ocorreram atualizações relevantes são exportados para o seu destino. Por exemplo, se um público-alvo mapeado para o fluxo de destino tiver cem membros e cinco novos perfis se qualificarem para o segmento, a exportação para o destino será incremental e incluirá apenas os cinco novos perfis.

Observe que todos os atributos mapeados são exportados para um perfil, independentemente de onde estejam as alterações. Portanto, no exemplo acima, todos os atributos mapeados para esses cinco novos perfis serão exportados mesmo se os atributos em si não tiverem sido alterados.

O que determina uma exportação de dados e o que está incluído na exportação

Em relação aos dados exportados para um determinado perfil, é importante entender os dois conceitos diferentes do que determina uma exportação de dados para o destino da API de streaming e quais dados são incluídos na exportação.

O que determina uma exportação de destino O que está incluído na exportação de destino
  • Atributos e públicos mapeados servem como indicação para uma exportação de destino. Isso significa que, se qualquer público mapeado alterar os estados (de null para realized ou de realized para exiting) ou qualquer atributo mapeado for atualizado, uma exportação de destino será iniciada.
  • Uma alteração no mapa de identidade é definida como uma identidade que é adicionada/removida para o gráfico de identidade do perfil, para namespaces de identidade mapeados para exportação.
  • Uma alteração em um atributo é definida como qualquer atualização no atributo, para atributos que são mapeados para o destino.
  • Os públicos-alvo mapeados para o destino e que foram alterados serão incluídos no segmentMembership objeto. Em alguns cenários, eles podem ser exportados usando várias chamadas. Além disso, em alguns cenários, alguns públicos que não foram alterados também podem ser incluídos na chamada do. Em qualquer caso, somente os públicos-alvo mapeados serão exportados.
  • Todas as identidades dos namespaces mapeadas para o destino na variável identityMap objetos também são incluídos.
  • Somente os atributos mapeados são incluídos na exportação de destino.
IMPORTANTE

Os destinos da API de transmissão transmitem dados de preenchimento retroativo ao ativar perfis para um destino. Isso significa que a primeira exportação de dados após a configuração de um fluxo de trabalho de ativação para um destino incluirá perfis que se qualificaram para o público-alvo ativado antes que o público-alvo seja mapeado para o destino.

Por exemplo, considere esse fluxo de dados para um destino de transmissão em que três públicos-alvo são selecionados no fluxo de dados.

fluxo de dados de destino da transmissão

Uma exportação de perfil para o destino pode ser determinada por um perfil qualificado para um ou saindo dos três segmentos mapeados. Se um perfil qualificado para a Cliente com DeLorean Cars segmento, isso acionará uma exportação. Os outros públicos (Cidade - Dallas e Site básico ativo) também podem ser exportados caso o perfil tenha esse público-alvo com um dos status possíveis (realized ou exited). Públicos não mapeados (como Fãs de ficção científica) não serão exportadas.

Do ponto de vista dos atributos de perfil, qualquer alteração nos três atributos mapeados acima determinará uma exportação de destino.

Destinos em lote (baseados em arquivo)

Ao exportar perfis para o destinos baseados em arquivo no Experience Platform, há três tipos de agendamentos (listados abaixo) e duas opções de exportação de arquivos (arquivos completos ou incrementais) que você pode usar. Todas essas configurações são definidas em nível de público-alvo, mesmo quando vários públicos-alvo são mapeados para um único fluxo de dados de destino.

  • Exportações programadas: configure um destino, adicione um ou mais segmentos, selecione se deseja exportar arquivos completos ou incrementais e selecione um horário definido a cada dia ou várias vezes por dia quando os arquivos devem ser exportados. Por exemplo, um horário de exportação de 17h significa que os perfis qualificados para o público serão exportados às 17h.
  • Após a avaliação do segmento: a exportação é acionada imediatamente após a execução diária do trabalho de avaliação do público-alvo. Isso significa que os números de perfil exportados no arquivo estão o mais próximo possível da população avaliada mais recentemente do segmento.
  • Exportações a pedido (exportar arquivo agora): Com base no trabalho de avaliação de público-alvo mais recente, um arquivo completo é exportado uma vez além das exportações programadas regularmente.

Em qualquer uma das situações de exportação acima, os arquivos exportados incluem os perfis qualificados para a exportação, junto com as colunas selecionadas como atributos XDM para exportação.

DICA

Quando um público-alvo de transmissão é mapeado para um destino em lote, há uma maior probabilidade de que o número de perfis no arquivo exportado esteja mais próximo do número de usuários no segmento. Isso ocorre porque há uma maior chance de a última avaliação de público-alvo ter sido executada mais perto do tempo de exportação.

Exportações incrementais de arquivos

Nem todas as atualizações em um perfil qualificam um perfil para ser incluído em exportações de arquivos incrementais. Por exemplo, se um atributo foi adicionado ou removido de um perfil, isso não inclui o perfil na exportação. Somente perfis para os quais segmentMembership atributo alterado será incluído nos arquivos exportados. Em outras palavras, somente se o perfil se tornar parte do público-alvo ou for removido do público-alvo será incluído nas exportações de arquivos incrementais.

Da mesma forma, se uma nova identidade (novo endereço de email, número de telefone, ECID e assim por diante) for adicionada a um perfil na gráfico de identidade, que não representa um motivo para incluir o perfil em uma nova exportação de arquivo incremental.

Se um novo público-alvo for adicionado a um mapeamento de destino, as qualificações e exportações de outro segmento não serão afetadas. Os agendamentos de exportação são configurados individualmente por público-alvo e os arquivos são exportados separadamente para cada segmento, mesmo que os públicos-alvo tenham sido adicionados ao mesmo fluxo de dados de destino.

Por exemplo, na configuração de exportação ilustrada abaixo, em que um público-alvo está exportando atualizações de arquivos incrementais, observe as seguintes circunstâncias em que um perfil é incluído ou não em uma exportação de arquivo incremental:

Exportar configuração com vários atributos selecionados.

  • Um perfil é incluído em uma exportação de arquivo incremental quando ele é qualificado ou desqualificado para o segmento.
  • Um perfil é não incluído em uma exportação de arquivo incremental quando um novo número de telefone é adicionado ao gráfico de identidade.
  • Um perfil é não incluído em uma exportação de arquivo incremental quando o valor de qualquer um dos campos XDM mapeados, como xdm: loyalty.points, xdm: loyalty.tier, xdm: personalEmail.address é atualizado em um perfil.
  • Sempre que a variável segmentMembership.status O campo XDM é mapeado no fluxo de trabalho de ativação de destino. Os perfis que saem do público-alvo também são incluídos em arquivos incrementais exportados, com um exited status.

O que determina uma exportação de dados e o que está incluído na exportação

Com base nas informações na seção acima, o comportamento de exportação do perfil para destinos baseados em arquivo pode ser resumido conforme descrito abaixo:

Exportações de arquivos completas

A população ativa completa do público-alvo é exportada todos os dias.

O que determina uma exportação de destino O que está incluído no arquivo exportado
Em exportações de arquivos completas, toda a população do perfil ativo de um segmento, com base na última avaliação do público-alvo, é incluída em cada exportação de arquivo. Os valores mais recentes para cada atributo XDM selecionado para exportação também são incluídos como colunas em cada arquivo. Observe que os perfis no status "fechado" não são incluídos na exportação de arquivos.

Exportações incrementais de arquivos

Na primeira exportação de arquivo após a configuração do fluxo de trabalho de ativação, toda a população do público-alvo é exportada. Nas exportações subsequentes, somente os perfis modificados serão exportados.

O que determina uma exportação de destino O que está incluído no arquivo exportado
  • O cronograma de exportação definido na interface ou na API determina o início de uma exportação de destino.
  • Quaisquer alterações na associação de público-alvo de um perfil, seja ele qualificado ou desqualificado do segmento, qualificam um perfil para ser incluído em exportações incrementais. Alterações nos atributos ou nos mapas de identidade de um perfil não qualifique um perfil para ser incluído em exportações incrementais.

Os perfis para os quais a associação de público-alvo foi alterada, juntamente com as informações mais recentes para cada atributo XDM selecionado para exportação.

Perfis com o status de saída são incluídos em exportações de destino, se a variável segmentMembership.status O campo XDM é selecionado na etapa de mapeamento.

DICA

Como lembrete, as alterações nos valores de atributo ou nos mapas de identidade de um perfil não qualificam um perfil para ser incluído em uma exportação de arquivo incremental.

Próximas etapas

Depois de ler este documento, agora você sabe o que esperar das exportações de perfil para destinos de transmissão, corporativos e baseados em arquivo.

Em seguida, você pode ler sobre como identidades são tratadas no workflow de ativação.

Nesta página