Een aangepaste handeling configureren configure-an-action
Als u een derdesysteem gebruikt om berichten te verzenden of als u reizen API vraag naar een derdesysteem wilt verzenden, gebruik douaneacties om zijn verbinding aan uw reis te vormen. U kunt bijvoorbeeld met aangepaste handelingen verbinding maken met de volgende systemen: Epsilon, Slack, Adobe Developer, Firebase, enz.
Aangepaste acties zijn aanvullende acties die door technische gebruikers worden gedefinieerd en beschikbaar worden gesteld aan verkopers. Zodra gevormd, verschijnen zij in het linkerpalet van uw reis, in Action categorie. Meer informatie in deze pagina.
Beperkingen custom-actions-limitations
Aangepaste acties worden geleverd met enkele beperkingen die worden vermeld in deze pagina.
In parameters voor aangepaste handelingen kunt u een eenvoudige verzameling en een verzameling objecten doorgeven. Meer informatie over verzamelingsbeperkingen vindt u in deze pagina.
De parameters voor aangepaste handelingen hebben een verwachte indeling (bijvoorbeeld tekenreeks, decimaal, enz.). U moet deze verwachte formaten zorgvuldig respecteren. Meer informatie in deze use case.
Aangepaste acties ondersteunen alleen de JSON-indeling bij gebruik van verzoek of antwoordlading.
Aanbevolen procedures custom-action-enhancements-best-practices
Wanneer het kiezen van een eindpunt om het gebruiken van een douaneactie te richten, ben zeker dat:
- Dit eindpunt kan de productie van de reis, gebruikend configuraties van steunen Throttling API of API voor uitlijnen om het te beperken. Wees voorzichtig dat een snelheidsbegrenzingsconfiguratie niet lager kan zijn dan 200 TPS. Om het even welk gericht eindpunt zal minstens 200 TPS moeten steunen.
- Dit eindpunt moet een reactietijd hebben zo laag mogelijk. Afhankelijk van uw verwachte productie, zou het hebben van een hoge reactietijd de daadwerkelijke productie kunnen beïnvloeden.
Een maximum van 300.000 vraag over één minuut wordt bepaald voor alle douaneacties. Daarnaast wordt de standaarduitlijning uitgevoerd per host en per sandbox. Op een sandbox bijvoorbeeld als u twee eindpunten met dezelfde host hebt (bijvoorbeeld: https://www.adobe.com/endpoint1 en https://www.adobe.com/endpoint2), wordt de aftopping toegepast op alle eindpunten onder de host adobe.com. De "eindpunt1"en "eindpunt2"zullen de zelfde het begrenzen configuratie delen en het hebben van één eindpunt bereikt de grens zal een effect op het andere eindpunt hebben.
Deze grens is geplaatst gebaseerd op klantengebruik, om externe eindpunten te beschermen die door douaneacties worden gericht. U moet hiermee rekening houden bij reizen voor uw publiek door een juiste leessnelheid te definiëren (5000 profielen/s wanneer aangepaste handelingen worden gebruikt). Indien nodig, kunt u deze het plaatsen met voeten treden door een grotere het maximum van het maximum of het vertragen grens door onze Capping/het Draaien APIs te bepalen. Zie deze pagina.
U zou openbare eindpunten met douaneacties niet om verschillende redenen moeten richten:
- Zonder behoorlijk het in kaart brengen of het vertragen, is er een risico om teveel vraag naar een openbaar eindpunt te verzenden dat zulk volume niet kan steunen.
- De gegevens van het profiel kunnen door douaneacties worden verzonden, zodat het richten van een openbaar eindpunt tot onbedoeld het delen van persoonlijke informatie buiten zou kunnen leiden.
- U hebt geen controle over de gegevens die door openbare eindpunten worden teruggekeerd. Als een eindpunt zijn API verandert of onjuiste informatie begint te verzenden, zullen die in verzonden mededelingen, met potentiële negatieve gevolgen ter beschikking worden gesteld.
Toestemming en gegevensbeheer privacy
In Journey Optimizer kunt u beleid voor gegevensbeheer en toestemming toepassen op uw aangepaste acties om te voorkomen dat bepaalde velden worden geëxporteerd naar systemen van derden of om klanten uit te sluiten die niet hebben ingestemd met het ontvangen van e-mail, push- of SMS-berichten. Raadpleeg de volgende pagina's voor meer informatie:
Configuratiestappen configuration-steps
Hier zijn de belangrijkste stappen die worden vereist om een douaneactie te vormen:
-
Selecteer in de sectie van het menu ADMINISTRATIE de optie Configurations. In de Actions sectie, klikken Manage. Klikken Create Action om een nieuwe handeling te maken. Het deelvenster Handelingsconfiguratie wordt aan de rechterkant van het scherm geopend.
-
Voer een naam in voor de handeling.
note note NOTE Alleen alfanumerieke tekens en onderstrepingstekens zijn toegestaan. De maximumlengte is 30 tekens. -
Voeg een beschrijving aan uw actie toe. Deze stap is optioneel.
-
Het aantal ritten dat deze handeling gebruikt, wordt weergegeven in het dialoogvenster Used in veld. U kunt op de knop View journeys om de lijst met reizen weer te geven die deze handeling gebruiken.
-
Verschillende definiëren URL Configuration parameters. Zie deze pagina.
-
Vorm Authentication sectie. Deze configuratie is het zelfde als voor gegevensbronnen. Zie deze sectie.
-
Definieer de Action parameters. Zie deze pagina.
-
Klikken Save.
De aangepaste handeling is nu geconfigureerd en klaar om te worden gebruikt tijdens uw reizen. Zie deze pagina.
note note NOTE Wanneer een douaneactie in een reis wordt gebruikt, zijn de meeste parameters read-only. U kunt alleen de Name, Description, URL en de Authentication sectie.
Eindpuntconfiguratie url-configuration
Wanneer het vormen van een douaneactie, moet u het volgende bepalen Endpoint Configuration parameters:
-
In de URL -veld, geeft u de URL van de externe service op:
-
Als de URL statisch is, voert u de URL in dit veld in.
-
Als de URL een dynamisch pad bevat, voert u alleen het statische gedeelte van de URL in, dat wil zeggen het schema, de host, de poort en eventueel een statisch gedeelte van het pad.
Voorbeeld:
https://xxx.yyy.com/somethingstatic/U geeft het dynamische pad van de URL op wanneer u de aangepaste handeling aan een rit toevoegt. Meer informatie.
note note NOTE Om veiligheidsredenen raden we u ten zeerste aan het HTTPS-schema te gebruiken voor de URL. Wij staan niet het gebruik van Adobe adressen toe die niet openbaar en het gebruik van IP adressen zijn. Alleen de standaardpoorten zijn toegestaan bij het definiëren van een aangepaste handeling: 80 voor http en 443 voor https. -
-
Selecteer de vraag Method: het kan POST, GET of PUT.
note note NOTE De DELETE methode wordt niet ondersteund. Als u een bestaande bron moet bijwerken, selecteert u de optie PUT methode. -
Definieer de headers en queryparameters:
- In de Headers sectie, klikken Add a header field om de kopballen van HTTP van het verzoekbericht te bepalen dat naar de externe dienst moet worden verzonden. De Content-Type en Charset koptekstvelden worden standaard ingesteld. U kunt deze velden niet verwijderen. Alleen de Content-Type header kan worden gewijzigd. De waarde ervan moet de JSON-indeling respecteren. Hier is de standaardwaarde:
- In de Query parameters sectie, klikken Add a Query parameter field om de parameters te bepalen u in URL wilt toevoegen.
-
Voer het label of de naam van het veld in.
-
Selecteer het type: Constant of Variable. Als u Constant Voer vervolgens de constante waarde in het dialoogvenster Value veld. Als u Variable, dan zult u deze variabele specificeren wanneer het toevoegen van de douaneactie aan een reis. Meer informatie.
note note NOTE Nadat u de douaneactie aan een reis hebt toegevoegd, kunt u kopbal of vraagparametergebieden aan het nog toevoegen als de reis in ontwerpstatus is. Als u niet wilt dat de reis door configuratieveranderingen wordt beïnvloed, dupliceer de douaneactie en voeg de gebieden aan de nieuwe douaneactie toe. Kopteksten worden gevalideerd volgens veldparseringsregels. Meer informatie in deze documentatie.
mTLS-protocolondersteuning mtls-protocol-support
U kunt de Wederzijdse Veiligheid van de Laag van het Vervoer (mTLS) nu gebruiken om verbeterde veiligheid in uitgaande verbindingen aan de douaneacties van Adobe Journey Optimizer te verzekeren. mTLS is een end-to-end veiligheidsmethode voor wederzijdse authentificatie die ervoor zorgt dat beide partijen die informatie delen wie zij beweren te zijn alvorens de gegevens worden gedeeld. mTLS bevat een extra stap in vergelijking met TLS, waarin de server ook om het certificaat van de client vraagt en dit aan het einde verifieert.
Wederzijdse TLS-verificatie (mTLS) wordt ondersteund in aangepaste handelingen. Er is geen extra configuratie vereist in de douaneactie of de reis om mTLS te activeren; het komt automatisch voor wanneer een mTLS-Toegelaten eindpunt wordt ontdekt. Meer informatie.
De parameters voor de nuttige lading definiëren define-the-message-parameters
-
In de Request plakken, plakt u een voorbeeld van de JSON-payload die u naar de externe service wilt verzenden. Dit gebied is facultatief en slechts beschikbaar voor POST en PUT die methodes roepen.
-
In de Response plakken, een voorbeeld van de lading die door de vraag is teruggekeerd. Dit veld is optioneel en beschikbaar voor alle aanroepmethoden. Voor gedetailleerde informatie over het gebruik van API-aanroepreacties in aangepaste handelingen raadpleegt u deze pagina.
U kunt het parametertype definiëren (bijvoorbeeld: tekenreeks, geheel getal, enz.).
U kunt ook opgeven of een parameter een constante of een variabele is.
- Constante betekent dat de waarde van de parameter in de ruit van de actieconfiguratie door een technische persoon wordt bepaald. De waarde zal altijd het zelfde over reizen zijn. Het zal niet variëren en de marktleider zal het niet zien wanneer het gebruiken van de douaneactie in de reis. Het kan bijvoorbeeld een id zijn die het externe systeem verwacht. In dat geval is het veld rechts van de schakelconstante/variabele de doorgegeven waarde.
- Variabele betekent dat de waarde van de parameter zal variëren. Marktdeelnemers die deze aangepaste handeling tijdens een reis gebruiken, kunnen de gewenste waarde doorgeven of opgeven waar de waarde voor deze parameter moet worden opgehaald (bijvoorbeeld vanaf het evenement, vanuit Adobe Experience Platform, enz.). In dat geval, is het gebied op het recht van de knevelconstante/variabele de etiketmarketers in de reis zullen zien om deze parameter te noemen.
