Utlösa kampanjer med API:er trigger-campaigns
Om API-utlösta kampanjer about
Med Journey Optimizer kan du skapa kampanjer och sedan anropa dem från ett externt system baserat på användarutlösaren med hjälp av REST API:t för interaktiv meddelandekörning. På så sätt kan ni täcka olika behov av marknadsföring och transaktionsmeddelanden, som lösenordsåterställningar, OTP-token, bland annat.
För att göra detta måste du först skapa en API-utlöst kampanj i Journey Optimizer och sedan starta körningen via ett API-anrop.
Tillgängliga kanaler för API-utlösta kampanjer är e-post-, SMS- och push-meddelanden.
➡️ Upptäck den här funktionen i videon
Skapa en API-utlöst kampanj create
Konfigurera och aktivera kampanjen create-activate
Följ stegen nedan för att skapa en API-utlöst kampanj. Detaljerad information om hur du skapar en kampanj finns i det här avsnittet.
-
Skapa en ny kampanj med typen API-triggered.
-
Välj kategorin Marketing eller Transactional beroende på vilken typ av kommunikation du vill skicka.
-
Välj en av kanalerna som stöds och den associerade kanalytan som ska användas för att skicka meddelandet och klicka sedan på Create.
-
Ange en titel och en beskrivning för kampanjen och klicka sedan på Edit content för att konfigurera meddelandet som ska skickas.
note note NOTE Du kan skicka ytterligare data till API-nyttolasten som du kan använda för att anpassa meddelandet. Läs mer Om du använder ett stort antal eller stora sammanhangsberoende data i ditt innehåll kan det påverka prestanda. -
I avsnittet Audience anger du det namnutrymme som ska användas för att identifiera de enskilda personerna.
-
Om du skapar en kampanj av typen transactional måste målprofilerna definieras i API-anropet. Med alternativet Create new profiles kan du automatiskt skapa profiler som inte finns i databasen. Läs mer om att skapa profiler vid kampanjkörning
note note NOTE Ett enda API-anrop stöder upp till 20 unika mottagare. Varje mottagare måste ha ett unikt användar-ID. Dubblerade användar-ID tillåts inte. Läs mer i API-dokumentationen för interaktiv meddelandekörning -
Klicka på knappen Audience för att välja målgrupp för kampanjer av typen marketing.
-
-
Konfigurera kampanjens start- och slutdatum.
Om du konfigurerar ett specifikt start- och/eller slutdatum för en kampanj körs det inte utanför dessa datum, och API-anrop misslyckas om kampanjen aktiveras av API:er.
-
Klicka på Review to activate för att kontrollera att kampanjen är korrekt konfigurerad och aktivera den sedan.
Du är nu redo att köra kampanjen från API:erna. Läs mer
Kör kampanjen execute
När kampanjen har aktiverats måste du hämta den genererade cURL-exempelbegäran och använda den i API:t för att skapa din nyttolast och utlösa kampanjen.
-
Öppna kampanjen och kopiera och klistra sedan in nyttolastbegäran från avsnittet cURL request. Den här nyttolasten innehåller alla personaliseringsvariabler (profil och kontext) som används i meddelandet. Den blir tillgänglig när kampanjen är live.
-
Använd denna cURL-begäran i API:erna för att bygga upp din nyttolast och utlösa kampanjen. Mer information finns i API-dokumentationen för interaktiv meddelandekörning.
Exempel på API-anrop finns också på den här sidan.
note note NOTE Om du har konfigurerat ett specifikt start- och/eller slutdatum när du skapar kampanjen kommer den inte att köras utanför dessa datum och API-anrop misslyckas.
Använd kontextuella attribut i API-utlösta kampanjer contextual
Med kampanjer som triggas av API kan ni skicka ytterligare data i API-nyttolasten och använda dem i kampanjen för att personalisera ert budskap.
Låt oss ta det här exemplet där kunderna vill återställa sitt lösenord och du vill skicka en URL för återställning av lösenord som genereras i ett verktyg från tredje part. Med API-utlösta kampanjer kan du skicka den här genererade URL:en till API-nyttolasten och sedan använda den i kampanjen för att lägga till den i meddelandet.
För att kunna använda dessa data i era kampanjer måste ni skicka dem till API-nyttolasten och lägga till dem i meddelandet med personaliseringsredigeraren. Använd syntaxen {{context.<contextualAttribute>}} där <contextualAttribute> ska matcha namnet på variabeln i API-nyttolasten som innehåller de data som du vill skicka.
Syntaxen {{context.<contextualAttribute>}} är endast mappad till datatypen String.
context.system är begränsad till intern användning i Adobe och ska inte användas för att skicka kontextuella attribut.Observera att det för närvarande inte finns något sammanhangsberoende attribut tillgängligt för användning på den vänstra menyn. Attribut måste anges direkt i ditt personaliseringsuttryck utan att någon kontroll utförs av Journey Optimizer.
Skapa profiler vid kampanjkörning profile-creation
I vissa fall kan du behöva skicka transaktionsmeddelanden till profiler som inte finns i systemet. Om en okänd användare till exempel försöker återställa lösenordet på webbplatsen.
När det inte finns någon profil i databasen kan du i Journey Optimizer automatiskt skapa den när kampanjen körs för att tillåta att meddelandet skickas till den här profilen.
Aktivera alternativet Create new profiles i avsnittet Audience om du vill aktivera skapande av profiler vid kampanjkörning. Om det här alternativet är inaktiverat kommer okända profiler att avvisas för alla utskickningar och API-anropet kommer att misslyckas.
Instruktionsvideo video
Lär dig hur du skapar en kampanj och utlöser den från ett externt system baserat på användarinteraktioner med hjälp av REST-API:t för interaktiv meddelandekörning.