- HubSpotのドラッグ＆ドロップエディターでページやEメールにメディアオブジェクトを埋め込むためのモジュール。
- プロスペクトまたは顧客が動画、音声、およびその他のメディアタイプを操作したときに表示されるCRMタイムラインイベント。
- ターゲットを絞り込み、パーソナライズされた体験を提供するためのセグメント化されたリスト。
- メディア消費イベントに基づいてインタラクションを自動化するワークフロー。
- メディアアセットの効果を測定するためのレポート。
スコープ要件
スコープ要件
メディアブリッジAPIの使用
メディアブリッジアプリをHubSpotユーザーのアカウントに関連付けるには、その前に、HubSpot開発者アカウントを使用して、メディアブリッジアプリを登録し、最初のメディアオブジェクト定義を設定する必要があります。メディアオブジェクト定義を作成してカスタマイズする
メディアオブジェクトを定義するには、POSTリクエストを/media-bridge/v1/{appId}/settings/object-definitionsに送信します。リクエスト本文には、mediaTypes配列内にVIDEO、AUDIO、DOCUMENT、IMAGE、またはOTHERのいずれかのメディアタイプ値を含めます。
メディアオブジェクトを定義したら、PATCHリクエストを/media-bridge/v1/{appId}/schemas/{objectType}に送信し、POSTリクエストを/media-bridge/v1/{appId}/properties/{objectType}に送信して、メディア オブジェクト プロパティーを作成して変更します。
メディアブリッジアプリをHubSpotユーザーのアカウントに関連付ける
メディアブリッジアプリをHubSpotユーザーのアカウントに関連付けるには、HubSpot開発者のアカウントでそのためのアプリ定義を作成する必要があります。アプリの定義には、以下の情報を含めます。- 連携でHubSpotユーザーのアカウントに対して最初に関連付けを行う際に、ユーザーに表示されるロゴやテキストなどの詳細。
- 連携で必要となる、ユーザーのHubSpotアカウントに対するスコープ。
- メディアブリッジアプリの開発者アカウントで、アプリケーション定義を作成します。
- アプリケーションを定義する際には、以下のスコープを含めます。
media_bridge.readmedia_bridge.write
- アプリからの呼び出しを認証する際は、OAuth認証を使用します。認証方式の詳細をご確認ください。
https://app.hubspot.com/media-bridge-demo/{HubID}の{HubID}をアカウントIDに置き換えてアクセスします。- 右上の［アプリ］ドロップダウンメニューをクリックし、ご使用のメディアブリッジアプリを選択します**。 **
- アプリでは、アプリでサポートされるメディアタイプの確認や、サンプルメディアの作成ができます。
メディアオブジェクトを作成する
メディアオブジェクトの定義を作成し、メディアブリッジアプリをユーザーのアカウントにインストールしたら、OAuthトークンを使用して、アカウントでメディアオブジェクトを作成し、変更できるようになります。メディアオブジェクトはカスタムオブジェクトなので、カスタムオブジェクトAPIエンドポイントを使用して作成します。GETリクエストを/media-bridge/v1/{appId}/settings/object-definitions/{mediaType}に送信して、objectTypeを見つけます。POSTリクエストを/crm/v3/objects/{objectType}に送信して、ユーザーのアカウントにメディアオブジェクトを作成します。
VIDEOおよびAUDIOメディアオブジェクトで利用可能な全てのプロパティーは、以下の表でご確認いただけます。
*でマークされたフィールドは必須です。
IMAGEメディアオブジェクトの場合に使用できる全てのプロパティーは、以下の表でご確認いただけます。
*でマークされたフィールドは必須です。
メディアを埋め込むためのCMSモジュールの作成
HubSpotのCMSでメディアをレンダリングするためのモジュールは、各メディアブリッジアプリ プロバイダーが作成する必要があります。 メディアブリッジアプリがHubSpotアカウントにインストールされている場合、モジュール上の埋め込みフィールドに、追加の「メディア連携」ソースタイプが示されます。_ _これにより、ユーザーはインストールされたアプリからウェブサイトページに埋め込むメディアを選択できるようになります。 ユーザーが埋め込むメディアを選択すると、メディアのoembed_urlおよびoembed_responseがHubLで使用可能になり、プレーヤーを簡単にレンダリングできるようになります。さらに、選択したメディアのidとmedia_typeが保存され、基盤となるCRMオブジェクトをcrm_objects HubL関数でクエリーすることが可能になります。これにより、メディアオブジェクトに含まれる全てのプロパティーまたはプロパティーの一部を取得できます。
メディアオブジェクトのIDが459と922の場合のcrm_objects HubL関数の使用例：
{% set objects = crm_objects("a123_Videos", [459,922]) %} {{ objects }}
同じオブジェクトの特定の画像を取得する場合：{% set object = crm_object("a123_Images", 459) %} {{ object }}
アプリではGETリクエストを/media-bridge/{appId}/settings/object-definitions/{mediaType}に送信することで、オブジェクトタイプ（この例では「a123_Videos」）を取得できます。
顧客がoAuthを介して接続した後、開発者はCMSソースコードAPIエンドポイントを使用して、カスタム モジュール コードを顧客のアカウントにプッシュする必要があります。モジュールコードが顧客のアカウントにプッシュされると、顧客は開発者が作成したモジュールをコンテンツ内で自動的に使用できるようになります。
oEmbedドメインを設定する
oEmbed HubL関数を使用するには、/media-bridge/v1/{appId}/settings/oembed-domainsにリクエストを送信して、oEmbedレスポンスの取得に使用されるドメインを登録する必要があります。以下のパラメーターが含まれている必要があります。
-
スキーム: メディアURLのURLパターン。このURLパターンは、oEmbed HubL関数に渡されたURLをoEmbed APIと照合するために使用されます。
*を使用したワイルドカード値を使用できます（例：www.domain.com/*）。 -
URL: oEmbed APIのURL。メディアは、
URLパラメーターを使用してこのURLに渡されます。 - Discovery（ブール値）: oEmbed APIでoEmbedのDiscovery機能がサポートされるかどうかを決定します。
portalId値を渡して、oEmbedドメインの使用を許可するアカウントを指定できます。これにより、そのoEmbedドメインを使用できるアカウントが、指定されたHubSpotアカウントのみに制限されます。
カスタムモジュールを作成する
カスタムモジュールを作成するには、次のようにします。- ［マーケティング］＞［ファイルとテンプレート］＞［デザインマネージャー の順に進みます。
- 左上の ［ファイル］>［新規ファイル］ をクリックします。
- ダイアログボックスで、［今日は何を作成しますか？］ ドロップダウンメニューをクリックし、［モジュール］ を選択します。
- ［次へ］ をクリックします。
- モジュールを使用するコンテンツのタイプ（［ページ］、［ブログ記事］、［ブログリスト］、［Eメール］、または ［引用］）の隣にあるチェックボックスをオンにします。Eメールテンプレートで使用されるモジュールに、CSSおよびJavaScriptを含めることはできません。
- このモジュールをローカルモジュールまたはグローバルモジュールのどちらにするかを選択します。グローバルモジュールとして作成した場合、このモジュールのコンテンツを編集すると、モジュールが使用されている全ての場所に変更が反映されます。
- モジュールのファイル名を入力して、［作成］ をクリックします。
- 右側の ［フィールド］ セクションで、［フィールドの追加］ ドロップダウンメニューをクリックし、［埋め込み］ を選択します。
- ［サポートされるソースタイプ］ セクションで、［メディアとの連携］ を選択します。
- ［既定の埋め込みコンテンツ］ セクションで、［[メディアブリッジアプリ]から選択］ をクリックします。
- 右側のパネルで、モジュールに埋め込むメディアを選択します。
- 必要に応じて、エディターオプション、フィールドの表示条件、フィールドのリピーターオプションを設定します。
- ［HubL変数名］ で、［コピー］>［スニペットをコピー］ をクリックします。
- 「module.html」 セクションにスニペットを貼り付けます。
- ページ上でのモジュールの表示をプレビューするには、［プレビュー］ をクリックします。
- 左側のセクションで、［[メディアブリッジアプリ]から選択］ をクリックし、プレビューするメディアを選択します。
メディアイベントを送信する
メディアイベントは、メディアオブジェクトに関連して発生するイベント（例：再生イベント）です。メディアブリッジアプリに送信されたメディアイベントは、レポートやタイムラインCRMカードで使用できます。 メディアイベントには次の3種類があります。- 再生イベント: ユーザーがメディアの再生を開始した時間を表します。このイベントはコンタクトのタイムラインとレポートツールの両方で確認できます。
- 四分位数イベント: ユーザーが閲覧しているメディアで、四分位数のマイルストーン（0％、25％、50％、75％、100％）に到達した時間を表します。このイベントはコンタクトタイムラインのみで使用できます。
- 注意持続時間イベント: ユーザーがメディアを完全に消費し終えた時間、またはユーザーがセッションを終了した時間を表します。このイベントはレポートツール内でのみできます。
POSTリクエストを/media-bridge/v2/events/media-played、/media-bridge/v2/events/media-played-percent、および/media-bridge/v2/events/attention-span respectivelyに送信します。
HubSpotでユーザーのコンタクトタイムラインにメディアイベントを表示するには、セッションごとに再生イベントをメディアブリッジアプリに送信する必要があります。単一のセッションからのイベントは、コンタクトのアクティビティータイムラインで1つのカードに表示されます。
V2イベントエンドポイントを使用して送信されたイベントは、v1エンドポイントを使用して送信されたイベントとは異なり、非同期で処理されます。そのため、以下のようにすることを推奨しています。
- 誤ったリクエストは即座にエラーになるため、v1バージョンのエンドポイントはテストに使用します。
- V2バージョンのエンドポイントは、その非同期性により、イベントがメディアブリッジに書き込まれる間のクライアントの遅延を防ぐのに役立つため、本番環境で使用します。また、メディアブリッジのサーバーに一時的な障害が発生した場合にも、イベントは保持され、再試行されます。
イベントをコンタクトレコードに関連付ける
メディアイベントをコンタクトレコードに関連付けるには、contactIdまたはcontactUtkのいずれかを提供する必要があります。contactUtkのみが提供された場合は、contactIdに変換されます。リクエストで両方が提供された場合は、contactIdが信頼できる情報源として使用されます。このパラメーターにより、メディアブリッジアプリはコンタクトレコードとイベントの間に関連付けを作成できます。
コンタクトレコードに関連付けられたメディアイベントは、クロスオブジェクトのレポートで使用できます。これにより、お客様はメディアイベントとコンタクトレコード、および関連する会社と取引を関連付けることができます。
イベントをメディアに関連付ける
メディアイベントをメディアに関連付けるには、mediaIDまたはexternalIDのいずれかのパラメーターをリクエストに含める必要があります。両方が提供された場合は、mediaIDが信頼できる情報源として使用されます。
イベントをページに関連付ける
メディアイベントをHubSpotのページに関連付けるには、次のパラメーターをリクエストに含める必要があります。- ページがHubSpot CMSでホスティングされている場合は、
pageIdを提供する必要があります。 - ページがHubSpot CMSでホスティングされていない場合は、
pageNameおよびpageUrlを含める必要があります。