API partenaire
Ressources API

Annonces vidéo

📘

Fonctionnalité bêta

Cette fonctionnalité est actuellement en version bêta et est susceptible d'être modifiée. Nous vous encourageons à nous faire part de vos commentaires pour nous aider à l'améliorer.

Les annonceurs et les détaillants peuvent télécharger des vidéos promotionnelles sur leurs bannières, qui s'affichent directement sur leur site Web ou leur application. Ces vidéos influencent les décisions d'achat en présentant les produits de manière attrayante. Les vidéos interactives, qui contiennent des options ajouter au panier ou acheter maintenant, permettent aux clients de découvrir et d'acheter des produits directement à partir de la vidéo.

Pourquoi choisir des annonces vidéo pour votre site ?

En créant des expériences d'achat plus attrayantes et en augmentant le temps que les clients passent sur votre site à explorer les options qui s'offrent à eux, la vidéo sur site permet à vos annonceurs de s'engager plus profondément avec eux sur votre site Web.

MotifsDescription
Promouvoir l'histoire d'une marqueLes annonces vidéo à fort taux d'engagement mettent en avant une partie captivante et pertinente de l'histoire globale de l'annonceur ou de l'histoire d'un produit spécifique, afin de nouer un lien plus profond avec votre marque.
Lancements de nouveaux produitsLes annonceurs peuvent utiliser la vidéo pour présenter de nouveaux produits de manière plus approfondie qu'avec un simple affichage. Elle leur permet de communiquer sur leur valeur ajoutée.
Notoriété de la marqueLes annonceurs qui souhaitent faire connaître une nouvelle catégorie ou diffuser un nouveau message peuvent l'utiliser à des endroits clés de votre site pour communiquer directement avec vos clients.
Renforcer le lien à votre marqueLa vidéo peut renforcer le lien entre un annonceur et votre marque dans l’esprit des clients.

Spécifications de la vidéo

  • Taille maximale du fichier : 300 Mo
  • Types de fichiers acceptés : vidéo/mp4, vidéo/quicktime, vidéo/x-msvideo
  • Validation des codecs (facultatif) : H.264, H.265
  • Hauteurs et largeurs : définies par le détaillant (en pixels)
  • Limite de durée : aucune
  • Évaluation de la campagne : obligatoire pour les campagnes de bannières X contenant un élément vidéo
  • Prise en charge des balises : balise VAST standard diffusée comme adm dans la réponse d'annonce

Intégrer des annonces vidéo

Vous pouvez créer des bannières publicitaires X vidéo qui s'intègrent parfaitement aux lecteurs vidéo compatibles VAST 4.0. Les détaillants bénéficient ainsi d'un format publicitaire interactif qui simplifie le déploiement.

Les annonces vidéo des bannières X respectent la norme Digital Video Ad Serving Template (VAST) 4.0, qui garantit une intégration fluide et compatible aux lecteurs vidéo pris en charge.

Lorsque vous intégrez des annonces vidéo à des campagnes, la réponse d'annonce inclut un champ intitulé adm. Ce champ contient les balises XML requises pour la conformité VAST 4.0, ce qui facilite l'intégration dans les lecteurs vidéo.

Exigences d'intégration

Demande d'annonce

Vous devrez envoyer une requête d'annonce à notre point de terminaison de la bannière X. Les vidéos et autres bannières seront uniquement diffusés pour les campagnes pour lesquelles ces éléments ont été configurés. Assurez-vous que des campagnes sont configurées avec des éléments vidéo avant de recevoir des annonces avec l'objet adm fourni.

Pour obtenir de plus amples informations sur les requêtes d'annonces, consultez la section Générer des bannières publicitaires X

Lecteur vidéo (diffusion des annonces)

Epsilon Retail Media utilise une balise VAST (Video Ad Server Template) dans notre réponse d'annonce en tant qu'objet adm de la réponse de la bannière X. Vous aurez donc probablement besoin d'un lecteur vidéo pour analyser la balise VAST et diffuser l'annonce vidéo.

📘

Vous n'avez pas de lecteur vidéo ?

De nombreux lecteurs vidéo open source sont disponibles. Nous vous recommandons de consulter les solutions payantes et les options open source, telles que Video JS ou Clappr. Veuillez noter que des plugins supplémentaires peuvent être nécessaires pour analyser les balises VAST.

