Tutorials｜MAAC x SurveyCake Form

 

💁🏻‍♀️ Advantage

After friends fill out the survey, they can automatically transfer their personal information, tags, and other data to MAAC via Webhook, allowing brands to integrate user data and provide a smoother user experience and better data collection.

1. Collect user information and communication channels.
2. Automatically send survey responses and tags back to MAAC, no more manual importing and exporting.
3. Automatically send rewards or offers for completing the survey after the friend has completed it
4. All tags in the survey can trigger an automated Customer Journey, design the follow-up re-marketing messages and communication.
5. Back-fill survey answers into a member custom field (e.g. address), shared across MAAC / CAAC 🆕

➤ SurveyCake form Application

• For users who have clicked and not completed the survey, you can filter with the tag of clicking survey and exclude with the tag of completing the survey, to send broadcasts or related messages to this segment to increase the survey completion rate.
• Conduct satisfaction surveys and game interactions for LINE friends, and send prizes with prize management to optimize the transaction/interaction rate.
• For users who completed surveys, trigger a follow-up customer journey with a tag to send out brand information, VIP events, coupon offers, etc.
• The survey can be linked to a message in the customer journey to guide the user to fill in the survey and then make a return purchase.

➤ Plan Availability
 

This is an advanced feature in APP marketing, needs purchase in addition, and is not included in the Basic or EC plan. If you're interested, please contact your CSM and we're happy to assist you!

🚨 Attentions：

- To use the MAAC x SurveyCake from, you must be a SurveyCake Professional、Team or Enterprise Edition user.
- The survey can only be opened and completed on mobile devices.
- If you are not a friend of the LINE official account, you cannot fill out the survey, so it is not recommended to put it in an environment other than LINE.
After the survey is made public to friends, subsequent edits can still be made, but the modified labels and user information are only applicable to new users after editing, and cannot be applied to friends who have already filled out the survey.
- After editing, please remember to click Save to save the settings.
- Please check the labels and user information fields again before making the survey public. Copy the form link to send the test message to the testers, fill it out internally and confirm it is correct before making it available to friends.

▶︎ Setting Steps

➤ SurveyCake Platform - Basic survey settings

1. Access the SurveyCake platform to create your survey, enter basic settings such as the name, welcome message, etc.
2. The contents of the surveys can be broadly divided into "User Information Import", "User Tag Tracking", and "Member Custom Field Back-fill".

   • User Information Import setting: The following information can be imported into MAAC member fields, such as name, LINE UID, phone number, email address, member ID, birthday, and gender.

     When setting up user personal information, in order to match the MAAC member fields and forms, the following items need to be set in order to import the collected user information directly into the MAAC member fields.

     1. Survey questions settings > Click "Advanced" > Clicks "Alias and Default"
        
         
     2. Fill in the value provided by MAAC settings steps below
        
   • User Tag Tracking setting: All other questions or answers must be imported into MAAC in the form of "tags".
     1. Tagging according to questions/answers: the right of the question button "Advanced" > Tags
     2. Fill in the tags
        
        
   • Member Custom Field Back-fill 🆕: Back-fill survey answers into a member's custom field created in Admin Center (e.g. address), also mapped via the SurveyCake "Alias" feature. See "➤ SurveyCake Platform - Member Custom Field Back-fill" below.

➤ SurveyCake Platform - User Information Import

In each question, go to Advanced > Alias and Default and enter the matching alias below to import the answer into the MAAC member field (alias values are copy-ready):

Member field	SurveyCake alias	Question type	Required
LINE UID (required, hide recommended)	maac_member_line_uid	Single-line text	No
Name	maac_member_name	Single-line text	Optional
Phone	maac_member_mobile	Single-line text	Recommended
Phone (with country code)	maac_member_country_mobile	Single-line text	—
Email	maac_member_email	Single-line text	Optional
Member ID	maac_member_customer_id	Single-line text	Recommended
Birthday	maac_member_birthday	Date	Optional
Gender	maac_member_gender	Single choice	Optional

💡 Note: the gender question’s answer options also need aliases: Male fill male, Female fill female, Other / prefer not to say fill unknown. Per-field details and notes are below.

• LINE UID
  • When setting up the survey, you must set the LINE UID field in order to complete the binding of user identity and LINE UID.
  • The system will bring in user LINE UID by default, and users will see their LINE UID as soon as they open the survey, so users do not need to fill in this field, and it is recommended to set it as hidden to avoid user adjustments affecting the data.
  • Format restrictions
    • Required or not: No need to select required
    • Question Type: Short Response
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_line_uid"

💡 Reminder： The following user information will overwrite the original information after automatically imported into MAAC, if you want to keep the original information of MAAC, please ignore the settings of Alias and Default. For example, if you want to keep a friend's LINE nickname and user interaction, it is recommended not to set up Alias and Default in the name; on the contrary, if you want to replace LINE nickname with name, please set up Alias and Default in the name according to the following instructions.

🚨 Attentions： Please do not set the following questions to "Hidden" and "Required" at the same time, otherwise the survey will not open properly.

• Name
  • You can choose whether you want to collect friends' real names or not
  • The collected friend names will be imported into the LINE display name (nickname) of the MAAC member field and will overwrite the original LINE display name.
  • Format restrictions
    • Required or not: No need to select required
    • Question Type: Short Response
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_name"
       
• Phone number
  • You can choose whether you want to collect friends' phone numbers or not
  • The collected phone numbers will be imported to "Phone" in the MAAC member field
  • Format restrictions
    • Required or not: This is an optional field, but it is recommended to make it required
    • Question Type: Short Response
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_mobile"
      🔑 Reference：Short Response - validate data
       
  • Other cases: Your users filling the survey with phone number from different countries are mandatory to type country code as well. For example, Taiwan users need to enter +8869********, Korea users need to enter +82******** and Singapore users enter +65********.
    • Steps: Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_country_mobile"
      
       
• Mail
  • You can choose whether you want to collect user emails or not
  • The collected emails will be imported into the "Email" section of the MAAC Member field.
  • Format restrictions
    • Required or not: This is an optional field, but it is recommended to make it required
    • Question Type: Short Response
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_email"
      🔑 Reference：Short Response - validate data
       
• Member ID(Customer ID)
  • You can choose whether you want to collect the user's membership number or not, but it is recommended to set.
  • Member IDs collected through the form will be imported into the "Customer ID" of the MAAC member field.
  • Format Restrictions
    • Required or not: This is an optional field, but it is recommended to make it required
    • Question Type: Short Response
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_customer_id"
      💡 Reminder： In addition to searching for Member IDs, most brands also choose to use the "Mobile Phone Number" to import into the "Customer ID" field of MAAC as a binding identifier. In this way, the phone number can be imported not only into the "Phone" field but also into the "Customer ID" field!
       
• Birthday
  • You can choose whether you want to collect the user's birthday date
  • The birthday date collected through the form will be imported into the "Birthday" of the MAAC member field.
  • Format Restrictions
    • Required or not: This is an optional field
    • Question Type: Date
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_birthday"
       
• Gender
  • You can choose whether you want to collect the user's gender or not
  • The gender collected through the form will be imported into the "Gender" of the MAAC member field
  • Format Restrictions
    • Required or not: This is an optional field
    • Question Type: Date
    • Step：Survey questions settings > Click "Advanced" > Clicks "Alias and Default" > Fill in "maac_member_gender"
      💡 Reminder： To import the gender answer into MAAC, the gender answer field also requires a code.
      • Male/ Physiological male etc.: Set the button to the right of the answer bar > Alias > enter male
      • Female/ Physiological female etc.: Set the button to the right of the answer bar > Alias > enter female
      • Non-binary gender/ unknown/ do not want to disclose, etc.: Set button to the right of the answer bar > Alias > enter unknown

➤ SurveyCake Platform - User Tag Tracking

Questions and answers can be tagged and automatically imported to the MAAC platform for that member

• Tagging according to questions: the right of the question button "Advanced" > Tags > Fill in the tag 
• Tagging according to answers: the right of the answer button "Advanced" > Tags > Fill in the tag💡 Reminder： If you need more than one tag, you need to use the half symbol "," to separate, such as MAAC, SurveyCake.
  🚨 Attention： 
  - No more than 20 words in a single tag
  - The total number of words in all labels for a single topic or option must not exceed 30 words. ( according to SurveyCake specification )
  - No more than 5 tags on the same option

➤ SurveyCake Platform - Member Custom Field Back-fill 🆕

Beyond the standard member fields and tags above, you can also back-fill survey answers into a member's custom field (a cross-product custom field created in Admin Center, shared across MAAC / CAAC). A common use case: back-fill the "address" collected in a survey to the member profile, so store staff can use it directly for post-purchase follow-up, routing measurement-appointment requests to the official LINE@, and more.

📕 Prerequisite: First create the custom field in Admin Center (e.g. set "Address" as a Text field) and get its key (identifier). The key looks like cl_custom_<your_key> (e.g. cl_custom_address). See 👉 Tutorial｜MAAC × CAAC Cross-Product Custom Fields.

Setup steps:

1. In Admin Center, open Custom Field Management, create or confirm the custom field you want to back-fill, and copy its key (format cl_custom_<key>; the key cannot be changed once created). See “📕 Prerequisite” above for how to create it.
2. Back in SurveyCake, click the question you want to back-fill to show its toolbar, then open Advanced > Alias and Default.
3. In the Alias field, enter the key you copied in step 1. It must exactly match the Admin Center key (including the cl_custom_ prefix, character-for-character). For example, for the address field:

   cl_custom_address

4. Still set the maac_member_line_uid alias to bind the member, so the system knows which member to back-fill.

⚠️ The alias value depends on your Admin Center custom field design: each custom field’s key (cl_custom_<key>) is decided when the field is created. The SurveyCake alias must use that field’s actual key, which differs by brand and field — do not directly reuse the example cl_custom_address. The key cannot be changed once created.

❓ FAQ

Q: What should I enter in the SurveyCake alias, and how does it relate to the Admin Center key?

