Åtgärdstyper för kanttillägg

NOTE
Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. Se följande dokument för en konsoliderad hänvisning till terminologiska förändringar.

I en taggregel är en åtgärd en åtgärd som utförs efter att regelvillkoren har utvärderats. Åtgärdstyper tillhandahålls av tillägg, och deras effekter definieras helt av tilläggsförfattaren.

Ett tillägg kan till exempel innehålla en"show support chat"-åtgärdstyp som kan visa en supportchattdialogruta för att hjälpa användare som kan ha problem med utcheckningen.

Det här dokumentet beskriver hur du definierar åtgärdstyper för ett kanttillägg i Adobe Experience Platform.

IMPORTANT
Om du utvecklar ett webbtillägg läser du i handboken åtgärdstyper för webbtillägg i stället.
I det här dokumentet förutsätts även att du känner till biblioteksmoduler och hur de är integrerade i kanttillägg. Om du behöver en introduktion kan du se översikten på formatering av biblioteksmodul innan du återgår till den här guiden.

Åtgärdstyper består vanligtvis av följande:

  1. En vy som visas i användargränssnittet för Experience Platform och datainsamling där användare kan ändra inställningar för åtgärden.
  2. En biblioteksmodul som skickas i taggens körningsbibliotek för att tolka inställningarna och utföra en åtgärd.

En modul för att vidarebefordra vissa data till en slutpunkt från tredje part kan till exempel se ut så här.

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

Om du vill göra slutpunkten konfigurerbar av användaren och tillåta indata och beständighet för en slutpunkt till inställningsobjektet i modulen, ser objektet ut ungefär så här.

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

Om du vill använda den användardefinierade slutpunkten måste modulen ändras till följande exempel.

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

Åtgärdsresultat

Resultatet som returneras av en åtgärdsmodul kan vara vad som helst. Om åtgärden behöver köra en asynkron åtgärd kan du returnera en löfte som returnerar det resultat du vill ha när det har lösts.

Åtgärdsresultatet sparas i en ruleStash som är tillgänglig för alla moduler via context parameter (context.arc.ruleStash). Du kan lära dig mer om ruleStash här.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743