Kom igång för utvecklare get-started-developers
Som utvecklare ansvarar du för att implementera och integrera Adobe Journey Optimizer i dina program och system. Du kan börja arbeta med Adobe Journey Optimizer när systemadministratören och datateknikern har gett dig åtkomst och förberett miljön.
Din roll i Journey Optimizer ekosystem
Medan andra teammedlemmar konfigurerar Journey Optimizer via användargränssnittet fokuserar du på:
- Implementera SDK:er i mobil- och webbprogram
- Skickar händelser från dina program för att utlösa resor
- Skapar API-slutpunkter som Journey Optimizer kan anropa via anpassade åtgärder
- Integrera Journey Optimizer med befintliga system och befintlig infrastruktur
- Testa och felsöka dina implementeringar
Din datatekniker hanterar datamodeller, händelsekonfigurationer och datakällor. Administratören konfigurerar behörigheter och kanalkonfigurationer. Marknadsförarna utformar resorna och innehållet som använder implementeringarna.
Den här guiden beskriver de viktigaste tekniska implementeringsstegen för att komma igång med Journey Optimizer. Oavsett om du skapar mobilappar, webbupplevelser eller API-integreringar följer du avsnitten nedan för att konfigurera implementeringen.
Förhandskrav prerequisites
Innan du börjar implementeringen måste du se till att du har:
* Förståelse av RESTful-API:er och JSON
* Förståelse med asynkron programmering och händelsestyrda arkitekturer
* Kunskap om organisationens programarkitektur
* Utvecklingsmiljö med tillgång till programmets kodbas
* Testverktyg som Postman för API-testning
* Webbläsarutvecklingsverktyg eller mobilfelsökningsverktyg
* XDM-scheman och händelsedefinitioner från Data Engineer
* Krav och användningsexempel från Marketers
Förstå den tekniska grunden technical-foundation
Innan du börjar dyka upp i implementeringen bör du bekanta dig med de viktigaste tekniska begreppen:
-
Adobe Experience Platform-integrering: Journey Optimizer är inbyggt i Adobe Experience Platform. Genom att förstå den underliggande arkitekturen kan ni skapa mer effektiva implementeringar. Läs mer om hur Journey Optimizer fungerar.
-
XDM-datamodeller: Journey Optimizer använder Experience Data Model (XDM) för att strukturera händelse- och profildata. Som utvecklare måste du förstå hur du skickar data som överensstämmer med scheman som konfigurerats av datateknikern. Läs mer om XDM-scheman.
-
Autentisering och säkerhet: Alla implementeringar kräver korrekt autentisering. Lär dig hur du konfigurerar autentisering för SDK:er och API:er. Läs mer om API-autentisering.
Konfigurera mobilappsintegreringar mobile-integration
Konfigurera Adobe Experience Platform Mobile SDK
Om du vill aktivera push-meddelanden, meddelanden i appen och andra mobilfunktioner integrerar du Adobe Experience Platform Mobile SDK i dina mobilappar.
-
Installera och konfigurera Mobile SDK: Följ dokumentationen för Adobe Experience Platform Mobile SDK för att komma igång med SDK-integrering.
-
Skapa en mobil egenskap: Konfigurera en mobil egenskap i Adobe Experience Platform Data Collection. Lär dig hur du skapar och konfigurerar en mobil egenskap.
-
Konfigurera push-meddelanden:
- För iOS-appar: Registrera din app med APN:er (Apple Push Notification service). Läs mer i Apple dokumentation.
- För Android-program: Konfigurera Firebase Cloud Messaging för din Android-app. Läs mer i Google dokumentation.
-
Testa din mobilintegration: Använd snabbstartsarbetsflödet för mobil introduktion för att snabbt konfigurera och testa din mobilkonfiguration.
Detaljerade steg för att konfigurera push-meddelanden finns på den här sidan.
Implementera kodbaserade upplevelser (Mobile SDK)
För intern mobilappspersonalisering med kodbaserade upplevelser:
- Följ den här självstudiekursen för implementering av Mobile SDK
- Granska exempelimplementeringar för iOS och Android
Implementera webbupplevelser web-implementation
Konfigurera Adobe Experience Platform Web SDK
För webbaserade implementeringar är Web SDK den primära integrationspunkten:
-
Installera SDK för webben: Följ implementeringshandboken för SDK för webben för att konfigurera SDK på webbplatsen.
-
Konfigurera datastreams: Skapa och konfigurera ett datastream i Adobe Experience Platform Data Collection med Journey Optimizer aktiverat. Läs mer i datastreams-dokumentationen.
-
Aktivera push-meddelanden på webben (valfritt): Konfigurera egenskapen pushNotifications i din SDK-webbkonfiguration och använd kommandot sendPushSubscription för att registrera push-prenumerationer.
Implementera kodbaserade upplevelser (Web SDK)
Med kodbaserade upplevelser kan ni personalisera alla digitala kontaktytor:
-
Välj implementeringsmetod: Klient, server eller hybridserver. Granska implementeringsexempel för varje metod.
-
Definiera ytor: Identifiera de platser i programmet där du vill leverera personaliserat innehåll. Läs mer om ytkonfiguration.
-
Implementera innehållsåtergivning: Använd Web SDK för att hämta och använda personaliseringsinnehåll. Se kodbaserade självstudiekurser för implementering.
-
Skicka visnings- och interaktionshändelser: Spåra när innehåll visas och när användare interagerar med det för analys och optimering.
Utforska exempelimplementeringar på GitHub för att se hur kodbaserade upplevelser fungerar.
Läs mer om att komma igång med kodbaserade upplevelser.
Implementera händelseströmning event-streaming
Skicka händelser för att utlösa resor
Som utvecklare implementerar du koden för att skicka händelser som utlöser resor. Din datatekniker konfigurerar händelsescheman och definitioner i Journey Optimizer.
-
Förstå händelsens nyttolast: Arbeta med din datatekniker för att hämta händelseschemat och den nödvändiga nyttolaststrukturen. Nyttolasten måste följa det XDM-schema som har konfigurerats. Lär dig mer om schemakrav för händelser.
-
Implementera händelsedirektuppspelning: Skicka händelser till Adobe Experience Platform med API:erna för direktuppspelning av inmatning. Lär dig stegen för att skicka händelser.
-
Hantera händelsetyper:
- Enhetshändelser: Implementera händelse som skickas för personspecifika åtgärder (t.ex. knappklickning, slutförande av köp)
- Affärshändelser: Skicka affärsrelaterade händelser (t.ex. lageruppdateringar, prisändringar)
-
Testa händelseleverans: Verifiera att händelser tas emot korrekt och utlösa resor som förväntat. Läs mer om felsökning av händelser.
Exempelimplementering för att skicka en händelse 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
}
}
}
Lär dig mer om att arbeta med resehändelser.
Utveckla anpassade åtgärdsslutpunkter custom-actions
Med anpassade åtgärder kan resor anropa API:er. Som utvecklare skapar du API-slutpunkterna som anpassade åtgärder anropar:
-
Bygg din API-slutpunkt: Skapa RESTful API-slutpunkter som Journey Optimizer anropar under körningen. Din slutpunkt bör:
- Acceptera JSON-nyttolaster
- Autentisera begäranden (OAuth, API-nyckel eller JWT)
- Bearbeta begäranden inom lämpliga tidsgränser
- Returnera svar i förväntat format
-
Förstå anpassade åtgärdsfunktioner: Anpassade åtgärder kan ansluta till tredjepartssystem som Epsilon, Slack, Firebase eller dina egna tjänster. Läs mer om anpassade åtgärder.
-
Arbeta med åtgärdskonfigurationer: Administratören eller Datateknikern konfigurerar den anpassade åtgärden i Journey Optimizer och definierar API-slutpunkts-URL:en, autentiseringsmetoden och parametrarna. Du kommer att förse dem med din API-specifikation. Läs mer om konfiguration för anpassad åtgärd.
-
Returnera användbara data: Designa ditt API för att returnera data som kan användas i efterföljande steg. Läs mer om åtgärdssvar.
-
Implementeringsbegränsning: Kontrollera att slutpunkterna kan hantera den förväntade volymen. Journey Optimizer har en gräns på 5 000 samtal/sekund, men systemet bör vara flexibelt. Läs om begränsning och begränsning.
Exempel på användning: Skriva resehändelser till Experience Platform med anpassade åtgärder.
Arbeta med Journey Optimizer API:er apis
Journey Optimizer erbjuder omfattande REST API:er för programmatisk åtkomst:
-
Förstå API-funktioner: Med Journey Optimizer API:er kan du skapa, läsa, uppdatera och ta bort olika resurser programmatiskt. Läs mer om Journey Optimizer API:er.
-
Autentisering: Följ den här självstudiekursen för att konfigurera API-autentisering med Adobe Developer Console.
-
Utforska API-referenser: Bläddra i den fullständiga API-dokumentationen och försök med API:er direkt i API-referensen för Adobe Journey Optimizer.
-
API-utlösta kampanjer: Skapa transaktionsmeddelanden med API-utlösta kampanjer. För scenarier med stora volymer (upp till 5000 TPS) kan du utforska läget Högt dataflöde (kräver tilläggslicens).
-
API:er för beslutshantering: Använd specialiserade API:er för erbjudandehantering och beslutsfattande. Läs mer i API-handboken för beslutshantering.
Testning och felsökning testing
-
Felsök SDK-implementering: Använd Adobe Experience Platform Assurance för att inspektera SDK-händelser, validera datainsamling och felsöka integreringsproblem i realtid. Läs mer om Assurance.
-
Testa händelseleverans: Verifiera att händelser från ditt program tas emot korrekt av Adobe Experience Platform och utlöser resor som förväntat. Övervaka händelseinmatning och validera nyttolaststrukturen.
-
Validera API-integreringar: Testa dina anpassade åtgärdsslutpunkter för att se till att de hanterar Journey Optimizer-begäranden korrekt, svarar inom tidsgränser och returnerar förväntade dataformat.
-
Använd testläge med testprofiler: Arbeta med din datatekniker för att få åtkomst till testprofiler och validera sedan implementeringen med testläge för resan. Lär dig hur du testar resor.
-
Övervaka SDK-loggar: Aktivera felsökningsloggning i din SDK-implementering för att felsöka problem under utveckling:
- Mobile SDK: Aktivera loggning för att visa SDK-händelser och API-anrop
- Webb-SDK: Använd webbläsarkonsolen för att övervaka SDK-aktivitet
-
Verifiera dataströmskonfiguration: Kontrollera att dataströmmen är korrekt konfigurerad för att skicka data till Journey Optimizer. Kontrollera att händelser flödar genom datastream till rätt mål.
-
Fråga efter resedata för analys: Använd SQL-frågor på Data Lake för att analysera resesegmentshändelser, felsöka problem och övervaka prestanda för anpassade åtgärder. Utforska frågeexempel för reseanalys inklusive:
- Orsaker till att ange/avsluta profil och kassera
- Mätvärden för anpassade åtgärder (latens, genomströmning, fel)
- Leverans av händelser och felmönster
- Resursinstanstillstånd
Avancerade ämnen för utvecklare advanced-topics
Arbeta med kontextuella data och berikning
- Iterera över arrayer: Använd Handlebars-syntax för att visa dynamiska listor från händelser, anpassade åtgärdssvar och datasetuppslag i meddelanden. Lär dig mer om att iterera sammanhangsbaserade data.
- Datauppsättningssökning: Implementera datauppsättningssökningar för att berika resedata från Adobe Experience Platform-datauppsättningar. Samarbeta med din datatekniker när det gäller konfiguration. Lär dig mer om datasökning.
Arbeta med samtycke och styrning
Implementera policyer för datastyrning och samtycke i era integreringar:
- Datastyrning: Använd dataanvändningsprinciper för anpassade åtgärder. Läs mer om datastyrning.
- Hantering av samtycke: Hantera inställningar för kundgodkännande i implementeringarna. Läs mer om medgivande.
Optimering och bästa praxis
- Takning och begränsning: Förstå hastighetsbegränsningar och implementera lämplig begränsning. Läs mer om externa system.
- Reseoptimering: Följ bästa praxis för reseoptimering.
- Felhantering: Implementera robust felhantering. Granska felkoder och felsökningsguider.
Ytterligare resurser additional-resources
- Developer Console: Använd Adobe Developer Console för att skapa integreringar och hantera API-autentiseringsuppgifter.
- Exempelkod: Utforska exempelimplementeringar på GitHub.
- Självstudievideor: Lär dig med praktiska självstudiekurser på Experience League.
- Developer Community: Kommunicera med andra utvecklare och få support i Adobe community-forum.
Samarbeta mellan roller next-steps
Implementeringsarbetet korsar med andra gruppmedlemmar:
Samarbeta med datatekniker om data- och händelsekonfigurationer:
-
Få de XDM-scheman och händelsestrukturer du behöver implementera
-
Förstå vilka händelser du måste skicka och deras obligatoriska nyttolastformat
-
Anpassa er efter datainsamlingskrav och standarder för datakvalitet
-
Testa händelseleverans och datainmatning tillsammans
Samarbeta med administratörer om åtkomst och konfigurationer:
-
Ange API-specifikationer för anpassade åtgärder som de konfigurerar
-
Begär nödvändiga behörigheter och API-autentiseringsuppgifter
-
Koordinera kanalkonfigurationskrav (t.ex. push-certifikat)
-
Justera mot testmiljöer och sandlådestrategi
Samarbeta med marknadsförare om resekrav och testning:
-
Förstå vilka användarinteraktioner som ska utlösa händelser
-
Implementera spårning för innehållsprestanda och användarengagemang
-
Stödja testning av resor med de implementerade funktionerna
-
Felsöka problem med meddelandeleverans eller personalisering
Börja implementera
Vill du börja bygga? Välj ditt första implementeringsområde från avsnitten ovan:
- Mobilapp? Börja med Mobile SDK-integrering
- Webbplats? Börja med Web SDK-konfiguration
- API-integrering? Hoppa till Arbeta med API:er
- Anpassat system? Kolla in Anpassade åtgärder
Varje avsnitt innehåller länkar till detaljerad teknisk dokumentation, kodexempel och självstudiekurser som kan vägleda implementeringen.