HubSpot REST API統合テストガイドの

REST API を使用して新しい HubSpot 統合を設定する場合、動画視聴データが実際に HubSpot に配信されているかどうかをテストして確認することは困難です。このトピックでは、統合が機能していること、および表示データとリードが HubSpot に送信されていることを体系的にテストして確認する方法を学びます。

始める前に

統合を検証する前に、次のことが前提になります。

• 正常に完了しましたBrightcoveキャンペーンとHubSpotの統合
• 少なくとも1つ作成しましたキャンペーン対応プレーヤー HubSpot接続を使用するように構成しました

テストリードフォームの設定とビデオの公開

テストの目的で、キャンペーンでカスタムリードフォームを作成して構成する必要があります。これは、キャンペーンに貼り付けた埋め込みコードのHubSpotフォームです。実稼働環境でリードフォームを使用しない場合でも、このリードフォームを使用して、データベースおよびページで既知であることが確認されます。HubSpotフォームを作成し、それを使用するようにCampaignを構成するには、次の手順に従います。

1. HubSpot アカウントにログインします。
2. HubSpot フォームを作成し、スタイルを設定します。HubSpot フォームの作成の詳細は、「HubSpot のカスタムリードフォームの作成」を参照してください。
3. クリック共有ページの上部にあります。
4. フォームの埋め込みコードをクリップボードにコピーします。
5. キャンペーンモジュールに戻ります。
6. HubSpot フォームの埋め込みコードを使用して、新しいリードフォームを作成します。
7. 5 秒のマークにフォームが表示されるようにカスタムフォームを設定します。このようにして、いつ表示されるべきかを正確に知ることができます。
8. [リードがすでにわかっている場合でも、常にリードフォームを表示する] チェックボックスをオンにします。これにより、テスト中に記入した後もフォームが表示され続けます。
9. フォームを保存します。
10. 作成したばかりの HubSpot リードフォームを使用するように HubSpot 接続で Brightcove Player を設定します。

ビデオを見るためのプレビューリンクの生成

ビデオへのプレビューリンクを生成するには、次の手順に従います。

1. Media モジュールを開きます。
2. ビデオを選択し、Web プレーヤーに公開します。リードフォームでキャンペーン対応のプレーヤーを選択してください。
3. プレビューリンクをクリックして、ビデオを新しいブラウザウィンドウで開きます。この方法でテストすると、HTML ページに埋め込まれたプレーヤーによって導入される可能性のある変数がなくなります。
4. ビデオが再生され、リードフォームが 5 秒マークに表示されることを確認します。
5. 一意の連絡先情報とメールアドレス (有名人の名前、または「bctest」という単語を含む名前) を使用してリードフォームに記入し、後でHubSpotで簡単に見つけることができます。これにより、ブラウザ、プレーヤー、データベースレベルの変数がなくなります。新しいユーザーとしてフォームに入力することで、HubSpot で既知のユーザーであることが確認されます。

キャンペーンがデータを正常にキャプチャしていることを確認する

HubSpotでビデオ視聴データを探す前に、まずCampaignが実際にビデオビューをキャプチャしたことを確認してください。データの表示は、キャンペーンUIに表示されるまでに最大3時間かかる場合があることに注意してください。キャンペーンがデータを正常にキャプチャしていることを確認するには、次の手順に従います。

1. キャンペーンモジュールを開きます。
2. クリック最近のすべての活動左側のナビゲーションで。
3. 視聴したばかりの動画の名前を示す最近のタイムスタンプが付いたイベントがあることを確認します。イベントステータスは未処理である必要があります。これは、Campaignがビューをキャプチャしたが、HubSpotへの同期をまだ試みていないことを示しています。

   

4. キャンペーンとHubSpot間の同期を手動でトリガーするには、同期アクティビティ左側のナビゲーションで。
5. [接続の選択]ドロップダウンリストから、HubSpot 統合を選択します。NS テスト同期ボタンが表示されます。
6. [ 同期のテスト] をクリックして、手動同期をトリガーします。手動同期をトリガーできる頻度は制限されます。デフォルトでは、キャンペーンは1時間に1回ビューをHubSpotに同期します。

   

7. クリック最近のすべての活動左側のナビゲーションで。
8. ビューイベントのステータスはキューに入れられます。データが HubSpot に実際に同期されるには 15 分ほどかかる場合があります。データが同期されると、ステータスは次の 2 つのステータスのいずれかに変更されます。
   • synced -ユーザーが既知のユーザーであり、データがアクティビティログに正常に配信されたことを示します。データは、数分以内に HubSpot でも表示できます。
   • unknown_contact -ユーザーが不明と見なされ、HubSpot がデータを受け入れることができなかったことを示します。unknown_contactのステータスが取得された場合は、正しいプレーヤーを使用して動画を公開したことを確認し、HubSpot フォームを設置し、ページに埋め込まれていないプレビューリンクを使用してテストします。

動画ビューのデータが HubSpot にあることの確認

キャンペーンが表示されたら同期ステータスが表示されたら、次の手順に従って、データがHubSpotにあることを確認します。

1. HubSpot アカウントにログインします。
2. HubSpot で [ 連絡先]領域に移動し、リードフォームに入力するときに使用した一意の名前または電子メールアドレスを探します。
3. 連絡先をクリックして、アクティビティログを開きます。
4. クリックしてくださいアクティビティをフィルタリングするドロップダウン（ページの下のページの上部アクティビティメニュー）そしてそれを確認するBrightcove Video Connectチェックされます。これにより、ビデオ視聴アクティビティがアクティビティログに表示されます。
5. アクティビティログで、ブライトコーブアクティビティ。詳細を展開して、ビデオビューイベントのデータを表示します。

   

HubSpot では、API 経由で配信されるデータを既知の連絡先に割り当てる必要があります。HubSpot は、既知の連絡先のデータのみを受け付けます。不明な連絡先のデータは同期されません。リードフォームを使用しない場合、不明なユーザーが既知のユーザーに変換する方法がないため、データは同期されません。