Outil de prévisualisation de la bannière X

Mettez à jour votre outil de prévisualisation de la bannière X pour vous assurer que l'aperçu des annonces s'affiche correctement lors de la création, la gestion et l'examen des campagnes. Voir Outil de prévisualisation de la bannière X.

Suivi et comptabilisation

Les balises VAST offrent de nombreuses options de suivi (impressions, clics, progression et interactions), mais seul le suivi des impressions et des clics est disponible dans la version bêta. Cela s’ajoute à la comptabilisation des commandes standard.

🚧

Capacités futures

Les rapports de progression et d'interaction seront disponibles dans une prochaine version.

Éléments de suivi

Utilise la norme Video Ad Serving Template (VAST) à des fins de suivi. La balise VAST comprend plusieurs mécanismes de suivi :

  • Suivi des impressions
  • Suivi des clics
  • Suivi des progrès (début, premier quartile, moitié, troisième quartile, terminé)
    • Premier quartile (vidéo visionnée à 25 %) : indicateur précoce de l'engagement initial.
    • Moitié (vidéo visionnée à 50 %) : indique un intérêt soutenu de la part du spectateur à mi-parcours du contenu.
    • Troisième quartile (75 % regardé): montre un fort engagement des spectateurs envers le contenu.
    • Terminé (vidéo visionnée à 100 %) : confirme que le spectateur a regardé la vidéo en entier, ce qui indique un engagement maximal.
  • Suivi des interactions (désactiver le son, réactiver le son, suspendre, reprendre, plein écran)
    • Désactiver le son : l'utilisateur a désactivé le son de la vidéo.
    • Réactiver le son : l'utilisateur a réactivé le son de la vidéo.
    • Suspendre : l'utilisateur a suspendu la lecture de la vidéo.
    • Reprendre : l'utilisateur a repris la lecture de la vidéo après l'avoir suspendue.

Exemple de réponse pour les annonces vidéo

Voici un extrait de la réponse d'annonce vidéo, y compris les informations relatives à la balise VAST :

{

  "ads": [

    {

      "contentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",

      "slotId": "Top_Banner",

      "banners": [

        {

          "citrusAdId": "shotgun_8SvgA7OvvuwtZkkOKR0vr8AXMvQKFgoURmluZ2VybGltZTI2LWZkeHZxMjcSABoMCO30r70GEKPplJQCIgIIAQ==",

          "citrusCampaignName": "Ads:74-330-96832622ed499dafb3da8de8b76340a2",

          "citrusContentStandardId": "c47c9ca2-ad3b-48cc-880b-e899c1661726",

          "citrusSlotId": "Top_Banner",

          "citrusExpiry": "2025-02-12T01:33:33.579155107Z",

          "headingText": "recusandae 3205",

          "bannerText": "placeat 2825",

          "bannerTextColour": "ffffff",

          "ctaFlag": true,

          "ctaText": "CTA text",

          "ctaTextAccessibility": "call to action accessibility text",

          "ctaLink": http://citrusad.com ,

          "backgroundColour": "000000",

          "backgroundImage": https://dev3.flavedo.io./citrus/8de07ed9-60b4-4611-8bd5-3f1f0c0b6be4,

          "secondaryBackgroundImage": https://dev3.flavedo.io./citrus/b7a70785-1366-42c6-8134-c7fe47a30c34,

          "secondaryBackgroundImagePosition": "rightaligned",

          "heroImage": https://dev3.flavedo.io./citrus/26798ca9-1022-422d-9100-1a3687c88372,

          "heroImageAltText": "hero image alt text",

          "secondaryHeroImage": https://dev3.flavedo.io./citrus/c4ee18b4-bf51-44d7-9eb6-eeb1dc4c422f,

          "secondaryHeroImageAltText": "secondary hero image alt text",

          "secondaryHeroMode": "landscape",

          "tags": {},

          "additionalFields": [

            {

              "id": "text-1",

              "value": "sed 5731"

            }

          ],

          "gtins": [

            "Fingerlime26-fdxvq27",

            "Oranges5-qgxeb6",

            "Cherries9-adkoj11",

            "Incaberries20-ppscn21",

            "Banana14-simfk15"

          ],

          "sellerId": "seller_id_772_659",

          "position": 1,

          "metadata": {

            "advertiserInfo": {

             "advertiser": "Bob's advertising agency",

             "onBehalfOf": "Brand company inc"

            }

          },
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<VAST version=\"4.0\">\n    <Ad id=\"1\">\n        <InLine>\n            <AdSystem>CitrusAd</AdSystem>\n            <Impression><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Impression>\n            <ViewableImpression>\n                <Viewable><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/first-i/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></Viewable>\n                <NotViewable></NotViewable>\n                <ViewUndetermined></ViewUndetermined>\n            </ViewableImpression>\n            <AdTitle>VAST-4.0-Short-Intro.mp4</AdTitle>\n            <Creatives>\n                <Creative>\n                    <UniversalAdId idRegistry=\"http://citrusad.com \" idValue=\"VAST-4.0-Short-Intro.mp4\">VAST-4.0-Short-Intro.mp4</UniversalAdId>\n                    <Linear>\n                        <Duration></Duration>\n                        <MediaFiles>\n                            <MediaFile delivery=\"progressive\" type=\"video/mp4\" width=\"0\" height=\"0\" bitrate=\"0\" codec=\"\"><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></MediaFile>\n                            <Mezzanine><![CDATA[https://cdn.flavedo.io./citrus/VAST-4.0-Short-Intro.mp4]]></Mezzanine>\n                        </MediaFiles>\n                        <VideoClicks>\n                            <ClickTracking><![CDATA[https://integration.BASE-URL.citrusad.com/v1/resource/second-c/shotgun_2DbJUbTdlM3HFvLuF75YoA2FgpwKBQoDMTIzEgAaCwjHsuG_BhD7sqZzIgIIAQ==]]></ClickTracking>\n                            <ClickThrough><![CDATA[a/a-national/everything/browse]]></ClickThrough>\n                        </VideoClicks>\n                    </Linear>\n                </Creative>\n            </Creatives>\n        </InLine>\n    </Ad>\n</VAST>"      

       }

      ]

    }

  ]

}

