Guida introduttiva quick-start

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