Configurar substituições de sequência de dados
O objeto edgeConfigOverrides
permite substituir as definições de configuração para comandos executados na página atual. Esse objeto de substituição não é um comando, mas um objeto que você pode incluir na maioria dos comandos do SDK da Web.
Esse objeto é útil quando você tem sites ou subdomínios diferentes para países diferentes ou se tem várias sandboxes Experience Platform para armazenar dados específicos de diferentes unidades de negócios.
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, na interface dos fluxos de dados. Consulte a documentação de substituições de configuração da sequência de dados para obter instruções sobre como configurar substituições.
-
Depois de configurar a substituição do fluxo de dados na interface do usuário, você deve enviar as substituições para o Edge Network de uma das seguintes maneiras:
- Por meio da extensão de tag do SDK da Web.
- Por meio dos comandos do SDK da Web
sendEvent
ouconfigure
. - Por meio do comando
sendEvent
do SDK móvel.
Se você definir substituições na configuração do SDK da Web e em um comando específico (como sendEvent
), as substituições no comando específico terão prioridade.
Enviar substituições de sequência de dados para o Edge Network pela extensão de tag do SDK da Web tag-extension
Consulte a documentação sobre configuração de substituições de sequência de dados da extensão de tag do SDK da Web para obter instruções detalhadas de configuração.
Se você deseja configurar substituições de sequência de dados da extensão de marca do SDK da Web, defina cada campo desejado em Substituições de configuração de sequência de dados ao configurar a extensão de marca.
- Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Coleção de dados > Marcas.
- Selecione a propriedade de tag desejada.
- Navegue até Extensões e clique em Configurar no cartão Adobe Experience Platform Web SDK.
- Role para baixo até a seção Substituições de configuração da sequência de dados. Defina cada valor de substituição desejado.
- Clique em Salvar e publique suas alterações.
Se quiser definir substituições apenas para um comando específico, defina cada campo desejado nas ações de uma regra de tag.
- Faça logon em experience.adobe.com usando suas credenciais da Adobe ID.
- Navegue até Coleção de dados > Marcas.
- Selecione a propriedade de tag desejada.
- Navegue até Regras e selecione a regra desejada.
- Em Ações, selecione uma ação existente ou crie uma ação.
- Defina o campo suspenso Extensão como Adobe Experience Platform Web SDK e defina o Tipo de Ação como Enviar evento.
- Role para baixo até a seção denominada Substituições de configuração da sequência de dados.
- Defina cada campo desta seção com o valor de substituição desejado.
- Clique em Manter alterações e execute o fluxo de trabalho de publicação.
Campos separados são fornecidos para ambientes de Desenvolvimento, Preparo e Produção. Preencha cada campo desejado para cada ambiente.
Envie as sobreposições para o Edge Network pela biblioteca JavaScript do SDK da Web library
Depois de configurar as substituições da sequência de dados na interface da Coleção de dados, você pode enviar as substituições para o Edge Network, por meio da biblioteca JavaScript do SDK da Web.
Se estiver usando o SDK da Web, enviar as substituições para o Edge Network por meio do comando edgeConfigOverrides
é a segunda e última etapa da ativação das substituições de configuração da sequência de dados.
As substituições de configuração de sequência de dados são enviadas para a rede de borda por meio do comando edgeConfigOverrides
do SDK da Web. Este comando cria substituições de sequência de dados que são passadas para Edge Network no próximo comando. Se você estiver usando o comando configure
, as substituições serão passadas para cada solicitação.
O comando edgeConfigOverrides
cria substituições de sequência de dados que são passadas para Edge Network no próximo comando.
Quando uma substituição de configuração é enviada com o comando configure
, ela é incluída nos seguintes comandos do SDK da Web.
As opções definidas globalmente podem ser substituídas pela opção de configuração em comandos individuais.
Enviar substituições de configuração por meio do comando sendEvent
do SDK da Web send-event
O exemplo abaixo mostra todas as opções de configuração de sequência de dados dinâmica com suporte em uma chamada sendEvent
.
Se a configuração da sequência de dados tiver todos os serviços com suporte habilitados, a amostra abaixo substituirá essa configuração e desabilitará todos os serviços (consulte a configuração enabled: false
em cada serviço).
alloy("sendEvent", {
renderDecisions: true,
edgeConfigOverrides: {
datastreamId: "bfa8fe21-6157-42d3-b47a-78310920b39d",
com_adobe_experience_platform: {
enabled: false,
datasets: {
event: {
datasetId: "64b6f949a8a6891ca8a28911",
},
},
com_adobe_edge_ode: {
enabled: false,
},
com_adobe_edge_segmentation: {
enabled: false,
},
com_adobe_edge_destinations: {
enabled: false,
},
com_adobe_edge_ajo: {
enabled: false,
},
},
com_adobe_analytics: {
enabled: false,
reportSuites: ["ujslconfigoverrides3"],
},
com_adobe_identity: {
idSyncContainerId: 34374,
},
com_adobe_target: {
enabled: false,
propertyToken: "f3fd55e1-a06d-8650-9aa5-c8356c6e2223",
},
com_adobe_audience_manager: {
enabled: false,
},
com_adobe_launch_ssf: {
enabled: false,
},
},
});
renderDecisions
edgeConfigOverrides.datastreamId
configure
.edgeConfigOverrides.com_adobe_experience_platform
edgeConfigOverrides.com_adobe_experience_platform.enabled
edgeConfigOverrides.com_adobe_experience_platform.datasets
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ode.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_segmentation.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_destinations.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ajo.enabled
com_adobe_analytics.enabled
com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_audience_manager.enabled
como true
. Caso contrário, o serviço Audience Manager será desativado.com_adobe_target.enabled
com_adobe_target.propertyToken
com_adobe_audience_manager.enabled
com_adobe_launch_ssf
Enviar substituições de configuração por meio do comando configure
do SDK da Web send-configure
O exemplo abaixo mostra como seria uma substituição de configuração em um comando configure
.
Se a configuração da sequência de dados tiver todos os serviços com suporte habilitados, a amostra abaixo substituirá essa configuração e desabilitará todos os serviços (consulte a configuração enabled: false
em cada serviço).
alloy("configure", {
orgId: "97D1F3F459CE0AD80A495CBE@AdobeOrg",
datastreamId: "db9c70a1-6f11-4563-b0e9-b5964ab3a858",
edgeConfigOverrides: {
com_adobe_experience_platform: {
enabled: false,
datasets: {
event: {
datasetId: "64b6f930753dd41ca8d4fd77",
},
},
com_adobe_edge_ode: {
enabled: false,
},
com_adobe_edge_segmentation: {
enabled: false,
},
com_adobe_edge_destinations: {
enabled: false,
},
com_adobe_edge_ajo: {
enabled: false,
},
},
com_adobe_analytics: {
enabled: false,
reportSuites: ["ujslconfigoverrides2"],
},
com_adobe_identity: {
idSyncContainerId: 34373,
},
com_adobe_target: {
enabled: false,
propertyToken: "01dbc634-07c1-d8f9-ca69-b489a5ac5e94",
},
com_adobe_audience_manager: {
enabled: false,
},
com_adobe_launch_ssf: {
enabled: false,
},
},
});
orgId
edgeConfigOverrides.datastreamId
configure
.edgeConfigOverrides.com_adobe_experience_platform
edgeConfigOverrides.com_adobe_experience_platform.enabled
edgeConfigOverrides.com_adobe_experience_platform.datasets
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ode.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_segmentation.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_destinations.enabled
edgeConfigOverrides.com_adobe_experience_platform.com_adobe_edge_ajo.enabled
com_adobe_analytics.enabled
com_adobe_analytics.reportSuites[]
com_adobe_identity.idSyncContainerId
com_adobe_audience_manager.enabled
como true
. Caso contrário, o serviço Audience Manager será desativado.com_adobe_target.enabled
com_adobe_target.propertyToken
com_adobe_audience_manager.enabled
com_adobe_launch_ssf