Campagnes activeren met API's trigger-campaigns
Informatie over API-gestuurde campagnes about
Met Journey Optimizer, kunt u campagnes tot stand brengen en hen dan aanhalen van een extern systeem dat op gebruikerstrij wordt gebaseerd die de Interactieve REST API van de Uitvoering van het Berichtgebruikt. 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.
➡️ ontdekt deze eigenschap in video
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. De gedetailleerde informatie over hoe te om een campagne tot stand te brengen is beschikbaar in deze sectie.
-
Maak een nieuwe campagne met het type API-triggered .
-
Kies de categorie Marketing of Transactional , afhankelijk van het type communicatie dat u wilt verzenden.
-
Kies een van de ondersteunde kanalen en de bijbehorende kanaalconfiguratie 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 configureren.
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. -
Geef in de sectie Audience de naamruimte op die moet worden gebruikt om de personen te identificeren.
-
Als u a transactie-type campagne creeert, moeten de gerichte profielen in de API vraag worden bepaald. Met de optie Create new profiles kunt u automatisch profielen maken die niet in de database bestaan. Leer meer op profielverwezenlijking bij campagneuitvoering
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. Leer meer in de Interactieve documentatie van API van de Uitvoering van het Bericht -
Voor marketing - type campagnes, klik de Audience knoop om het publiek te kiezen om te 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.
-
Klik op Review to activate om te controleren of uw campagne correct is geconfigureerd en activeer deze vervolgens.
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 en plak vervolgens het laadverzoek vanuit de sectie cURL request . 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. Voor meer informatie, verwijs naar de Interactieve documentatie van API van de Uitvoering van het Bericht.
API vraagvoorbeelden 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. Hiervoor gebruikt u de syntaxis {{context.<contextualAttribute>}} , waarbij <contextualAttribute> de naam moet hebben van de variabele in de API-lading die de gegevens bevat die u wilt doorgeven.
De syntaxis {{context.<contextualAttribute>}} wordt alleen toegewezen aan een gegevenstype String.
context.system is beperkt tot Adobe intern gebruik en mag niet worden gebruikt om contextuele kenmerken door te geven.Let op: voorlopig is er geen contextueel kenmerk beschikbaar voor gebruik in het menu Linkerspoor. Kenmerken moeten rechtstreeks in uw personalisatie-expressie worden getypt, zonder dat er een controle door Journey Optimizer wordt uitgevoerd.
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 het uitvoeren van de campagne, schakelt u de optie Create new profiles in in de sectie Audience . 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.