サポートに連絡する| システムステータス
ページコンテンツ

    REST APIのを使用したVideoCloudとMarketoの統合

    このトピックでは、RESTAPIを使用してMarketoで使用するキャンペーンモジュールを構成する方法について説明します。

    キャンペーンモジュールを使用すると、VideoCloudはBrightcoveプレーヤーからMarketoへの表示データを同期できます。Marketoのデータをセグメント化、キャンペーンロジック、レポート、リードスコアリング、コミュニケーションのパーソナライズに使用できます。

    キャンペーンモジュールとMarketoの統合は、次の2つの主要コンポーネントで構成されています。

    • 動画視聴回数データのトラッキングを可能にするBrightcoveプレーヤープラグイン
    • 動画クラウドからMarketoにトラッキングデータを送信する同期プロセス

    要件

    Marketo REST統合でキャンペーンモジュールを使用するには、次のことを行う必要があります。

    • すべての API 権限にアクセスできるロールを Marketa で作成する
    • LaunchPoint サービスの作成
    • ProfessionalまたはEnterprise Video Cloudアカウントを保有している
    • キャンペーンモジュールを開いたときに表示される最初のスプラッシュ画面で必要な情報を送信して、アカウントでキャンペーンモジュールを有効にします
    • はじめてモジュールを使用するときにサービス利用契約に同意している
    • プレーヤーを公開するときは、高度な埋め込み (ページ内) 公開コードを使用してください。標準埋め込み (iframe) 公開コードはプラグインが iframe 内で実行されるため、機能しません。したがって、親ページの URL パラメータにアクセスできず、正しい Cookie を取得できない可能性があります

    API のみのユーザーと LaunchPoint サービスの作成

    Marketoの REST API を呼び出す前に、すべての API にアクセスできる新しい API ロールを作成し、API のみのユーザーを作成し、クライアントアプリケーションを一意に識別するサービスを作成する必要があります。これらのタスクを完了する手順は、 Marketoのドキュメントで概説されています。

    接続のセットアップ

    Marketo 側の構成手順が完了したら、以下の手順に従って Video Cloud と Marketo 間の接続を設定します。

    Video CloudとMarketoとの間の接続を確立する

    1. キャンペーンモジュールを開き、をクリックしますデータ接続左側のナビゲーションで。
    2. [新規コレクションの追加]をクリックします。
    3. 選択するMarketo統合として。
    4. (オプション) 接続名を入力します。
      Campaign setup
    5. [接続]をクリックします。
    6. [ 標準 (REST API)] を選択し、[ 保存] をクリックします。
      marketo integration type

      Marketa アカウントからいくつかの値を貼り付ける必要があります。以下の手順を実行するには、Marketto 管理者としてログインする必要があります。次の手順では、空のリンクをクリックし、適切な値を指定します。

    7. MarketoアカウントID -この値を取得するには、Marketoでクリックします管理者 > 統合 > マンチキン。
    8. Marketo RESTAPIエンドポイントURL -この値を取得するには、Marketoでクリックします管理者 > 統合 > ウェブサービス。
    9. Marketo RESTAPIアイデンティティURL -この値を取得するには、Marketoでクリックします管理者 > 統合 > ウェブサービス。
    10. MarketoLaunchPointクライアントID -この値を取得するには、Marketoでクリックします管理者 > 統合 > LaunchPoint次に、をクリックします詳細を見るこのセットアップの一部として以前に作成したLaunchPointへのリンク。
    11. Marketo LaunchPoint クライアントシークレット -この値を取得するには、Marketo で [ 管理] > [ LaunchPoint]をクリックし、前にこのセットアップの一部として作成した LaunchPoint の [詳細の表示]リンク。
    12. [ 設定] をクリックします。

    これで、Marketo への Video クラウド接続がセットアップされ、使用できるようになります。

    統合を設定する

    Video CloudからMarketoへの接続を完了した後、統合を設定できます。

    connected options
    1. デフォルトでは、[ 接続ステータス]は [ 有効] になります。接続ステータスは、Video Cloud 動画エンゲージメントデータを Marketoに送信するかどうかを決定します。
      • 有効 -データが収集され、Marketo に送信されます
      • 無効 -データは収集されません（統合は無効です）
    2. 既定では、[ 不明なビューアのデータの追跡]は [ 無効] に設定されます。このオプションを有効にすると、不明なユーザーのデータが追跡されます。データは、選択したデータ保持ポリシーに基づいて保持されます。データ保持が [ 保存期間なし] に設定されている場合、このフィールドは表示されません。
    3. データ保存ポリシーを選択します。データ保持ポリシーは、キャプチャしたリード情報データを Video Cloud アカウントと Marketo に保持するかどうか、およびその期間を決定します。Video Cloud にデータを保持すると、中断された同期から回復できます。ただし、保持設定は、プライバシーポリシーに従って調整する必要があります。Video Cloud にユーザーデータを保持する必要はありません。データは、データ保持期間が過ぎると削除されます。
      data retention options

    Marketoとの統合を削除するには、[切断]をクリックします。

    キャンペーン対応プレーヤーの作成

    ビデオエンゲージメントデータは、キャンペーン対応のビデオプレーヤーを使用している場合にのみMarketoに送信されます。キャンペーン対応のBrightcoveプレーヤーの作成については、を参照してください。キャンペーン対応プレーヤーの作成。

    視聴者を識別する

    Marketoと統合されたキャンペーン対応のプレーヤーは、ユーザーのブラウザで作成されたMunchkin Cookie（_mkto_trk）を参照します。この値は、キャンペーンモジュールの表示データに取り込まれ、表示データをMarketoに同期するために使用されます。

    ユーザーの電子メールアドレスは、ビデオを表示しているページの bcemail URL パラメータで渡すことができます。詳細と例については、を参照してください。キャンペーンモジュールが視聴者を識別する方法。

    統合の確認

    統合を構成したら、統合をテストして、ビデオビューデータが Marketo に送信されていることを確認します。統合の検証については、 Marketto REST 統合テストガイドを参照してください。

    ページの最終更新日26 Oct 2021