Chronologie 2 : L’utilisateur abandonne la session

VOD, publicité preroll, publicités mid-roll, utilisateur abandonne le contenu tôt

Les diagrammes suivants illustrent la chronologie du curseur de lecture et la chronologie correspondante des actions d’un utilisateur. Les détails de chaque action et des demandes qui l’accompagnent sont présentés ci-dessous.

Détails de l’action

Action 1 - Démarrage de la session

Détails de mise en œuvre

Cet appel signale l’intention de l’utilisateur de lire une vidéo. Il renvoie un ID de session ({sid}) au client, utilisé pour identifier tous les appels de suivi suivants dans la session. L’état du lecteur n’est pas encore « lecture », mais à la place, « démarrage ». Les paramètres de session obligatoires doivent être inclus dans la carte params du corps de la requête. Sur le serveur principal, cet appel génère un appel de lancement d’Adobe Analytics.

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:sessionStart, params: {
        "media.playerName": "sample-html5-api-player",
        "analytics.trackingServer": "[ _YOUR-TS_ ]",
        "analytics.reportSuite": "[ _YOUR-RSID_ ]",
        "analytics.visitorId": "[ _YOUR-VISITOR-ID_ ]",
        "media.contentType": "VOD",
        "media.length": 60.3333333333333,
        "media.id": "VA API Sample Player",
        "visitor.marketingCloudOrgId": "[YOUR-MCID]",
        "media.name": "ClickMe",
        "media.channel": "sample-channel",
        "media.sdkVersion": "va-api-0.0.0",
        "analytics.enableSSL": false
    }
}

Action 2 - Démarrage du minuteur de ping

Détails de mise en œuvre

Démarrez le minuteur de ping de votre application. Le premier événement ping doit alors se déclencher après 1 seconde en cas de publicités preroll ou après 10 secondes dans le cas contraire.

Action 3 - Début de la coupure publicitaire

Détails de mise en œuvre

Les publicités preroll doivent être suivies. Les publicités ne peuvent être suivies que dans une coupure publicitaire.

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.podIndex": 0,
        "media.ad.podSecond": 0
    }
}

Action 4 - Démarrage de la publicité

Détails de mise en œuvre

Une publicité de 12 secondes commence.

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.name": "Ad 1",
        "media.ad.id": "002",
        "media.ad.length": 7,
        "media.ad.podPosition": 1,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "1",
        "media.ad.creativeId": "42",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz-creative.com",
        "media.ad.placementId": "sample-placement2"
    },
}

Action 5 - Pings de publicité

Détails de mise en œuvre

Envoyez un ping au serveur principal toutes les secondes. (Les pings de publicité suivants ne se pas montrés, dans un souci de concision.)

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Action 6 - Fin de la publicité

Détails de mise en œuvre

La première publicité preroll est terminée.

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adComplete
}

Action 7 - Fin de la coupure publicitaire

Détails de mise en œuvre

La coupure publicitaire est terminée. Tout au long de la coupure publicitaire, le lecteur est resté à l’état « lecture ».

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakComplete
}

Action 8 - Lecture du contenu

Détails de mise en œuvre

Déplacez le lecteur vers l’état « lecture » ; commencez le suivi du début de la lecture du contenu.

Exemple de corps de requête

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:play,
    qoeData: { bitrate: 10000 }
}

Action 9 - Ping

Détails de mise en œuvre

Envoyez un ping au serveur principal toutes les 10 secondes.

Exemple de corps de requête

{
    playerTime: {
        playhead: 8ß,
        ts: <timestamp>
    },
    eventType:ping
}

Action 10 - Ping

Détails de mise en œuvre

Envoyez un ping au serveur principal toutes les 10 secondes.

Exemple de corps de requête

{
    playerTime: {
        playhead: 18,
        ts: <timestamp>
    },
    eventType:ping
}

Action 11 - Erreur

Détails de mise en œuvre

Exemple de corps de requête

{
    playerTime: {
        playhead: 20,
        ts: <timestamp>
    },
    eventType:error
}

Action 12 - Lecture du contenu

Détails de mise en œuvre

Exemple de corps de requête

{
    playerTime: {
        playhead: 18,
        ts: <timestamp>
    },
    eventType:play, qoeData: { bitrate: 10000 }
}

Action 13 - Ping

Détails de mise en œuvre

Envoyez un ping au serveur principal toutes les 10 secondes.

Exemple de corps de requête

{
    playerTime: {
        playhead: 28,
        ts: <timestamp>
    },
    eventType:ping
}

Action 14 - Début de la coupure publicitaire

Détails de mise en œuvre

Publicité mid-roll d’une durée de 8 secondes : envoyez adBreakStart .

Exemple de corps de requête

{
    playerTime: {
        playhead: 33,
        ts: <timestamp>
    },
    eventType:adBreakStart, params: {
        "media.ad.podFriendlyName": "ad_pod2",
        "media.ad.podIndex": 1,
        "media.ad.podSecond": 33
    }
}

Action 15 - Démarrage de la publicité

Détails de mise en œuvre

Suivez la publicité mid-roll.

Exemple de corps de requête

{
    playerTime: { playhead: 33, ts: <timestamp>
    },
    eventType:adStart, params: {
        "media.ad.podFriendlyName": "ad_pod1",
        "media.ad.name": "Ad 1",
        "media.ad.id": "002",
        "media.ad.length": 8,
        "media.ad.podPosition": 1,
        "media.ad.playerName": "Sample Player",
        "media.ad.advertiser": "Ad Guys",
        "media.ad.campaignId": "7",
        "media.ad.creativeId": "40",
        "media.ad.siteId": "XYZ",
        "media.ad.creativeURL": "https://xyz_creative.com",
        "media.ad.placementId": "sample_placement2"
    },
}

Action 16 - Fermeture de l’application

Détails de mise en œuvre

Envoyez sessionEnd au serveur principal VA pour indiquer que la session doit être fermée immédiatement, sans autre traitement.

Exemple de corps de requête

{
    playerTime: {
        playhead: 33,
        ts: <timestamp>
    },
    eventType:sessionEnd
}