Documentatie Analytics Handleiding voor het streamen van mediaverzameling

Snel starten quick-start

Last update: Fri Nov 11 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Gebruiker
Beheerder
Ontwikkelaar

TIP

Verzamel de aanvraaggegevens die nodig zijn om een geslaagde Sessieverzoek naar de back-endserver van de verzameling-API voor Media Analytics (MA). U kunt uw aanvraaggegevens snel verifiëren door verzoeken handmatig te verzenden (met curl, of Postman, enz.). Zo kunt u direct feedback geven over de vraag of er problemen zijn met onjuiste gegevenstypen of onjuiste gegevens in uw aanvraag. Gebruik de JSON-validatieschema's om te verifiëren dat u juiste verzoekgegevens verstrekt.

Verzamel de standaard, vereiste Adobe Analytics- en Bezoekergegevens die u moet leveren om een van de Experience Cloud-toepassingen uit te voeren:
- Bezoeker Experience Cloud Org ID
- Gebruikersnaam bezoeker Experience Cloud
- ID Analyserapport
- URL Analytics Tracking Server

Een JSON-object maken voor uw sessions verzoek het lichaam, dat de minimumgegevens bevat die voor een succesvolle vraag worden vereist. Bijvoorbeeld:

code language-json

code language-json
{ "playerTime": { "playhead": 0, "ts": 1234560890123 }, "eventType": "sessionStart", "params": { "media.playerName": "sample-html5-api-player", "analytics.trackingServer": "[YOUR_TS]", "analytics.reportSuite": "[YOUR_RSID]", "media.contentType": "VOD", "media.length": 60.39333333333333, "media.id": "MA Collection API Sample Player", "visitor.marketingCloudOrgId": "[YOUR_ORG_ID]", "visitor.marketingCloudUserId": "[YOUR_ECID]", "media.name": "ClickMe", "media.channel": "sample-channel", "media.sdkVersion": "va-api-0.0.0", "analytics.enableSSL": false } }

{
    "playerTime": {
        "playhead": 0,
        "ts": 1234560890123
    },
    "eventType": "sessionStart",
    "params": {
        "media.playerName": "sample-html5-api-player",
        "analytics.trackingServer": "[YOUR_TS]",
        "analytics.reportSuite": "[YOUR_RSID]",
        "media.contentType": "VOD",
        "media.length": 60.39333333333333,
        "media.id": "MA Collection API Sample Player",
        "visitor.marketingCloudOrgId": "[YOUR_ORG_ID]",
        "visitor.marketingCloudUserId": "[YOUR_ECID]",
        "media.name": "ClickMe",
        "media.channel": "sample-channel",
        "media.sdkVersion": "va-api-0.0.0",
        "analytics.enableSSL": false
    }
}

note note
NOTE
U moet de correcte gegevenstypes in het JSON verzoeklichaam gebruiken. bijv. `analytics.enableSSL` een booleaanse waarde vereist, `media.length` is numeriek, enzovoort. U kunt parametertypen en verplichte versus optionele vereisten controleren door de JSON-validatieschema's.

Verzend Sessieverzoeken naar het API-eindpunt van de MA-verzameling. Als uw aanvraag ongeldig is, identificeert u het probleem en probeert u het opnieuw totdat u een 201 Created reactie. In dit curl De JSON-aanvraaginstantie bevindt zich bijvoorbeeld in een bestand met de naam sample_data_session:

code language-sh

code language-sh
`$ curl -i -d \ @sample_data_session https://{uri}/api/v1/sessions \ > curl.sessions.out $ cat curl.sessions.out HTTP/1.1 201 Created Server: nginx/1.13.5 Date: Mon, 18 Dec 2017 22:34:12 GMT Content-Type: application/octet-stream Content-Length: 0 Connection: keep-alive Location: /api/v1/sessions/a39c037641f[...] # <== Session ID Access-Control-Allow-Origin: * Access-Control-Allow-Methods: OPTIONS,POST,PUT Access-Control-Allow-Headers: Content-Type Access-Control-Expose-Headers: Location`

$ curl -i -d \
  @sample_data_session https://{uri}/api/v1/sessions \
  > curl.sessions.out

$ cat curl.sessions.out
HTTP/1.1 201 Created
Server: nginx/1.13.5
Date: Mon, 18 Dec 2017 22:34:12 GMT
Content-Type: application/octet-stream
Content-Length: 0
Connection: keep-alive
Location: /api/v1/sessions/a39c037641f[...]  # <== Session ID
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: OPTIONS,POST,PUT
Access-Control-Allow-Headers: Content-Type
Access-Control-Expose-Headers: Location

Als de Aanvraag voor sessies succesvol, u ontvangt 201 Created dezelfde reactie als hierboven. De reactie bevat een sessie-id in de koptekst Locatie. Identiteitskaart van de Zitting is het cruciale stuk van informatie in de reactie, aangezien het voor alle verdere het volgen vraag wordt vereist. Na een geslaagde terugkeer van een Aanvraag voor sessieskunt u er zeker van zijn dat u verdergaat met het implementeren van videotracering met behulp van de MA API in uw videospeler.

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb