Creating a custom registration landing page

Important: The Oracle Eloqua WeChat app has been removed from the Oracle Cloud Marketplace and is no longer available for download. For customers with the app enabled, the app will remain active in its current form until December 1, 2022, after which the app will be sunset and no longer be available for use.

You can create a custom registration landing page to collect WeChat follower information. For example, you can create a custom landing page for event registration. Alternatively, you can use a template to create a registration landing page using the WeChat Landing Page Generator cloud content service.

WeChat users are directed to your registration landing page when they scan your QR code and follow your WeChat official account. The link to the registration landing page is included in the welcome message. The registration landing page should contain an Eloqua form to collect their information. A contact field in the form must be mapped to a contact's WeChat OpenID. You can create additional custom fields to map other WeChat information, such as the nickname.

Prerequisites:
  • A custom contact field to capture followers' OpenIDs is required. If you have multiple official accounts, you must create an OpenID field for each service account and one field for UnionIDs is recommended.

    An image of custom contact field creation.

  • (Optional) Create custom fields or a custom object (CDO) to map any WeChat social profile information needed for your use case, such as WeChat nickname, country, province, and city. For more details, see Configuring fields for the Eloqua-WeChat Integrator app.
  • Create a form to collect WeChat follower information based on your use case. For example: WeChat OpenID (required), email address (required), WeChat nickname, country, province, city, and a UnionID is required if you have multiple official accounts. The data type for these fields is Text and the field type is Textbox. The WeChat OpenID and UnionID must not be modified by the follower, so specify a hidden field type. You can add a hidden field with a fixed value of follow to map the follower's status (recommended).

    An image of a form used to collect WeChat follower information.

    Learn how to create forms in Oracle Eloqua.

To create a registration landing page:

  1. Navigate to AssetsAn image of the Assets icon, which is represented by a black pencil., then click Landing Pages.
  2. Click Create a Landing Page to open the Template Chooser window.

    An image of the Create a Landing Page option.

  3. Click Blank HTML Landing Page or Blank Landing Page, then click Choose.
  4. Click Form and then select the registration form you created from the Form Browser dialog.

    An image of the registration form on a landing page.

  5. Add JavaScript to populate the WeChat social profile into Eloqua's landing page:
    1. Click Cloud Content. The Cloud Content dialog is displayed.

      An image of the WeChat GeneratorJS Gallery dialog

    2. Search for the WeChat GenerateJS Gallery content service and drag it in to the body of your landing page.

      An image of the Landing page showing the WeChat Social Profile JavaScript Generator configuration

    3. Map each attribute of WeChat social profile to a field in your form. All form fields are automatically listed in the drop-down menu, formatted as Label: HTML name.

      An image of the mapped Wechat JS Generator content service.

      Note: Only the OpenID attribute is required. The other attributes are optional.

    4. Click Save.
  6. Save your landing page.

    An image of a landing page with the WeChat javascript.

  7. Test your landing page:
    1. Access your landing page with the query string parameters.
    2. Check whether values of the query string parameters are automatically populated in the form.

    An image of the form preview.

    Example: Use your landing page URL and add the query string parameters.

    http://{landing_page}?openid={openid}nickname={nickname}&country={country}&province={province}&city={city}

    http://example.com?openid=wxidds2120301290862skl&nickname=youngsmile&country=China&province=Beijing&city=Haidian

  8. Copy the URL of the landing page and insert it in your: welcome message, rich media message, or a template message.

Once a WeChat follower receives the message and clicks the link to your landing page, their WeChat public information is appended at the end of the URL. The landing page automatically captures the WeChat public information from the URL and automatically populates the information into relevant fields. Once a WeChat follower submits the landing page form, the information is automatically synchronized in Eloqua. If the submitted email address exists in Eloqua, the contact will be updated with the submitted information. If the submitted email address does not exist in Eloqua, a new contact is created.

Learn more

Creating a registration landing page

Landing pages

Eloqua-WeChat Integrator app

Oracle Eloqua AppCloud apps

WeChat custom registration landing page, WeChat GenerateJS Gallery, Generator JS, GeneratorJS, JS Generator, Cloud Content, WeChat public information, hidden field