ezID (Ezoic Identity) is a privacy-safe solution that connects your first-party data—like email subscriber lists—to premium identity providers. By identifying high-value users through hashed emails or phone numbers, ezID allows advertisers to bid more aggressively on your traffic, significantly improving your revenue performance in a cookie-less environment.
The first step is to bring your existing audience data into the ezID ecosystem. Click the "Connect or Upload Your List" button on the ezID tab to begin.
Email Service Providers: Sync directly with platforms like Mailchimp, ActiveCampaign, Beehiiv, MailerLite, or Kit.
CSV Upload: If you have a custom list, you can upload it manually.
Managing Multiple Lists: From the Manage Lists, you can track the status of individual imports, see your total subscriber count (e.g., "623 Total Subscribers"), and ensure that your sync status is "Completed."
The New Subscribers graph on your Overview page provides a real-time look at how your identified audience is growing.
Date Range Filtering: Use the date picker to monitor spikes in identification, typically following a newsletter blast or a successful login campaign.
Account Selection: If you have multiple sites or email providers linked, you can filter this graph to see which source is driving the most identified users.
To begin, navigate to the ezID icon in your top navigation bar or go directly to the Identity Dashboard.
The most common way to identify users is through your existing newsletter subscribers.
Direct Integration: Ezoic offers native API connections for popular providers like Mailchimp, ActiveCampaign, Beehiiv, MailerLite, and Kit.
Manual Upload: If you use a different provider, you can upload your list via a CSV file.
Automatic Tagging: Once linked, Ezoic can automatically add a unique ID to your outbound newsletter links. When a subscriber clicks a link to your site, they are instantly "identified."
Once your list is synced, you must ensure Ezoic can recognize these users when they visit your site.
Click the "Embedding IDs in Links" button.
Follow the instructions to add the unique subscriber ID (ZID) to your outbound newsletter links as a UTM parameter (e.g., ?utm_content=zid-12345).
When a user clicks this link, Ezoic automatically reads the ID and matches them to your synced data.
You can allow Ezoic to automatically collect first-party data from login forms or newsletter sign-ups on your site.
Go to EzoicAds > Ad Positions and enable "Data Collection" to allow sharing data with identity partners (like UID2 by The Trade Desk).
This allows the system to capture and hash emails in real-time as users engage with your site.
The left-hand sidebar contains two critical tools for enhancing your data collection:
Google One Tap: Enable this to prompt Chrome users to sign in with one click. This is the fastest way to grow your "Identified" audience percentage. Instrcutions here.
Privacy Controls: Under Privacy Controls, you will find the Identity Privacy Opt Out toggle.
Note: Enabling this will prevent ezID from saving any email addresses or phone numbers passed from your site. Use this if you need to temporarily suspend data collection for specific compliance reasons.
If you have already integrated your email or phone service provider with Ezoic, or if you run a custom membership site, you can pass the custom user ID (also known as zuserid or zid) directly via JavaScript. This ensures that even logged-in users who didn't arrive via a newsletter link can be identified.
Integrated Email Service IDs
Use this snippet to pass the User ID to ezID:
window.ezoicIdentity = window.ezoicIdentity || {};
window.ezoicIdentity.queue = window.ezoicIdentity.queue || [];
window.ezoicIdentity.queue.push(function(){
window.ezoicIdentity.setIdentity({
userid: USER_ID
});
});Use this snippet to pass the hashed email to ezID:
window.ezoicIdentity = window.ezoicIdentity || {};
window.ezoicIdentity.queue = window.ezoicIdentity.queue || [];
window.ezoicIdentity.queue.push(function(){
window.ezoicIdentity.setIdentity({
md5: MD5_HASHED_EMAIL,
sha256: SHA256_HASHED_EMAIL,
sha1: SHA1_HASHED_EMAIL
});
});Additional documentation for more advanced settings can be found here.
If you've already integrated your email service provider with Ezoic, you can pass the custom user ID, also known by zuserid or zid, via the JS.
window.ezoicIdentity = window.ezoicIdentity || {};
window.ezoicIdentity.queue = window.ezoicIdentity.queue || [];
window.ezoicIdentity.queue.push(function(){
window.ezoicIdentity.setIdentity({
userid: USER_ID
});
});
If you've already integrated your phone notification service provider with Ezoic, you can pass the custom user ID, also known by zuserid or zid in the phone service provider, via the JS.
window.ezoicIdentity = window.ezoicIdentity || {};
window.ezoicIdentity.queue = window.ezoicIdentity.queue || [];
window.ezoicIdentity.queue.push(function(){
window.ezoicIdentity.setPhoneNumber({
userid: USER_ID
});
});
When passing a hashed email address, please note the following:
john.smith@gmail.com should look like johnsmith@gmail.com before hashing@: johnsmith+home@gmail.com to johnsmith@gmail.comTo pass a hashed email address, you can call the following function to pass either sha256, md5, or sha1 hashes of a user's plaintext email address.
window.ezoicIdentity = window.ezoicIdentity || {};
window.ezoicIdentity.queue = window.ezoicIdentity.queue || [];
window.ezoicIdentity.queue.push(function(){
window.ezoicIdentity.setIdentity({
md5: MD5_HASHED_EMAIL,
sha256: SHA256_HASHED_EMAIL,
sha1: SHA1_HASHED_EMAIL
});
});
You may also submit an unhashed email which Ezoic will hash for you for maximum coverage before passing it to our vendors.
window.ezoicIdentity = window.ezoicIdentity || {};
window.ezoicIdentity.queue = window.ezoicIdentity.queue || [];
window.ezoicIdentity.queue.push(function(){
window.ezoicIdentity.setIdentity({
email: PLAINTEXT_EMAIL
});
});
When providing a phone number, you are able to pass in either a hashed or unhashed phone number. If you pass in only an unhashed phone number, Ezoic will hash it for you before passing it to our vendors. You are also able to hash the phone number yourself using the SHA-256 algorithm and provide only the hash when calling the function. When hashing the phone number, please note the following before hashing:
[+][country code][area code][local phone number]1(234)567-8901 would be normalized to +1234567890165 1234 5678 would be normalized to +6512345678(02) 1234 5678 is normalized to drop the leading zero for the city then prepend the country code to +61212345678You can include a user id or email hash in any url parameter formatted to the below specification and Ezoic will automatically read the parameter from the URL and provide the identity information to advertising providers. You can include these in links, email campaigns, logins, and more!
*We recommend using a UTM parameter, though any parameter will work.
Here are some examples of accepted values:
If using one of our supported providers, further information regarding the adding of UTM tags to links can be found via the relevant links below:
Ensure your CSV file is formatted correctly with a clear header for "Email." If the sync status remains "Pending" for more than 24 hours, try re-uploading the file or checking the Manage Lists section for specific error messages.
The system creates a session cookie called ezidentity to hold the secure hashes. If you don't see this in your browser's developer tools, ensure that your Privacy Script (the CMP) is loading correctly and that you haven't enabled the Identity Privacy Opt Out in your dashboard.
Check that the parameter in your URL exactly matches the specification (e.g., ?utm_content=zid-12345). If your newsletter provider automatically strips or renames UTM tags, you may need to manually configure them to include the zid prefix.
Yes. ezID never shares plaintext personal information. It uses one-way cryptographic hashing (SHA-256) to anonymize data before it ever reaches an advertiser. Furthermore, users can opt-out via your site’s consent modal.
Yes, if you have Google One Tap enabled. This allows ezID to identify users through their Google account even if they haven't subscribed to your newsletter yet.
No. The JavaScript used for ezID is lightweight and loads asynchronously, meaning it does not block the rendering of your content or ads.
If you need further assistance with Ezoic Identi, please log in via support.ezoic.com to make use of our dedicated resources for support. We're here to help!
