Skip to content

Publisher Platform Whitelabel Setup Guide

Overview

Whitelabeling is a feature that allows external publishers to run our application on their own custom domain. This provides a seamless branded experience for publishers while maintaining the functionality of our platform.

What is Whitelabeling?

Whitelabeling enables publishers to: - Host our application on their custom domain (e.g., offers.publisherdomain.com) - Maintain their brand identity and user experience - Use a single domain across multiple campaigns and vendors - Provide a trusted, branded experience to their users

Technical Architecture

The whitelabel solution is built using: - AWS CloudFront - Content delivery network for global performance - AWS Certificate Manager (ACM) - SSL/TLS certificate management for secure connections - DNS validation - Domain ownership verification process

Prerequisites

Before starting the whitelabel setup process, ensure you have: - A custom domain or subdomain you want to use (e.g., offers.yourdomain.com) - Access to your domain's DNS management system - Authority to add DNS records to your domain

Setup Process

Step 1: Domain Submission

  1. Provide your domain name to our technical team
  2. Submit the exact domain/subdomain you want to use

  3. Example: offers.publisherdomain.com or campaigns.yourbrand.com

  4. Domain validation initiation

  5. Our team will add your domain to AWS Certificate Manager
  6. This triggers the domain validation process

Step 2: DNS Validation

  1. Receive DNS records
  2. Our team will provide you with specific DNS records for validation

  3. These records prove you own the domain

  4. DNS record format 

    Type: CNAME
Name: _validation_string.yourdomain.com
Value: _validation_value.acm-validations.aws.

  5. Add DNS records

  6. Log into your DNS management system
  7. Add the provided CNAME records exactly as specified
  8. DNS propagation may take up to 24-48 hours

Step 3: CloudFront Configuration

  1. Domain verification
  2. Once DNS validation is complete, our team will be notified

  3. The SSL certificate will be automatically issued

  4. CloudFront distribution update

  5. Your domain will be added to our CloudFront distribution

  6. This enables your custom domain to serve our application

  7. Final DNS configuration

  8. You'll receive the final CNAME record to point your domain to CloudFront 
    Type: CNAME
Name: offers.yourdomain.com
Value: d123456789.cloudfront.net

Step 4: Go Live

  1. Domain accessibility
  2. Your custom domain will now serve our application

  3. SSL certificate ensures secure HTTPS connections

  4. Testing and verification

  5. Test the domain functionality
  6. Verify SSL certificate is working correctly
  7. Confirm all features are accessible

Domain Usage

Single Domain, Multiple Uses

Important: A single whitelabel domain can be used across: - ✅ Any campaign on the publisher platform - ✅ Any vendor within the publisher platform - ✅ Multiple concurrent campaigns

You do NOT need: - ❌ Separate domains for each campaign - ❌ New whitelabel setup for each vendor - ❌ Multiple SSL certificates

Example Usage Scenarios

Domain: offers.publisherdomain.com

✅ Campaign A with Vendor 1: offers.publisherdomain.com/campaign-a
✅ Campaign B with Vendor 2: offers.publisherdomain.com/campaign-b  
✅ Campaign C with Vendor 1: offers.publisherdomain.com/campaign-c

Branding and Customization

Creative Team Handoff

Once your domain is live:

  1. Logo and styling requirements are referred to our Creative team
  2. Brand assets can be customized to match your brand guidelines
  3. Visual elements are managed through our creative workflow

What Can Be Customized

  • Company logos and branding
  • Color schemes and themes
  • Custom styling elements
  • Brand-specific messaging

Timeline

Phase Duration Description
Domain Submission 1 business day Submit domain to technical team
DNS Validation 1-3 business days Add DNS records and wait for validation
CloudFront Setup 1 business day Configure distribution and final DNS
Creative Customization 3-5 business days Logo and styling implementation
Total Timeline 5-10 business days Complete whitelabel setup

Troubleshooting

Common Issues

DNS Validation Fails - Verify DNS records are added exactly as provided - Check for typos in record names or values - Allow up to 48 hours for DNS propagation

Domain Not Accessible - Confirm final CNAME record is correctly configured - Check if DNS changes have propagated globally - Verify CloudFront distribution is deployed

SSL Certificate Issues - Ensure domain validation was successful - Check that HTTPS is being used in URLs - Contact technical support if certificate errors persist

Getting Help

For technical assistance: 1. Contact your technical representative 2. Provide your domain name and specific error details 3. Include screenshots of DNS configuration if applicable

Security Considerations

SSL/TLS Security

  • All whitelabel domains use industry-standard SSL/TLS encryption
  • Certificates are automatically managed and renewed by AWS
  • HTTPS is enforced for all connections

Domain Security

  • Only validated domains can be added to the platform
  • DNS validation ensures domain ownership
  • Regular security monitoring and updates

Best Practices

Domain Selection

  • Use a subdomain (e.g., offers.yourdomain.com) rather than your main domain
  • Choose a memorable, brand-appropriate subdomain name
  • Avoid special characters or complex naming

DNS Management

  • Keep DNS records properly documented
  • Use reliable DNS providers with good uptime
  • Monitor DNS changes and maintain access to DNS management

Ongoing Maintenance

  • Monitor domain performance and accessibility
  • Keep contact information updated with our team
  • Report any issues promptly for quick resolution

FAQ

Q: Can I use multiple domains for different campaigns? A: While possible, it's not necessary. A single domain can serve all your campaigns and vendors efficiently.

Q: How long does the setup process take? A: Typically 5-10 business days from domain submission to full deployment, including creative customization.

Q: What if I need to change my domain later? A: Contact our technical team to discuss domain changes. The process is similar to initial setup.

Q: Is there any downtime during setup? A: No, the setup process doesn't affect your existing campaigns or platform access.

Q: Can I use my root domain (e.g., publisherdomain.com)? A: We recommend using a subdomain for better flexibility and DNS management.

Contact Information

For whitelabel setup requests or technical support: - Technical Team: [Contact details to be added] - Creative Team: [Contact details to be added] - Account Management: [Contact details to be added]

Last updated: [Date to be added] Version: 1.0