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

Choose a subdomain (e.g., ads.yourplatform.com)
Add a DNS record pointing to Symphony
We configure SSL and routing on our end
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.