Required Information
AdPlusMedia lets your users earn rewards through segmented, automatically localised offers. Our offerwall adapts to any screen size. Before integrating it, you need three pieces of information from your approved placement.
Get your keys
-
Open Apps in your dashboard
Log in and navigate to the Apps section, then click Edit on the placement you want to integrate.
-
Confirm your placement details
Check that the name, URL and reward configuration are correct, then open the integration panel.
-
Copy your credentials
Copy the App ID, API key and secret key shown there.
The three values
| Value | Example | Where it is used |
|---|---|---|
| App ID | 1042 |
Path segment in every offerwall and API URL. |
| API key | ak_9f2c7e1b4d8a35660c1ee9b7a4f0d213 |
The api query parameter on Offers API requests. |
| Secret key | 4f1c… (64 characters) |
Server-side only. Used to verify the {sig} hash on postbacks. |
Your API key functions like a public key. It identifies your placement but cannot be used to forge a conversion, so it is safe to include it in client-side code.
Your secret key must never leave your server. Anyone holding it can compute a valid
{sig} and credit arbitrary users on your platform.
The user identifier
Alongside your own credentials, every integration requires a user ID: your unique,
permanent identifier for the user currently viewing the wall. We echo this value back to you on every
postback as {user_id}, and it is the only way to know which of your users to credit.
| Requirement | Detail |
|---|---|
| Unique | One value per user. Never recycle an identifier across accounts. |
| Stable | It must not change between sessions, or pending conversions will be lost. |
| URL safe | Use letters, digits, hyphens and underscores. URL-encode anything else. |
| Non-personal | Do not use an email address or any other personal data. |
Do not pass a session ID, a device ID or a rotating token as the user ID. Conversions can arrive hours or days after the click, and a value that has changed in the meantime cannot be matched back to a user.