Responses are generated using AI and may contain mistakes.
IMPORTANT: We're updating product naming across our documentation. Engage is now Customer Engagement and Elevate is now Product Discovery. This doesn't change Voyado's services, functionality, or terms of your agreement. Be aware, as these changes happen, that you may see both the old and new names being used.
The discoveryKey attribute lets you tap into the full potential of both Customer Engagement’s customer insights and Product Discovery’s product intelligence. Ensuring that a high number of contacts have this means that you’ll be more equipped to personalize your site using Customer Engagement data, and sessions enriched by Product Discovery’s AI-powered product understanding are more likely to link to a contact in Customer Engagement.
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 Customer Engagement.
The simplest case. A key aspect of the Customer Engagement and Product Discovery integration is using the customerKey generated by the e-commerce platform as the discoveryKey when creating a contact in Customer Engagement. All new contacts in Customer Engagement should have a discoveryKey.
Read about Product Discovery and customerKey
You can use any internal ID as discoveryKey as long as:
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 Customer Engagement whenever a user is identified (no matter how or when).
Read about selecting visitor identifier in Product Discovery
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 Customer Engagement. 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.
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 Customer Engagement.
When a contact signs in or is otherwise identified, you can make an API call to Customer Engagement to update their information with their assigned discoveryKey. This will increase the share of contacts in Customer Engagement with a discoveryKey value.If there is a registry held by the e-com that includes both the Product Discovery customerKey and the Customer Engagement contactId consider making a bulk import to save these values in Customer Engagement and boost the rate.There are several ways to update contacts in bulk, and they are explained in detail here:
Read about bulk contact updates
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Voyado Docs","colors":{"primary":"#fe4a49","light":"#ffffff","dark":"#fe4a49"},"logo":{"light":"https://mintcdn.com/voyado/fiZZVymeDExCOKTK/logo/light.svg?fit=max\u0026auto=format\u0026n=fiZZVymeDExCOKTK\u0026q=85\u0026s=114e763881bcc646add31724b257f726","dark":"https://mintcdn.com/voyado/fiZZVymeDExCOKTK/logo/dark.svg?fit=max\u0026auto=format\u0026n=fiZZVymeDExCOKTK\u0026q=85\u0026s=68eaa3b1f64893ebcee4c7d65f20ecbc","href":"/docs"},"favicon":"https://mintcdn.com/voyado/_EinvHkwtU2pq43w/favicon.png?fit=max\u0026auto=format\u0026n=_EinvHkwtU2pq43w\u0026q=85\u0026s=4109ede7a6d04311c67ffa2f695ce527","appearance":{"default":"light"},"background":{"decoration":"grid"},"navbar":{"links":[{"icon":"/icons/help-center-link.png","href":"https://help.engage.voyado.com/hc/en-gb","label":"Help Center"}],"primary":{"type":"button","label":"Contact us","href":"https://voyado.com/about-voyado/contact-us/"}},"footer":{"socials":{"facebook":"https://www.facebook.com/voyado","linkedin":"https://www.linkedin.com/company/voyadoab"}},"fonts":{"heading":{"family":"Voyado Text","source":"https://mintlify-assets.b-cdn.net/VoyadoText-Medium.woff2","format":"woff2"},"body":{"family":"Voyado Regular","source":"https://mintlify-assets.b-cdn.net/VoyadoText-Regular.woff2","format":"woff2"}},"integrations":{"cookies":{"key":"mintlify_telemetry","value":"granted"}},"banner":{"content":"IMPORTANT: We're updating product naming across our documentation. **Engage** is now **Customer Engagement** and **Elevate** is now **Product Discovery**. This doesn't change Voyado's services, functionality, or terms of your agreement. Be aware, as these changes happen, that you may see both the old and new names being used.","dismissible":false},"errors":{"404":{"redirect":false,"title":"The page you are looking for can't be found. Search for it in the box above.","description":"Or press [here](https://developer.voyado.com/) to come to the start page and the menu."}},"contextual":{"options":["claude","chatgpt","assistant","copy","view","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"voyado","hasAudioNarration":false,"actualSubdomain":"voyado","customDomains":["developer.voyado.com"],"gitSource":{"type":"github","owner":"voyado","repo":"developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae1bb4a83326b7b15e9050b","collectionId":"97bdc92d-fe34-45d7-8595-921786581f7e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae1bb4a83326b7b15e9050b"},"feedback":{"thumbs":true,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1bb4a83326b7b15e9050b","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Integration","count":46},{"language":"default","tag":"Data access","count":26},{"language":"default","tag":"E-com and communication","count":19},{"language":"default","tag":"File based transfer","count":18},{"language":"default","tag":"Contacts","count":15},{"language":"default","tag":"BI export","count":14},{"language":"default","tag":"BI Exports available","count":13},{"language":"default","tag":"E-com and tracking","count":11},{"language":"default","tag":"Delta share","count":9},{"language":"default","tag":"Home","count":8}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"styles/style.css","content":".border-b{border-bottom-width:2px;border-color:rgb(var(--gray-200))}.prose-sm{font-size:.9rem;line-height:1.7}.prose :where(code):not(:where([class~=not-prose],[class~=not-prose] *)){color:var(--tw-prose-code);font-weight:500;background-color:#f8f8f7;border:1px solid #c7dbe8;border-radius:4px}.py-1\\.5{padding-top:1px;padding-bottom:1px}@media (min-width:1024px){.lg\\:mt-8{margin-top:1rem}}.sidebar-title{margin-bottom:-.3rem;font-size:15px}#pagination{display:none!important}.prose table{border-collapse:collapse;width:100%}.prose table td,.prose table th{border:1px solid rgba(0,0,0,.15);padding:.6rem .75rem}html.dark .prose table td,html.dark .prose table th{border:1px solid rgba(255,255,255,.15)}.prose table thead tr{background-color:rgba(59,130,246,.12)}html.dark .prose table thead tr{background-color:rgba(59,130,246,.25)}.prose table thead th{font-weight:600}.prose table tbody tr:nth-child(odd) td{background-color:rgba(0,0,0,.03)}html.dark .prose table tbody tr:nth-child(odd) td{background-color:rgba(255,255,255,.05)}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.6em;margin-bottom:.7em}.prose :where(h3):not(:where([class~=not-prose],[class~=not-prose] *)),.prose :where(h4):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.5em;margin-bottom:.6em}@media (min-width:1024px){.update h2{margin-top:-2px!important}}.update-container{padding-top:15px!important;padding-bottom:25px!important;gap:5px!important}"}],"page":{"pagePath":"docs/product-discovery/discovery-key","slug":"/docs/product-discovery/discovery-key","pageMetadata":{"title":"Boosting discoveryKey use","description":null,"href":"/docs/product-discovery/discovery-key"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Card,Heading,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`discoveryKey`}),` attribute lets you tap into the full potential of both Customer Engagement’s customer insights and Product Discovery’s product intelligence. Ensuring that a high number of contacts have this means that you’ll be more equipped to personalize your site using Customer Engagement data, and sessions enriched by Product Discovery’s AI-powered product understanding are more likely to link to a contact in Customer Engagement.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`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.`})}),`\n`,_jsxs(_components.p,{children:[`Here are some tips to help you maximize the number of your contacts using `,_jsx(_components.code,{children:`discoveryKey`}),` in Customer Engagement.`]}),`\n`,_jsx(Heading,{level:`2`,id:`new-member-recruited-onsite`,children:`New member recruited onsite`}),`\n`,_jsxs(_components.p,{children:[`The simplest case. A key aspect of the Customer Engagement and Product Discovery integration is using the `,_jsx(_components.code,{children:`customerKey`}),` generated by the e-commerce platform as the `,_jsx(_components.code,{children:`discoveryKey`}),` when creating a contact in Customer Engagement. All new contacts in Customer Engagement should have a `,_jsx(_components.code,{children:`discoveryKey`}),`.`]}),`\n`,_jsx(Card,{title:`Read about Product Discovery and customerKey`,href:`/docs/product-discovery/integration#customer-key`,icon:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=fbd08f956358ab12f664a7158e1a1399`,horizontal:true,\"data-og-width\":`128`,width:`128`,\"data-og-height\":`128`,height:`128`,\"data-path\":`icons/developer-link.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=578148bc52109a62b81752b2bdcca681 280w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=f2db9fd1adc7070915fd141f27bbb394 560w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=90bd01623e630bdd7d6a9e4be36e588b 840w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=bf680b4f85d26b755a76865c2cf85c63 1100w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=f2fd6e9882691d17cd6e0f9f1fb164dd 1650w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=0dce3c83fcfa177e7bd88d61bb4df03a 2500w`}),`\n`,_jsx(_components.p,{children:`You can use any internal ID as discoveryKey as long as:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`It is the same the one as used for customerKey`}),`\n`,_jsx(_components.li,{children:`It is a unique value in your system`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`existing-member-identified-onsite`,children:`Existing member identified onsite`}),`\n`,_jsxs(_components.p,{children:[`Assigning a `,_jsx(_components.code,{children:`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 `,_jsx(_components.code,{children:`customerKey`}),` as the `,_jsx(_components.code,{children:`discoveryKey`}),` in Customer Engagement whenever a user is identified (no matter how or when).`]}),`\n`,_jsx(Card,{title:`Read about selecting visitor identifier in Product Discovery`,href:`https://product-discovery.developer.voyado.com/docs/integration/site-integration/session-management#selecting-visitor-identifier`,icon:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=d3bbe9d0aab6dd040395641416bf535e`,horizontal:true,\"data-og-width\":`128`,width:`128`,\"data-og-height\":`128`,height:`128`,\"data-path\":`icons/elevate-link.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=1dd82357e9ab7ab040472d4477db2060 280w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=ef4b74fe424e36c85c07d49affbc7958 560w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=e707b7b2bf1d530cb7ca8d0d42382f29 840w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=70f4d0a0e6bf5e743cae6d5b4e736905 1100w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=6c6081e2dcf7967f70e6dd2bf022e636 1650w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/elevate-link.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=e683a4f5ed89413ada27234a5949c5c0 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`new-member-recruited-in-store`,children:`New member recruited in-store`}),`\n`,_jsxs(_components.p,{children:[`When recruiting a member in-store, create the `,_jsx(_components.code,{children:`customerKey`}),` at the same time, if possible, so it can be added when setting up the contact in Customer Engagement. 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.`]}),`\n`,_jsx(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\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=3e7ca2ce0b8cfb9fbd27a4bdf53b2ce1`,horizontal:true,\"data-og-width\":`128`,width:`128`,\"data-og-height\":`128`,height:`128`,\"data-path\":`icons/help-center-link.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=e0d8bb2afb39e9eec9ac2ef99bc3e076 280w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=186dbfe68eb972eb2e6156a337e922c3 560w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=daa7f71dbb1c8d8b817475cd16e3f05b 840w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=2d4a246217df4a4aed0412826930ef48 1100w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=14720bcc53f6426fab6d346c858e369d 1650w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/help-center-link.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=058ad8e270036f3cae39247fc94e215b 2500w`}),`\n`,_jsx(_components.p,{children:`The SMS or email should link to the e-commerce site, where additional customer data and consent can be collected.`}),`\n`,_jsx(_components.p,{children:`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 Customer Engagement.`}),`\n`,_jsx(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\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=fbd08f956358ab12f664a7158e1a1399`,horizontal:true,\"data-og-width\":`128`,width:`128`,\"data-og-height\":`128`,height:`128`,\"data-path\":`icons/developer-link.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=578148bc52109a62b81752b2bdcca681 280w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=f2db9fd1adc7070915fd141f27bbb394 560w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=90bd01623e630bdd7d6a9e4be36e588b 840w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=bf680b4f85d26b755a76865c2cf85c63 1100w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=f2fd6e9882691d17cd6e0f9f1fb164dd 1650w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=0dce3c83fcfa177e7bd88d61bb4df03a 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`bulk-update-of-contacts`,children:`Bulk update of contacts`}),`\n`,_jsxs(_components.p,{children:[`When a contact signs in or is otherwise identified, you can make an API call to Customer Engagement to update their information with their assigned `,_jsx(_components.code,{children:`discoveryKey`}),`. This will increase the share of contacts in Customer Engagement with a `,_jsx(_components.code,{children:`discoveryKey`}),` value.`]}),`\n`,_jsxs(_components.p,{children:[`If there is a registry held by the e-com that includes both the Product Discovery `,_jsx(_components.code,{children:`customerKey`}),` and the Customer Engagement `,_jsx(_components.code,{children:`contactId`}),` consider making a bulk import to save these values in Customer Engagement and boost the rate.`]}),`\n`,_jsx(_components.p,{children:`There are several ways to update contacts in bulk, and they are explained in detail here:`}),`\n`,_jsx(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\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=fbd08f956358ab12f664a7158e1a1399`,horizontal:true,\"data-og-width\":`128`,width:`128`,\"data-og-height\":`128`,height:`128`,\"data-path\":`icons/developer-link.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=280\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=578148bc52109a62b81752b2bdcca681 280w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=560\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=f2db9fd1adc7070915fd141f27bbb394 560w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=840\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=90bd01623e630bdd7d6a9e4be36e588b 840w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=bf680b4f85d26b755a76865c2cf85c63 1100w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=f2fd6e9882691d17cd6e0f9f1fb164dd 1650w, https://mintcdn.com/voyado/Ns4bBcK3LNctK_Un/icons/developer-link.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Ns4bBcK3LNctK_Un\u0026q=85\u0026s=0dce3c83fcfa177e7bd88d61bb4df03a 2500w`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Boosting discoveryKey use","description":null,"href":"/docs/product-discovery/discovery-key"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"New member recruited onsite","slug":"new-member-recruited-onsite","depth":2,"children":[]},{"title":"Existing member identified onsite","slug":"existing-member-identified-onsite","depth":2,"children":[]},{"title":"New member recruited in-store","slug":"new-member-recruited-in-store","depth":2,"children":[]},{"title":"Bulk update of contacts","slug":"bulk-update-of-contacts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/voyado/e3b0c44298fc1c14/js/test.js","/_mintlify/custom/voyado/a093bfac3f8a0766/js/gtm.js"],"subdomain":"voyado","siteName":"Voyado Docs","title":"Boosting discoveryKey use - Voyado Docs","navMaps":{"firstHrefInVersion":{"API version 3":{"href":"/docs/product-discovery/discovery-key","matchLevel":0},"API version 2":{"href":"/docs-v2/api-v2","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T15:45:33.274Z","originalFileLocation":"docs/product-discovery/discovery-key.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Voyado Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Boosting discoveryKey use - Voyado Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Voyado Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.voyado.com/docs/product-discovery/discovery-key\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://voyado.mintlify.app/_mintlify/api/og/v2?division=Product+Discovery\u0026amp;title=Boosting+discoveryKey+use\u0026amp;theme=d6be399f515d3ce011325711\u0026amp;signature=d94e082303a3436b6722aa9717336978f833b8e5b0f645675e59016b1a006bea\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Boosting discoveryKey use - Voyado Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://voyado.mintlify.app/_mintlify/api/og/v2?division=Product+Discovery\u0026amp;title=Boosting+discoveryKey+use\u0026amp;theme=d6be399f515d3ce011325711\u0026amp;signature=d94e082303a3436b6722aa9717336978f833b8e5b0f645675e59016b1a006bea\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/voyado/9fqQ87AEVqs68vAz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Voyado Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#fe4a49\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.voyado.com/docs/product-discovery/discovery-key\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/product-discovery/discovery-key.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.voyado.com/#organization\",\"name\":\"Voyado Docs\",\"url\":\"https://developer.voyado.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/voyado/fiZZVymeDExCOKTK/logo/light.svg?fit=max\u0026auto=format\u0026n=fiZZVymeDExCOKTK\u0026q=85\u0026s=114e763881bcc646add31724b257f726\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.voyado.com#website\",\"name\":\"Voyado Docs\",\"url\":\"https://developer.voyado.com\",\"publisher\":{\"@id\":\"https://developer.voyado.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.voyado.com/docs/product-discovery/discovery-key#webpage\",\"url\":\"https://developer.voyado.com/docs/product-discovery/discovery-key\",\"name\":\"Boosting discoveryKey use\",\"dateModified\":\"2026-10-26T15:45:33.274Z\",\"isPartOf\":{\"@id\":\"https://developer.voyado.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.voyado.com/docs/product-discovery/discovery-key#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.voyado.com/docs/product-discovery/discovery-key#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Product Discovery\",\"item\":\"https://developer.voyado.com/docs/product-discovery/integration\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Boosting discoveryKey use\",\"item\":\"https://developer.voyado.com/docs/product-discovery/discovery-key\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developer.voyado.com/docs/product-discovery/discovery-key#article\",\"headline\":\"Boosting discoveryKey use\",\"name\":\"Boosting discoveryKey use\",\"url\":\"https://developer.voyado.com/docs/product-discovery/discovery-key\",\"mainEntityOfPage\":{\"@id\":\"https://developer.voyado.com/docs/product-discovery/discovery-key#webpage\"},\"dateModified\":\"2026-10-26T15:45:33.274Z\",\"publisher\":{\"@id\":\"https://developer.voyado.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.voyado.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Voyado Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Voyado Docs","nav":{"global":null,"versions":[{"version":"API version 3","tag":"Latest","tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/docs/introduction/about"}]},{"tab":"Integration","groups":[{"group":" ","pages":[{"title":"About integration","href":"/docs/integration/about-integration"},{"title":"Non-functional requirements","href":"/docs/api/non-functional-requirements"},{"title":"Custom triggers","sidebarTitle":"Custom triggers","href":"/docs/setup/custom-triggers"},{"title":"Stores","href":"/docs/setup/stores"}]},{"group":"Contacts","pages":[{"title":"Introduction to contacts","href":"/docs/contacts/about-contacts"},{"title":"Contact field definitions","href":"/docs/contacts/contact-field-definitions"},{"group":"Identify contact","pages":[{"title":"Find a contact","href":"/docs/contacts/identify-contact/find-contact"},{"title":"Get contact data","href":"/docs/contacts/identify-contact/get-contact-data"},{"title":"Get enriched profile","href":"/docs/contacts/identify-contact/get-enriched-profile"},{"title":"Soft identification","href":"/docs/contacts/identify-contact/soft-identification"},{"title":"Deep linking to contacts","href":"/docs/contacts/identify-contact/deep-linking"}]},{"title":"Create contact","href":"/docs/contacts/create-contact"},{"title":"Update contact","href":"/docs/contacts/update-contact"},{"title":"Delete contact","href":"/docs/contacts/delete-contact"},{"title":"Security best practices","href":"/docs/contacts/security-best-practices"},{"title":"Target audiences","href":"/docs/contacts/target-audiences"},{"title":"Consents","href":"/docs/setup/consents"},{"title":"Bulk contacts API","href":"/docs/contacts/bulk-contacts-api"},{"title":"NPS","href":"/docs/contacts/nps"}]},{"group":"Transactions","pages":[{"title":"Introduction to transactions","href":"/docs/transactions/introduction-to-transactions"},{"title":"Transaction field definitions","href":"/docs/transactions/transaction-field-definitions"},{"title":"Group currency","href":"/docs/transactions/group-currency"},{"title":"Register a purchase","href":"/docs/transactions/register-a-purchase"},{"title":"Register a return","href":"/docs/transactions/register-a-return"},{"title":"Discounts","href":"/docs/transactions/discounts"},{"title":"Purchase history summary","href":"/docs/transactions/purchase-history-summary"}]},{"group":"Orders","pages":[{"title":"Introduction to orders","sidebarTitle":"Introduction to orders","href":"/docs/orders/introduction-to-orders"},{"title":"Orders data structure","href":"/docs/orders/orders-data-structure"},{"title":"Orders API endpoints","href":"/docs/orders/orders-api-endpoints"},{"title":"Orders and actions","href":"/docs/orders/orders-and-actions"},{"title":"Order action schemas","href":"/docs/orders/order-action-schemas"}]},{"group":"Loyalty","pages":[{"title":"Introduction to loyalty","href":"/docs/loyalty/about-loyalty"},{"title":"Points","href":"/docs/loyalty/points"},{"title":"Point shop","href":"/docs/loyalty/point-shop"},{"title":"Vouchers","href":"/docs/loyalty/vouchers"},{"title":"Promotions","href":"/docs/loyalty/promotions"},{"title":"Challenges","href":"/docs/loyalty/challenges"},{"title":"Interactions","href":"/docs/loyalty/interactions"}]},{"group":"Product data","pages":[{"title":"Product feeds","href":"/docs/setup/product-feeds"},{"title":"Article register","href":"/docs/setup/article-register"}]},{"group":"Ratings and Reviews (BETA)","pages":[{"title":"Integrating Ratings and Reviews","sidebarTitle":"Ratings and Reviews","href":"/docs/ratings-and-reviews/ratings-and-reviews-integration"},{"title":"Migrating Ratings and Reviews","sidebarTitle":"Migrating reviews","href":"/docs/ratings-and-reviews/migrating-reviews"},{"title":"Ratings and Reviews product data","sidebarTitle":"Product data","href":"/docs/ratings-and-reviews/product-data"}]},{"group":"Product Discovery","pages":[{"title":"Integration with Product Discovery","description":null,"href":"/docs/product-discovery/integration"},{"title":"Boosting discoveryKey use","href":"/docs/product-discovery/discovery-key"},{"title":"Troubleshooting connected sessions","sidebarTitle":"Troubleshooting connected sessions","description":null,"href":"/docs/product-discovery/connected-sessions"}]}]},{"tab":"File based transfer","pages":[{"title":"File based transfer","href":"/docs/file-based-transfer/about-file-based-transfer"}]},{"tab":"Data access","pages":[{"title":"Data access","href":"/docs/data-access/overview"}]},{"tab":"E-com and communication","pages":[{"title":"E-com and communication","href":"/docs/communication/communication"}]},{"tab":"Partner integrations","pages":[{"title":"Partner integrations","href":"/docs/introduction/about-partner-integrations"}]},{"tab":"What's new?","pages":[{"title":"What's new?","href":"/docs/introduction/whats-new"}]}]},{"version":"API version 2","tag":"Legacy","pages":[{"title":"API version 2","href":"/docs-v2/api-v2"}]}]},"title":"Boosting discoveryKey use - Voyado Docs","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["10e4515597"],"chunks":["BannerMarkdown-B-Glu166.js","dist-zbf22OZA.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-Cs6nMGht.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}