Tipi di azioni per le estensioni Edge

NOTA

Adobe Experience Platform Launch è stato classificato come una suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

In una regola di tag, un'azione viene eseguita dopo che le condizioni della regola hanno superato la valutazione. I tipi di azione vengono forniti dalle estensioni e i loro effetti sono interamente definiti dall'autore dell'estensione.

Ad esempio, un’estensione potrebbe fornire un tipo di azione “show support chat” che potrebbe mostrare una finestra di dialogo con la chat di supporto per aiutare gli utenti che riscontrano difficoltà nel concludere un acquisto.

Questo documento illustra come definire i tipi di azioni per un'estensione Edge in Adobe Experience Platform.

IMPORTANTE

Se stai sviluppando un'estensione web, consulta invece la guida sui tipi di azione per le estensioni web.

Questo documento presuppone anche che tu abbia familiarità con i moduli di libreria e con il modo in cui sono integrati nelle estensioni edge. Per un'introduzione, vedere la panoramica sulla formattazione del modulo libreria prima di tornare a questa guida.

I tipi di azione in genere consistono nei seguenti elementi:

  1. Visualizzazione nell’interfaccia utente di raccolta dati che consente agli utenti di modificare le impostazioni dell’azione.
  2. Un modulo libreria emesso all'interno della libreria di runtime di tag per interpretare le impostazioni ed eseguire un'azione.

Ad esempio, un modulo per inoltrare alcuni dati a un endpoint di terze parti potrebbe avere questo aspetto.

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  return fetch('http://someendpoint.com', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

Se si desidera configurare l’endpoint dall’utente e consentire l’input e la persistenza di un endpoint nell’oggetto delle impostazioni all’interno del modulo, l’oggetto avrà un aspetto simile a questo.

{
  "endpoint": "http://someendpoint.com"
}

Per funzionare sull’endpoint definito dall’utente, il modulo deve passare all’esempio seguente.

module.exports = (context) {
  const { arc, utils } = context;
  const { fetch } = utils;
  const { event: { xdm } } = arc;
  const  { endpoint } = settings;
  return fetch(endpoint, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(xdm)
  })
};

Risultato azione

Il risultato restituito da un modulo di azione può essere qualsiasi cosa. Se l'azione deve eseguire un'attività asincrona, è possibile restituire una promessa che restituisce il risultato desiderato una volta risolta.

Il risultato dell'azione viene memorizzato all'interno di una chiave ruleStash che viene resa disponibile a tutti i moduli tramite il parametro context (context.arc.ruleStash). Ulteriori informazioni su ruleStash sono disponibili qui.

In questa pagina