Démarrage rapide quick-start

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.
  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 :

    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
        }
    }
    
    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.
  3. 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
    $ 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