> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.offerzy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the offerwall to your website

> Embed the hosted offerwall in an iframe or open it in a new tab, with your user's ID in the link.

The offerwall is a hosted page. Open it with your placement ID and the signed-in user's ID:

```text theme={null}
https://wall.offerzy.io/{placement_id}?user_id={USER_ID}
```

<ParamField path="placement_id" type="string" required>
  Your placement's ID. Copy the full link from the placement in the dashboard.
</ParamField>

<ParamField query="user_id" type="string" required>
  Your ID for the signed-in user. Every postback sends it back, so you know whom to credit.
</ParamField>

## Choose how to show it

<Tabs>
  <Tab title="Embed in a page">
    Put the offerwall on a page of your site, such as an "Earn" page:

    ```html theme={null}
    <iframe
      src="https://wall.offerzy.io/YOUR_PLACEMENT_ID?user_id=USER_ID"
      title="Earn rewards"
      style="width: 100%; height: 100vh; min-height: 800px; border: 0;"
    ></iframe>
    ```

    Give the iframe the full width of your content and most of the screen's height, so users can scroll the offers comfortably on phones too.
  </Tab>

  <Tab title="Open in a new tab">
    Link to the offerwall from a button or menu item:

    ```html theme={null}
    <a href="https://wall.offerzy.io/YOUR_PLACEMENT_ID?user_id=USER_ID" target="_blank" rel="noopener">
      Earn rewards
    </a>
    ```
  </Tab>
</Tabs>

## Build the link on your server

Add the user ID when you render the page, and URL-encode it:

<CodeGroup>
  ```js Node.js theme={null}
  const offerwallUrl = new URL(`https://wall.offerzy.io/${PLACEMENT_ID}`);
  offerwallUrl.searchParams.set("user_id", user.id);
  ```

  ```php PHP theme={null}
  $offerwallUrl = 'https://wall.offerzy.io/' . rawurlencode($placementId)
      . '?' . http_build_query(['user_id' => $user->id]);
  ```

  ```python Python theme={null}
  from urllib.parse import quote, urlencode

  offerwall_url = f"https://wall.offerzy.io/{quote(placement_id)}?{urlencode({'user_id': user.id})}"
  ```
</CodeGroup>

## Choosing a user ID

* **Stable**: pass the same ID for a user every time, or rewards can land on the wrong account.
* **Unique**: one ID per user account, never shared between users.
* **Private**: use your internal ID, never an email address, phone number or other personal data.

<Tip>
  An offerwall that's easy to find gets opened more. Link to it from your main navigation and from places where users run low on currency.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.