サポート対応・方針について

API：Marketoに登録されたユーザーをEventHubに自動登録する

  • 更新

対象プランOFFLINEBUSINESSPRO

実装にかかる想定時間：約30分
イベント毎に設定する作業：My TokenにeventKeyとticketIdを設定する

image_158.png

本ページでは、APIを活用してMarketoの登録フォームから収集した登録者を、EventHubへ自動登録する方法をご紹介します。

 

 

1. Marketoで登録フォーム を作成する

まずは、Marketoで登録フォームを作成しましょう。
登録後に遷移するサンクスページには、以下のように仮登録中であることを示すとパスワード設定率が向上します。パスワード設定率が向上すると、ログイン率も高まりますのでご参考ください。mceclip1.png

<attention>Marketoでフォームを作成した場合、EventHubの利用規約及びプライバシーポリシーに同意した上で登録が行われるようにしてください。詳細は参加者からEventHub利用規約・プライバシーポリシーの同意を取得するをご覧ください。</attention>

 

 

2. EventHubでチケット・フォームを作成する

次に、EventHubでチケット・フォームを作成します。
Marketoで作成したフォームから登録したユーザーは、チケット・フォームを通してEventHubへユーザー登録がされます。

mceclip2.png

以下のページを参考にチケット・フォームを作成しましょう。
登録期限や上限数、ユーザータイプ[来場者/出展者]、コンテンツグループの設定なども反映されます。

また、Marketoの登録フォームでカスタム項目を作成した場合は、EventHubでも同様にプロフィール項目（カスタム項目）を作成する必要があります。以下のページを参考にカスタム項目を作成してください。

<attention>

- イベントの閉鎖日時を過ぎると登録ができません。
- チケット・フォームの登録期限や上限数を超えると登録ができません。
- ステータスが販売中・非公開の場合は登録が可能ですが、準備中の場合は登録ができません。
- API連携では有料チケットの作成ができません。


上記のいずれかが該当した場合、「Ticket cost must be free and status on sale or private to register a user」というエラーが出現し、ユーザー登録ができません。EventHubのチケット設定を変更してください。</attention>

 

 

3. MarketoでMy Tokenを作成する

Marketo公式ヘルプページ「マイトークンの管理」を参考に、以下のTokenを作成します。

Token名 データ型 説明
eventKey テキスト イベント毎に発行されるKeyが代入されるTokenです
ticketId テキスト チケットフォーム毎に発行されるIdが代入されるTokenです

<tips>My Tokenとは？
様々な値を代入することができる変数です。{{my.eventKey}}を利用すると、プログラム内で指定したeventKeyが代入されます。
参考：プログラム内のマイトークンの理解</tips>

 

 

4. Marketoでウェブフックを作成する

Marketoでウェブフックを作成します。

① [管理]＞[ウェブフック]＞[新規ウェブフック]から以下の情報を入力します。
管理.png

項目名 入力内容
ウェブフック名 適当な名称 （例：EventHub連携用Webhook）
詳細 ウェブフックの詳細説明 ※ 任意
URL https://api.eventhub.jp/v1/users/create/{{my.eventKey}}?lang=ja
リクエストタイプ POST
テンプレート

ペイロードのサンプルをご紹介します。
カスタムフィールドのデータを連携する場合は、EventHubのcustomFieldIdを取得してください。
※ //以降のコメントは削除してください。

{
"ticketId":"{{my.ticketId}}", //作成したMy Token
"email": "{{lead.Email Address}}", 
"lastName": "{{lead.Last Name}}", 
"firstName": "{{lead.First Name}}", 
"affiliation": "{{company.Company Name}}", 
"position": "{{lead.Job Title}}",
"department": "{{lead.Department}}",
//カスタム項目はcustomFieldxxxという形でIDを指定
"customFieldtel": "{{lead.Phone Number}}", 
"customFieldsize": "{{lead.size}}", 
"customFieldinteresting": "{{lead.interesting}}"
}
リクエストトークンのエンコード なし
応答タイプ なし

 

② カスタムヘッダの[編集]をクリックし、[Content-Type]に[application/json]を、[X-API-KEY]に発行したAPIキーを入力します。※ APIキーの取得はAPIキーの発行方法をご覧ください。
__.png

 

③ これでウェブフックの作成は完了です。
イベント毎に作成するキャンペーンで、本ウェブフックを[フロー]に設定しましょう。
01_________________________.png

 

 

5. イベント毎にMy Tokenの値を設定する

イベント毎に作成したプログラムのマイトークンのページから、eventKeyとticketIdを入力します。手順4で作成したWebhookのペイロードに、こちらで設定したeventKeyが{{my.eventKey}}へ、ticketIdが{{my.ticketId}}へ代入されます。イベント毎に異なるeventKeyとticketIdが発行されるため、プログラムを作成する度に入力してください。

230630_Webinar_アメリカの最新事例から学ぶイベントマーケティングの未来_•_マーケティング活動.png

 

これでEventHubとの連携設定は完了です。登録フォームからテスト登録を行い、動作を確認してください。問題なく動作した場合は、EventHubの[ユーザーリスト]にチケットフォーム経由で登録されます。

<tips> - Marketoの実行結果の詳細ログはAPI：参加登録連携のエラー詳細の確認方法からご確認いただけます。
技術者向けAPIドキュメントに記載のエラーレスポンスを参照しながらエラーを解消してください。

- お問い合わせの際は、以下3点を添えて、画面右下の吹き出しよりカスタマーサポートまでご連絡いただきますようお願いいたします🙇‍♀️
● 画面に表示されるメッセージもしくはメッセージの内容がわかるスクリーンショット
● 該当のイベント名
● 該当ユーザーのメールアドレス
</tips>

 

 

6. 登録からログインまでの導線

APIでMarketoとEventHubを連携した場合、以下の導線で参加者はイベントページにログインすることになります。

mceclip3.png

① Marketoで作成した登録フォームから参加登録をする
② EventHubからパスワード設定案内のメールを受信する
③ パスワードを設定する
④ パスワード設定完了メールを受信する
⑤ イベントページへログイン

<tips>パスワード設定[なし]でイベントを作成した場合は、パスワードの設定手順③④がありません。</tips>

 

この時、②で配信されるメールは[メール]＞[システムメール]の[埋め込みフォーム・API連携のパスワード設定 ]から編集してください。「申し込みありがとうございました」という文言を記載するとパスワード設定をせずに離脱するケースがあるため、"良い例"を参考にパスワード設定を促すシンプルな文章にしましょう。

mceclip2.png

④で配信されるメールは[メール]＞[システムメール]の[EXCELアップロード・埋め込みフォーム・API連携・Marketo連携・同僚招待の登録完了]から編集してください。

 

 

7. サポート対応について

こちらでご紹介する方法は、提供する情報の継続や正確性を完全に保証するものではありません。実装方法に関するご不明な点はMarketoカスタマーサポート、もしくは社内エンジニアへお問い合わせください。

機能や取得したいAPI情報が足りない場合は、ご要望としてお伺いしますので、EventHubカスタマーサポートへお問い合わせください。

 

 

 

この記事は役に立ちましたか？
はい いいえ
お役に立てずごめんなさい😢 改善の参考にいたしますので、理由をお聞かせください🙇‍♀️
お忙しいところ貴重なご意見をありがとうございます🙇‍♀️
エラーが発生して送ることができませんでした。もう一度お試しください...🙇‍♀️

関連記事