Campagnes activeren met API's trigger-campaigns
Informatie over API-gestuurde campagnes about
Met Journey Optimizerkunt u campagnes maken en deze vervolgens aanroepen vanuit een extern systeem op basis van een gebruikerstrigger met behulp van de Interactive Message Execution REST API. Dit staat u toe om diverse marketing en transactionele overseinenbehoeften zoals wachtwoordterugstellen, het teken van OTP, onder andere te behandelen.
Hiervoor moet u eerst een API-getriggerde campagne in Journey Optimizer maken en vervolgens de uitvoering starten via een API-aanroep.
Beschikbare kanalen voor API-getriggerde campagnes zijn E-mail, SMS en Push berichten.
➡️ Deze functie in video detecteren
Een API-gestuurde campagne maken create
De campagne configureren en activeren create-activate
Voer de onderstaande stappen uit om een API-gestuurde campagne te maken. Gedetailleerde informatie over het maken van een campagne is beschikbaar in deze sectie.
-
Maak een nieuwe campagne met de API-triggered type.
-
Kies de optie Marketing of Transactional afhankelijk van het type communicatie dat u wilt verzenden.
-
Kies een van de ondersteunde kanalen en het bijbehorende kanaaloppervlak voor het verzenden van uw bericht en klik op Create.
-
Geef een titel en een beschrijving voor de campagne op en klik vervolgens op Edit content om het te verzenden bericht te vormen.
note note NOTE U kunt aanvullende gegevens doorgeven in de API-lading die u kunt gebruiken om uw bericht aan te passen. Meer informatie Het gebruik van een groot aantal of zware contextafhankelijke gegevens in uw inhoud kan van invloed zijn op de prestaties. -
In de Audience in, geeft u de naamruimte op die moet worden gebruikt om de personen te identificeren.
-
Als u een transactie-type campagne, moeten de gerichte profielen in de API vraag worden bepaald. De Create new profiles kunt u automatisch profielen maken die niet in de database voorkomen. Meer informatie over het maken van profielen tijdens de uitvoering van de campagne
note note NOTE Eén API-aanroep ondersteunt maximaal 20 unieke ontvangers. Elke ontvanger moet een unieke gebruikersnaam hebben. Dubbele gebruikers-id's zijn niet toegestaan. Meer informatie in het dialoogvenster Interactieve API-documentatie voor berichtuitvoering -
Voor marketing-type campagnes, klik Audience om het publiek te kiezen waarop u zich wilt richten.
-
-
De begin- en einddatum van de campagne configureren.
Als u een specifieke begin en/of einddatum voor een campagne vormt, zal het niet buiten deze data worden uitgevoerd, en API vraag zal ontbreken als de campagne door APIs teweeggebracht wordt.
-
Klikken Review to activate om te controleren dat uw campagne correct wordt gevormd, dan activeer het.
U kunt de campagne nu uitvoeren vanuit de API's. Meer informatie
De campagne uitvoeren execute
Nadat de campagne is geactiveerd, moet u het gegenereerde voorbeeld-cURL-verzoek ophalen en deze in de API gebruiken om de payload te bouwen en de campagne te starten.
-
Open de campagne en kopieer vervolgens het laadverzoek van de cURL request sectie. Deze nuttige lading omvat alle verpersoonlijkings (profiel en context) variabelen die in het bericht worden gebruikt. Het is beschikbaar zodra de campagne live is.
-
Gebruik dit cURL-verzoek in de API's om de payload te bouwen en de campagne te starten. Raadpleeg voor meer informatie de Interactieve API-documentatie voor berichtuitvoering.
Voorbeelden van API-aanroepen zijn ook beschikbaar in deze pagina.
note note NOTE Als u een specifieke begin en/of einddatum toen het creëren van de campagne hebt gevormd, zal het niet buiten deze data worden uitgevoerd, en API vraag zal ontbreken.
Contextafhankelijke kenmerken gebruiken in door API's geactiveerde campagnes contextual
Met API-getriggerde campagnes kunt u aanvullende gegevens doorgeven in de API-lading en deze gebruiken in de campagne om uw bericht aan te passen.
Neem dit voorbeeld, waar de klanten hun wachtwoord willen terugstellen, en u hen een wachtwoord wilt verzenden terugstellen URL die in een derdehulpmiddel wordt geproduceerd. Met API-getriggerde campagnes kunt u deze gegenereerde URL doorgeven in de API-lading en deze gebruiken in de campagne om deze toe te voegen aan het bericht.
Om deze gegevens in uw campagnes te gebruiken, moet u hen in de API lading overgaan, en hen toevoegen in uw bericht gebruikend de verpersoonlijkingsredacteur. Om dit te doen, gebruik {{context.<contextualAttribute>}}
syntaxis, waarbij <contextualAttribute>
moet overeenkomen met de naam van de variabele in de API-lading die de gegevens bevat die u wilt doorgeven.
De {{context.<contextualAttribute>}}
syntaxis wordt alleen toegewezen aan een gegevenstype String.
context.system
syntaxis is beperkt tot Adobe intern gebruik en mag niet worden gebruikt om contextafhankelijke kenmerken door te geven.Let op: voorlopig is er geen contextueel kenmerk beschikbaar voor gebruik in het menu Linkerspoor. De attributen moeten direct in uw verpersoonlijkingsuitdrukking worden getypt, zonder controle die door Journey Optimizer.
Profiel maken tijdens uitvoering van de campagne profile-creation
In sommige gevallen moet u mogelijk transactieberichten verzenden naar profielen die niet in het systeem bestaan. Bijvoorbeeld als een onbekende gebruiker het wachtwoord op uw website opnieuw probeert in te stellen.
Wanneer een profiel niet in de database bestaat, kunt u het door Journey Optimizer automatisch maken tijdens het uitvoeren van de campagne om het verzenden van het bericht naar dit profiel toe te staan.
Als u het maken van profielen wilt activeren tijdens de uitvoering van de campagne, schakelt u het Create new profiles in de Audience sectie. Als deze optie is uitgeschakeld, worden onbekende profielen voor verzending geweigerd en mislukt de API-aanroep.
Hoe kan ik-video video
Leer hoe te om een campagne tot stand te brengen en het van een extern systeem teweeg te brengen dat op gebruikersinteractie wordt gebaseerd, gebruikend de Interactieve REST API van de Uitvoering van het Bericht.