LiveRamp RampID
LiveRamp RampID is a privacy-first, people-based identity solution that enables publishers to maximize programmatic revenue through deterministic and probabilistic user recognition across the open web.
Setup
Troubleshooting
Overview
LiveRamp RampID is an industry-leading identity solution that provides publishers with a people-based identifier to improve addressability in programmatic advertising. The RampID integration with Permutive allows publishers to deploy LiveRamp’s Authenticated Traffic Solution (ATS) through the Permutive SDK without additional implementation work. This integration is a Destination integration:- Destination: Permutive retrieves RampID ephemeral identity envelopes and passes them to the programmatic bidstream via Prebid or Amazon Publisher Services (APS), enabling demand-side platforms (DSPs) to recognize users and improve match rates.
- Deterministic and Probabilistic Matching: Uses both hashed emails and probabilistic signals for comprehensive coverage
- No-Code Integration: Enable via Permutive dashboard without additional implementation
- Privacy-First: Ephemeral envelopes for bidstream use only, with automatic TCF consent handling
- Industry Standard: Widely adopted across the advertising ecosystem with strong DSP and SSP support
- Yield Optimization: Enrich programmatic bids with RampID envelopes to increase CPMs and fill rates
- Maximize addressability in a cookie-restricted environment with authenticated and probabilistic signals
Environment Compatibility
Prerequisites
Before enabling the RampID integration, ensure you have the following. These prerequisites are for Prebid integration; for APS integration, contact your Customer Success Manager.-
LiveRamp Partner Account: You must have a LiveRamp partnership agreement to use RampID. This typically requires:
- Signing up for a LiveRamp account at liveramp.com
- Accepting LiveRamp’s terms of service
- Obtaining your unique Partner ID from your LiveRamp account dashboard
- Note: While publishers can use RampID for free (advertisers pay to decrypt the IDs), you need to register and establish a partnership
-
Consent Management: RampID must be added to your Consent Management Platform (CMP) as an approved vendor in your TCF vendor list. Without proper consent configuration, RampID will not generate identifiers.
- Add LiveRamp as a vendor in your TCF implementation
- Ensure required TCF purposes are configured (consult LiveRamp documentation for specific requirements)
- LiveRamp typically requires Purpose 1 (Store and/or access information on a device) and may require additional purposes
-
Prebid Integration: The RampID integration requires the Permutive Identity Manager Prebid module to be enabled. This is a specialized Prebid module separate from the standard Permutive RTD module.
- The Permutive Identity Manager ID System module must be compiled into your Prebid build
- See our Prebid integration guide for complete setup instructions including the Identity Manager module configuration
- Permutive SDK: The Permutive Web SDK must be deployed and operational on your website
-
Hashed Email Collection (Optional but Recommended): While RampID can work with probabilistic signals alone, maximum effectiveness is achieved when you collect and hash user email addresses:
- Implement email collection through registration, newsletter signup, or authentication
- Hash emails using SHA-256 before passing to Permutive
- Store hashed emails in Permutive’s identity graph via the SDK’s
identify()method
Setup
- Primary Setup Steps
- Web
Sign Up for LiveRamp Account
- Visit liveramp.com and complete the publisher registration process
- Work with your LiveRamp account representative to set up your partnership agreement
- Accept LiveRamp’s terms of service for the Authenticated Traffic Solution (ATS)
- Navigate to your LiveRamp account dashboard and copy your Partner ID (you’ll need this in the next step)
Configure Consent Management
- Log in to your CMP dashboard
- Add LiveRamp to your TCF vendor list (LiveRamp’s TCF Vendor ID is typically 97)
- Ensure the required TCF purposes are enabled for LiveRamp:
- Purpose 1: Store and/or access information on a device (required)
- Additional purposes as specified by LiveRamp
- Test that consent is properly collected and LiveRamp appears in your consent string
Enable Prebid Identity Manager Module
- Check your current Prebid configuration or contact your Prebid implementation team
- If the module is not already included, rebuild Prebid with the
permutiveIdentityManagerIdSystemmodule - Deploy the updated Prebid build to your website
Enable RampID in Permutive Dashboard
- Navigate to Identity → Catalog in your Permutive dashboard
- Locate LiveRamp RampID in the identity provider catalog
- Click Connect to begin the configuration process
- Enter your LiveRamp Partner ID when prompted
- Configure any additional settings as needed
- Save the configuration
Verify Setup
- Open your website in a browser with developer tools enabled
- Navigate to the Console tab
- Look for Permutive SDK log messages indicating RampID initialization
- Check the Network tab for API calls to LiveRamp’s endpoints (typically
ats.rlcdn.comorapi.rlcdn.com) - Inspect Prebid bid requests to verify that
eidsarray contains RampID identifiers
- LiveRamp API calls should complete successfully (HTTP 200)
- Prebid bid requests should include RampID in the
user.eidsarray with sourceliveramp.com
Data Types
The RampID integration does not collect event data into Permutive. Instead, it provides ephemeral identity signals that are passed directly to the programmatic bidstream via Prebid.Identity Signals Transmitted
LiveRamp RampID
LiveRamp RampID
liveramp.com to identify the LiveRamp RampID provider in the bidstream3 (authenticated) for RampID identifiers derived from hashed emails, or 1 for probabilistic signalsidl (Identity Link)Troubleshooting
RampID identifiers not appearing in bid requests
RampID identifiers not appearing in bid requests
- Verify LiveRamp is listed in your TCF vendor list (typically Vendor ID 97)
- Ensure required TCF purposes are granted (at minimum Purpose 1)
- Check the browser console for consent-related errors
- Test in a fresh browser session or incognito mode to rule out cached consent states
- Verify the consent string includes LiveRamp using browser developer tools
- Confirm the Permutive Identity Manager ID System module is compiled into your Prebid build
- Check that no Prebid configuration is blocking RampID from the
eidsarray - Review Prebid console logs for initialization errors
- Ensure your Prebid version is up to date (module requires Prebid.js 5.0+)
- Navigate to Identity → Catalog in Permutive dashboard
- Verify RampID shows as “Connected” or “Enabled”
- Ensure your LiveRamp Partner ID is correctly entered
- Check that an SDK build has occurred since enabling RampID
- Check browser developer tools Network tab for failed API calls to LiveRamp endpoints (
ats.rlcdn.com,api.rlcdn.com) - Verify no ad blockers or content security policies are blocking LiveRamp requests
- Test from different networks to rule out firewall or proxy issues
- Ensure HTTPS is enabled (LiveRamp requires secure connections)
LiveRamp account setup and Partner ID location
LiveRamp account setup and Partner ID location
- Ensure you’ve completed the full partnership agreement with LiveRamp (not just a basic account registration)
- Check your email for confirmation or welcome messages from LiveRamp with account details
- Log in to your LiveRamp dashboard - the Partner ID is typically displayed in account settings or integration sections
- Contact your LiveRamp account representative if you cannot locate your Partner ID
- Verify you have access to the Authenticated Traffic Solution (ATS) product specifically
Low RampID match rates or coverage
Low RampID match rates or coverage
- RampID only generates identifiers for users who grant consent
- In regions with strict privacy regulations (EU, California), consent rates may be lower
- Review your consent management strategy and consent request UI
- Consider A/B testing different consent messaging to improve opt-in rates
- RampID performs best when publishers collect and pass hashed email addresses
- If you’re not collecting emails, consider implementing registration or newsletter signup
- Ensure emails are properly hashed (SHA-256, lowercase, trimmed of whitespace)
- Verify hashed emails are being passed to Permutive via the
identify()method with tagemail_sha256
- Users with strict browser privacy settings may block RampID’s signals
- Safari’s Intelligent Tracking Prevention (ITP) may limit effectiveness in some scenarios
- Incognito/private browsing modes may reduce match rates
- Ad blockers may interfere with LiveRamp API calls
- Use the Identity Insights dashboard in Permutive to view RampID coverage metrics
- Compare RampID coverage to other identity solutions to establish a baseline
- Monitor coverage trends over time to identify sudden changes that may indicate technical issues
- Analyze coverage by user segment (authenticated vs. anonymous, new vs. returning)
- Implement hashed email collection to significantly boost match rates
- Ensure your consent UI clearly explains the value exchange for users
- Work with LiveRamp to understand their recommended best practices for your specific use case
- Consider implementing progressive registration to gradually collect user data
RampID integration conflicts with existing LiveRamp implementation
RampID integration conflicts with existing LiveRamp implementation
- Keep existing implementation: If your direct LiveRamp integration is working well and meets all your needs, you may not need the Permutive integration
- Migrate to Permutive: Remove your direct LiveRamp implementation and manage everything through Permutive for:
- Simplified operations (single dashboard)
- Reduced JavaScript overhead
- Unified identity management across all providers
- Better performance monitoring
- Coordinate with LiveRamp: Contact LiveRamp support to ensure both implementations are configured optimally if you need both
- Avoid duplicate calls: Ensure you’re not making duplicate API calls for the same user, which can impact performance
- Disable the direct LiveRamp ATS script
- Enable RampID in Permutive dashboard
- Wait for new SDK build
- Test thoroughly before removing old implementation entirely
No visible impact on programmatic revenue
No visible impact on programmatic revenue
- Allow at least 2-4 weeks for measurable impact
- Programmatic revenue fluctuates naturally; compare equivalent time periods before and after RampID enablement
- Consider seasonal factors that may affect baseline performance
- Not all DSPs and advertisers decrypt and utilize RampID identifiers
- The value of RampID depends on your specific demand partners and their LiveRamp integrations
- Contact your SSP or programmatic partners to confirm they support RampID
- Ask which DSPs in your auctions are actively bidding on RampID-enabled inventory
- Low RampID coverage (percentage of impressions with RampID) will limit revenue impact
- Review coverage metrics in Permutive Identity Insights
- If coverage is below 30-40%, consider implementing hashed email collection
- Review Prebid analytics to see bid density changes in auctions with RampID present
- Compare win rates for bid requests with vs. without RampID identifiers
- Analyze CPM lift for impressions with RampID vs. without
- Segment analysis by geography, device type, and user segment
- Consult with your ad operations team or programmatic partner for detailed analysis
- Work with LiveRamp to ensure your partnership is properly configured
- Verify that your inventory is eligible for LiveRamp’s demand partnerships
- Discuss with SSPs about enabling RampID-specific deal IDs or PMPs
- Consider participating in LiveRamp’s publisher monetization programs
Hashed email format errors or rejection
Hashed email format errors or rejection
- Emails must be lowercase before hashing
- Remove all leading and trailing whitespace
- Do not include any additional characters or encoding
- Using MD5 or SHA-1 instead of SHA-256
- Hashing the email without normalizing (lowercase, trim)
- Double-hashing the email
- Including salt or pepper in the hash
- Base64 encoding the hash (LiveRamp expects hexadecimal)
- Test your hashing implementation with a known email
- Use online SHA-256 tools to verify your output matches
- Check Permutive SDK logs for identifier rejection messages
- Verify the tag is set to
email_sha256when callingidentify()