Exemple de balise VAST complète

📘

Cela contient des champs que nous ne prenons pas en charge pour le moment.

Le suivi est prévu pour une prochaine mise à jour.

L'exemple suivant illustre la configuration d'une annonce vidéo en ligne. Il détaille la définition des créations, des URL de redirection et des événements de suivi.

<VAST version="4.0" xmlns="http://www.iab.com/VAST">

  <Ad id="inArticle_123" sequence="1">

    <InLine>

      <AdSystem version="1.0">InArticleAdServer</AdSystem>

      <AdTitle>In-Article Video Ad</AdTitle>

      <Description>Video ad that plays within article content</Description>

      <Impression><![CDATA[http://example.com/track/impression]]></Impression>

      <Creatives>

        <Creative>

          <Linear>

            <Duration>00:00:15</Duration>

            <MediaFiles>

              <MediaFile delivery="progressive" type="video/mp4" width="640" height="360">

                <![CDATA[https://example.com/video/ad.mp4]]>

              </MediaFile>

            </MediaFiles>

            <VideoClicks>

              <ClickThrough>https://advertiser.com/landing</ClickThrough>

            </VideoClicks>

            <TrackingEvents>

              <Tracking event="start">http://example.com/tracking/start</Tracking>

              <Tracking event="firstQuartile">http://example.com/tracking/firstQuartile</Tracking>

              <Tracking event="midpoint">http://example.com/tracking/midpoint</Tracking>

              <Tracking event="thirdQuartile">http://example.com/tracking/thirdQuartile</Tracking>

              <Tracking event="complete">http://example.com/tracking/complete</Tracking>

              <Tracking event="progress" offset="00:00:10">http://example.com/tracking/progress-10</Tracking>

              <Tracking event="creativeView">http://example.com/tracking/creativeView</Tracking>

              <Tracking event="mute">http://example.com/tracking/mute</Tracking>

              <Tracking event="unmute">http://example.com/tracking/unmute</Tracking>

              <Tracking event="pause">http://example.com/tracking/pause</Tracking>

              <Tracking event="resume">http://example.com/tracking/resume</Tracking>

              <Tracking event="fullscreen">http://example.com/tracking/fullscreen</Tracking>

              <Tracking event="exitFullscreen">http://example.com/tracking/exitFullscreen</Tracking>

          </TrackingEvents>

          </Linear>

        </Creative>

      </Creatives>

    </InLine>

  </Ad>

</VAST>