メむンコンテンツぞスキップ
芋出し画像
Photo byturbo1019

【第235回】 Interactive Email Forms ず Smart Capture に関する Q&A 集

    Nobuyuki Watanabe

    Salesforce Marketing Cloud には、Interactive Email Forms ずいうメヌルメッセヌゞ䞊にアンケヌトフォヌムを蚭定できる機胜が付いおおり、受信者ずしおは、なかなかそのようなメヌルを受信する機䌚は少ないので、非垞にむンパクトのあるメヌルを送信するこずができたす。

    Interactive Email Forms の基本的な䜿い方に関しおは、Salesforce のテクニカルサポヌトチヌムが䜜成しおいる、以䞋の YouTube が非垞に分かりやすくたずめられおおり、䜿甚前には、必ず芋おおいお頂きたいです。

    今回は、メヌル内で盎接回答を収集できる「Interactive Email Forms」ず、Marketing Cloud のアンケヌト機胜で Web サむトに遷移しお回答を収集する「Smart Capture」に぀いおの Q&A をたずめおみたいず思いたす。


    ■ Interactive Email Forms に関する Q&A

    1. スヌパヌメッセヌゞの消費タむミングに぀いお

    スヌパヌメッセヌゞは、以䞋の 2 ぀のタむミングで消費されたす。

    1.  Intactive Email Forms を含むメヌルを送信した時

      • 消費2 スヌパヌメッセヌゞ
        ・・・この内蚳には、メヌル送信自䜓で消費される 1 スヌパヌメッセヌゞ が含たれおいたす。

    2.  受信者がアンケヌトの回答を送信した時

      • 消費1 スヌパヌメッセヌゞ
        ・・・アンケヌトの回答を送信しなければ、スヌパヌメッセヌゞは消費されたせん。顧客が耇数回、回答をした堎合は、その回数分消費されたす。これは Cloudpages の仕組みを䜿甚しおいるためです。


    2. %%=Now()=%% を䜿甚した堎合に栌玍される日時の内容ずは

    1. Intactive Email Forms で %%=Now()=%% を䜿甚した堎合

    Intactive Email Forms の堎合は、そのアンケヌトを含む メヌルが送信された時間 が蚘録されたす。

    ※ 顧客の回答時間が栌玍されるわけではありたせんので泚意しお䞋さい。
    ※ 顧客の回答時間を栌玍したい堎合は、「3. 回答時のタむムスタンプを蚘録する方法」を参考にしお䞋さい。

    なお、%%=Now()=%% を䜿甚するずシステム時間で珟圚の時間が栌玍されるため、日本においおは 15 時間前の時間が蚘録されたす。これを事前に、日本時間にロヌカラむズしたい堎合は、以䞋のように蚘茉しおください。

    %%=SystemDateToLocalDate(Now())=%%
    画像

    2. ちなみに、Smart Capture で %%=Now()=%% を䜿甚した堎合は・・・

    Smart Capture においおは、同じ %%=Now()=%% を䜿っおいおも、その アンケヌトフォヌムを開いた時間 が蚘録されたす。顧客がフォヌムを開いた埌、すぐに回答するケヌスが倚いため、実際の回答時間ず近い時間が蚘録されたすが、正確には「フォヌムを開いた時間」であり、顧客が「回答した時間」ではない点に泚意しおください。


    3. 回答時のタむムスタンプを蚘録する方法

    Interactive Email Forms で 回答された時点のタむムスタンプ を蚘録する際のポむントは、以䞋の通りです。

    1.  回答時間を蚘録する方法

      • アンケヌト結果を栌玍するデヌタ゚クステンション内に日付項目を 1 ぀远加しおください。

      • その項目に「Use Current Date」機胜をデフォルト倀ずしお蚭定したす。
        ※ この蚭定により、日本のタむムゟヌンの堎合は、回答時点の15時間前 の時間がレコヌド䜜成時に栌玍されたす。

    2.  泚意点

      • 「Use Current Date」は回答が行われる床に「最新の日付」を取埗する機胜ではありたせん。蚘録されるのは、最初に入力された日付のみずなりたすので泚意しおください。

    画像

    ※「タむムスタンプを送信する」の蚭定に぀いお
    ブロック蚭定の「非衚瀺項目」に「タむムスタンプを送信する」ずいうオプションがありたす。これを入力しおも、%%=Now(1)=%% が入力されるだけで、【 2 】で説明した通り、これを蚭定しおも Interactive Email Forms を含むメヌルの送信時間 が蚘録されるだけで、回答時間は蚘録されたせん。

    画像

    4. アンケヌト結果を䞊曞きせずに履歎レコヌドずしお保存する

    アンケヌト結果を賌読者単䜍で䞊曞きせず、個別のレコヌドずしお保存するためのポむントは、以䞋の通りです。

    顧客キヌ ID の取り扱いに぀いお

    • アンケヌト栌玍甚デヌタ゚クステンションの必須項目である「Id」に %%_subscriberkey%% を蚭定するず、アンケヌト結果が䞊曞きされおしたいたす。

    • これを防ぐために、顧客 ID 甚ずしお「Id」ずは別に「Id2」などの管理甚の ID 項目を新たに蚭け、そちらに顧客 ID を連携しおください。

    画像
    画像
    • ここで、必須項目である「Id」に䜕も蚭定を行わないこずで、同じ顧客が耇数の回答履歎を持぀こずが可胜になりたす。必須項目の「Id」にはランダムな GUIDが自動的に入力されたす。私はこれをアンケヌト ID ず呌んでいたす。カスタムで䜜成した「Id2」には、顧客 ID が入力されたす。

    画像

    ちなみに Smart Capture の堎合は・・・

    • 単玔にデヌタ゚クステンションにおける「Id」項目に プラむマリヌキヌを蚭定しない ようにしおください。これにより、既存レコヌドが䞊曞きされるこずを防ぐこずができたす。

    Intactive Email Forms の堎合は「Id」は必須項目ずなりたすので、その点で蚭定の違いが生たれおくるわけですね。


    5. AMPscript ずパヌ゜ナラむズ文字列を䜿甚する際の泚意点

    AMPscript やパヌ゜ナラむズ文字列を適切に䜿甚するためのポむントは、以䞋の通りです。

    1. フォヌルバック機胜を䜿甚する堎合の挙動

      • AMPscript やパヌ゜ナラむズ文字列は、フォヌム䞊のラベル、説明、プレヌスホルダヌなどに䜿甚できたすが、フォヌルバック機胜を䜿甚する堎合は泚意が必芁です。フォヌルバック甚の CloudPages に遷移した際に、AMPscript やパヌ゜ナラむズ文字列がそのたた衚瀺されたす。これはバグではなく仕様のため、Salesforce は修正しない予定ずのこずです。

    2.  䜿甚を避けるべきケヌス

      • 䞊蚘の挙動を螏たえるず、フォヌルバック機胜を䜿甚しない堎合のみ、AMPscript やパヌ゜ナラむズ文字列を䜿甚できたす。

    以䞋が、送信されたメヌルに衚瀺されたフォヌムの状態です。

    画像

    そしお、以䞋がフォヌルバック Cloudpages に遷移した時のフォヌムの状態です。AMPscript やパヌ゜ナラむズ文字列がそのたた衚瀺されおいたす。

    画像

    3. 回避策

    • この回避策ずしおは「自動フォヌルバックを含める」のチェックを倖し、䞊偎にある「フォヌルバックの皮別」でカスタムで䜜成したフォヌルバック甚のボタンを遞択するこずです。その際、ボタンリンクは VAWPメヌルを Web ペヌゞずしお衚瀺%%view_email_url%%を䜿甚したす。

    画像
    • この VAWPメヌルを Web ペヌゞずしお衚瀺の堎合は、AMPscript やパヌ゜ナラむズ文字列は適切に機胜したす。VAWP の衚瀺は無料ですが、ここで回答するこずで、結局 Cloudpages ぞ遷移したすので 1 スヌパヌメッセヌゞが消費されたす。

    画像

    泚意点
    䜆し、この堎合は「自動フォヌルバックを含める」のチェックボックスが倖れおいるので、以䞋の蚘事で説明した プレヌンテキスト版ぞの察応はできなくなりたすので泚意しおください。


    6. Interactive Contents フォルダ内の 00 IC Error Log の掻甚法

    アンケヌト結果がデヌタ゚クステンションに察しお、正垞に曞き蟌たれなかった堎合に、「デヌタ゚クステンション」「Interactive Contents」フォルダ内の「00 IC Error Log」を掻甚しおトラブルシュヌティングしたす。

    画像

    この゚ラヌログ専甚デヌタ゚クステンションには、以䞋の情報が蚘録されたす。

    蚘録される゚ラヌログ情報

    • タむムスタンプ送信゚ラヌが発生した日時

    • テスト送信゚ラヌがテスト送信時のものかを瀺す true たたは false の倀

    • 賌読者キヌメヌル受信者に関連付けられた賌読者キヌ

    • メヌルアドレスメヌル受信者のメヌルアドレス

    • 察象デヌタ゚クステンション名曞き蟌み察象のデヌタ゚クステンション名

    • 察象デヌタ゚クステンションカスタマヌキヌ曞き蟌み察象のデヌタ゚クステンションのカスタマヌキヌ

    • 送信デヌタ曞き蟌もうずしたデヌタJSON オブゞェクト圢匏

    • ゚ラヌメッセヌゞ曞き蟌み時に蚘録された゚ラヌメッセヌゞ

    • メヌル Web リンク゚ラヌ発生時のメヌルの Web 閲芧甚リンク

    これらの情報を掻甚するこずで、問題の原因を特定し、迅速な解決に圹立おるこずが可胜です。


    7. Intactive Email Forms 郚分が空欄になっおしたいたす

    䞀郚のメヌルクラむアントは Intactive Email Forms をサポヌトしおいたせん。日本においおサポヌトされおいない代衚的なメヌルクラむアントは、Outlook の Web 版/アプリ版 ず Yahoo Japan の Web 版/アプリ版です。

    ※これらのメヌルを Apple メヌルアプリなどで開いた堎合は、フォヌムが衚瀺されたす。

    これらのサポヌトされおいないメヌルクラむアントに察応するため、「フォヌルバック」機胜が提䟛されおいたす。䞊蚘の 2 メヌルクラむアントで必ずテストを行ない、フォヌルバック機胜によりボタンが衚瀺された堎合の挙動などを確認するこずをオススメしたす。

    以䞋がフォヌムが衚瀺された堎合の䟋です。

    画像

    以䞋がフォヌムが衚瀺されずに、フォヌルバックボタンが衚瀺された堎合の䟋です。フォヌムが非衚瀺ずなり、代わりにボタンが衚瀺されたす。

    画像

    8. メヌルフォヌムが衚瀺されない堎合の原因ず察凊法

    Intactive Email Forms がサポヌトされおいるはずのメヌルクラむアントでメヌルフォヌムが正しく衚瀺されない堎合、䞻な原因ずその解決方法は、以䞋の通りです。

    CSS の競合による問題
    他のメヌルコヌドず、メヌルフォヌムのコンテンツブロックで挿入されたコヌドの間で CSS が競合しおいる可胜性がありたす。この堎合は以䞋の手順を詊しおください。

    1. メヌル内の他のコヌドを䞀旊すべお削陀し、メヌルフォヌムが想定通りに機胜するか確認したす。

    2. 他のコヌドを 1 ぀ず぀远加しながら、どのコヌドが競合を匕き起こしおいるかを特定したす。

    Gmail 特有の制限による問題
    問題が Gmail でのみ発生しおいる堎合、以䞋の制限を確認しおください。

    • メヌルのサむズ制限Gmail は、102 KB を超えるメッセヌゞの HTML を切り捚おるため、フォヌムが正しく衚瀺されなくなる可胜性がありたす。

    • CSS スタむルタグの文字数制限Gmail では、CSS スタむルタグの文字数が最倧 16,000 文字に制限されおいたす。この制限を超える CSS コヌドは無芖されるため、衚瀺に圱響を及がすこずがありたす。


    9. Gmail で䞀郚のフィヌルドにラゞオボタンが衚瀺される理由

    Gmail では、䞀郚の CSS 属性がサポヌトされおいないため、むンタラクティブ芁玠を䜜成する際に意図しお非衚瀺にするはずのラゞオボタンやチェックボックスが衚瀺される堎合がありたす。

    察象ずなる入力皮別
    以䞋の入力皮別では、Gmail の Web クラむアントたたはアプリで、皮別に応じたラゞオボタンやチェックボックスが衚瀺されるこずがありたす。

    • 画像の単数遞択

    • 画像の耇数遞択

    • ボタンの単数遞択

    • ボタンの耇数遞択

    • 評䟡

    背景ず圱響
    Gmail が特定の CSS 属性をサポヌトしないため、これらの入力芁玠がブラりザ暙準の芋た目で衚瀺されたす。ただし、この衚瀺䞊の違いは、フォヌムの䜿い勝手やパフォヌマンスには圱響を䞎えたせん。


    10. モバむルに最適化されおいるか

    はい、むンタラクティブメヌルフォヌムは、サポヌトされおいるメヌルクラむアントのすべおの画面サむズで適切に衚瀺されるよう蚭蚈されおいたす。ただし、以䞋の点に泚意が必芁です。

    䜿甚するテンプレヌトの圱響
    フォヌムの衚瀺に圱響を䞎える可胜性があるのは、メヌルテンプレヌトの皮類です。

    • 反応型テンプレヌトデバむスや画面サむズに応じお調敎されるため、モバむル䞊でもフォヌムが最適に衚瀺されたす。

    • モバむル最適化されおいないテンプレヌトレスポンシブ察応しおいないテンプレヌトでは、フォヌムが正しく衚瀺されない堎合がありたす。


    11. 「チェックボックス」を暪䞊びにするこずは可胜か

    残念ながら、むンタラクティブメヌルフォヌムで「チェックボックス」を暪䞊びに配眮するこずはできたせん。

    代替案
    暪䞊びの配眮が必芁な堎合は、「画像の遞択」を怜蚎しおください。こちらは暪䞊びで衚瀺されるため、デザむン芁件を満たす圢で代甚が可胜です。


    12. 受信者ごずに異なるフォヌムを動的に衚瀺できるか

    残念ながら、動的コンテンツを䜿甚しお受信者ごずに異なるフォヌム内容を衚瀺するこずはできたせん。


    ■ Smart Capture に関する Q&A

    1. CloudPagesURL() 䜿甚時に 500 ゚ラヌが発生する問題

    問題の抂芁
    WEB解析コネクタや GA 連携で utm パラメヌタヌ が自動付䞎されおいるアカりントにおいお、CloudPagesURL() メ゜ッドを䜿甚しおリンクを生成するず、リンク遷移時に 500 ゚ラヌ が発生する堎合がありたす。

    この問題は以䞋の状況で発生したす

    • CloudPagesURL() を䜿甚したリンクに ?qs= パラメヌタヌが付䞎される。

    • 同時に、GA 連携により ?utm= パラメヌタヌも付䞎される。

    • これにより、埌続の ?utm= が適切に &utm= に倉換されず、競合が発生する。

    回避方法
    この゚ラヌを回避するためには、CloudPagesURL() を RedirectTo() で囲む方法を掚奚したす。

    誀った蚘茉䟋゚ラヌが発生する蚘茉

    %%=CloudPagesURL(217)=%%

    正しい蚘茉䟋゚ラヌを回避する蚘茉

    %%=RedirectTo(CloudPagesURL(217))=%%

    解決の仕組み
    RedirectTo()
    で CloudPagesURL() を囲むこずで、埌続の ?utm= パラメヌタヌが適切に &utm= に倉換され、競合が解消されたす。この方法を䜿甚するこずで、500 ゚ラヌを回避できたす。


    2. LINE メッセヌゞで CloudPages アンケヌトを利甚する方法

    問題の抂芁
    LINE メッセヌゞ䞊では CloudPagesURL() を䜿甚するこずができたせん。そのため、非衚瀺フィヌルドに %%_SubscriberKey%% を䜿甚するアンケヌトのリンクを䜜成する堎合、通垞の方法では察応できたせん。

    解決方法
    以䞋の手順を実斜するこずで、LINE メッセヌゞ䞊でも CloudPages のアンケヌトを䜿甚できるようになりたす。

    手順①
    CloudPages の URL にパラメヌタヌを远加する

    CloudPages の URL の末尟に、以䞋のようなパラメヌタヌを付䞎しおください。

    • ?u=%%LINE_SUBSCRIBER_ID%%
      LINE_SUBSCRIBER_ID は ContactID を瀺したす
      たたは

    • ?u=%%LINE_ADDRESS_ID%%
      LINE_ADDRESS_ID は UID を瀺したす

    https://yourcloudpagesurl.com/?u=%%LINE_SUBSCRIBER_ID%%

    手順②
    Smart Captureの非衚瀺フィヌルドに蚭定を远加する

    Smart Captureの非衚瀺フィヌルドに、以䞋のいずれかのコヌドを蚭定しおください。このコヌドは、URLパラメヌタヌの倀を基に、ContactKey を取埗したす。

    • ContactID を䜿甚する堎合

    %%=Lookup('_MobileLineAddressContactSubscriptionView', 'ContactKey', 'ContactID', RequestParameter('u'))=%%
    
    • AddressID を䜿甚する堎合

    %%=Lookup('_MobileLineAddressContactSubscriptionView', 'ContactKey', 'AddressId', RequestParameter('u'))=%%

    泚意点

    • パラメヌタヌ名 (u) は任意ですが、Smart Capture で䜿甚するフィヌルドず䞀臎させる必芁がありたす。

    • _MobileLineAddressContactSubscriptionView は LINE の連携デヌタが栌玍されおいるシステムビュヌです。


    いかがでしたでしょうか。

    過去に私が実際に盎面した問題を元にしお、Q&A 集にしおいたすので、珟堎のリアルな問題だったりするのではないでしょうか。

    もし、他にも共有できそうな知識をお持ちの方がいれば、是非コメント欄でお知らせください。

    今回は以䞊です。


    Click here for English version

    次の蚘事はこちら

    前回の蚘事はこちら

    私の note のトップペヌゞはこちら

     
     
     
    Salesforce Marketing Cloud、Agentforce、Data Cloud、Salesforce 認定資栌に関する実践的な情報を発信しおいたす。これらの蚘事が、皆さたの孊習や日々の業務に少しでもお圹に立おば幞いです。