Configurar substituições de sequência de dados
As substituições de sequência de dados permitem definir configurações adicionais para as sequências de dados, que são transmitidas para o Edge Network por meio do SDK da Web ou do SDK móvel.
Isso ajuda a acionar comportamentos de sequência de dados diferentes dos padrão, sem criar uma sequência de dados ou modificar as configurações existentes.
A substituição da configuração da sequência de dados é um processo de duas etapas:
-
Primeiro, você deve definir a substituição da configuração da sequência de dados na página de configuração da sequência de dados.
-
Em seguida, você deve enviar as sobreposições para o Edge Network de uma das seguintes maneiras:
- Por meio dos comandos
sendEvent
ouconfigure
SDK da Web. - Por meio da extensão de tag do SDK da Web.
- Por meio da API sendEvent do SDK móvel ou usando Regras.
- Por meio dos comandos
Este artigo explica o processo completo para criar cada tipo de substituição de configuração de sequência de dados compatível.
As substituições de sequência de dados devem ser usadas quando você precisa que dados diferentes sejam enviados para sequências de dados diferentes. Não use substituições de fluxo de dados para casos de uso de personalização ou dados de consentimento.
Casos de uso use-cases
Para melhorar o entendimento sobre como e quando usar substituições de sequência de dados, veja alguns casos de uso que os clientes da Adobe Experience Platform podem resolver usando esse recurso.
Coleta de dados de várias regiões
Uma empresa tem sites ou subdomínios diferentes para países diferentes nos quais opera. Ela configurou sequências de dados separadas com conjuntos de relatórios específicos do Analytics, tokens de propriedade do Adobe Target específicos de um país, esquemas específicos de um país, conjuntos de dados, configurações do Journey Optimizer e assim por diante. A empresa também tem um conjunto global de configurações onde agrega todos os dados específicos de um país.
Ao usar substituições de sequência de dados, a empresa pode alternar dinamicamente o fluxo dos dados para sequências de dados diferentes, em vez do comportamento padrão de enviar dados para uma sequência de dados.
Um caso de uso comum pode ser o envio de dados para um fluxo de dados específico de país e também para um fluxo de dados global em que os clientes executam uma ação importante, como fazer um pedido ou atualizar o perfil do usuário.
Diferenciação de perfis e identidades para diferentes unidades de negócios
Uma empresa com várias unidades de negócios deseja usar várias sandboxes Experience Platform para armazenar dados específicos de cada unidade de negócios.
Em vez de enviar dados para uma sequência de dados padrão, a empresa pode usar substituições de sequência de dados para garantir que cada unidade de negócios tenha sua própria sequência de dados para receber dados.
Configurar substituições na interface das sequências de dados configure-overrides
As substituições de configuração de sequência de dados permitem modificar as seguintes configurações de sequência de dados:
- Conjuntos de dados de eventos da Experience Platform
- Tokens de propriedade do Adobe Target
- Containers de sincronização de ID do Audience Manager
- Conjuntos de relatórios do Adobe Analytics
Substituições de sequência de dados para o Adobe Target target-overrides
Para configurar substituições para uma sequência de dados do Adobe Target, primeiro você deve criar uma sequência de dados do Adobe Target. Siga as instruções para configurar uma sequência de dados com o serviço do Adobe Target.
Depois de criar a sequência de dados, edite o serviço Adobe Target que você adicionou e use a seção Substituições de Token de Propriedade para adicionar as substituições de sequência de dados desejadas, conforme mostrado na imagem abaixo. Adicione um token de propriedade por linha.
Depois de adicionar as substituições desejadas, salve as configurações da sequência de dados.
Agora as substituições de sequência de dados do Adobe Target devem estar configuradas. Agora você pode enviar as substituições para o Edge Network pelo SDK da Web ou SDK móvel.
Substituições de sequência de dados para o Adobe Analytics analytics-overrides
Para configurar substituições para uma sequência de dados do Adobe Analytics, primeiro você deve criar uma sequência de dados do Adobe Analytics. Siga as instruções para configurar uma sequência de dados com o serviço do Adobe Analytics.
Depois de criar a sequência de dados, edite o serviço Adobe Analytics que você adicionou e use a seção Substituições do Conjunto de Relatórios para adicionar as substituições da sequência de dados desejadas, conforme mostrado na imagem abaixo.
Selecione Mostrar modo de lote para habilitar a edição em lote de substituições de conjunto de relatórios. É possível copiar e colar uma lista de substituições de conjunto de relatórios, inserindo um conjunto de relatórios por linha.
Depois de adicionar as substituições desejadas, salve as configurações da sequência de dados.
Agora as substituições de sequência de dados do Adobe Analytics devem estar configuradas. Agora você pode enviar as substituições para o Edge Network pelo SDK da Web ou SDK móvel.
Substituições de sequência de dados para conjuntos de dados de eventos da Experience Platform event-dataset-overrides
Para configurar substituições de sequência de dados para conjuntos de dados de evento da Experience Platform, primeiro você deve criar uma sequência de dados da Adobe Experience Platform. Siga as instruções para configurar uma sequência de dados com o serviço da Adobe Experience Platform.
Depois de criar a sequência de dados, edite o serviço Adobe Experience Platform que você adicionou e selecione a opção Adicionar conjunto de dados do evento para adicionar um ou mais conjuntos de dados de evento de substituição, conforme mostrado na imagem abaixo.
Depois de adicionar as substituições desejadas, salve as configurações da sequência de dados.
Agora as substituições de sequência de dados da Adobe Experience Platform devem estar configuradas. Agora você pode enviar as substituições para o Edge Network pelo SDK da Web ou SDK móvel.
Substituições de sequência de dados para containers de sincronização de ID de terceiros container-overrides
Para configurar substituições de sequência de dados para containers de sincronização de ID de terceiros, primeiro você deve criar uma sequência de dados. Siga as instruções para configurar uma sequência de dados.
Depois de criar a sequência de dados, acesse Opções avançadas e habilite a opção Sincronização de ID de terceiros.
Em seguida, use a seção Substituições de ID de container para adicionar as IDs de container que você deseja usar para substituir a configuração padrão, conforme mostrado na imagem abaixo.
1234567
, e não strings, como "1234567"
. Um erro será exibido se você enviar uma string por meio do SDK da Web como uma substituição de ID de container.
Depois de adicionar as substituições desejadas, salve as configurações da sequência de dados.
Agora as substituições do container de sincronização de ID devem estar configuradas. Agora você pode enviar as substituições para o Edge Network pelo SDK da Web ou SDK móvel.
Enviar as sobreposições para o Edge Network send-overrides
Depois de configurar as substituições de fluxo de dados na interface da Coleção de dados, você pode enviar as substituições para o Edge Network por meio do SDK da Web ou do SDK móvel.
- SDK da Web: consulte substituições da configuração da sequência de dados para obter instruções sobre a extensão da marca e exemplos de código de biblioteca da JavaScript.
- SDK móvel: você pode enviar substituições de ID de sequência de dados usando a API sendEvent ou usando as Regras.
Exemplo de conteúdo payload-example
Os exemplos acima geram uma carga de Edge Network similar à abaixo.
{
"meta": {
"configOverrides": {
"com_adobe_experience_platform": {
"datasets": {
"event": {
"datasetId": "SampleProfileDatasetIdOverride"
}
}
},
"com_adobe_analytics": {
"reportSuites": [
"MyFirstOverrideReportSuite",
"MySecondOverrideReportSuite",
"MyThirdOverrideReportSuite"
]
},
"com_adobe_identity": {
"idSyncContainerId": "1234567"
},
"com_adobe_target": {
"propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
}
},
"state": { }
},
"events": [ ]
}