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:

Categorie
Vereisten
Technische vaardigheden
* Ervaring met JavaScript (voor het Web SDK) of Swift/Kotlin (voor Mobiele SDK)
* Begrip van RESTful APIs en JSON
* Familiariteit met asynchrone programmering en gebeurtenis-gedreven architectuur
* Kennis van de de toepassingsarchitectuur van uw organisatie
Toegang en hulpmiddelen
* Toegang tot ​ Adobe Developer Console ​ voor API geloofsbrieven
* 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
van andere teamleden
* De toegang van het milieu die door uw ​ wordt verleend beheerder ​
* 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:

  1. 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.

  2. 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 ​.

  3. 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.

  1. installeer en vorm Mobiele SDK: Volg de ​ documentatie van Adobe Experience Platform Mobile SDK ​ om met de integratie van SDK te beginnen.

  2. 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.

  3. vorm dupberichten:

  4. 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:

Webervaringen implementeren web-implementation

Adobe Experience Platform Web SDK instellen

Voor web-based implementaties, is het Web SDK uw belangrijkste integratiepunt:

  1. installeer het Web SDK: Volg de ​ de implementatiegids van SDK van het Web ​ aan opstelling SDK op uw website.

  2. vorm gegevensstromen: Maak en configureer een gegevensstroom in Adobe Experience Platform Data Collection met Journey Optimizer ingeschakeld. Leer meer in de ​ documentatie van gegevensstromen ​.

  3. 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:

  1. kies uw implementatiemethode: Client-kant, server-kant, of hybride. Herzie ​ implementatiemonsters ​ voor elke benadering.

  2. bepaal oppervlakten: Identificeer de plaatsen in uw toepassing waar u gepersonaliseerde inhoud wilt leveren. Leer over ​ oppervlakteconfiguratie ​.

  3. voert inhoud uit die teruggeeft: Gebruik het Web SDK om personalisatie-inhoud op te halen en toe te passen. Zie ​ code-gebaseerde implementatieleerprogramma’s ​.

  4. 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.

  1. 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 ​.

  2. voer gebeurtenis het stromen uit: Verzend gebeurtenissen naar Adobe Experience Platform gebruikend ​ Streaming Ingestie APIs ​. Leer de ​ stappen om gebeurtenissen ​ te verzenden.

  3. 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)
  4. 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:

  1. 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
  2. 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 ​.

  3. 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.

  4. 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 ​.

  5. 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.

  6. 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:

  1. begrijp API mogelijkheden: Met Journey Optimizer API’s kunt u verschillende bronnen programmatisch maken, lezen, bijwerken en verwijderen. Leer over ​ Journey Optimizer APIs ​.

  2. Authentificatie: Volg ​ dit leerprogramma ​ aan opstelling API authentificatie gebruikend Adobe Developer Console.

  3. verken API verwijzingen: Blader de volledige API documentatie en probeer direct APIs in de ​ Adobe Journey Optimizer API verwijzing ​.

  4. 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).

  5. 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 ​.

  6. 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 ​.

  7. 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

  1. 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 ​.

  2. 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.

  3. 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.

  4. 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.

  5. 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
  6. 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.

  7. 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

Aanvullende bronnen additional-resources

Samenwerken in verschillende rollen next-steps

Uw implementatiewerk doorsnijdt met andere teamleden:

Werk met de Ingenieurs van Gegevens

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

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

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:

  1. Mobiele app? Begin met ​ Mobiele integratie van SDK ​
  2. Website? Begin met ​ opstelling van SDK van het Web ​
  3. API integratie? Springen aan ​ Werkend met APIs ​
  4. 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.

recommendation-more-help
journey-optimizer-help