autoCollectPropositionInteractions

La proprietà autoCollectPropositionInteractions è un'impostazione facoltativa che determina se il Web SDK deve raccogliere automaticamente le interazioni della proposta.

Il valore è una mappa dei fornitori di decisioni, ciascuno con un valore che indica come devono essere gestite le interazioni automatiche della proposta.

Valori supportati supported-values

Per impostazione predefinita, le interazioni di proposta automatiche sono sempre raccolte per Adobe Journey Optimizer (AJO) e mai raccolte per Adobe Target (TGT).

Il valore predefinito di autoTrackPropositionInteractions è mostrato di seguito.

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

Fai riferimento alla tabella seguente per i valori di configurazione supportati per ciascun provider di decisioni.

Tracciamento automatico delle interazioni delle proposte logic

Quando abiliti il tracciamento automatico dell'interazione della proposta, tutti i clic all'interno di un elemento della proposta sottoposto a rendering nel DOM verranno raccolti automaticamente da Web SDK. Sono incluse tutte le esperienze sottoposte a rendering automatico nel DOM da Web SDK e le esperienze sottoposte a rendering nel DOM utilizzando il comando applyPropositions.

Attributi dei dati data-attributes

Puoi utilizzare gli attributi di dati sugli elementi per aggiungere specificità a un’interazione.

Esempio

Fai riferimento al frammento di codice seguente per visualizzare un esempio di utilizzo degli attributi di dati.

<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>

Il comando applyPropositions apply-propositions

Per informazioni sul funzionamento di questo comando, consultare la documentazione di applyPropositions.

Il comando applyPropositions è un modo pratico per eseguire il rendering delle proposte in DOM. Tuttavia, nel caso di campagne basate su codice con JSON, puoi utilizzare questo comando per correlare un elemento DOM esistente (o quello di cui il codice dell'applicazione ha eseguito il rendering sullo schermo in base ai valori JSON) con una proposta.

Questa correlazione attiva il tracciamento automatico delle interazioni per quell’elemento e assegna a quell’elemento la proposta appropriata. Per ottenere questo risultato, impostare actionType su track.

Esempio

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

Abilitare il tracciamento automatico delle proposizioni e delle interazioni tramite clic attraverso l’estensione tag Web SDK tag-extension

Abilitare il tracciamento automatico delle proposte e delle interazioni tramite la libreria JavaScript di Web SDK library

Il tracciamento delle proposte è abilitato per impostazione predefinita in Web SDK. Tuttavia, è possibile configurarlo ulteriormente utilizzando il valore autoCollectPropositionInteractions durante l'esecuzione del comando configure.

Se si omette questa proprietà durante la configurazione del Web SDK, per impostazione predefinita viene utilizzato {"AJO": "always", "TGT": "never"}. Se preferisci non tenere traccia automaticamente delle interazioni della proposta, imposta il valore su {"AJO": "never", "TGT": "never"}.

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