autoCollectPropositionInteractions

La propriété autoCollectPropositionInteractions est un paramètre facultatif qui détermine si le SDK Web collecte 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.

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

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"
  }
});

Les propriétés prises en charge dans cet objet sont les suivantes :

Les valeurs possibles pour chaque propriété sont les suivantes :

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

<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/alpha.jpg" class="poster" />
    <h2>Example Movie Alpha</h2>
    <p class="description"> A lighthearted story about exploration and friendship set on a distant world. Follow a curious rover who discovers that small actions can lead to big changes.</p>
    <p>
      <button class="btn btn-default" data-aep-click-label="view-movie-Example-Alpha">View details</button>
    </p>
  </div>
  <div class="col-md-4 movie" data-aep-click-token="6ZUrou9BVKIsINIAqxylzw">
    <img src="/img/bravo.jpg" class="poster" />
    <h2>Example Movie Bravo</h2>
    <p class="description">An uplifting tale of a determined chef who overcomes unlikely odds to create culinary masterpieces in a bustling city bistro.</p>
    <p>
      <button class="btn btn-default" data-aep-click-label="view-movie-Example-Bravo">View details</button>
    </p>
  </div>
  <div class="col-md-4 movie" data-aep-click-token="QuuXntMRGnCP/AsZHf4pnQ">
    <img src="/img/charlie.jpg" class="poster" />
    <h2>Example Movie Charlie</h2>
    <p class="description">A vibrant adventure following a young musician who journeys into a fantastical realm to find the true meaning of family and tradition.</p>
    <p>
      <button class="btn btn-default" data-aep-click-label="view-movie-Example-Charlie">View details</button>
    </p>
  </div>
</div>

Utilisation de autoCollectPropositionInteractions avec la commande applyPropositions apply-propositions

La commande applyPropositions est un moyen pratique de rendre des propositions dans le 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 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.

alloy("sendEvent", {
    renderDecisions: true,
}).then((result) => {
    const {
        propositions = []
    } = result;
    const proposition = propositions.find(
        (proposition) => proposition.scope === "web://example.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://example.com/#weather-widget": {
                    selector: "#weather-widget",
                    actionType: "track",
                },
            },
        });
    }
});

Configuration des interactions de proposition automatiques pour l'extension de balise Web SDK

Les deux menus déroulants suivants lors de la configuration de l’extension de balise Web SDK sont l’équivalent de balise de cet objet :