DocumentazioneAnalyticsGuida a Streaming Media Collection

Guida introduttiva quick-start

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

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore
TIP
Raccogliere i dati della richiesta necessari per completare una Richiesta di sessione al server back-end API di Media Analytics (MA) Collection. Puoi verificare rapidamente i dati della richiesta inviando manualmente le richieste (con curl, o Postman, ecc.). Questo ti darà un feedback immediato su eventuali problemi relativi a tipi di dati errati o informazioni errate nella tua richiesta. Utilizza gli schemi di convalida JSON per verificare di aver fornito dati di richiesta corretti.

  1. Raccogli i dati standard e richiesti di Adobe Analytics e Visitor da fornire per eseguire una qualsiasi delle applicazioni Experience Cloud:

    • ID visitatore organizzazione Experience Cloud
    • ID utente visitatore Experience Cloud
    • ID suite per report di Analytics
    • URL del server di tracciamento di Analytics

  2. Creare un oggetto JSON per il corpo della richiesta delle sessions, contenente i dati minimi necessari per una chiamata di successo. Ad esempio:

    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
    Devi utilizzare i tipi di dati corretti nel corpo della richiesta JSON. Ad esempio, analytics.enableSSL richiede un valore booleano, media.length è numerico, ecc. Puoi controllare i tipi di parametri e i requisiti obbligatori rispetto a quelli facoltativi controllando Schemi di convalida JSON.

  3. Invia richieste di sessioni all’endpoint API della raccolta MA. Se il payload della richiesta non è valido, identifica il problema e riprova fino a ottenere una risposta 201 Created. In questo esempio curl, il corpo della richiesta JSON si trova in un file denominato 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

Se la Richiesta sessioni viene eseguita correttamente, viene visualizzato una risposta 201 Created simile a quella precedente. La risposta include un ID sessione nell’intestazione Posizione. L’ID sessione è la parte cruciale delle informazioni nella risposta, in quanto è richiesto per tutte le chiamate di tracciamento successive. Dopo il ritorno riuscito di una Richiesta sessioni, puoi procedere con l’implementazione del tracciamento video utilizzando l’API MA nel lettore video.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb