Aan de slag met ontwikkelaars get-started-developers
Als a Ontwikkelaar, bent u verantwoordelijk voor het uitvoeren van en het integreren van Adobe Journey Optimizer in uw toepassingen en systemen. U kunt beginnen met Adobe Journey Optimizer te werken zodra de Beheerder van het Systeem en de Ingenieur van Gegevens u toegang hebben verleend en uw milieu hebben voorbereid.
Uw rol in het ecosysteem van Journey Optimizer
Terwijl andere teamleden Journey Optimizer configureren via de gebruikersinterface, richt u zich op:
- Uitvoerend SDKs in mobiele en Webtoepassingen
- Verzendende gebeurtenissen van uw toepassingen om reizen teweeg te brengen
- bouw API eindpunten die Journey Optimizer via douaneacties kan roepen
- Integrerend Journey Optimizer met uw bestaande systemen en infrastructuur
- het Testen en het zuiveren uw implementaties
Uw Ingenieur van Gegevens zal gegevensschema’s, gebeurtenisconfiguraties, en gegevensbronnen behandelen. Uw Beheerder zal opstellingstoestemmingen en kanaalconfiguraties. Marketers zullen de reizen en de inhoud ontwerpen die uw implementaties gebruiken.
In deze handleiding worden de belangrijkste stappen besproken die nodig zijn om u op weg te helpen met Journey Optimizer. Of u nu mobiele apps, webervaringen of API-integratie ontwikkelt, volg de onderstaande secties om uw implementatie in te stellen.
Vereisten prerequisites
Voordat u met de implementatie begint, moet u controleren of:
* Begrip van RESTful APIs en JSON
* Familiariteit met asynchrone programmering en gebeurtenis-gedreven architectuur
* Kennis van de de toepassingsarchitectuur van uw organisatie
* het milieu van de Ontwikkeling met toegang tot codebase van uw toepassing
* het Testen hulpmiddelen zoals Postman voor API het testen
* Browser ontwikkelaarshulpmiddelen of mobiele het zuiveren hulpmiddelen
* XDM schema’s en gebeurtenisdefinities van uw Ingenieur van Gegevens
* Vereisten en gebruiksgevallen van uw Marketers
De technische basis begrijpen technical-foundation
Voordat u de implementatie ingaat, moet u zich vertrouwd maken met de belangrijkste technische concepten:
-
de integratie van Adobe Experience Platform: Journey Optimizer is in eigen land gebouwd op Adobe Experience Platform. Kennis van de onderliggende architectuur helpt u effectievere implementaties te maken. Leer meer over hoe Journey Optimizer werkt.
-
XDM gegevensmodellen: Journey Optimizer maakt gebruik van het XDM (Experience Data Model) om gebeurtenis- en profielgegevens te structureren. Als ontwikkelaar, zult u moeten begrijpen hoe te om gegevens te verzenden die aan de schema’s in overeenstemming zijn die door uw Ingenieur van Gegevens worden gevormd. Leer over schema’s XDM .
-
Authentificatie en veiligheid: Voor alle implementaties is een correcte verificatie vereist. Begrijp hoe te opstellingsauthentificatie voor SDKs en APIs. Leer over API authentificatie .
Integratie van mobiele apps instellen mobile-integration
Adobe Experience Platform Mobile SDK configureren
Als u pushberichten, in-app berichten en andere mobiele mogelijkheden wilt inschakelen, integreert u de Adobe Experience Platform Mobile SDK in uw mobiele toepassingen.
-
installeer en vorm Mobiele SDK: Volg de documentatie van Adobe Experience Platform Mobile SDK om met de integratie van SDK te beginnen.
-
creeer een mobiel bezit: Stel een eigenschap mobile in in Adobe Experience Platform Data Collection . Leer hoe te tot stand brengen en een mobiel bezit vormen.
-
vorm dupberichten:
- Voor iOS apps: Registreer uw app bij APNs (Apple Push Notification service). Leer meer in documentatie van Apple .
- Voor Android apps: Stel Firebase Cloud Messaging in voor uw Android-app. Leer meer in documentatie van Google .
-
Test uw mobiele integratie: Gebruik het mobiele onboarding snel beginwerkschema om uw mobiele opstelling snel te vormen en te testen.
De gedetailleerde stappen om dupberichten te vormen zijn beschikbaar op deze pagina .
Op code gebaseerde ervaringen implementeren (Mobile SDK)
Voor systeemeigen mobiele app-personalisatie met gebruik van op code gebaseerde ervaringen:
- Volg dit leerprogramma voor de Mobiele implementatie van SDK
- De steekproefimplementaties van het overzicht voor iOS en Android
Webervaringen implementeren web-implementation
Adobe Experience Platform Web SDK instellen
Voor web-based implementaties, is het Web SDK uw belangrijkste integratiepunt:
-
installeer het Web SDK: Volg de de implementatiegids van SDK van het Web aan opstelling SDK op uw website.
-
vorm gegevensstromen: Maak en configureer een gegevensstroom in Adobe Experience Platform Data Collection met Journey Optimizer ingeschakeld. Leer meer in de documentatie van gegevensstromen .
-
laat Web pushberichten (facultatief) toe: Webpushmeldingen zijn nu over het algemeen beschikbaar. Vorm het pushNotifications bezit in uw configuratie van SDK van het Web en gebruik het sendPushSubscription bevel om pushabonnementen te registreren. leer over Web duw configuratie .
Implementeer op code gebaseerde ervaringen (Web SDK)
Met codegebaseerde ervaringen kunt u elk digitaal aanraakpunt aanpassen:
-
kies uw implementatiemethode: Client-kant, server-kant, of hybride. Herzie implementatiemonsters voor elke benadering.
-
bepaal oppervlakten: Identificeer de plaatsen in uw toepassing waar u gepersonaliseerde inhoud wilt leveren. Leer over oppervlakteconfiguratie .
-
voert inhoud uit die teruggeeft: Gebruik het Web SDK om personalisatie-inhoud op te halen en toe te passen. Zie code-gebaseerde implementatieleerprogramma’s .
-
verzend vertoning en interactiegebeurtenissen: Houd bij wanneer inhoud wordt weergegeven en wanneer gebruikers ermee werken voor analyse en optimalisatie.
Onderzoek steekproefimplementaties op GitHub om code-gebaseerde ervaringen in actie te zien.
Leer meer over begonnen worden met code-gebaseerde ervaringen .
Gebeurtenisstreaming implementeren event-streaming
Gebeurtenissen verzenden om reizen te activeren
Als ontwikkelaar, zult u de code uitvoeren om gebeurtenissen te verzenden die reizen teweegbrengen. Uw Ingenieur van Gegevens zal de gebeurtenisschema’s en definities in Journey Optimizer vormen.
-
begrijp de gebeurtenislading: Werk met uw Ingenieur van Gegevens om het gebeurtenisschema en de vereiste loonladingsstructuur te krijgen. De nuttige lading moet met het XDM schema in overeenstemming zijn zij hebben gevormd. Leer over vereisten van het gebeurtenisschema .
-
voer gebeurtenis het stromen uit: Verzend gebeurtenissen naar Adobe Experience Platform gebruikend Streaming Ingestie APIs . Leer de stappen om gebeurtenissen te verzenden.
-
de gebeurtenistypen van de Handle:
- Eenheid gebeurtenissen: Gebeurtenis verzenden voor persoonlijk specifieke handelingen (bijvoorbeeld klikken op een knop, voltooiing van de aankoop) implementeren
- Bedrijfs gebeurtenissen: Zakelijke gebeurtenissen verzenden (bijvoorbeeld voorraadupdates, prijswijzigingen)
-
de gebeurtenislevering van 0} Test: Controleer of gebeurtenissen correct zijn ontvangen en activeer de reis zoals u had verwacht. Leer over gebeurtenis het oplossen van problemen .
implementatie van het Voorbeeld voor het verzenden van een gebeurtenis via API:
POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json
{
"header": {
"datasetId": "{DATASET_ID}",
"imsOrgId": "{ORG_ID}",
"source": {
"name": "Web SDK"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "{SCHEMA_ID}"
}
},
"xdmEntity": {
"_id": "unique-event-id",
"eventType": "purchase",
"timestamp": "2024-01-01T12:00:00Z",
// ... your event data
}
}
}
Leer meer over het werken met reisgebeurtenissen .
Eindpunten van aangepaste handelingen ontwikkelen custom-actions
Met aangepaste handelingen kunnen reizen uw API’s bellen. Als ontwikkelaar gaat u de API-eindpunten maken die door aangepaste handelingen worden aangeroepen:
-
bouwt uw API eindpunt: Maak RESTful API-eindpunten die Journey Optimizer tijdens de uitvoering van de reis zal aanroepen. Uw eindpunt moet:
- JSON-payloads accepteren
- Verzoeken verifiëren (OAuth, API-sleutel of JWT)
- Verzoeken om verwerking binnen passende tijdslimieten
- Reacties retourneren in de verwachte indeling
-
begrijp de mogelijkheden van de douaneactie: Met aangepaste handelingen kunt u verbinding maken met systemen van derden, zoals Epsilon, Slack, Firebase of uw eigen services. Leer meer over douaneacties .
-
Werk met actieconfiguraties: Uw Ingenieur van de Beheerder of Gegevens zal de douaneactie in Journey Optimizer vormen, bepalend het API eindpunt URL, authentificatiemethode, en parameters. U geeft hen uw API-specificatie. Leer over configuratie van de douaneactie . U kunt een facultatieve lading van de foutenreactie van de foutenreactie voor rijkere reservelogica in onderbrekings/foutentakken bepalen.
-
Van de de activering van de terugkeer gegevens: Ontwerp uw API om gegevens te retourneren die in volgende stappen kunnen worden gebruikt. Leer over actiereacties .
-
gezondheid van de de douaneactie van de Monitor: Gebruik het dashboard van de controle van de douaneactie aan spoor succesvolle vraag, fouten, productie, reactietijden, en rij wachttijden. Leer over douaneactie die rapporteert.
-
voer het beperken van uit: Zorg ervoor dat uw eindpunten het verwachte volume kunnen verwerken. Journey Optimizer past een limiet van 5000 aanroepen per seconde toe, maar uw systeem moet veerkrachtig zijn. Leer over het in kaart brengen en het vertragen .
het gebruiksgeval van het Voorbeeld: het Schrijven van reisgebeurtenissen aan Experience Platform gebruikend douaneacties.
Werken met Journey Optimizer API’s apis
Journey Optimizer biedt uitgebreide REST API’s voor programmatische toegang:
-
begrijp API mogelijkheden: Met Journey Optimizer API’s kunt u verschillende bronnen programmatisch maken, lezen, bijwerken en verwijderen. Leer over Journey Optimizer APIs .
-
Authentificatie: Volg dit leerprogramma aan opstelling API authentificatie gebruikend Adobe Developer Console.
-
verken API verwijzingen: Blader de volledige API documentatie en probeer direct APIs in de Adobe Journey Optimizer API verwijzing .
-
API-teweeggebrachte campagnes: Bouw transactioneel overseinen met API-teweeggebrachte campagnes. Voor high-volume scenario’s (tot 5000 TPS), onderzoek Hoge wijze van de Output (vereist vergunning toe:voegen-op).
-
Beheer APIs van het Besluit: Gebruik gespecialiseerde API’s voor het beheer en de besluitvorming van aanbiedingen. Leer meer in de gids van het Beheer API van het Besluit .
-
De migratie APIs van de Beslissing: Migreer via programmacode beslissingsbeheerentiteiten naar Beslissing met flexibele mogelijkheden, automatische validatie en ondersteuning voor terugdraaien. Leer meer in de gids van de migratie API van de Beslissing .
-
Webhooks van SMS: Configureer binnenkomende websites om binnenkomende berichten vast te leggen en feedback te geven op websites om ontvangstbewijzen en statusupdates te ontvangen. Meer info.
Testen en fouten opsporen testing
-
zuivert de implementatie van SDK: Gebruik Adobe Experience Platform Assurance om SDK-gebeurtenissen te inspecteren, gegevensverzameling te valideren en integratieproblemen in real-time op te lossen. leer meer over Assurance .
-
de gebeurtenislevering van 0} Test: Controleer of gebeurtenissen van uw toepassing correct door Adobe Experience Platform worden ontvangen en start de reis zoals u had verwacht. De opname van gebeurtenissen controleren en de ladingsstructuur valideren.
-
bevestigt API integraties: Test uw eindpunten voor aangepaste handelingen om te controleren of ze Journey Optimizer-verzoeken correct verwerken, binnen time-outlimieten reageren en de verwachte gegevensindelingen retourneren.
-
de testwijze van het Gebruik met testprofielen: Het werk met uw Ingenieur van Gegevens om toegang tot testprofielen te krijgen, dan bevestigt uw implementatie gebruikend de wijze van de reistest. Leer hoe te reizen testen.
-
Logboeken van SDK van de Monitor: Schakel foutopsporing in uw SDK-implementatie in om problemen tijdens de ontwikkeling op te lossen:
- Mobiele SDK: Logboekregistratie inschakelen om SDK-gebeurtenissen en API-aanroepen te zien
- SDK van het Web: Browserconsole gebruiken om SDK-activiteiten te controleren
-
verifieer de configuratie van de gegevensstroom: Zorg ervoor dat uw gegevensstroom correct is geconfigureerd voor het verzenden van gegevens naar Journey Optimizer. Controleer of gebeurtenissen door de gegevensstroom naar de juiste doelen lopen.
-
de reisgegevens van de vraag voor analyse: Gebruik SQL vragen op het meer van Gegevens om de gebeurtenissen van de reisstap te analyseren, kwesties te zuiveren, en de prestaties van de douaneactie te controleren. Onderzoek vraagvoorbeelden voor reisanalyse met inbegrip van:
- Opsporing voor het in- en uitschakelen van profielen en redenen voor verwijderen
- Eigen maatstaven voor de prestaties van handelingen (latentie, doorvoer, fouten)
- Gebeurtenislevering en foutpatronen
- Frames voor reisexemplaar
Geavanceerde ontwikkelaarsonderwerpen advanced-topics
Werken met contextuele gegevens en verrijking
- herhaalt over series: De syntaxis van Handlebars van het gebruik om dynamische lijsten van gebeurtenissen, de reacties van de douaneactie, en datasetraadplegingen in berichten te tonen. Leer over herhalend contextafhankelijke gegevens .
- de raadpleging van de Dataset: Voer datasetraadplegingen uit om reisgegevens van de datasets van Adobe Experience Platform te verrijken. Werk met uw Ingenieur van Gegevens op configuratie. Leer over datasetraadpleging .
Werken met instemming en bestuur
Implementeer het beleid voor gegevensbeheer en instemming in uw integratie:
- het bestuur van Gegevens: Beleid voor gegevensgebruik toepassen op aangepaste handelingen. Leer meer over gegevensbeheer .
- Toegelaten beheer: Verwerk de voorkeuren voor klanttoestemming in uw implementaties. Leer over toestemming .
Optimalisatie en aanbevolen procedures
- Aftappen en throttling: Begrijp tariefgrenzen en voer aangewezen het vertragen uit. Leer over externe systemen .
- optimalisering van de Reis: Volg beste praktijken voor reis optimalisering .
- de behandeling van de Fout: Voer robuuste foutenbehandeling uit. Herzie foutencodes en het oplossen van problemengidsen .
Aanvullende bronnen additional-resources
- Developer Console: Heb toegang tot Adobe Developer Console om integratie tot stand te brengen en API geloofsbrieven te beheren.
- code van de Steekproef: Onderzoek steekproefimplementaties op GitHub .
- video’s van het Leerprogramma: Leer door hands-on leerprogramma’s op Experience League .
- de gemeenschap van de Ontwikkelaar: Neem contact op met andere ontwikkelaars en profiteer van ondersteuning in de forums van de Adobe-community.
Samenwerken in verschillende rollen next-steps
Uw implementatiewerk doorsnijdt met andere teamleden:
Werk met Ingenieurs van Gegevens op gegevens en gebeurtenisconfiguraties samen:
- Krijg de schema’s XDM en gebeurtenisstructuren u moet uitvoeren
- Begrijp welke gebeurtenissen u moet verzenden en hun vereist ladingsformaat
- Uitlijnen op vereisten voor gegevensverzameling en kwaliteitsnormen voor gegevens
- Gebeurtenislevering en gegevensinvoer tegelijk testen
Werk met Beheerders op toegang en configuraties samen:
- API-specificaties opgeven voor aangepaste handelingen die ze zullen configureren
- Vereiste machtigingen en API-referenties aanvragen
- Coördinaat op de eisen van de kanaalconfiguratie (b.v., dupcertificaten)
- Uitlijnen op testomgevingen en sandboxstrategie
Werk met Marketers op reisvereisten en het testen samen:
- Begrijp welke gebruikersinteractie gebeurtenissen zou moeten teweegbrengen
- Tracking implementeren voor de prestaties van inhoud en de betrokkenheid van gebruikers
- Het testen van reizen met uw geïmplementeerde functies ondersteunen
- Problemen met berichtlevering of personalisatie oplossen
Starten met implementeren
Klaar om te beginnen met bouwen? Kies het eerste implementatiegebied in de bovenstaande secties:
- Mobiele app? Begin met Mobiele integratie van SDK
- Website? Begin met opstelling van SDK van het Web
- API integratie? Springen aan Werkend met APIs
- Systeem van de Douane? Controle uit {de acties van 0} Douane 🔗
Elke sectie bevat koppelingen naar gedetailleerde technische documentatie, codevoorbeelden en zelfstudies om uw implementatie te begeleiden.