Configuring fields for the Eloqua-WeChat Integrator app

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.

Before you can add a WeChat official account, you must create a custom field for storing followers' WeChat OpenIDs when they register into Eloqua (for example, oDBPcs3JRzzNG4rY_1BRzZvyMYSQ).

You can create the following custom fields to store information that supports common Eloqua-WeChat Integrator app use cases. Custom fields are typically easier to implement than custom objects, but you can create custom objects to store specific fields marked as such in the following table if you exceed custom field limits.

If you have multiple service accounts, some of these fields can be shared across accounts.

Field Description Shared across accounts? Fields which can store custom objects
Last Activity Time Store the date and time of the most recent activity by the WeChat follower. This can be used for creating segments and defining decision steps in a campaign. For example, you can use this field to filter the audience of messages to include followers that interact with the WeChat official account in the past 48 hours. Activities can include following, clicking menus, scanning a QR code, and sending messages to the official account. The data type must be Date and the field type must be Textbox. Leave the default values for other field settings.

An image of Last Activity Time field creation

 An image of a red x icon, which represents a failed validation. An image of a red x icon, which represents a failed validation.
OpenID (Required) You must create a unique contact field for each WeChat official account's OpenIDs. The data type for the OpenID field must be Text and the field type must be Textbox.

An image of custom contact field creation.

 An image of a red x icon, which represents a failed validation. An image of a red x icon, which represents a failed validation.
Subscription Status

Stores followers' subscription status when they follow a WeChat official account (FOLLOW). If followers unfollow an official account, the value of this field is updated as UNFOLLOW. Create a picklist with the following options used by the Subscription Status field, where Blank is the default option:

  • Blank: value is null
  • Follow: value is FOLLOW
  • Unfollow: value is UNFOLLOW

An image of picklist creation for use with the subscription status field

Then create a custom field for storing followers' WeChat subscription status. The data type for this field must be Text and the field type must be Picklist.

An image of custom contact field creation for subscription status

Note: If the follower's OpenID has not been collected, their subscription status cannot be updated.

See also: Synchronizing subscription status.		 An image of a red x icon, which represents a failed validation. An image of a red x icon, which represents a failed validation.
Super OpenID You can specify a super OpenID to support broadcasts. An image of a red x icon, which represents a failed validation. An image of a red x icon, which represents a failed validation.
UnionID Stores UnionIDs, which are used to identify the follower across accounts. This field is recommended if your company has multiple WeChat official accounts. If a follower subscribes to more than one account, the UnionID is used to identify them because their OpenIDs are unique to each account. Create a unique contact field for storing followers' UnionIDs. The data type must be Text and the field type must be Textbox. All your WeChat official accounts must be registered in the same WeChat open platform if you want to link followers via a UnionID. You can register a maximum of five WeChat official accounts on the same WeChat open platform. An image of a green checkmark icon, which represents a successful validation. An image of a red x icon, which represents a failed validation.
WeChat City The city specified in the follower's public WeChat social profile information. Supported only by service accounts. The data type must be Text and the field type must be Textbox.

Tip: Depending on your business needs, you can use Eloqua's contact fields to store WeChat region information instead of creating custom fields to capture followers' city, country, and province.

 An image of a green checkmark icon, which represents a successful validation. An image of a green checkmark icon, which represents a successful validation.
WeChat Country The country specified in the follower's public WeChat social profile information. Supported only by service accounts. The data type must be Text and the field type must be Textbox. An image of a green checkmark icon, which represents a successful validation. An image of a green checkmark icon, which represents a successful validation.
WeChat Nickname The nickname specified in the follower's public WeChat social profile information. Supported only by service accounts. The data type must be Text and the field type must be Textbox. An image of a green checkmark icon, which represents a successful validation. An image of a green checkmark icon, which represents a successful validation.
WeChat Province The province specified in the follower's public WeChat social profile information. Supported only by service accounts. The data type must be Text and the field type must be Textbox. An image of a green checkmark icon, which represents a successful validation. An image of a green checkmark icon, which represents a successful validation.

Specifying a super OpenID for broadcast messages

Broadcast messages require a minimum of two contacts for the broadcast to be sent. If only one WeChat contact is included in the specified segment at the time that it is routed into the campaign's WeChat Message Sender action step, the broadcast will fail unless you specify a super OpenID in the WeChat toolkit's WeChat Super OpenID box.

If the segment has only one contact at the time the broadcast is sent, a message is sent via that follower's OpenID and to the super OpenID follower.

You can use the OpenID of a WeChat follower who is internal to your organization. The super OpenID follower must be subscribed to the current WeChat official account.

To specify a super OpenID:

  1. In Eloqua, open the contact of the WeChat follower with the OpenID you will specify as the super OpenID.
  2. Click the Field Detail tab.

    Image of an Eloqua contact with a populated WeChat subscription status field

  3. Alternatively, you can search for the super ID follower in the WeChat official account platform and open their contact to display their tofakeid value in the URL, which is the follower's OpenID.

    Image of an Eloqua contact with a populated WeChat subscription status field

  4. Record the follower's OpenID.
  5. From the Dashboard, click the cloud menuAn image of the Cloud Menu icon, which is represented by a gray cloud. icon on the right hand side to expand it.
  6. From the Apps list, click WeChat Message Gallery.

    An image of the cloud menu where you can access the Eloqua-WeChat Integrator app.

    The Eloqua-WeChat Integrator page is displayed.
  7. If you have multiple WeChat official accounts, click the user profile icon Image of the user profile icon in the upper-right corner of the Eloqua-WeChat Integrator page in the upper-right corner and select a WeChat account from the list.
  8. Click the WeChat Toolkit tab. The WeChat Toolkit page is displayed.

    An image of the WeChat Toolkit page where you can edit your WeChat Tag Preference to label a tag for new WeChat followers.

  9. Click the Edit icon in the WeChat Super OpenID row.
  10. Enter the OpenID of the super OpenID follower in the WeChat Super OpenID box and click Save.

    Image of the WeChat Toolkit page after selecting the Label a tag for new WeChat followers check box

Learn more

Creating contact fields

Custom objects

WeChat account types

Adding WeChat official accounts

Synchronizing subscription status

Eloqua-WeChat Integrator app

OpenID article

OpenID, UnionID, Subscription Status, Last Activity Time, WeChat Nickname, Country, Province, City