Waar moet ik analyses uitvoeren?
Een van de beste plaatsen om Analytics te implementeren is in de app. De app ontvangt de intentie en de details van de digitale assistent, waarna de app bepaalt hoe moet worden gereageerd.
Tijdens een aanvraag zijn er twee keer gegevens die nuttig kunnen zijn voor het verzenden van gegevens naar Adobe Analytics.
- Wanneer de aanvraag naar uw app wordt verzonden.
- Nadat de reactie van de app is geretourneerd.
Als u alleen maar geïnteresseerd bent in het opnemen van wat er met de klant is gebeurd voor toekomstige optimalisatie, stuurt u een verzoek naar Adobe Analytics nadat het antwoord is geretourneerd. U krijgt de volledige context van wat het verzoek was en hoe het systeem reageerde.
Nieuwe installaties
Voor sommige digitale medewerkers, krijgt u een bericht wanneer iemand de vaardigheid installeert, vooral wanneer de authentificatie betrokken is. Adobe raadt aan een Install-gebeurtenis te verzenden door de variabele met de contextgegevens in te stellen a.InstallEvent=1
. Deze functie is niet beschikbaar voor alle digitale assistenten, maar is handig wanneer u deze functie gebruikt om de retentie te bekijken. De volgende codesteekproef verzendt de Install gebeurtenis, installeert Datum, en waarden AppID in de variabelen van contextgegevens.
GET
/b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.InstallEvent=1&c.a.InstallDate=2017-04-24&c.a.AppID=Spoofify1.0&c.OSType=Alexa&pageName=install
HTTP/1.1
Host:
<xref href="https://example.data.adobedc.net">
example.data.adobedc.net
Cache-Control: no-cache
</xref href="https:>
Meerdere assistenten of meerdere apps
Uw organisatie wil waarschijnlijk apps voor meerdere platforms. De beste manier is om bij elke aanvraag een toepassings-id op te nemen. Deze variabele kan worden ingesteld in het dialoogvenster a.AppID
contextgegevensvariabele. Volg de notatie van [AppName] [BundleVersion]
, bijvoorbeeld BigMac voor Alexa 1.2:
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.a.Launches=1&c.Product=AmazonEcho&c.OSType=Alexa&pageName=install HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify2.0&c.a.Launches=1&c.Product=GoogleHome&c.OSType=Android&pageName=install HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
Identificatie gebruiker/bezoeker
Adobe Analytics gebruikt de Adobe Experience Cloud Identity Service om interacties in de loop van de tijd aan dezelfde persoon te koppelen. De meeste digitale assistenten retourneren een userID
die u kunt gebruiken om de activiteit voor verschillende gebruikers te houden. In de meeste gevallen is deze waarde wat u kunt doorgeven als een unieke id. Sommige platforms retourneren een id die langer is dan de 100 toegestane tekens. In deze gevallen, adviseert de Adobe dat u het unieke herkenningsteken aan een vaste lengtewaarde gebruikend een standaard het hakken algoritme, zoals MD5 of Sha1 hakt.
Het gebruiken van de Dienst van identiteitskaart verstrekt de meeste waarde wanneer u ECIDs over verschillende apparaten (bijvoorbeeld, Web aan digitale medewerker) in kaart brengt. Als uw app een mobiele toepassing is, gebruikt u de SDK's van het Experience Platform ongewijzigd en verzendt u de gebruikers-id met de setCustomerID
methode. Als uw app echter een service is, gebruikt u de door de service opgegeven gebruikers-id als de ECID en stelt u deze in setCustomerID
.
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&pageName=[intent] HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
Sessies
Omdat digitale assistenten conversatief zijn, hebben ze vaak het concept van een sessie. Bijvoorbeeld:
Consumenten: "Ok Google, bel een taxi voor me."
Google:: "Natuurlijk, hoe laat wil je?"
Consumenten: "20:30
Google: "Het klinkt goed, de bestuurder zal om 20:30 zijn"
Sessies zijn belangrijk om context te behouden en helpen u meer details te verzamelen om de digitale assistent natuurlijker te maken. Wanneer het uitvoeren van Analytics op een gesprek, zijn er twee dingen om te doen wanneer een nieuwe zitting is begonnen:
- Uitgaan naar Audience Manager: Haal de relevante segmenten op waarvan een gebruiker een onderdeel is, zodat u de reactie kunt aanpassen. (Deze persoon komt momenteel bijvoorbeeld in aanmerking voor de multikanaalskorting.)
- Verzenden in een nieuwe sessie of startgebeurtenis: Wanneer u de eerste reactie op Analytics verzendt, neemt u een opstartebeurtenis op. Dit kan meestal worden verzonden door contextgegevens in te stellen van
a.LaunchEvent=1
.
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.LaunchEvent=1&c.Intent=[intent]&pageName=[intent] HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
Intenten
Elk van de digitale assistenten heeft algoritmen die intenties detecteren en vervolgens de intentie doorgeven aan de "App", zodat de app weet wat ze moeten doen. Deze intenties vormen een beknopte weergave van het verzoek.
Als een gebruiker bijvoorbeeld zegt: "Siri, Stuur John $20 voor het avondeten vanuit mijn bankapp", dan kan de bedoeling iets als sendMoney.
Door elk van deze verzoeken als eVar in te dienen, kunt u tekenrapporten uitvoeren over elk van de intents voor conversatie-apps. Zorg ervoor dat uw toepassing aanvragen ook zonder intentie kan afhandelen. Adobe raadt aan 'Geen intentie opgegeven' door te geven aan de gegevensvariabele van de intentcontext, in plaats van de variabele weg te laten.
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0&c.a.LaunchEvent=1&c.Intent=SendPayment&pageName=[intent] HTTP/1.1
Host: example.sc.adobedc.net
Cache-Control: no-cache
of
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0&c.a.LaunchEvent=1&c.Intent=No_Intent_Specified&pageName=[intent] HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
Parameters/sleuven/entiteiten
Naast de intentie hebben digitale assistenten vaak een set sleutel-/waardeparen die details van de intentie geven. Deze kunnen groeven, entiteiten of parameters worden genoemd. "Siri, Send John $20 for diner gisteravond from my banking app" zou bijvoorbeeld de volgende parameters hebben:
- Who = John
- Bedrag = 20
- Waarom = Diner
De app bevat meestal een eindig aantal van deze waarden. Om deze waarden in Analytics te volgen, verzend hen in de variabelen van contextgegevens en wijs dan elk van de parameters aan een eVar toe.
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0=1&c.a.LaunchEvent=1&c.Intent=SendPayment&c.Amount=20.00&c.Reason=Dinner&c.ReceivingPerson=John&c.Intent=SendPayment&pageName=[intent] HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
Foutstatussen
Soms verschaft de digitale assistent uw app invoer die deze niet kan verwerken. Bijvoorbeeld "Siri, Stuur John 20 tassen steenkool voor diner gisteravond vanuit mijn bankapp"
Wanneer deze situatie zich voordoet, vraagt uw app om opheldering. Verstuur bovendien gegevens naar de Adobe die aangeeft dat de toepassing een foutstatus heeft, samen met een eVar die aangeeft welk type fout is opgetreden. Zorg ervoor dat u fouten opneemt waar de invoer niet correct is en fouten opneemt waar de app een probleem heeft.
GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Penmo1.0&c.Error=1&c.ErrorName=InvalidCurrency&pageName=[intent] HTTP/1.1
Host: example.data.adobedc.net
Cache-Control: no-cache
Apparaatmogelijkheden
Terwijl de meeste platforms niet het apparaat blootstellen dat de gebruiker aan sprak, stellen zij de mogelijkheden van het apparaat bloot. Bijvoorbeeld audio, scherm, video, enz. Deze informatie is handig omdat hiermee de typen inhoud worden gedefinieerd die kunnen worden gebruikt bij interactie met uw gebruikers. Bij het meten van apparaatmogelijkheden kunt u deze het beste samenvoegen (in alfabetische volgorde).
Voorbeeld: ":Audio:Camera:Screen:Video:"
De voorloopdubbele en navolgende dubbele punten helpen u bij het maken van segmenten. Alle treffers bijvoorbeeld tonen met :Audio:
mogelijkheden.
- Amazon-mogelijkheden Amazon Alexa gebruiken
- Google-mogelijkheden Handelingen gebruiken in Google
Voorbeelden
Persoon | Apparaatreactie | Handeling/intentie | Verzoek om GET |
---|---|---|---|
Spoofify installeren | Geen reactie | Installeren | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.InstallEvent=1&c.a.InstallDate=[currentDate]&c.a.AppID=Spoofify1.0&c.OSType=Alexa&c.Intent=Install&pageName=Install HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
Spoofiel afspelen | "Oké, Spoofify spelen" | Afspelen | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.a.LaunchEvent=1&c.Intent=Play&pageName=PlayApp HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
Ander nummer | "Oké, welk liedje wil je?" | ChangeSong | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.Intent=ChangeSong&pageName= Ask%20For%20Song HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
"Baby Shark" afspelen | "Oké, 'Baby Shark' afspelen van PinkFong" | ChangeSong | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.Intent=ChangeSong&pageName=Action%20Play%20Song&c.SongID=[012345] HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
Afspeellijst wijzigen | "Oké, welke afspeellijst wilt u?" | ChangePlaylist | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.Intent=ChangePlaylist&pageName=Ask%20For%20Playlist HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
Speel mijn favoriete liedjesspeellijst | "Oké, je favoriete muziektoneelschrijver afspelen" | ChangePlaylist | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.Intent=ChangePlaylist&pageName=Action%20Play%20Playlist&c.Playlist=My%20Favorite%20Songs HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
Muziek uitschakelen | Geen reactie, muziek schakelt uit | Uit | GET /b/ss/examplersid1,examplersid2/1?vid=[UserID]&c.a.AppID=Spoofify1.0&c.Intent=Off&pageName=Music%20Off HTTP/1.1 Host: example.data.adobedc.net Cache-Control: no-cache |
Analytics
- Adobe Analytics implementeren
- de Nota’s van de Versie van Analytics
- Opmerkingen bij de release AppMeasurement
- Variabelen, functies en methoden van Analytics
- Implementatie van Adobe Analytics voorbereiden
- Analyses implementeren met Experience Platform Edge
- Analyses implementeren met de Adobe Analytics-extensie
- Analytics implementeren met JavaScript
- Analytics implementeren op andere platforms
- Analyses implementeren op mobiele apparaten
- Gebruiksscenario’s implementeren
- Uw implementatie valideren
- Veelgestelde vragen
- Uw implementatie controleren