autoCollectPropositionInteractions

La propriété autoCollectPropositionInteractions est un paramètre facultatif qui détermine si le SDK Web doit collecter automatiquement les interactions de proposition.

La valeur est une carte des fournisseurs de décision, chacun avec une valeur indiquant la manière dont les interactions de proposition automatiques doivent être traitées.

Valeurs prises en charge supported-values

Par défaut, les interactions de proposition automatiques sont toujours collectées pour Adobe Journey Optimizer (AJO) et jamais collectées pour Adobe Target (TGT).

La valeur par défaut de autoTrackPropositionInteractions est affichée ci-dessous.

{
  "AJO": "always",
  "TGT": "never"
}

Consultez le tableau ci-dessous pour connaître les valeurs de configuration prises en charge pour chaque fournisseur de décision.

Suivi automatique des interactions de proposition logic

Lorsque vous activez le suivi automatique des interactions de proposition, tous les clics dans un élément de proposition rendu au DOM sont automatiquement collectés par le Web SDK. Cela inclut toutes les expériences rendues automatiquement au DOM par Web SDK et les expériences rendues au DOM à l’aide de la commande applyPropositions.

Attributs de données data-attributes

Vous pouvez utiliser des attributs de données sur les éléments pour ajouter de la spécificité à une interaction.

Exemple

Reportez-vous au fragment de code ci-dessous pour voir un exemple d’utilisation des attributs de données.

<div class="row movies" data-aep-interact-id="5">
  <div class="col-md-4 movie" data-aep-click-token="wlpk/z/qyDGoFGF1E47O0w">
    <img src="/img/walle.jpg" class="poster" />
    <h2>WALL·E</h2>
    <p class="description"> In a distant, but not so unrealistic, future where mankind has abandoned earth because it has become covered with trash from products sold by the powerful multi-national Buy N Large corporation, WALL-E, a garbage collecting robot has been left to clean up the mess. </p>
    <p>
      <button class="btn btn-default" data-aep-click-label="view-movie-WALL·E"> View details >> </button>
    </p>
  </div>
  <div class="col-md-4 movie" data-aep-click-token="6ZUrou9BVKIsINIAqxylzw">
    <img src="/img/ratatouille.jpg" class="poster" />
    <h2>Ratatouille</h2>
    <p class="description"> A rat named Remy dreams of becoming a great French chef despite his family's wishes and the obvious problem of being a rat in a decidedly rodent-phobic profession. When fate places Remy in the sewers of Paris, he finds himself ideally situated beneath a restaurant made famous by his culinary hero, Auguste Gusteau. </p>
    <p>
      <button class="btn btn-default" data-aep-click-label="view-movie-Ratatouille"> View details >> </button>
    </p>
  </div>
  <div class="col-md-4 movie" data-aep-click-token="QuuXntMRGnCP/AsZHf4pnQ">
    <img src="/img/coco.jpg" class="poster" />
    <h2>Coco</h2>
    <p class="description"> Despite his family's baffling generations-old ban on music, Miguel dreams of becoming an accomplished musician like his idol, Ernesto de la Cruz. Desperate to prove his talent, Miguel finds himself in the stunning and colorful Land of the Dead following a mysterious chain of events. </p>
    <p>
      <button class="btn btn-default" data-aep-click-label="view-movie-Coco"> View details >> </button>
    </p>
  </div>
</div>

La commande applyPropositions apply-propositions

Reportez-vous à la documentation applyPropositions pour en savoir plus sur le fonctionnement de cette commande.

La commande applyPropositions est un moyen pratique de rendre des propositions au DOM. Cependant, dans le cas de campagnes basées sur du code avec JSON, vous pouvez utiliser cette commande pour corréler un élément de DOM existant (ou celui que le code de votre application a rendu à l’écran en fonction des valeurs JSON) à une proposition.

Cette corrélation active le suivi automatique des interactions pour cet élément et attribue à cet élément la proposition appropriée. Pour ce faire, définissez la actionType sur track.

Exemple

alloy("sendEvent", {
    renderDecisions: true,
}).then((result) => {
    const {
        propositions = []
    } = result;
    const proposition = propositions.find(
        (proposition) => proposition.scope === "web://mywebsite.com/#weather-widget"
    );

    if (proposition) {
        renderWeatherWidget(proposition); // custom code that renders the weather widget based on the code-based campaign JSON

        alloy("applyPropositions", {
            propositions: [proposition],
            metadata: {
                "web://mywebsite.com/#weather-widget": {
                    selector: "#weather-widget",
                    actionType: "track",
                },
            },
        });
    }
});

Activer le suivi des clics des propositions et interactions automatiques par le biais de l’extension de balises Web SDK tag-extension

Activer le suivi des liens des propositions et interactions automatiques via la bibliothèque JavaScript Web SDK library

Le suivi des propositions est activé par défaut dans Web SDK. Cependant, vous pouvez le configurer davantage à l’aide de la valeur autoCollectPropositionInteractions lors de l’exécution de la commande configure.

Si vous omettez cette propriété lors de la configuration de Web SDK, elle est définie par défaut sur {"AJO": "always", "TGT": "never"}. Si vous préférez ne pas suivre automatiquement les interactions de proposition, définissez la valeur sur {"AJO": "never", "TGT": "never"}.

alloy("configure", {
   "edgeConfigId": "ebebf826-a01f-4458-8cec-ef61de241c93",
   "orgId": "ADB3LETTERSANDNUMBERS@AdobeOrg",
   "autoCollectPropositionInteractions": {"AJO": "always", "TGT": "never"}
});