Account Engagement（AE）フォームハンドラー連携
1. 概要
Account Engagement（旧 Pardot）のフォームハンドラー機能とGRiXを連携することで、GRiXの閲覧ユーザーの認証フォームで取得した顧客情報をAEへ送信し、フォーム送信アクティビティの記録およびProspectの作成・更新を行うことができます。
本機能を利用することで、GRiX資料閲覧画面で入力された情報をAEへ連携し、マーケティング施策のトラッキングやリード管理に活用できます。
利用イメージ
textCopied!
閲覧者が認証フォームへ入力↓GRiXが顧客情報を取得↓AEフォームハンドラーへデータ送信↓AEでフォーム送信アクティビティを記録↓Prospect作成または更新↓コンテンツ閲覧画面へ遷移2. 事前設定
AEフォーム連携を有効化する
管理者アカウントでGRiXへログイン
「設定」→「外部連携」を開く
「AEフォーム連携」を選択
「連携する」を選択
保存
・設定項目
| 項目 | 説明 |
| 連携する | AEフォームハンドラー連携を有効化 |
| 連携しない | AEフォームハンドラー連携を無効化 |
・注意事項
本設定は管理者のみ変更可能です
テナント単位の設定となります
Salesforce Sales Cloudとの連携は不要です
Account Engagement単体で利用可能です
3. URL発行時の設定
AEフォーム連携を有効にすると、新規URL発行画面およびURLテンプレート編集画面にAEフォーム設定が表示されます。
・設定方法
URL発行またはURL編集画面を開く
「AEフォームハンドラーと連携する」をON
AE側で発行したフォームハンドラーURLを入力
保存
・設定項目
| 項目 | 説明 |
| AEフォームハンドラーと連携する | URL単位でAE連携を有効化 |
| AEフォームハンドラーURL | Account Engagementで発行したForm Handler URL |
※ URLテンプレートでの利用
本機能は以下で利用できます。
URL発行
URL編集
URLテンプレート作成
URLテンプレート編集
※ コンテンツトークンについて
本機能はコンテンツトークン発行には対応しておりません。
対象機能：
URL発行
URLテンプレート
のみとなります。
4. AE Form Handlerの設定
AE側でフォームハンドラーを作成する際は、以下の設定を推奨します。
Success Location
textCopied!
Referring URLError Location
textCopied!
Referring URLこれにより、フォーム送信後に適切なコンテンツ閲覧画面へ遷移できます。
・フォーム送信条件
GRiX認証フォームに、AE Form Handlerで必須設定されている項目がすべて存在している必要があります。
必須項目が不足している場合、AEへの送信は実行されません。
・送信される例：
GRiX認証フォーム
Email
Company
Phone
AE Form Handler必須項目
Email
結果：
textCopied!
フォーム送信実行・送信されない例：
GRiX認証フォーム
Email
Company
Phone
AE Form Handler必須項目
Email
Department
結果：
textCopied!
フォーム送信スキップDepartmentが認証フォームに存在しないためです。
・マッピング仕様
AE Form Handlerでは、External Field Nameを利用してGRiX認証フォームの項目とマッピングを行います。
以下の名称でExternal Field Nameを設定してください。
| GRiX項目 | AE External Field Name（設定可能値） |
| Email / email / E-mail / mail | |
| First Name | First Name / first name / first_name |
| Last Name | Last Name / last name / last_name |
| Company | Company / company |
| Department | Department / department |
| Job Title | Title / title / Job Title |
| Postal Code | postal_code / Postal Code / Zip |
| Phone | Phone / phone |
| Address | Address / address / Address One |
・マッピング例
GRiX認証フォーム
| 項目 |
| Company |
| Phone |
AE Form Handler
| AE項目 | External Field Name |
| Email Address | |
| Company Name | Company |
| Phone Number | Phone |
この場合、GRiXで入力されたEmail、Company、PhoneがAEの各項目へ送信されます。
・マッピングに関する注意事項
External Field Nameが上記一覧と一致している場合、自動的にマッピングされます
マッピングされていない項目は送信されません
AE Form Handlerで必須設定されている項目は、GRiX認証フォームにも設定されている必要があります
必須項目が不足している場合、フォーム送信は実行されません
Email項目はProspect識別に利用されるため設定を推奨します
5. Prospect作成・更新について
・新規Prospect
AE側に該当するProspectが存在しない場合、新規Prospectが作成されます。
例
送信内容
| 項目 | 値 |
| test@gmail.com mailto:test@gmail.com | |
| Name | John |
| Company | ABC |
結果
textCopied!
新規Prospect作成・既存Prospect
AEはEmailアドレスをキーとしてProspectを検索します。
同じEmailアドレスのProspectが存在する場合は既存Prospectが更新されます。
例
送信前
| 項目 | 値 |
| test@gmail.com mailto:test@gmail.com | |
| Name | name_test |
| Company | Company_test |
| Phone | （空） |
GRiX認証フォーム送信
| 項目 | 値 |
| test@gmail.com mailto:test@gmail.com | |
| Name | John |
| Company | ABC |
| Phone | 090-1234-5678 |
送信後
| 項目 | 値 |
| test@gmail.com mailto:test@gmail.com | |
| Name | John |
| Company | ABC |
| Phone | 090-1234-5678 |
・Prospect更新ルール
AE Form Handlerでマッピングされた項目は、フォーム送信時の最新値で更新されます。
更新例
既存値
| 項目 | 値 |
| Company | OpenAI |
| Phone | 03-1111-1111 |
フォーム送信値
| 項目 | 値 |
| Company | Open AI |
| Phone | 090-9999-9999 |
更新後
| 項目 | 値 |
| Company | Open AI |
| Phone | 090-9999-9999 |
同一メールアドレスのProspectが複数存在する場合
AE側の仕様に従い、最新アクティビティ対象のProspectが更新されます。
そのため、同一Emailアドレスを持つProspectが複数存在する運用は推奨しておりません。
・注意事項
Prospect情報の上書き
AE Form Handlerでマッピングされた項目は、フォーム送信時に既存Prospectの値を上書きする可能性があります。
意図しないデータ更新を防ぐため、マッピング設定は十分に確認してください。
必須項目不足による送信スキップ
AE Form Handlerで必須設定された項目がGRiX認証フォームに存在しない場合、AEへのフォーム送信は実行されません。
その場合、フォーム送信アクティビティも記録されません。
Prospect作成・更新ロジック
GRiXはAEへデータを送信するのみです。
以下はすべてAccount Engagement側の仕様に依存します。
Prospect作成
Prospect更新
重複判定
Activity記録
データ上書き
6. FAQ
・Salesforce Sales Cloudとの連携は必要ですか？
不要です。
AEフォーム連携はAccount Engagement単体で利用できます。
・URLテンプレートでも利用できますか？
利用できます。
・コンテンツトークンでも利用できますか？
利用できません。
・必須項目が不足している場合どうなりますか？
AEへのフォーム送信は実行されません。
また、フォーム送信アクティビティも記録されません。
・既存Prospectのデータは更新されますか？
更新されます。
同じEmailアドレスのProspectが存在する場合、送信された最新値で更新されます。
・マッピングしていない項目は送信されますか？
送信されません。
AE Form Handlerで設定された項目のみ送信されます。
・Prospectはどの項目で識別されますか？
Emailアドレスで識別されます。
同じEmailアドレスを持つProspectが存在する場合は既存Prospectが更新されます。