クエリー文字列を使用したフォームフィールドの自動入力

ページURLをコンタクトに送信する前に、ページURLにクエリー文字列を付加して、ページ上のフォームフィールドに自動入力することができます。付加されたクエリー文字列に基づいてフィールドに入力されます。これは 非表示フォームフィールドにも使用できます。例えば、カスタムUTMプロパティーを作成し、UTMパラメーターを使用して非表示フォームフィールドに自動入力できます。 

制限事項と考慮事項を理解する

• クエリー文字列によって 依存フォームフィールドに自動入力 することはできません。
• 依存 フォームフィールドは、 クエリー文字列内の複数の値に基づいてトリガーすることはできません。

定義済みの値を使用して静的クエリー文字列を作成する

静的クエリー文字列を含むURLを作成するには、自動入力するフィールドの内部プロパティー名をコピーしてから、それをページURLの末尾に追加する必要があります。

プロパティーの内部名をコピーする

1. HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。
2. 左のサイドバーメニューで[ プロパティー]に移動します。
3. 値を事前入力するには、プロパティーの名前をクリックします。
4. プロパティーの内部名をコピーします。内部プロパティー名の詳細をご確認ください。
5. フォームに値を自動入力するプロパティーが他にもある場合は、この操作を繰り返します。

静的クエリー文字列を使用したURLの作成

内部プロパティー名をコピーしたら、コンタクトに送信するページURLを設定できます。 

1. ブラウザーで、フォームがあるページに移動します。次に、URLをコピーします。
2. ページURLの末尾に疑問符（?）を追加します。
3. プロパティーの内部名、続いて等号とフィールドに自動入力する値を追加します。プロパティーのフィールドタイプに応じて、値を追加するルールが異なります。
   • 単一チェックボックス：クエリー文字列には、yesまたはnoではなく、trueまたはfalseの値を含める必要があります。
   • 日付入力：クエリー文字列には、YYYY-MM-DD形式の日付値が含まれている必要があります。
   • 複数チェックボックス：クエリー文字列の値は、そのプロパティーの値オプションと完全に一致し、値はセミコロンで区切る必要があります。
   • ラジオ選択/ドロップダウン選択：クエリー文字列の値は、そのプロパティーの値オプションと完全に一致する必要があります。
   • 全てのフィールドタイプ：クエリー文字列を作成する際に、次のルールが全てのフィールドタイプに適用されます。
     • プロパティー値に含まれるスペースは、「%20」で区切る必要があります。 
     • 複数の異なるプロパティーは、アンパサンド（&）で区切る必要があります。

静的クエリー文字列を含むURLの例 

http://www.domain.com/marketing-offer?firstname=John&lastname=Smith&email=jsmith@email.com
&favorite_season=Winter%20Season&favorite_fast_food=Burger;Taco&number_property=7
&will_you_come_to_the_party=Maybe&do_you_like_parties=true&date_of_party=2018-10-24

• クエリー文字列と単一行テキストフィールドの先頭: ?firstname=John
• 単行テキストフィールド：&lastname=Smith
• 単行テキストフィールド：&email=jsmith@email.com
• ドロップダウン選択フィールド：&favorite_season=Winter%20Season
• 複数チェックボックスフィールド：&favorite_fast_food=Burger;Tacos
• 数値フィールド：&favorite_number=7
• ラジオ選択フィールド：&will_you_come_to_the_party=Maybe
• 単一チェックボックスフィールド：&do_you_like_parties=true
• 日付入力フィールド：&date_of_party=2018-10-2

パーソナライズトークンを使用した動的クエリー文字列の作成

パーソナライズトークン を使用して、既知のコンタクトプロパティーに基づいてフォームフィールドに自動入力する動的クエリー文字列を作成できます。

パーソナライズトークンを取得する

まず、クエリー文字列の作成に必要なパーソナライズトークンを取得します。プロパティーのパーソナライズトークンを取得するには、次の手順に従います。 

1. HubSpotアカウントにて、［マーケティング］＞［Eメール］の順に進みます。
2. [ Eメールを作成 ]をクリックするか、下書きEメール の名前 をクリックします。
3. リッチ テキスト ツールバーで、［パーソナライズ］をクリックします。
4. パーソナライズトークンを設定します：
   
   • ダイアログボックスで、フォームに自動入力するパーソナライズトークンを選択します。 
   • パーソナライズトークンを挿入するときは、［このプロパティーのグローバル既定値を使用］チェックボックスをオンにします。
   • 必要に応じて、他のパーソナライズトークンを追加します。 

5. リッチ テキスト ツールバーで[ その他 ]をクリックし、codef ソース コード アイコン を選択して、EメールのHTMLを表示します。
6. ソースコードには、Eメール本文に追加したパーソナライズトークンの未加工のコードが表示されます。各トークンは二重括弧{{ }}で囲まれます。トークンを選択し（例：{{ contact.firstname }}）、右クリックして［コピー］を選択します。 
7. フォームに事前入力するパーソナライズトークンにこれを繰り返します。
8. ダイアログボックスの下部にある [キャンセル ]をクリックして、ソースコードを終了します。

動的クエリー文字列を使用したURLを作成する

パーソナライズトークンを使用して、動的クエリー文字列を使用したURLを作成します。このURLは、EメールやページなどのHubSpotコンテンツ内、またはHubSpot トラッキングコードを使用する外部ページ内のリンクとして使用できます。クエリー文字列内のフィールドに既知の値がある場合、コンタクトがリンクをクリックすると、その情報が自動入力されたフォームがページに表示されます。

動的クエリー文字列を使用したURLを作成するには、次の手順に従います。

1. ブラウザーで、フォームがあるページに移動します。次に、URLをコピーします。
2. ページURLとパーソナライズトークンを使用して、動的クエリー文字列の形式を設定します。
   • ページURLの末尾に疑問符（?）を追加します。
   • プロパティーの内部名続いて等号とパーソナライズトークンを追加します。トークンからすべてのスペースを削除してください(例: {{contact.firstname}} )。
   • 複数のプロパティーはアンパサンド（&）で区切ります。
3. 適切な形式の動的クエリー文字列を使用したURLの例:

http://www.domain.com/marketing-offer?firstname={{contact.firstname}}&lastname={{contact.lastname}}&email={{contact.email}}