[Alpha]{class="badge informative"}

edgeConfigOverrides (Server SDK, configure)

Cette page décrit les edgeConfigOverrides de la méthode configure de Server SDK. Pour le Web SDK, voir edgeConfigOverrides.

L’objet edgeConfigOverrides vous permet de remplacer les paramètres du flux de données pour chaque requête envoyée par une instance. Par exemple, vous pouvez envoyer des données à un jeu de données Experience Platform, une suite de rapports Analytics ou une propriété Target différent des valeurs par défaut du flux de données. Cela s’avère utile lorsqu’un serveur gère plusieurs sites web ou unités opérationnelles qui partagent un flux de données. Pour remplacer les paramètres d’un événement unique, utilisez plutôt l’objet edgeConfigOverrides dans sendEvent.

Le remplacement des paramètres de train de données se fait en deux étapes :

Lorsque vous définissez des edgeConfigOverrides dans configure, elles s’appliquent à chaque requête de l’instance et à chaque gestion de forRequest créée par l’instance. Les méthodes suivantes acceptent également un objet edgeConfigOverrides pour un seul appel :

Si un appel de méthode inclut son propre objet edgeConfigOverrides, le SDK le combine avec l’objet de configure pour cet appel. Pour chaque propriété de niveau supérieur, telle que com_adobe_analytics, la valeur de l’appel de méthode remplace la valeur entière de configure. Les propriétés de niveau supérieur que vous définissez uniquement dans configure s’appliquent toujours.

Par exemple, si configure définit com_adobe_analytics et com_adobe_target, et qu’un appel sendEvent définit uniquement com_adobe_analytics, cet événement utilise com_adobe_analytics de sendEvent et com_adobe_target de configure. Les propriétés imbriquées dans une propriété de niveau supérieur ne sont pas combinées. Vous devez donc inclure chaque propriété imbriquée dont vous avez besoin, telle que enabled et reportSuites.

Exemple

L’exemple suivant remplace le jeu de données Experience Platform, les suites de rapports Analytics et la propriété Target pour chaque requête :

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  },
  edgeConfigOverrides: {
    com_adobe_experience_platform: {
      datasets: {
        event: {
          datasetId: "64b6f930753dd41ca8d4fd77"
        }
      }
    },
    com_adobe_analytics: {
      reportSuites: ["examplersid1", "examplersid2"]
    },
    com_adobe_target: {
      propertyToken: "01dbc634-07c1-d8f9-ca69-b489a5ac5e94"
    }
  }
});

Remplacements pris en charge properties

Vous pouvez remplacer uniquement les paramètres que vous avez autorisés dans la configuration du flux de données. Voir Remplacements de la configuration des trains de données.