iFrame Intro

Welcome to the Cherries iFrame! The integration of the iFrame is easy and only takes a few minutes.

<iframe width="100%" src="https://grabcherries.com/wall?pid={panelist_id}&sid={supplier_code}"></iframe>

<iframe width="100%" src="https://grabcherries.com/wall?pid={panelist_id}&sid={supplier_code}&email={email}&gender={gender_profiler}&date_of_birth={dob}&postal_code={postal_code}&hash={URL_HASH}"></iframe>

You can integrate a basic iFrame by including just the panelist id (pid) and your supplier code (sid). Or you can pass us additional identifier or demographic information in the entry URL to improve the user experience.

Paramater
`pid` ❗required	A unique panelist id assigned by the supplier. This should be distinct for each user. Max characters: 100.
`sid` ❗required	Supplier ID
identifier information	For information on how to append identifier information such as email or phone number, please see here
demographic information	For information on how to append demographic information, please see Profilers
`hash`	For information on how to secure the iFrame with hashing please see the hashing article. Note that securing with a hash is required if you choose to pass in identifier or demographic information.

Example iFrame using a hashed URL

If you choose to pass in identifier or demographic information, you'll also need to add a hash to secure the URL. Here's an example. Let's begin with a URL that includes the email, gender, date_of_birth, and postal_code parameters. Before we add the hash, the URL looks like this:

https://grabcherries.com/wall?pid=USER_ID12345&sid=SUPPLIER_ID&[email protected]&gender=f&date_of_birth=2001-02-03&postal_code=30022

If your secrete key is SECRET_KEY, then the calculated hash would be: wAnxYoh7HXs0PprH01DyiYn4opOs4JC8mTTs13CswSg

Putting them together, the final URL form should look like this:

https://grabcherries.com/wall?pid=USER_ID12345&sid=SUPPLIER_ID&[email protected]&gender=f&date_of_birth=2001-02-03&postal_code=30022&hash=wAnxYoh7HXs0PprH01DyiYn4opOs4JC8mTTs13CswSg

Next steps

Once the iFrame is setup, you can continue setting up your postback (S2S).