Documentation Analytics Guide de collection des médias en streaming

Démarrage rapide quick-start

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Utilisateur ou utilisatrice
Administration
Développeur

TIP

Rassemblez les données de demande nécessaires pour terminer une requête sessions sur le serveur principal de l’API Collection de Media Analytics (MA). Vous pouvez vérifier rapidement vos données de requête en envoyant les requêtes manuellement (avec curl, Postman, etc.). Vous obtenez ainsi un feedback immédiat indiquant l’existence ou non de problèmes de types de données incorrects ou d’informations incorrectes dans votre requête. Utilisez les schémas de validation JSON pour vérifier que vous fournissez des données de requêtes correctes.

Rassemblez les données Adobe Analytics et de visiteur standard que vous devez fournir pour exécuter l’une des applications Experience Cloud :
- Identifiant d’entreprise Experience Cloud du visiteur
- Identifiant utilisateur Experience Cloud du visiteur
- Identifiant de suite de rapports Analytics
- URL du serveur de suivi Analytics

Créez un objet JSON pour le corps de votre requête sessions, contenant les données minimales requises pour un appel réussi. Par exemple :

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
Vous devez utiliser les types de données corrects dans le corps de la requête JSON. Par exemple, `analytics.enableSSL` nécessite une valeur booléenne, `media.length` est une valeur numérique, etc. Vous pouvez comparer les types de paramètre obligatoires aux conditions facultatives en vérifiant les schémas de validation JSON.

Envoyez des requêtes sessions au point d’entrée d’API MA Collection. Si la charge utile de votre requête n’est pas valide, identifiez le problème et réessayez jusqu’à obtention d’une réponse 201 Created. Dans cet exemple curl, le corps de la requête JSON se trouve dans un fichier nommé 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

Si la requête sessions réussit, vous recevez une réponse 201 Created similaire à la réponse ci-dessus. La réponse comprend un ID de session dans l’en-tête Emplacement. L’ID de session est la donnée essentielle de la réponse, car il est nécessaire pour tous les appels de suivi suivants. Après un retour réussi d’une requête sessions, vous pouvez passer en toute confiance à la mise en œuvre du suivi vidéo en utilisant l’API MA dans votre lecteur vidéo.

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb