HopinプラットフォームでMarketoを設定する

  • 更新

Biz_Enter.png

Marketo.png

Hopin<>Marketoアプリはどのプランで利用できますか?

Marketoアプリは、ビジネスプランとエンタープライズプランで利用できます。

Hopinライセンスの概要は、料金ページでご確認いただけます。 アップグレードに関しては、お気軽に営業チームにお問い合わせください。

Hopin<>Marketoアプリにはどのような機能がありますか?

HopinとMarketoを統合することで、以下のワークフローをサポートします。

  1. MarketoからHopinに登録者を引き出し、Marketoにマジックリンクをプッシュバックします。
  2. カスタムアクティビティとして、Marketoに登録者をプッシュします。
  3. カスタムアクティビティとして、Marketoに「参加済み」のステータスをプッシュします。
  4. カスタムアクティビティとしてカスタム登録Q&Aをプッシュします。
注:Marketoでマジックリンクを送信した場合、イベントダッシュボードの[マジックリンク/招待を管理]タブのチケットステータスは[招待済み]に更新されません。 招待を送信済みの場合は、Marketoを使用して追跡する必要があります。 ただし、登録者がマジックリンクを承認すると、その登録者のHopinのマジックリンクステータスは[登録済み]に変更されます。

Hopin—Marketo間でどのようなデータが同期されていますか?

現在、同プラットフォーム間で名、姓、メールアドレス、カスタムフォームの質問を同期しています。 登録オブジェクト全体(見出し、ウェブサイト)の同期に積極的に取り組んでいます。

Marketoの統合をテストする

前述のすべての機能を利用するには、以下の手順に従います。これらのいずれかの機能を利用しない場合は、構成画面で何も入力せず、次の画面に進みます。

Marketoアプリを設定するには、3つの重要なポイントがあります。

  • Hopinでアプリを構成する
  • Marketoでウェブフックを設定する(Marketoから登録者をインポートする場合)
  • Marketoでカスタムアクティビティを設定する(Marketoへの登録または参加のエクスポート、またはQ&Aへのカスタム登録のエクスポートを希望する場合)

