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:

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.

Propriedades do objeto

As seguintes propriedades estão disponíveis nesse objeto:

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.

Se quiser definir substituições apenas para um comando específico, defina cada campo desejado nas ações de uma regra de tag.

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 como seria uma substituição de configuração em um comando sendEvent.

alloy("sendEvent", {
  xdm: {
    /* ... */
  },
  edgeConfigOverrides: {
    datastreamId: "{DATASTREAM_ID}"
    com_adobe_experience_platform: {
      datasets: {
        event: {
          datasetId: "SampleEventDatasetIdOverride"
        }
      }
    },
    com_adobe_analytics: {
      reportSuites: [
        "MyFirstOverrideReportSuite",
        "MySecondOverrideReportSuite",
        "MyThirdOverrideReportSuite"
        ]
    },
    com_adobe_identity: {
      idSyncContainerId: "1234567"
    },
    com_adobe_target: {
      propertyToken: "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
    }
  }
});

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.

alloy("configure", {
  defaultConsent: "in",
  edgeDomain: "etc",
  edgeBasePath: "ee",
  datastreamId: "{DATASTREAM_ID}",
  orgId: "org",
  debugEnabled: true,
  edgeConfigOverrides: {
    "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"
    }
  },
  onBeforeEventSend: function() { /* … */ });
};