Connect CleverReach

This how-to connects your game to CleverReach, so that the email addresses your players sign up with are added to a CleverReach group and the Metadata you map is written to their contact fields.

Prerequisites

• A CleverReach account with an OAuth client. Create one in CleverReach under My Account → REST API to get a client ID and client secret.
• The ID of the CleverReach group your players should be added to.
• White Label Login configured for your game. Without it, LootLocker has no email addresses to pass to CleverReach.

Open the CleverReach Settings

Click Settings in the Web Console sidebar and open CRM Platforms, then select CleverReach from the platform list on the left.

Add Your CleverReach Credentials

Three fields are required:

• Client ID: your CleverReach OAuth client ID.
• Client Secret: your CleverReach OAuth client secret.
• Group ID: the CleverReach group, or list, that players are added to.

Caution

Treat the client secret as a secret. Anyone with it can read and write the contacts in your CleverReach account.

Map Your Metadata Keys

The Key mapping row shows how many keys are currently mapped and gives you an Edit mapping button to change them. Each mapping sends one Metadata key from a player's profile to one CleverReach field.

You can connect CleverReach without mapping any keys — LootLocker will still pass email addresses — but nothing beyond the email address reaches CleverReach until you map at least one key. See Map Metadata Keys to CRM Fields for how to map keys individually or in bulk.

Configure Double Opt-in

CleverReach uses a double opt-in flow, where a player confirms their subscription from an activation email before they receive any campaigns. Two optional fields drive it:

• Marketing Opt-in Key: the Metadata key that records whether the player opted into marketing, such as newsletter_subscribed. Set this to the key you write that value to on the player's profile.
• Activation Form ID: the ID of the CleverReach form used to send the double opt-in activation email.

Save Your Settings

Click Save Changes to store the configuration.

Caution

Saving does not test your credentials against CleverReach, and the Web Console does not report on individual pushes. Create a White Label Login account in your game and confirm the contact appears in your CleverReach group to verify the connection works.

Conclusion

CleverReach is connected, and new White Label Login accounts will be added to the group you configured. Next, map the Metadata you want to campaign on with Map Metadata Keys to CRM Fields.