問合せ文字列によるフィールド・マージの作成

問合せ文字列フィールド・マージは、非表示のフィールドを含む、フォーム・フィールドに事前移入するためにのみ使用できます。セキュリティ上の理由から、ランディング・ページ、Eメールまたは「Webページへのリダイレクト」フォーム処理ステップが有効になっているフォーム・フィールドでは使用できません。

問合せ文字列キーを入力する場合は、次のガイドラインに従ってください。

  • キーは、ホスティング・ランディング・ページのURLに表示されるキーと一致している必要があります。URLでは、ブラウザ内で正しく解決されるように、エンコーディングやその他の書式変更が行われることがよくあります。たとえば、スペースは受け入れられないため、ほとんどの場合スペースは%20に変更されます。そのため、問合せ文字列キーも変換されることがあります。ランディング・ページのURLと一致するように、キーがどのように変更される可能性があるかを理解しておくことが重要です。エンコーディングが問合せ文字列キーに影響するかどうかや、どのように影響するかが不明な場合は、 を参照してください。
  • 次のものはサポートされません。
    • Unicode
    • 先頭または末尾のスペース
    • %uなどの古いエンコーディング体系

問合せ文字列フィールド・マージのを参照してください。

問合せ文字列によりフィールド・マージを作成する手順は、次のとおりです。

  1. 「アセット」 > 「コンポーネント」にナビゲートし、「フィールド・マージ」をクリックします。

  2. 画面の右上隅にある「新規」をクリックして、フィールド・マージ・エディタをオープンします。

  3. フィールド・マージの名前を「名前」フィールドに入力します。この名前は、リストでフィールド・マージを識別するために使用します。
  4. キーが値に解決されない場合に表示するデフォルト値を入力します。
  5. 「マージ元」ドロップダウン・リストで、「問合せ文字列」を選択します。

  6. 問合せ文字列キーを入力します。これはランディング・ページURLでの書式と一致する必要があることに注意してください。

    : 問合せ文字列キーとしてmyKeyを入力する場合、ランディング・ページURLはhttp://example.com?myKey=myValueである必要があります。

    値の出力をURLでエンコードする場合は、encodeFor=urlをフィールド・マージの<span>内に追加します。例: <span class=eloquaemail encodeFor=url>_469_numeric1</span>。この場合、すべてのスペースがURLでエンコードされて、%20に変換されます。encodeFor文字列が存在しない場合は、すべてのスペースがHTMLでエンコードされるため、「 」(スペース)は「 」(スペース)のままです。

  7. 「保存」をクリックします。ボタンが無効な場合は、無効な問合せ文字列キーを入力しています。

これで、フィールド・マージをフォーム・フィールドのみの事前移入に使用できるようになりました。

問合せ文字列の検証

次の表は、キー値がOracle Eloquaによってどのように解決されるかを示しています。この表を使用して、入力するキーがランディング・ページURLのキーと一致するにようにしてください。

注意: 値の出力をURLでエンコードする場合は、encodeFor=urlをフィールド・マージの<span>内に追加します。例: <span class=eloquaemail encodeFor=url>_469_numeric1</span>。この場合、すべてのスペースがURLでエンコードされて、%20に変換されます。encodeFor文字列が存在しない場合は、すべてのスペースがHTMLでエンコードされるため、「 」(スペース)は「 」(スペース)のままです。

キー値 ランディング・ページURL マージ・タグ 解決後の値
myParam http://...?myParam=my:value <span class=eloquaemail>
MyField</span>
my:value
myParam http://...?myParam=my%3Avalue <span class=eloquaemail>
MyField</span>
my:value
myParam http://...?myParam=my%2Bvalue <span class=eloquaemail>
MyField</span>

my+value

myParam http://...?myParam=my+value <span class=eloquaemail>
MyField</span>
my value
myParam http://...?myParam&anotherParam=val <span class=eloquaemail>
MyField</span>
<値なし - キーが存在しません - デフォルトを使用>
myParam http://...?myParam=&anotherParam=val <span class=eloquaemail>
MyField</span>
空の値 - デフォルトを使用
my+Param http://...?my%2BParam=myvalue <span class=eloquaemail>
MyField</span>
myvalue
my+Param http://...?my+Param=myvalue <span class=eloquaemail>MyField
</span>
値なし - キーが存在しません - デフォルトを使用
my:Param http://...?my:Param=myvalue <span class=eloquaemail>MyField
</span>
myvalue
my key http://...?my%20key=my%20value <span class=eloquaemail>MyField
</span>
my value
my key http://...?my%20key=my%20value <span class=eloquaemail encodeFor=url>MyField</span> my%20value
my key http://...?my+key=my%20value <span class=eloquaemail encodeFor=url>MyField</span> my%20value
myParam http://...?myParam=gar%C3%A7on <span class=eloquaemail encodeFor=url>MyField</span> gar%C3%A7on
garçon http://...?gar%C3%A7on=my%20value <span class=eloquaemail>MyField
</span>
my value (Unicodeはサポートされません。)
myParam http://...?myParam=gar%C3%A7on <span class=eloquaemail>MyField
</span>
garçon
evilScript http://...?evilScript=%3Cscript%3EDoEvilStuff()%3C%2Fscript%3E <span class=eloquaemail>MyField
</span>
&lt;script&gt;DoEvilStuff()&lt;/script&gt;
multiKey http://...?multiKey=first&b=2&multiKey=last <span class=eloquaemail>MyField
</span>
first
myParam http://...?myParam=Deloitte%20%26%20Touche <span class=eloquaemail>MyField
</span>
Deloitte & Touche
Deloitte & Touche http://...?Deloitte%20%26%20Touche=myValue <span class=eloquaemail>MyField
</span>
myValue
my&Param http://...?my%26Param=hello <span class=eloquaemail>MyField
</span>
hello
myKey 先頭のスペースはサポートされません
myKey (末尾のスペース) 末尾のスペースはサポートされません

関連項目

フィールド・マージの例

フィールド・マージ

コンポーネント・ライブラリ

Eメール