autoCollectPropositionInteractions

A propriedade autoCollectPropositionInteractions é uma configuração opcional que determina se o Web SDK deve coletar automaticamente interações de apresentação.

O valor é um mapa de provedores de decisão, cada um com um valor que indica como as interações automáticas de apresentação devem ser tratadas.

Valores compatíveis supported-values

Por padrão, as interações automáticas de apresentação são sempre coletadas para Adobe Journey Optimizer (AJO) e nunca coletadas para Adobe Target (TGT).

O valor padrão de autoTrackPropositionInteractions é mostrado abaixo.

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

Consulte a tabela abaixo para obter os valores de configuração compatíveis com cada provedor de decisão.

Rastreamento automático da interação da apresentação logic

Ao habilitar o rastreamento automático de interação de apresentação, os cliques em um elemento de apresentação renderizado para o DOM serão coletados automaticamente pelo Web SDK. Isso inclui quaisquer experiências renderizadas automaticamente para o DOM por Web SDK e experiências renderizadas para o DOM usando o comando applyPropositions.

Atributos de dados data-attributes

Você pode usar atributos de dados em elementos para adicionar especificidade a uma interação.

Exemplo

Consulte o trecho de código abaixo para ver um exemplo do uso de atributos de dados.

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

O comando applyPropositions apply-propositions

Consulte a documentação do applyPropositions para saber como esse comando funciona.

O comando applyPropositions é uma maneira conveniente de renderizar apresentações para o DOM. No entanto, no caso de campanhas baseadas em código com JSON, você pode usar este comando para correlacionar um elemento DOM existente (ou aquele que seu código de aplicativo renderizou para a tela com base nos valores JSON) com uma proposta.

Essa correlação ativa o rastreamento automático de interação para esse elemento e atribui a esse elemento a apresentação apropriada. Para fazer isso, defina o actionType como track.

Exemplo

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

Ativar o rastreamento de cliques de apresentações e interações automáticas por meio da extensão de tag do Web SDK tag-extension

Ativar o rastreamento de links de propostas e interações automáticas por meio da biblioteca JavaScript do Web SDK library

O rastreamento de apresentações é habilitado por padrão em Web SDK. No entanto, você pode configurá-lo ainda mais usando o valor autoCollectPropositionInteractions ao executar o comando configure.

Se você omitir essa propriedade ao configurar o Web SDK, o padrão será {"AJO": "always", "TGT": "never"}. Se preferir não rastrear automaticamente as interações de apresentação, defina o valor como {"AJO": "never", "TGT": "never"}.

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