iframe (embed URL)

This is a page URL, not a JSON API. Put it in the src of an
<iframe> on your site. Fusion renders the offerwall, runs any
pre-screener, and sends the respondent into the survey — all inside
the frame. Completions are reported to you by server-to-server
postback, exactly as with the hosted Offerwall.

Getting the snippet

In the supplier portal, open Redirect Settings → iFrame Settings
(shown once Offerwall is enabled on your account). Enter a
Respondent ID and Locale (plus an optional Member ID), click
Generate Iframe Code, and copy the result:

publisherId, currency and conversion are filled in from your
account's Offerwall Settings. You can also build the URL yourself
using the parameters below — the generator is a convenience, not a
requirement.

Replace respondentId (and memberId) per session. The
generator emits whatever you typed into the form. Your page must
inject the real, unique session ID for each respondent before the
iframe loads — a hard-coded value means every respondent shares one
session and completes cannot be credited correctly.

Redirects inside the frame

After a survey, Fusion redirects the respondent according to your
Complete and Non-Complete redirect settings. In an iframe
that redirect happens inside the frame:

Redirect to Offerwall (recommended for iframe): the respondent
lands back on the offerwall with a localized message
("You completed the survey and will be credited! Would you like to
try another?" or "This survey wasn't a good fit! Would you like to
try another?") and can pick another offer. Fusion appends
complete=true or nonComplete=true to the offerwall URL to
trigger the message; you do not need to handle these.

Redirect to Publisher URL: your redirect URL loads inside the
800px frame. Only choose this if that URL is designed to be framed
(e.g. a small "thank you" page), or handle it with your own script
on that page.

Technical notes

Fixed size: the snippet uses width="100%" height="800px". The
page is mobile responsive within that width; there is no automatic
height resizing or messaging to the parent page.

No cookie dependence: the offerwall keeps all respondent state in
the URL, so third-party-cookie blocking in embedded contexts does
not affect it.

Serve the parent page over HTTPS. The offerwall is HTTPS-only
and browsers block mixed content.

Pass as many profile parameters as you can (qualification ID =
value, e.g. 211=1&212=34&229=90210) and a persistent memberId
so already-attempted surveys are removed from the offers shown.

Use the staging host while integrating. Ask your account manager
for a staging publisher ID and test values.

text/html

HTML offerwall page rendered inside the iframe. If publisherId, respondentId or countryCode is missing or invalid, the page shows a localized error state instead of offers (still HTTP 200 — this is a single-page app, not an API).

Getting the snippet

Redirects inside the frame

Technical notes

Request

Request Code Samples

Responses

iframe (embed URL)

Getting the snippet#

Redirects inside the frame#

Technical notes#

Request

Request Code Samples

Responses

Getting the snippet

Redirects inside the frame

Technical notes