Show Menu
TOPICS×

Démarrage rapide

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.
  1. 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
  2. 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 :
    { "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 } }
    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.
  3. Envoyez des requêtes sessions au point de terminaison 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
     :
    $ 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.