Skip to main content

LiveRamp RampID

LiveRamp RampID

DirectionDestination
Environment
Web
Capability
Identity Signal
SDK RequiredYes
Product(s) RequiredCore Platform

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.

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.
Key features of the RampID integration:
  • 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
Use cases include:
  • 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
RampID identifiers are not ingested into Permutive’s identity graph. They are ephemeral signals generated at bid time and passed directly to the bidstream. These IDs cannot be used for Permutive cohort building, identity resolution, or data collaboration features.
Amazon Publisher Services (APS) SupportIn addition to Prebid, this integration also supports Amazon Publisher Services (APS) for bidstream activation. APS support is currently available on request. If you’re interested in using APS, please contact your Customer Success Manager to discuss setup and requirements.

Environment Compatibility

EnvironmentSupportedNotes
WebYesFull support via Permutive SDK and Prebid module
iOSNoNot supported - RampID focuses on web-based identity
AndroidNoNot supported - RampID focuses on web-based identity
CTVNoNot supported
API DirectNoNot supported

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

1

Sign Up for LiveRamp Account

Register for a LiveRamp account and establish your partnership:
  1. Visit liveramp.com and complete the publisher registration process
  2. Work with your LiveRamp account representative to set up your partnership agreement
  3. Accept LiveRamp’s terms of service for the Authenticated Traffic Solution (ATS)
  4. Navigate to your LiveRamp account dashboard and copy your Partner ID (you’ll need this in the next step)
RampID is free for publishers to use. Advertisers pay LiveRamp to decrypt the identity envelopes in the bidstream.
2

Configure Consent Management

Add LiveRamp to your Consent Management Platform:
  1. Log in to your CMP dashboard
  2. Add LiveRamp to your TCF vendor list (LiveRamp’s TCF Vendor ID is typically 97)
  3. 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
  4. Test that consent is properly collected and LiveRamp appears in your consent string
If LiveRamp is not properly configured in your CMP, the integration will not generate identifiers, even if enabled in Permutive.
3

Enable Prebid Identity Manager Module

Ensure the Permutive Identity Manager ID System module is included in your Prebid build:
  1. Check your current Prebid configuration or contact your Prebid implementation team
  2. If the module is not already included, rebuild Prebid with the permutiveIdentityManagerIdSystem module
  3. Deploy the updated Prebid build to your website
The Permutive Identity Manager module is separate from the standard Permutive RTD module. Both can coexist in your Prebid setup. For detailed Prebid configuration instructions including the Identity Manager module setup, see our Prebid integration guide.
4

Enable RampID in Permutive Dashboard

Activate the RampID integration in Permutive:
  1. Navigate to IdentityCatalog in your Permutive dashboard
  2. Locate LiveRamp RampID in the identity provider catalog
  3. Click Connect to begin the configuration process
  4. Enter your LiveRamp Partner ID when prompted
  5. Configure any additional settings as needed
  6. Save the configuration
The Permutive SDK will automatically begin retrieving RampID identifiers on your next SDK build.
5

Verify Setup

Confirm that RampID identifiers are being generated and passed to Prebid:
  1. Open your website in a browser with developer tools enabled
  2. Navigate to the Console tab
  3. Look for Permutive SDK log messages indicating RampID initialization
  4. Check the Network tab for API calls to LiveRamp’s endpoints (typically ats.rlcdn.com or api.rlcdn.com)
  5. Inspect Prebid bid requests to verify that eids array contains RampID identifiers
Expected behavior:
  • LiveRamp API calls should complete successfully (HTTP 200)
  • Prebid bid requests should include RampID in the user.eids array with source liveramp.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

An encrypted identity envelope generated by LiveRamp and passed to demand-side platforms through Prebid’s Extended ID (EID) format.
source
string
Always set to liveramp.com to identify the LiveRamp RampID provider in the bidstream
uids[].id
string
The encrypted RampID identity envelope. This is an ephemeral identifier that varies across requests and cannot be used for long-term tracking. The envelope is encrypted specifically for programmatic use and can only be decrypted by authorized advertisers who pay LiveRamp for access.
uids[].atype
integer
Authentication type indicator. Typically set to 3 (authenticated) for RampID identifiers derived from hashed emails, or 1 for probabilistic signals
uids[].ext.rtiPartner
string
LiveRamp’s RTI (Real-Time Identity) partner identifier, typically set to idl (Identity Link)
RampID identifiers are not stored in Permutive’s identity graph or made available for cohort building. They exist solely for bidstream activation. The encrypted envelopes ensure privacy while enabling advertiser recognition.

