Contacter le support | État du système
Contenu de la page

    Intégration de Video Cloud avec HubSpot à l'aide des API REST

    Cette rubrique explique comment configurer le module Campaign à utiliser avec HubSpot.

    Le module Campaign permet à Video Cloud de synchroniser les données de visualisation des Brightcove Players vers HubSpot. Une fois dans HubSpot, ces données peuvent être utilisées pour la segmentation, la logique de campagne, les rapports, la notation des prospects et la personnalisation des communications.

    Il existe deux options pour intégrer Video Cloud avec HubSpot :

    • Utilisation de la méthode Standard (API REST) - Avec cette méthode, Campaign suivra uniquement les données de visionnage des téléspectateurs connus. Par défaut, les formulaires de prospect ne seront affichés qu'aux spectateurs inconnus. Cette méthode est abordée dans cette rubrique.
    • Utilisation du volume élevé (côté client API) méthode - Avec cette méthode, Campaign suivra les données de visionnage pour tous les téléspectateurs. Pour plus d'informations sur ce type d'intégration, voir Intégration de Video Cloud avec HubSpot Utilisation des API côté client.

    L'intégration du module Campaign avec HubSpot se compose de deux composants principaux :

    • Un plug-in Brightcove Player pour permettre le suivi des données de vues vidéo
    • Processus de synchronisation pour envoyer des données de suivi de Video Cloud à HubSpot

    Exigences

    Pour utiliser le module Campagne avec HubSpot, vous devez :

    • Avoir un compte HubSpot
    • Avoir un compte Professional ou Enterprise Video Cloud
    • Activez le module Campagne pour votre compte en soumettant les informations requises dans l'écran de démarrage initial qui apparaît lorsque vous ouvrez le module Campagne
    • Cliquez sur le contrat de service la première fois que vous utilisez le module
    • Utilisez le code de publication Advanced Inbed (dans la page) lors de la publication de votre lecteur ; le code de publication d'intégration standard (iframe) ne fonctionnera pas car le plugin fonctionnera à l'intérieur d'un iframe et ne pourra donc pas accéder aux paramètres d'URL de la page parent et peut ne pas obtenir les bons cookies

    Fonctionnalités

    Voici quelques-unes des principales fonctionnalités de l'intégration Video Cloud - HubSpot :

    • Formulaires Lead - Créez des formulaires HubSpot qui apparaîtront automatiquement lorsque les spectateurs regardent des vidéos. Pour plus d'informations, voir Création de formulaires de prospect personnalisés pour HubSpot.
    • Format des données - L'affichage des données est fourni sous la forme d'un type d'événement chronologique personnalisé. Les données répliquées sur HubSpot sont les suivantes :
      • Nom de la vidéo
      • ID de la vidéo
      • ID de compte (Video Cloud)
      • URL de la page (URL de la page de référence)
      • ID du lectuer (lecteur Video Cloud)
      • % regardé (25 %, 50 %, 75 %, 95 %)
    • Transfert de données - La visualisation des données est envoyée à HubSpot à l'aide d'un processus automatisé. Toutefois, certains rapports sur la plateforme HubSpot peuvent prendre du temps à être actualisés
    • Conservation des données - Les données collectées peuvent éventuellement être conservées dans Video Cloud pendant 6 mois.

    Configuration de la connexion

    Procédez comme suit pour configurer la connexion entre Video Cloud et HubSpot.

    Établissement de la connexion entre Video Cloud et HubSpot

    1. Ouvrez le module Campagne et cliquez sur Connexions de données dans la navigation de gauche.
    2. Cliquez sur Add New Collection.
    3. Sélectionnez HubSpot comme intégration.
    4. (Facultatif) Entrez un nom de connexion.
      campaign setup
    5. Cliquez sur Connect.
    6. Sélectionnez Standard (API REST), puis cliquez sur Enregistrer.
      Campaign setup
    7. Cliquez sur Se connecter à HubSpot .
      connect to hubspot
    8. Vous serez invité à vous connecter à HubSpot. Entrez votre adresse e-mail et votre mot de passe. Cliquez sur Se connecter.
      HubSpot login
    9. Si la connexion est réussie, vous serez invité à sélectionner un compte. Cliquez sur Choisissez un compte.
      hubspot access

    La connexion Video Cloud à HubSpot est maintenant configurée et prête à l'emploi.

    Configuration de l'intégration

    Une fois la connexion Video Cloud à HubSpot établie, vous pouvez configurer l'intégration. Cliquez sur Informations sur le compte HubSpot pour afficher les informations du compte HubSpot connecté.

    connected options
    1. Par défaut, l' état de la connexion sera activé. L' état de la connexion détermine si les données d'engagement vidéo Video Cloud sont envoyées à HubSpot.
      • Activé - Les données sont collectées et seront envoyées à HubSpot
      • Désactivé - Aucune donnée n'est collectée (l'intégration est désactivée)
    2. Par défaut, les données de piste pour les visionneuses inconnues seront définies sur Désactivé. L'activation de cette option permet de suivre les données des utilisateurs inconnus. Les données seront conservées en fonction de la politique de rétention des données sélectionnée. Si la rétention des données est définie sur Aucune rétention, ce champ n'est pas affiché.
    3. Sélectionnez une politique de conservation des données. La politique de conservation des données détermine la durée pendant laquelle les données de visualisation et les données du formulaire de prospect (si vous utilisez un formulaire de prospect Campaign) seront conservées dans votre compte Video Cloud. La conservation des données dans Video Cloud vous permet de récupérer les données en cas de synchronisation interrompue. En outre, Campaign continuera à réessayer les événements dont la synchronisation échoue (généralement parce que le spectateur n'est pas un contact connu au moment où il a visionné une vidéo) jusqu'à ce que l'événement ait dépassé la période de conservation des données. Vous devez ajuster les paramètres de rétention conformément à votre politique de confidentialité. Il n'est pas nécessaire de conserver des données utilisateur dans Video Cloud. Les données seront supprimées après la période de conservation des données.
      data retention options

    Pour supprimer l'intégration avec HubSpot, cliquez sur Déconnecter. Le module Campaign prend en charge plusieurs connexions aux plateformes marketing. Cliquez sur Add New Collection pour configurer des intégrations supplémentaires.

    Vérification de l'intégration

    Lorsque l'intégration est configurée, testez l'intégration pour confirmer que les données de la vue vidéo sont envoyées à HubSpot. Pour plus d'informations sur la vérification de l'intégration, reportez-vous au HubSpot REST API Integration Testing Guide.

    Création d'un lecteur compatible avec la campagne

    Les données d'engagement vidéo ne seront envoyées à HubSpot que lorsque vous utilisez un lecteur vidéo compatible avec Campaign. Pour plus d'informations sur la création d'un Brightcove Player activé pour la campagne, consultez Création d'un lecteur compatible avec la campagne.

    Transmission d'un ID de suivi

    Le module Campaign prend en charge la possibilité de transmettre une valeur d'ID de suivi à HubSpot. L'ID de suivi peut être utilisé pour suivre un ID de campagne par exemple. L'ID de suivi peut être ajouté à l'URL qui affiche le lecteur activé pour la campagne ou ajouté au code d'intégration du lecteur.

    • Exemple: Ajoute à l'URL
      http://www.myurl.com/video.html ?bctrackingid=12345
    • Exemple: Ajouté au code d'intégration du lectuer
      <vidéo data-video-id="6033402539001" data-account="1486906377" data-player="default" data-embed="default" data-application-id class="video-js" data-bc-trackingid="12345" les contrôles>< /vidéo>< script src="//players.brightcove.net/1486906377/default_default/index.min.js">< /scénario>

    Campaign transmettra ensuite la valeur à HubSpot en tant qu'autre champ synchronisé.

    Identification des visiteurs

    Pour que le suivi des visionneuses se produise, le visualiseur peut être suivi de l'une des deux manières suivantes :

    • Paramètre d'URL - L'adresse e-mail de l'utilisateur peut être transmise dans un bcemail Paramètre d'URL sur la page qui affiche la vidéo. Pour plus d'informations et un exemple, voir Comment le module de campagne identifie les téléspectateurs.
    • Cookie HubSpot - Lorsque le lecteur se charge, Campaign vérifie si l'utilisateur a déjà été cookie par HubSpot. Si tel est le cas, Campaign demandera à HubSpot s'il sait qui est l'utilisateur via la valeur du cookie. Si HubSpot renvoie un contact, Campaign associera toutes les données de visualisation à cet utilisateur.

    Un scénario possible consiste à créer des pages de destination vidéo avec une URL générée de manière unique à des fins de suivi. Le module Campaign utilisera ensuite le paramètre URL pour rechercher l'utilisateur côté serveur et synchroniser les données de visualisation.

    Pour que le lecteur ou le plug-in puisse lire les paramètres d'URL, vous devez utiliser le code de publication Advanced Embed (in-page). Le code de publication Standard Embed (iframe) ne fonctionnera pas, car le plug-in sera exécuté à l'intérieur d'un iframe et par conséquent, ne pourra pas accéder aux paramètres de l'URL de la page parente.


    Dernière mise à jour de la page le 12 Dec 2021