Configurare gli override dello stream di dati

L'oggetto edgeConfigOverrides consente di ignorare le impostazioni di configurazione per i comandi eseguiti nella pagina corrente. Questo oggetto override non è un comando, ma un oggetto che è possibile includere nella maggior parte dei comandi dell'SDK Web.

Questo oggetto è utile quando si dispone di siti web o sottodomini diversi per paesi diversi o se si dispone di più sandbox di Experience Platform per memorizzare dati specifici per diverse business unit.

La sostituzione della configurazione dello stream di dati è un processo in due fasi:

Se imposti le sostituzioni sia nella configurazione dell'SDK Web che in un comando specifico (ad esempio sendEvent), le sostituzioni nel comando specifico hanno la priorità.

Proprietà oggetto

In questo oggetto sono disponibili le seguenti proprietà:

Inviare le sostituzioni dello stream di dati all’Edge Network tramite l’estensione tag Web SDK tag-extension

Per istruzioni di configurazione dettagliate, consulta la documentazione su configurazione delle sostituzioni dello stream di dati dall'estensione tag Web SDK.

Se desideri configurare le sostituzioni dello stream di dati dall'estensione tag Web SDK, imposta ogni campo desiderato in Sostituzioni della configurazione dello stream di dati durante la configurazione dell'estensione tag.

Se desideri impostare le sostituzioni solo per un comando specifico, imposta ogni campo desiderato all’interno delle azioni di una regola di tag.

Sono stati forniti campi separati per gli ambienti Sviluppo, Gestione temporanea e Produzione. Assicurati di compilare ogni campo desiderato per ogni ambiente.

Inviare le sostituzioni all’Edge Network tramite la libreria JavaScript dell’SDK web library

Dopo aver configurato le sostituzioni dello stream di dati nell'interfaccia utente di Data Collection, ora puoi inviare le sostituzioni all'Edge Network tramite la libreria JavaScript dell'SDK Web.

Se utilizzi Web SDK, l'invio delle sostituzioni all'Edge Network tramite il comando edgeConfigOverrides è il secondo e ultimo passaggio dell'attivazione delle sostituzioni della configurazione dello stream di dati.

Gli override della configurazione dello stream di dati vengono inviati alla rete Edge tramite il comando edgeConfigOverrides di Web SDK. Questo comando crea le sostituzioni dello stream di dati passate a Edge Network nel comando successivo. Se si utilizza il comando configure, le sostituzioni vengono passate per ogni richiesta.

Il comando edgeConfigOverrides crea le sostituzioni dello stream di dati che vengono passate a Edge Network nel comando successivo.

Quando viene inviato un override di configurazione con il comando configure, viene incluso nei seguenti comandi di Web SDK.

Le opzioni specificate a livello globale possono essere ignorate dall’opzione di configurazione relativa ai singoli comandi.

Invia sostituzioni di configurazione tramite il comando Web SDK sendEvent send-event

L’esempio seguente mostra l’aspetto di un override della configurazione con un 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"
    }
  }
});

Invia sostituzioni di configurazione tramite il comando Web SDK configure send-configure

L’esempio seguente mostra l’aspetto di un override della configurazione con un 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() { /* … */ });
};