Aan de slag voor 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 wordt gebouwd native 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 gebruikt het Model van Gegevens van de Ervaring (XDM) 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: Alle implementaties vereisen juiste authentificatie. 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 ​ Mobiele documentatie van SDK van Adobe Experience Platform ​ om met de integratie van SDK begonnen te worden.

  2. creeer een mobiel bezit: Opstelling een mobiel bezit 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 ​ mobiel op het instappen 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: creeer en vorm een gegevensstroom in Adobe Experience Platform Data Collection met toegelaten Journey Optimizer. Leer meer in de ​ documentatie van gegevensstromen ​.

  3. laat Web pushberichten (facultatief) toe: Vorm het ​ pushNotifications bezit ​ in uw configuratie van SDK van het Web en gebruik het ​ sendPushSubscription bevel ​ om dupabonnementen te registreren.

Implementeer op code gebaseerde ervaringen (Web SDK)

Met codegebaseerde ervaringen kunt u elk digitaal aanraakpunt aanpassen:

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

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

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

  4. verzendt vertoning en interactiegebeurtenissen: Spoor wanneer de inhoud wordt getoond en wanneer de gebruikers met het voor analyse en optimalisering in wisselwerking staan.

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: Het werk met uw Ingenieur van Gegevens om het gebeurtenisschema en de vereiste loonlaststructuur 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: Voer gebeurtenis uit die voor persoon-specifieke acties (b.v., knoop klikt, aankoopvoltooiing) verzendt
    • Bedrijfs gebeurtenissen: Verzend zaken-verwante gebeurtenissen (b.v., inventarisupdates, prijsveranderingen)
  4. de gebeurtenislevering van de Test: Verifieer dat de gebeurtenissen behoorlijk ontvangen zijn en reizen zoals verwacht teweegbrengen. 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: Creeer RESTful API eindpunten die Journey Optimizer tijdens reisuitvoering zal roepen. 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: De acties van de douane kunnen met derdesystemen zoals Epsilon, Slack, Vuurbasis, of uw eigen diensten verbinden. Leer meer over ​ douaneacties ​.

  3. Werk met actieconfiguraties: Uw ​ Beheerder ​ of ​ Ingenieur van 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 ​.

  4. de actiefgegevens van de Terugkeer: Ontwerp uw API om gegevens terug te keren die in verdere reisstappen kunnen worden gebruikt. Leer over ​ actiereacties ​.

  5. voert het beperken van uit: Zorg uw eindpunten het verwachte volume kunnen behandelen. 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: ​ schrijvend 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: Journey Optimizer APIs staat u toe om, diverse middelen programmatically tot stand te brengen te lezen bij te werken en te schrappen. Leer over ​ Journey Optimizer APIs ​.

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

  3. onderzoek API verwijzingen: Doorblader de volledige API documentatie en probeer direct APIs in de ​ verwijzing van Adobe Journey Optimizer API ​.

  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 APIs voor aanbiedingsbeheer en besluitvorming. Leer meer in de ​ gids van het Beheer API van het Besluit ​.

Testen en fouten opsporen testing

  1. zuivert de implementatie van SDK: Gebruik Adobe Experience Platform Assurance om de gebeurtenissen van SDK te inspecteren, gegevensinzameling te bevestigen, en integratiekwesties in real time problemen op te lossen. ​ leer meer over Assurance ​.

  2. de gebeurtenislevering van de Test: Verifieer dat de gebeurtenissen van uw toepassing correct door Adobe Experience Platform worden ontvangen en reizen zoals verwacht teweegbrengen. De opname van gebeurtenissen controleren en de ladingsstructuur valideren.

  3. bevestigt API integraties: Test uw eindpunten van de douaneactie om ervoor te zorgen zij verzoeken van Journey Optimizer correct behandelen, binnen onderbrekingsgrenzen antwoorden, en terugkeer verwachte gegevensformaten.

  4. de testwijze van het Gebruik met testprofielen: Het werk met uw ​ Ingenieur van Gegevens ​ om toegang tot testprofielen te krijgen, dan uw implementatie te bevestigen gebruikend de wijze van de reistest. Leer hoe te ​ reizen ​ testen.

  5. Logboeken van SDK van de Monitor: Laat toe zuivert het registreren in uw implementatie van SDK om kwesties tijdens ontwikkeling problemen op te lossen:

    • Mobiele SDK: Laat het registreren toe om de gebeurtenissen van SDK en API vraag te zien
    • SDK van het Web: De browser van het gebruik console om de activiteit van SDK te controleren
  6. verifieer gegevensstroomconfiguratie: Zorg ervoor uw gegevensstroom correct wordt gevormd om gegevens naar Journey Optimizer te verzenden. Controleer of gebeurtenissen door de gegevensstroom naar de juiste doelen lopen.

  7. de reisgegevens van de Vraag voor analyse: SQL vragen van het gebruik 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

  • Interactief 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: Pas het beleid van het gegevensgebruik op douaneacties toe. Leer meer over ​ gegevensbeheer ​.
  • Toegangsbeheer: De voorkeur van de de klantentoestemming van de handvatklant 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 toepassing? Begin met ​ Mobiele integratie van SDK ​
  2. Website? Begin met ​ de opstelling van SDK van het Web ​
  3. API-integratie? sprong aan ​ Werkend met APIs ​
  4. Aangepast systeem? Controle uit ​ de acties van de Douane ​

Elke sectie bevat koppelingen naar gedetailleerde technische documentatie, codevoorbeelden en zelfstudies om uw implementatie te begeleiden.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76