Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.voyado.com/llms.txt

Use this file to discover all available pages before exploring further.

The discoveryKey attribute lets you tap into the full potential of both Engage’s customer insights and Elevate’s product intelligence. Ensuring that a high number of contacts have this means that you’ll be more equipped to personalize your site using Engage data, and sessions enriched by Elevate’s AI-powered product understanding are more likely to link to a contact in Engage.
Every implementation is unique and here “ecom“ could mean different things (one of several different platforms) depending on the retailer. Use this article as a source of ideas to further investigate with your tech team and your team at Voyado.
Here are some tips to help you maximize the number of your contacts using discoveryKey in Engage.

​
New member recruited onsite

The simplest case. A key aspect of the Engage and Elevate integration is using the customerKey generated by the e-commerce platform as the discoveryKey when creating a contact in Engage. All new contacts in Engage should have a discoveryKey.
https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399

Read more about Elevate and customerKey

You can use any internal ID as discoveryKey as long as:
  • It is the same the one as used for customerKey
  • It is a unique value in your system

​
Existing member identified onsite

Assigning a discoveryKey value to your existing members is likely the most important step in identifying as many visitors as possible. This is done by always using the existing the customerKey as the discoveryKey in Engage whenever a user is identified (no matter how or when).
https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=d3bbe9d0aab6dd040395641416bf535e

Read more about selecting visitor identifier in Elevate

​
New member recruited in-store

When recruiting a member in-store, create the customerKey at the same time, if possible, so it can be added when setting up the contact in Engage. If that’s not an option, a good approach is to send a verification SMS or email as a double opt-in via an automation.
https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=3e7ca2ce0b8cfb9fbd27a4bdf53b2ce1

Read more about building automations

The SMS or email should link to the e-commerce site, where additional customer data and consent can be collected. If you use email, and soft identification is enabled, the visitor will be identified automatically. With SMS, the identification needs to be managed by, for example, adding the contactId as a shortGUID in the URL. Once identified in the e-commerce platform, the customerKey should be assigned as the discoveryKey in Engage.
https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399

Read more about soft identification

​
Bulk update of contacts

When a contact signs in or is otherwise identified, you can make an API call to Engage to update their information with their assigned discoveryKey. This will increase the share of contacts in Engage with a discoveryKey value. If there is a registry held by the e-com that includes both the Elevate customerKey and the Engage contactId consider making a bulk import to save these values in Engage and boost the rate. There are several ways to update contacts in bulk, and they are explained in detail here:
https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399

Read about bulk contact updates