Troubleshooting

If RampID identifiers are not showing up in your Prebid bid requests:Check consent configuration:
  • 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
Verify Prebid module:
  • Confirm the Permutive Identity Manager ID System module is compiled into your Prebid build
  • Check that no Prebid configuration is blocking RampID from the eids array
  • Review Prebid console logs for initialization errors
  • Ensure your Prebid version is up to date (module requires Prebid.js 5.0+)
Confirm dashboard configuration:
  • 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
Network connectivity:
  • 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)
If you’re having trouble obtaining your LiveRamp Partner ID:
  1. Ensure you’ve completed the full partnership agreement with LiveRamp (not just a basic account registration)
  2. Check your email for confirmation or welcome messages from LiveRamp with account details
  3. Log in to your LiveRamp dashboard - the Partner ID is typically displayed in account settings or integration sections
  4. Contact your LiveRamp account representative if you cannot locate your Partner ID
  5. Verify you have access to the Authenticated Traffic Solution (ATS) product specifically
Common issue: Publishers sometimes confuse different LiveRamp products. The RampID integration requires the ATS (Authenticated Traffic Solution) product, not the Data Marketplace or other LiveRamp offerings.
If you’re new to LiveRamp, your account representative can provide detailed onboarding guidance and help you locate all necessary credentials.
If you’re seeing lower than expected RampID coverage:User consent factors:
  • 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
Email collection factors:
  • 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 tag email_sha256
Technical factors:
  • 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
Measurement:
  • 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)
Optimization strategies:
  • 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
Publishers who collect and pass hashed emails typically see 2-3x higher RampID coverage compared to those relying on probabilistic signals alone.
If you already have LiveRamp ATS deployed directly on your site:The Permutive RampID integration can coexist with direct LiveRamp implementations, but there may be redundant API calls and potential conflicts. Consider:
  1. Keep existing implementation: If your direct LiveRamp integration is working well and meets all your needs, you may not need the Permutive integration
  2. 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
  3. Coordinate with LiveRamp: Contact LiveRamp support to ensure both implementations are configured optimally if you need both
  4. Avoid duplicate calls: Ensure you’re not making duplicate API calls for the same user, which can impact performance
Performance consideration: Running duplicate RampID implementations may result in unnecessary API calls and increased page load time. Consolidating to a single implementation is recommended.Migration path: If migrating from direct integration to Permutive:
  • Disable the direct LiveRamp ATS script
  • Enable RampID in Permutive dashboard
  • Wait for new SDK build
  • Test thoroughly before removing old implementation entirely
If you’ve enabled RampID but haven’t seen changes in CPMs or fill rates:Measurement timeframe:
  • 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
Demand-side adoption:
  • 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
Coverage factors:
  • 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
Analysis approach:
  • 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
Partnership optimization:
  • 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
RampID’s value proposition varies by publisher based on audience composition, demand partners, email collection rates, and existing identity solutions. Publishers with high email collection rates and strong authenticated audiences typically see the most significant uplift.
If you’re passing hashed emails but RampID isn’t recognizing them:Email normalization:
  • Emails must be lowercase before hashing
  • Remove all leading and trailing whitespace
  • Do not include any additional characters or encoding
Correct hashing format:
// CORRECT - proper normalization and hashing
const email = "  [email protected]  ";
const normalized = email.toLowerCase().trim(); // "[email protected]"
const hashed = await sha256(normalized); // proper SHA-256 hash
Common mistakes:
  • 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)
Verification:
  • 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_sha256 when calling identify()
Always hash emails client-side before sending to Permutive. Never send plaintext emails to any third-party service.

Changelog

For detailed changelog information, visit our Changelog.