Configurar anulaciones de secuencia de datos

El objeto edgeConfigOverrides le permite anular los valores de configuración de los comandos que se ejecutan en la página actual. Este objeto override no es un comando, sino un objeto que se puede incluir en la mayoría de los comandos del SDK web.

Este objeto es útil cuando tiene diferentes sitios web o subdominios para diferentes países o si tiene varios entornos limitados de Experience Platform para almacenar datos específicos de diferentes unidades de negocio.

La anulación de la configuración del flujo de datos es un proceso de dos pasos:

Si establece invalidaciones tanto en la configuración del SDK web como en un comando específico (como sendEvent), las invalidaciones del comando específico tienen prioridad.

Propiedades del objeto

Las siguientes propiedades están disponibles en este objeto:

Envíe invalidaciones de secuencia de datos al Edge Network a través de la extensión de etiquetas del SDK web tag-extension

Consulte la documentación sobre configuración de anulaciones de secuencia de datos desde la extensión de etiqueta del SDK web para obtener instrucciones de configuración detalladas.

Si desea configurar las invalidaciones de secuencia de datos desde la extensión de etiqueta del SDK web, establezca cada campo deseado en Invalidaciones de configuración de secuencia de datos al configurar la extensión de etiqueta.

Si desea establecer invalidaciones solo para un comando específico, establezca cada campo deseado dentro de las acciones de una regla de etiqueta.

Se proporcionan campos independientes para los entornos Development, Staging y Production. Asegúrese de rellenar cada campo deseado para cada entorno.

Envíe las invalidaciones al Edge Network a través de la biblioteca JavaScript del SDK web library

Después de configurar las invalidaciones de la secuencia de datos en la IU de recopilación de datos, ahora puede enviar las invalidaciones al Edge Network a través de la biblioteca JavaScript del SDK web.

Si utiliza el SDK web, el envío de las invalidaciones al Edge Network mediante el comando edgeConfigOverrides es el segundo y último paso de activar las invalidaciones de configuración de la secuencia de datos.

Las anulaciones de configuración de la secuencia de datos se envían a Edge Network a través del comando edgeConfigOverrides del SDK web. Este comando crea invalidaciones de secuencia de datos que se pasan al Edge Network en el siguiente comando. Si usa el comando configure, las invalidaciones se pasan para cada solicitud.

El comando edgeConfigOverrides crea invalidaciones de secuencia de datos que se pasan al Edge Network en el siguiente comando.

Cuando se envía una anulación de la configuración con el comando configure, se incluye en los siguientes comandos del SDK web.

Las opciones especificadas globalmente pueden ser anuladas por la opción de configuración en comandos individuales.

Enviar invalidaciones de configuración mediante el comando sendEvent del SDK web send-event

El ejemplo siguiente muestra el aspecto que podría tener una anulación de la configuración en 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"
    }
  }
});

Enviar invalidaciones de configuración mediante el comando configure del SDK web send-configure

El ejemplo siguiente muestra el aspecto que podría tener una anulación de la configuración en 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() { /* … */ });
};