Integration Options

iFrame Embed

The simplest way to integrate AdBox is by embedding it in an iFrame within your existing application.

Basic Implementation

<iframe
  src="https://app.symphony.to/demo/adbox/{your-partner-id}"
  width="100%"
  height="800"
  frameborder="0"
  allow="payment"
  style="border: none; border-radius: 8px;"
></iframe>

Responsive Implementation

For a fully responsive experience:

<div style="position: relative; width: 100%; padding-bottom: 150%; min-height: 600px;">
  <iframe
    src="https://app.symphony.to/demo/adbox/{your-partner-id}"
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: none;"
    frameborder="0"
    allow="payment"
  ></iframe>
</div>

React Component Example

const AdBoxEmbed = ({ partnerId }: { partnerId: string }) => {
  return (
    <div className="adbox-container" style={{ width: '100%', minHeight: '800px' }}>
      <iframe
        src={`https://app.symphony.to/demo/adbox/${partnerId}`}
        style={{
          width: '100%',
          height: '100%',
          border: 'none',
          borderRadius: 8
        }}
        allow="payment"
        title="Symphony AdBox"
      />
    </div>
  );
};

Important Notes for iFrame

• Payment Permissions: Include allow="payment" to enable Stripe checkout within the iFrame
• Height: AdBox content is dynamic—consider using a minimum height of 800px or making the container scrollable
• Mobile: The AdBox is fully responsive and works well on mobile devices
• Cross-Origin: The iFrame works cross-origin out of the box

Custom Domain

For a more seamless, branded experience, you can point your own subdomain to Symphony's AdBox.

How It Works

1. Choose a subdomain (e.g., ads.yourplatform.com)
2. Add a DNS record pointing to Symphony
3. We configure SSL and routing on our end
4. Your users visit ads.yourplatform.com and see your branded AdBox

DNS Configuration

Add a CNAME record to your DNS settings.

What Your Users See

• URL: https://ads.yourplatform.com
• Branding: Your logo, colors, and partner configuration
• Experience: Identical to the hosted version, but on your domain

Benefits of Custom Domain

• ✅ Brand Consistency: Users stay on your domain
• ✅ Trust: No third-party URLs visible to users
• ✅ SEO: Your domain gets the traffic
• ✅ Professional: Looks like a native feature of your platform

Setup Time

Custom domain setup typically takes 24-48 hours after DNS propagation.