Show Menu
TOPICS×

Inicio rápido

Recopile los datos de solicitud necesarios para completar una solicitud de sesión correcta en el servidor back-end de la API de recopilación de Media Analytics (MA). Puede verificar rápidamente los datos de solicitud enviando solicitudes manualmente (con
curl
o Postman, etc.). Esto le indicará de inmediato si en su solicitud hay problemas con tipos de datos incorrectos o información incorrecta. Utilice los esquemas de validación de JSON para verificar que está suministrando los datos de solicitud adecuados.
  1. Recopile los datos estándar de Adobe Analytics y del visitante que debe proporcionar para ejecutar cualquiera de las aplicaciones de Experience Cloud:
    • ID de organización para visitantes en Experience Cloud
    • ID de usuario para visitantes en Experience Cloud
    • ID de informes de Analytics
    • URL del servidor de seguimiento de análisis
  2. Cree un objeto JSON para su solicitud de
    sessions
    que contenga los datos mínimos necesarios para una llamada correcta. Por ejemplo:
    { "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 } }
    Debe utilizar los tipos de datos correctos en el cuerpo de la solicitud JSON. Por ejemplo,
    analytics.enableSSL
    requiere un booleano,
    media.length
    es numérico, etc. Puede comprobar los tipos de parámetros y los requisitos obligatorios frente a los requisitos opcionales comprobando los esquemas de validación de JSON.
  3. Envíe solicitudes de sesiones al punto final de la API de recopilación de MA. Si la carga de la solicitud no es válida, identifique el problema y vuelva a intentarlo hasta que obtenga una respuesta de
    201 Created
    . En este ejemplo de
    curl
    , el cuerpo de la solicitud JSON se encuentra en un archivo denominado
    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 solicitud de sesiones se realiza correctamente, recibirá una respuesta de
201 Created
similar a la anterior. La respuesta incluye un ID de sesión en el encabezado Ubicación. El ID de sesión es información fundamental en la respuesta, ya que es necesaria para todas las llamadas de seguimiento subsiguientes. Una vez que se haya devuelto correctamente una solicitud de sesiones , puede continuar con la implementación del seguimiento de vídeo con la API de MA en su reproductor de vídeo.