Enter the custom field key in full, as cl_custom_<key> (e.g. cl_custom_address). It must match the Admin Center key character-for-character (including the cl_custom_ prefix).

Q: Can I set both a tag and a field back-fill on the same question?

Yes. Tags and field aliases are independent settings, so the same question's answer can be both tagged and back-filled into one member field (either a standard member field or a custom field).

Q: Can the same answer back-fill both a standard member field and a custom field?

No. Each question's Alias and Default Value holds one alias only, so a single answer is written to just one destination—either a standard member field (maac_member_*) or a custom field (cl_custom_<key>), not both. You also cannot chain two aliases with a comma (comma separation applies to tags only). To write the same data to both a standard field and a custom field, use two separate questions, each with one alias.

Q: If the same member submits again, is the custom field overwritten or appended?

It is overwritten with the latest value.

Q: If the back-fill fails, will the survey fail to submit?

No. A failed back-fill only skips that custom field; the survey still submits normally.

Q: Which field types are supported? Can I use a "Dropdown"?

Text, Number, Date, and Date-time are supported (use "Text" for address); the "Dropdown" type is not currently supported.

➤ MAAC Platform - Integrate SurveyCake form with MAAC

1. In the SurveyCake platform, go to the survey list, click the "..." button and "Share" at the bottom right of the survey you want to link to, copy the sharing link of the form, and temporarily paste it into your notes.
   
2. Click the "..." button and "Notifications" at the bottom right of the survey, then go to the Webhook page, copy the Hash Key and IV Key, and paste them into your notes.
   
3. In the MAAC platform, go to APP marketing > SurveyCake Forms > Add Form.
   
4. Fill in the survey title, link, Hash Key, and IV Key you just copied from SurveyCake according to the field names.
   
5. If prizes are awarded after filling out the survey, and if you want to avoid duplicate prizes, you must set up the form so that each LINE user can only fill out the form once. Also, if you want to tag users who click on the survey and those who do complete it, you can add tags to filter them in future uses.
   • MAAC platform: Check the box "Limit each friend to take the survey no more than once.".
   • SurveyCake platform: Survey Settings > Check "Isolate Multiple Responses" to avoid duplicate filling of coupons by the same browser
     
6. Copy the Webhook URL and go back to the Webhook URL field on the SurveyCake page and paste it in, then click Save.
   
   
   
    
7. It is recommended to be used in conjunction with Prize Management. Click the "Create" button to complete the MAAC x SurveyCake form setup.
   🚨 Attention： After filling out the form, if the user can only play the game once, please be sure to use it together with the "game tix".
   📚 Review： Tutorials｜ Prize Management
8. If the blue box "When a member clicks the link repeatedly, messages will also be sent repeatedly. " is checked, users who repeat the form will be repeatedly sent thank you messages and rewards, and will be charged for pushing the message. If "Limit each friend to take the survey no more than once." is checked in the previous step, this item cannot be checked by default.
   
9. After completing the integration, go to the list page and copy the survey Liff URL, it can be directly put into the editors of broadcast, auto-reply, rich menu, etc.
   🚨 Attention： The link of surveys is special Liff URL "https://liff.line.me/*************/form/?webhook_id=********", so it cannot be reduced to the short URL/tracelink of MAAC.
   

🔍 Tips： After users submit the survey, it will be automatically redirected to the official account, so users don't need to close the thank you page by themselves.
- Setting Steps:
1. In the SurveyCake platform > Click survey > Custom Thank You > Set up redirect URL

2. Fill in https://line.me/R/ti/p/[bot basic id] (example: https://line.me/R/ti/p/@925kyswn), press Save to complete the setting

➤ Please check the following information first to ensure settings when you have some issues

1. Make sure you click "Save" after setting "Set Webhook URL" in the SurveyCake platform.
2. Make sure the alias setting is correct, especially for the LINE UID field.
    
3. Make sure that both "Hidden" and "Required" can't be set in one field. For example, if the LINE UID field is set to "Hide", please do not check "Required".
    
4. Your SurveyCake platform plan is Professional or Enterprise Edition.
5. If a custom field isn't back-filled: make sure the SurveyCake alias exactly matches the Admin Center key (including the cl_custom_ prefix), the field isn't archived, the type matches, and maac_member_line_uid is set to bind the member.

▶︎ List and Performance

1. The following results of the survey can be viewed.

   • Data update: Currently the data is updated once every 1 hour
   • Clicks: How many users click on the survey does not represent the actual number of survey returns
   • Number of replies: the actual number of surveys returned
   • Number of Responses: The number of non-repeated users who completed the survey, e.g. 3 users completed 5 surveys, the number of responses would be 3
   • Response rate.
     • If repeats are allowed, the response rate = number of responses (actual number of questionnaires returned) / Clicks
     • If limited to one completion per person, the response rate = number of responses/number of non-repeated clicks, as the number of non-repeated clicks

2. Copy survey Liff URLs, created surveys can only be closed and cannot be deleted.

3. Copy the survey Liff URL, it can be directly put into the editors of broadcast, auto-reply, rich menu, etc.