> ## 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.

# Boosting discoveryKey use

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.

<Tip>
  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.
</Tip>

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`.

<Card title="Read more about Elevate and customerKey" href="/docs/elevate/engage-with-elevate#customer-key-in-elevate" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />

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).

<Card title="Read more about selecting visitor identifier in Elevate" href="https://docs.elevate.voyado.cloud/elevate/4/integration/site-integration/session-management/?#selecting-visitor-identifier" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=d3bbe9d0aab6dd040395641416bf535e" horizontal width="128" height="128" data-path="icons/elevate-link.png" />

## 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.

<Card title="Read more about building automations" href="https://help.engage.voyado.com/hc/en-gb/articles/17212850184476-How-to-build-an-automation" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=3e7ca2ce0b8cfb9fbd27a4bdf53b2ce1" horizontal width="128" height="128" data-path="icons/help-center-link.png" />

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.

<Card title="Read more about soft identification" href="/docs/contacts/identify-contact/soft-identification" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />

## 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:

<Card title="Read about bulk contact updates" href="/docs/contacts/bulk-contacts-api" icon="https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max&auto=format&n=Ns4bBcK3LNctK_Un&q=85&s=fbd08f956358ab12f664a7158e1a1399" horizontal width="128" height="128" data-path="icons/developer-link.png" />