以下のタブをクリックして、セットアッププロセスの各段階の手順にそれぞれ従います。

  • 1. 開始するには、Hopin組織にMarketoアプリをインストールする必要があります。 組織ダッシュボードに移動し、[アプリ]タブに移動すると、アプリストアにアクセスできます。 その後、[App Storeでさらに検索]をクリックします。 

    Integrations-Hopin.png

    2. Marketoは、マーケティングカテゴリの下にあります。または、このリンク をクリックしてページに直接移動することもできます。 [アプリをインストール]をクリックして、Marketoアプリを組織に追加します。

    marketo.png

    3. ポップアップウィンドウが表示され、新しいMarketo認証の作成を要求します。

    Screenshot_2021-04-15_at_19.02.41.png

    4. Marketoインスタンスを承認するには、Marketo APIエンドポイントドメイン、クライアントID、クライアントシークレットが必要です。 APIエンドポイントドメインを取得するには、Marketoで[管理者] > [ウェブサービス]の順に移動して、Rest APIエンドポイントをコピーします。ただし、URLの末尾には「rest」を含めないでください。

    クライアントIDとクライアントシークレットを取得するには、MarketoインスタンスにAPIロールとユーザーを持っており、さらにLaunchpointで「インストール済みサービス」を作成する必要があります。 こちらのドキュメントをご覧ください。

    すでにAPIユーザーとインストール済みサービスが存在する場合は、「管理者」>「ローンチポイント」>「詳細を表示」でクライアントIDとクライアントシークレットを見つけることができます。

    統合を設定するため、APIユーザーには次のアクセス許可が必要です。

    • アクセスAPI > 読み取り/書き込みユーザー
    • アクセスAPI > 読み取り/書き込みアクティビティ
    • アクセスAPI > 読み取り/書き込みアクティビティメタデータ
    • アクセスAPI > 読み取り-書き込みアセット

    Screenshot_2021-04-15_at_19.07.03.png

    image5.png

    image6.png

    5. Marketoインスタンスの認証が完了したら、「次へ」をクリックします。

    Screenshot_2021-04-15_at_19.10.12.png

    6. [次へ]をクリックして、「登録者をインポート」画面に進みます。 MarketoからHopinに登録をインポートするには、Marketoのプログラムメンバーオブジェクトに以下の2つのフィールドが必要です。

    1. Hopinのチケット統合コードを含むフィールド(このドキュメントの「テスト」セクションでこの値の場所を説明します)。
    2. Hopinのマジックリンク(メールアドレス、チケット、イベントに関連付けられ、登録者にイベントへのアクセスを許可するリンク)を受信できるフィールド。

    これらの欄は、「文字列」タイプとして設定します。 目的を明確にするため、Marketoではカスタム欄として設定することをおすすめします。 見出し情報をHopinにインポートする場合は、それ用のフィールドを選択することもできます。

    image10.png

    7. 次の画面には、デフォルトでインポートされるMarketoリードフィールドが表示されます。 続行するには、「次へ」をクリックします。

    image24.png

    8. 「次へ」をクリックして、最後の「MarketoのWebhook URL」画面に進みます。 ウェブフックURLをコピーします(残りの手順で必要になるため、メモ帳に貼り付けておきます)。

    注:URL欄が空白の場合は、「完了」をクリックして統合を解除し、もう一度接続します。これで問題が解決するはずです。

    Screenshot_2021-04-15_at_19.19.11.png

    9. 登録およびカスタム登録Q&AをHopinからMarketoにプッシュする場合は、カスタムアクティビティを介してプッシュし、カスタムアクティビティの下にフィールドを構成できます(この手順が必要ない場合は、次へをクリックして画面をスキップします)。 このアクションにカスタムアクティビティが設定されていない場合は、以下の手順に従って設定する必要があります。 この場合、当社側で「イベントに登録済み」というカスタムアクティビティを設定してありますので、「登録をエクスポート」画面のドロップダウンからそのカスタムアクティビティを選択します。

    image26.png

    10. カスタムアクティビティが選択されたら、最大3秒間待って、組織に関連する既存のカスタム登録の質問があるかを確認します。

    ヒント:Hopinで登録フォームを作成する方法は、こちらのガイドをご覧ください。

    カスタムアクティビティの下にカスタム登録の質問をマッピングするフィールドも設定されている場合は、ここにも表示されます。 このアクション用に設定されたカスタムアクティビティの下にフィールドを設定していない場合は、「カスタムアクティビティの設定」とその下の「フィールドの作成」のセクションで、以下の手順に従ってフィールドを設定する必要があります。

    注: カスタム登録質問を作成する際、質問が2つ以上のイベント間で共通している場合は、完全に同じ表現であることを確認してください。

    image1.png

    11. [ Next ]をクリックし、[Export Attendance]画面に進みます。 Marketoでイベント参加者を録画する場合は、カスタムアクティビティを設定する必要があります(参加者を録画しない場合は、この画面をスキップします)。

    Screenshot_2021-04-15_at_19.13.35.png

    12. [完了]をクリックすると、統合が接続されたことを示す確認メッセージが表示されます。 引き続きMarketo側を設定します。

    Screenshot_2021-04-15_at_19.20.28.png

  • 最初に、コピーしたウェブフックURLを使用して、Marketoでウェブフックを設定します。 Marketoから登録者をインポートしない場合は、このセクションをスキップします。

    1. Marketoダッシュボードにログインして[管理者]に移動し、「ウェブフック」を検索します。 ウェブフックを作成し、必ず次の値を含めます。

    • URL:以前の手順でコピーしたMarketoウェブフックURLを貼り付けます。
    • リクエストタイプ:POST
    • テンプレート:lead_id={{lead.Id}}
    • リクエストトークンエンコーディング:Form/Url
    • レスポンスタイプ:JSON

    [保存]をクリックします。

    image34.png

    2. まだプログラムがない場合は、プログラムを作成してから、プログラム内のリストを作成します。 次にトリガーを構成し、ウェブフックがアクティベートできるようにします。 ここでは、完了するとリストにユーザーが追加され、ウェブフックがアクティベートされるMarketoフォームの例が見つかります。 最初に、フォームをプログラムに追加します。

    image14.png

    3. フォームには、Hopinチケットの統合コードが含まれる欄が必要です。 これは、イベントで1枚のチケットのみを設定している場合、フォームに表示されない欄として追加できます。このフォームは、この値を保管するために選択した欄にチケットの統合コードをプッシュします。 複数のチケットタイプを設定している場合は、格納された値として統合コードを保管する選択式のドロップダウンを使用できます。これにより、フォームへの入力が完了すると、保管された値はチケットの統合コードにプッシュされます。

    image15.png

    4. フォームを保存して承認すると、スマートキャンペーンの「スマートリスト」画面にはトリガーとして追加されます。

    image16.png

    5. 次の「フロー」画面では、フォームへの入力が完了した時点で実行される「リストに追加」と、以前に設定したWebhookを呼び出せる「Webhookを呼び出し」を選択できます。

    image17.png

    6. これでHopinに登録者をインポートするための設定は完了です!

  • 以下の手順に従って、カスタムアクティビティを作成し、その下に関連フィールドを作成できます。

    ヒント: カスタムアクティビティの設定に関するMarketoのドキュメントはこちらにあります。カスタムアクティビティのフィールドの設定に関するドキュメントはこちらです。

    Marketoのカスタムアクティビティは、Marketoで実行するワークフローのトリガーを定義します。 この場合は、登録者をリストにプッシュ、または参加済みステータスをプログラムメンバーにプッシュします。 Marketoから登録者をインポートのみする場合は、このセクションをスキップします。

    ここでは、Marketoでカスタムアクティビティを設定します。 Marketoから登録や参加をエクスポートしていない場合は、このセクションをスキップできます。

    Marketoでのカスタムアクティビティの作成:

    1. Marketoアカウントにログインし、「管理者」タブをクリックします。

    image28.png

    2. 左側のパネルで「データベース管理」という項目を探し、「Marketoカスタムアクティビティ」を選択します。

    image31.png

    3. 「新規カスタムアクティビティ」をクリックして、名前とオプションの説明を入力し、「次へ」をクリックします。

    image36.png

    4. 選択したフィルターとトリガー名を入力し、「次へ」をクリックします。

    image22.png

    5. 「プライマリフィールド名」にイベント名を入力します。 入力を完了したら、「送信」をクリックします。

    image14.png

    6. この時点で、カスタムアクティビティは下書きとして保存されます。 カスタムアクティビティの作成を完了するためには、アクティビティを承認します。 これを行うには、ドロップダウンメニューから「カスタムアクティビティのアクション」を選択し、「アクティビティを承認」をクリックします。

    image32.png

    7. これで、Marketoでカスタムアクティビティが設定されました。 これでHopinから登録者を受信するための設定は完了です! 参加済みステータスのカスタムアクティビティは、同じように設定できます。

  • ここでは、Marketoのカスタムアクティビティの下にフィールドを設定します。 カスタム登録Q&をMarketoからエクスポートしない場合は、このセクションをスキップできます。

    1. Hopinからカスタム登録Qs&Asをプッシュする先となる、選択したカスタムアクティビティに移動し、「フィールド」タブをクリックします。

    image38.png

    2. 「新しいフィールド」をクリックし、フィールドのデータタイプを選択します。 名前とオプションの説明を入力します。 「保存」をクリックします。

    image11.png

    3. これで、カスタムアクティビティの下に新しい項目が作成されました。 ステップ1~2を繰り返して、マッピングしたい他の質問用の新しいフィールドを作成できます。

    4. すべてのフィールドが設定されたら、作成されたすべての新しいフィールドにアクセスするために、アクティビティを承認する必要があります。 これを行うには、ドロップダウンメニューから「カスタムアクティビティのアクション」を選択し、「アクティビティを承認<0>」をクリックします。

    image32.png

    5. 最終状態は、カスタムアクティビティ上で承認される必要があります。

    image10.png

  • Marketoのカスタムアクティビティは、Marketoで実行するワークフローのトリガーを定義します。 この場合は、登録者をリストにプッシュ、または参加済みステータスをプログラムメンバーにプッシュします。 Marketoから登録者をインポートのみする場合は、このセクションをスキップします。

    1. まだない場合は、プログラム内でプログラムとリストを作成します。 トリガーするスマートキャンペーンは、カスタムイベントで構成できます。 Marketoではイベント名の後にスペースが追加されることがあるため、トリガーするカスタムイベントには、下のようにHopinイベントの名前を含めて、「is」ではなく「starts with」を使用します。

    image18.png

    2. 次の画面(「フロー」では、[リストに追加]を使用して、Hopinからプログラム内のMarketoリストに登録者をプッシュします。

    image19.png

    3. [スケジュール]タブでスマートキャンペーンをアクティベートします。

    image20.png

Marketoの統合をテストする

データのインポートとエクスポートの両方をテストします。

  • 登録者のインポート設定をテストします。

    1. 登録者を作成したときには、必ず正しいチケットの統合コードを使用します。 「統合コード」を明記したチケットを見つけるには、以下の手順に従います。

    イベントダッシュボードで、[登録者] > [チケット]タブの順に移動します。

    image1.png

    チケットのURLをコピーしてどこかに貼り付けて、URLの「コード」部分をコピーします(下の画像では「xeTWv3xjdXo2yw89L71K7Jprcke」)。

    image2.png

    2. Marketoリストにユーザーが追加されたときには、この目的のために作成した欄にチケットの統合コードを必ず追加します。 下の例では、Marketoフォームのドロップダウンの保管された値には、チケットの統合コードを使用しています。

    image22.png

    3. Marketoの「欄」で、Hopinチケットの統合コードを使用する欄を選択し、保管された値が正しい欄に追加されたことを確認します。

    image23.png

    4. フォームの「完了」画面で[終了して承認]をクリックし、どこかに埋め込んでテストします(これを実行する場合はGoogle Sitesが便利です)。

    image24.png

    image25.png

    image28.png

    5. フォームへの入力を完了し、Marketoのリストに登録が追加されたことを確認します。

    image9.png

    6. リスト内のユーザーには、正しい欄にHopinチケットの統合コードが追加され、(正しく設定されている場合は、)Hopinによってマジックリンク欄が追加されたことが確認できます。

    image28.png

    7. 次に、Hopinイベントの「マジックリンク」ページで、ユーザーが追加されたことを確認します。

    image3.png

    8. おめでとうございます。登録者のインポートが正常に設定されました!

  • 登録者のエクスポートをテストする場合は、以下の手順に従います。

    1. まず、Hopinで登録フォームが作成されていることを確認してください。 はじめに、「イベントダッシュボード」>「登録」>「登録フォーム」に移動し、 こちらのガイドに従ってください。

    2. 次に、右上隅にある「イベントをプレビュー」ボタンを使用してイベントを開き、「イベントに参加」ボタンをクリックします。 登録フォームを設定した場合は、イベントに参加する前に質問に答えるように求められます。

    image32.png

    3. イベントに登録しました。Marketoに移動して、正しくプッシュされたかどうか確認できます。 さらに、カスタム登録Q&Aのマッピングを設定した場合、特定のMarketoリードの「アクティビティ詳細」の下で、回答された質問を見ることもできます。

    image22.png

    image36.png

    注:ここで問題が発生したら、Hopinイベント名の後にスペースが入っていないかどうか確認します。 これは、スマートキャンペーンのトリガーを設定するときに、[Starts in]ではなく[Starts with]を使用することで解決します。

    image34.png

    4. これで完了です!

 

ご質問がある、またはサポートが必要な場合は、support@hopin.comまでお気軽にお問い合わせください。

この記事は役に立ちましたか?