# Quick Start

ClickWall connects advertisers and publishers to grow users and revenue.  Advertisers get real users. Publishers earn more from their traffic.  All through a smart, performance-driven OfferWall.

### How does it work? <a href="#how-does-it-work" id="how-does-it-work"></a>

#### For Advertisers

* Acquire high-quality users for your app or platform
* Pay only for verified actions
* Track performance in real time
* Optimize campaigns with full transparency

#### For Publishers

* Monetize your traffic more effectively
* Offer engaging, relevant offers to users
* Block unwanted offers at any time
* Get paid through flexible payout methods

<br>

<figure><img src="/files/IoYKG4ZQvxdiD1EnXGit" alt="" width="563"><figcaption></figcaption></figure>

### Get Started in Minutes

You can start using ClickWall in just a few steps:

* Create your account
* Complete the setup
* Go live

👉 Create an account: [register Account](https://clickwall.net/register)


# Getting Started

ClickWall allows you to work as a publisher, an advertiser, or both from the same account.  Before diving into technical details, choose the path that matches your goal.

### Choose Your Role

#### 📣 Advertiser

If your goal is to grow users for your app or platform.

As an advertiser, you will learn how to:

* Fund your account
* Create performance-based campaigns
* Set targeting, caps, and payouts
* Track results using postback
* Optimize and scale campaigns

👉 [**Go to Advertiser Guide**](https://docs.clickwall.net/advertiser-overview)

***

#### 👥 Publisher

If your goal is to monetize your traffic.

As a publisher, you will learn how to:

* Add your app or website
* Integrate the OfferWall
* Track conversions correctly
* Block unwanted offers
* Receive payouts with flexible methods

👉 [**Go to Publisher Guide**](https://docs.clickwall.net/postback)

***

### Can I use both?

Yes.\
You can switch between **Publisher** and **Advertiser** at any time from your dashboard.

No separate accounts. No additional setup.


# Postback

Experience a seamless journey towards setting up your own Postback as we walk you through each step, providing comprehensive guidance along the way.

{% hint style="info" %}
What The Postback?

When a user successfully completes an offer, we immediately trigger a call to the Postback URL you have provided in your placement. This call contains all the relevant information required to credit your users, serving as a real-time notification to your server.
{% endhint %}

Postback Parameter

<table data-header-hidden data-full-width="false"><thead><tr><th width="168">Header 1</th><th width="428.3333333333333">Header 2</th><th>Header 3</th></tr></thead><tbody><tr><td>Parameter</td><td>DESCRIPTION</td><td>EXAMPLE</td></tr><tr><td>{user_id}</td><td>This is the unique identifier code of the user who completed action on your platform.</td><td>varchar (25)</td></tr><tr><td>{offer_name}</td><td>The Name of the offer completed.</td><td>varchar (255)<br></td></tr><tr><td>{amount}</td><td>The amount of your virtual currency to be credited to your user.</td><td>99999</td></tr><tr><td>{payout}</td><td>Amount in USD that you earned for this conversion.</td><td>100.5</td></tr><tr><td>{user_ip}</td><td>IP address of the user that completed the offer.</td><td>1.1.1.1</td></tr><tr><td>{txid}</td><td>Unique ID of the conversion generated by ClickWall.</td><td>sdf8sd7fs</td></tr><tr><td>{offer_id}</td><td>Display number in our system</td><td>varchar (50)</td></tr></tbody></table>

### Example Postback URL <a href="#example-postback-url" id="example-postback-url"></a>

```url
https://example.com/postback/clickwall.php?user_id={user_id}&payout={payout}&amount={amount}&offer_name={offer_name}&user_ip={user_ip}&txid={txid}
```

We expect a response with a status code of **Ok** or **1** to indicate that the retransmission was received successfully.

### PHP Example <a href="#php-example" id="php-example"></a>

```php
<?php
                    /*!
                     * ClickWall LLC
                     * http://clickwall.net
                     * mail@dclickwall.net
                     * Demo: https://example.com/postback/clickwall.php?user_id={user_id}&amount={amount}&offer_name={offer_name}&user_ip={user_ip}
                     */

                    // Include the initialization file
                    include_once("../admin/core/init.inc.php");

                    // Get data from the request
                    $user_id = $_REQUEST['user_id'];
                    $amount = $_REQUEST['amount'];
                    $offerName = $_REQUEST['offer_name'];
                    $user_ip = $_REQUEST['user_ip'];

                    // Get the current timestamp
                    $timeCurrent = time();

                    // Initialize the functions object
                    $configs = new functions($dbo);

                    // Define the event type
                    $type = "ClickWall: Offername: $offerName . IP: $user_ip";

                    // Create an account object and retrieve user data
                    $account = new account($dbo, 1);
                    $userdata = $account->getuserdata($user_id);

                    // Calculate the new user balance
                    $newBalance = $userdata['points'] + $amount;

                    // Update user Points
                    $sql = "UPDATE users SET points = '$newBalance' WHERE login = '$user_id'";
                    $stmt = $dbo->prepare($sql);
                    $stmt->execute();

                    // Update user Tracker
                    $sql = "INSERT INTO tracker(username, points, type, date) values ('$user_id', '$amount', '$type', '$timeCurrent')";
                    $stmt = $dbo->prepare($sql);
                    $stmt->execute();

                    if ($stmt) {
                        echo "OK";
                    }
                    

                    ?>
```


# Web Offerwall

Integrating ClickWAll Offers offerwall into your website is a quick and simple process, follow this guide, it just take few minutes

{% hint style="info" %}
**Quick Info :**

Deliver personalized incentives and rewards to your users through ClickWAll Offers flexible Offer Wall. Our offerwall seamlessly adapts to any screen, displaying targeted, translated ads based on user device and location.
{% endhint %}

### Integration <a href="#integration" id="integration"></a>

Obtain your placement identifier from publisher Dashboard, Determine your unique userId and use the following code to integrate :

{% tabs %}
{% tab title="Iframe" %}
**Without Values :**

Make sure you replace \[**App\_ID**] with your placement identifier and \[**USER\_ID**] with your unique user id.

```html
<iframe style="width:100%; height:800px; border:0; padding:0; margin:0;" scrolling="yes" frameborder="0" src="https://clickwall.net/app/iframe/[App_ID]/[USER_ID]"></iframe>
```

{% endtab %}

{% tab title="Direct Link" %}
**Without Values :**

Make sure you replace \[App\_ID] with your placement identifier and \[USER\_ID] with your unique user id.

```
https://clickwall.net/app/iframe/[App_ID]/[USER_ID]
```

You must pass a valid user ID to return a receipt in the postback.<br>
{% endtab %}
{% endtabs %}


# Offers API

Offers APIs allow server-side data retrieval. Utilize these APIs to fetch offers directly on your server.

### Get Offers <a href="#get-offers" id="get-offers"></a>

\
Our application interface consists of all available offers, individual and split offers, all of which can be displayed in JSON format or using micro modules to filter offers.

API Parameters.

<table data-header-hidden><thead><tr><th width="162"></th><th width="441"></th><th></th></tr></thead><tbody><tr><td>Parameter</td><td>Description</td><td>Example</td></tr><tr><td>app_id</td><td>The publisher's order number is a unique (mandatory) number.</td><td>000</td></tr><tr><td>country_code</td><td>The country code consists of two letters (not required)</td><td>US or UK or CA</td></tr><tr><td>os</td><td>User's operating system (not required)</td><td>Android or IOS</td></tr></tbody></table>

### Examples&#x20;

This is how we call your postback URL:

```http
https://clickwall.net/api/?app_id=0000&country_code=UK&os=Android
```

To request all offers use this :

```http
https://clickwall.net/api/?app_id=0000
```

### Response JSON&#x20;

```json
 {
  "success": true,
  "message": "Offers fetched successfully.",
  "offers_count": 525,
  "country": "All",
  "operating_system": "All",
  "offers": [
    {
      "id": 3,
      "name": "NoiseMeter",
      "description": "Get NoiseMeter app. Measure 2 sound levels.",
      "payout": 224.00000000000003,
      "image_url": "https://link_to_icon_image",
      "tracking_url": "https://clickwall.net/app/tracking/10000/AAAA/[user_id]",
      "countries": "AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK",
      "operating_system": "Android",
      "has_events": 1,
      "events": [
        {
          "event_name": "Get NoiseMeter app.",
          "event_payout": 0
        },
        {
          "event_name": "Measure 2 sound levels.",
          "event_payout": 224.00000000000003
        }
      ]
    },
    {
      "id": 4,
      "name": "Compass Guide",
      "description": "Get Compass Guide app. Use the compass to find at least 2 directions.",
      "payout": 196,
      "image_url": https://link_to_icon_image",
      "tracking_url": "https://clickwall.net/app/tracking/10000/AAAA/[user_id]",
      "countries": "US",
      "operating_system": "Android",
      "has_events": 1,
      "events": [
        {
          "event_name": "Get Compass Guide app.",
          "event_payout": 0
        },
        {
          "event_name": "Use the compass to find at least 2 directions.",
          "event_payout": 196
        }
      ]
    },
    {
      "id": 5,
      "name": "Compass Guide",
      "description": "Get CubeStacker app. Play 2 consecutive games.",
      "payout": 167.99999999999997,
      "image_url": "https://link_to_icon_image",
      "tracking_url": "https://clickwall.net/app/tracking/10000/AAAA/[user_id]",
      "countries": "AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK",
      "operating_system": "Android",
      "has_events": 1,
      "events": [
        {
          "event_name": "Get CubeStacker app.",
          "event_payout": 0
        },
        {
          "event_name": "Play 2 consecutive games.",
          "event_payout": 167.99999999999997
        }
      ]
    },
```


# Advertiser Overview

Acquire real users. Pay only for verified actions. No impressions. Just measurable results.

#### How advertising works on ClickWall

1. Add funds to your advertiser balance
2. Create a campaign with your targeting and payout
3. Integrate postback tracking
4. Launch and monitor performance in real time

You stay in full control of budgets, caps, and optimization.

#### Who should use ClickWall as an advertiser?

* App owners looking to grow user base
* Platforms seeking performance-driven traffic
* Teams that want transparent tracking and reporting


# Add Funds

Before creating or activating any campaign, you need to add funds to your advertiser balance.  ClickWall uses a prepaid balance system, which gives you full control over spending and campaign limits.

### Deposit Funds

On the **Add Fund** page, you will see your current available balance at the top.

This balance is used to:

* Run active campaigns
* Cover conversion costs
* Control daily and total campaign spend

***

### Payment Details

ClickWall currently supports the following deposit methods:

* **Bybit**
* **USDT (TRC20)**
* **PayPal**

You will find the required payment details displayed clearly on the page, including:

* Minimum deposit amount
* PayPal email (if applicable)
* Bybit UID
* TRC20 wallet address

> ⚠️ Always send funds only to the addresses shown inside your dashboard.

***

### Minimum Deposit

The minimum deposit amount is displayed on the page.

Example:

* **Minimum deposit: $50**

Deposits below the minimum amount will not be processed.

***

### How to Add Funds (Step by Step)

1. Go to **Balance → Add Fund**
2. Send the funds using one of the available payment methods
3. Enter the **exact amount sent** in USD
4. Select the **payment method** you used
5. Upload a clear screenshot of the payment confirmation
6. Click **Submit Proof**

***

### Upload Payment Screenshot

After sending the funds, you must upload a payment screenshot.

Accepted formats:

* JPG
* JPEG
* PNG

Maximum file size:

* 500 KB

Make sure the screenshot clearly shows:

* Amount
* Transaction ID (if available)
* Date and time

***

### Deposit Request History

On the right side of the page, you can view your **Deposit Request History**, which includes:

* Amount
* Payment method
* Status
* Date

Once approved, the deposited amount will be added to your available balance.

***

### When Will My Balance Be Updated?

* **Crypto payments**: after network confirmation and manual review
* **PayPal payments**: usually processed faster

If your balance is not updated within a reasonable time, contact support and provide your transaction details.

***

### Important Notes

* Funds are non-refundable once added
* Unused balance remains available for future campaigns
* Campaigns will not start until sufficient balance is available


# Create a Campaign

This page allows advertisers to create a new performance-based campaign on ClickWall.  Once submitted, campaigns are reviewed before activation to ensure quality and compliance.

### Campaign Basics

#### App Name

Enter the name of your app or product.

This name will be visible to publishers, so make sure it is clear and recognizable.

***

#### Tracking URL

Provide the destination URL for your campaign.

This is the link users will be redirected to after clicking the offer.

> 💡 Make sure your tracking URL is correct and fully functional to avoid delays during review.

***

#### Campaign Image

Upload an image that represents your app or campaign.

* Recommended format: square image
* Accepted formats: JPG, PNG
* Use a clear, professional image to increase conversions

***

### Campaign Limits & Pricing

#### Total Installs

Set the maximum number of installs you want for this campaign.

Once this limit is reached, the campaign will stop automatically.

***

#### Payout (Cost Per Install)

Set how much you are willing to pay per install.

* Minimum payout is displayed on the page
* Higher payouts usually attract more publishers

> 💡 Competitive payouts lead to faster scaling.

***

### Targeting Settings

#### Target Countries

Select the countries where you want your campaign to be available.

You can:

* Select individual countries
* Use **Select All** or **Unselect All** for faster setup

Choose only countries that match your target audience.

***

#### Operating System

Choose the operating system supported by your app.

Example:

* Android
* iOS (if available)

Only users on the selected OS will see your campaign.

***

### Campaign Description

Provide a clear description of what users need to do.

Include:

* Required action (install, signup, etc.)
* Any restrictions or requirements
* Important notes for publishers

Clear descriptions reduce invalid traffic and rejected conversions.

***

### Campaign Cost Overview

At the bottom of the page, you will see:

* **Total campaign cost** (based on installs × payout)

This helps you understand the maximum possible spend before launching.

***

### Review & Submission

Once you click **Submit Campaign**:

* Your campaign will be marked as **Pending Review**
* You will not be able to edit the campaign during review
* Our team will verify links, targeting, and compliance

> ⚠️ Make sure all details are correct before submitting.

***

### After Approval

Once approved:

* Your campaign becomes available to publishers
* You can monitor clicks, installs, and spend in real time
* Campaigns can be paused or adjusted after approval


# Advertiser Postback (S2S)

ClickWall uses server-to-server (S2S) postback tracking for accurate conversion reporting. Postback setup is required to track installs and actions correctly.

### When Do I Get the Postback URL?

Once your campaign is **approved**, ClickWall will generate a **unique postback URL** for your campaign.

You will find this postback URL inside your dashboard.

This URL must be added to your tracking platform.

***

### How Advertiser Postback Works

The flow is simple:

1. A user clicks your campaign through ClickWall
2. The user completes the required action (install, signup, etc.)
3. Your tracking system detects the conversion
4. Your tracking system sends a **postback request** to ClickWall
5. ClickWall records the conversion and updates campaign statistics

This process happens automatically without user interaction.

***

### Postback URL Format

After approval, you will receive a postback URL similar to the following:

```
https://clickwall.net/postback/advertiser?campaign_id=XXXX&click_id={click_id}
```

> ⚠️ The actual URL and parameters will be provided in your dashboard.

***

### Required Parameters

Your tracking system must send the following parameters exactly as provided:

| Parameter    | Description                               |
| ------------ | ----------------------------------------- |
| click\_id    | Unique identifier passed during the click |
| campaign\_id | Your ClickWall campaign ID                |

Additional parameters may be included depending on campaign type.

***

### How to Add the Postback to Your Tracking Platform

1. Copy the postback URL from your ClickWall dashboard
2. Open your tracking platform (e.g. AppsFlyer, Adjust, Voluum, custom tracker)
3. Locate the **Postback / S2S / Conversion Tracking** section
4. Paste the ClickWall postback URL
5. Save your changes

Once configured, conversions will be reported automatically.

***

### Important Notes

* Postback must be added **exactly as provided**
* Do not modify parameter names
* Missing or incorrect parameters will cause conversions to be rejected
* Postback should be triggered **only once per conversion**

***

### Testing the Postback

After setup:

* Launch a test conversion
* Verify that the conversion appears in your campaign statistics
* Confirm that the status updates correctly

If conversions are not appearing, double-check:

* Postback URL
* Parameter mapping
* Campaign status (must be approved and active)

***

### Common Issues

**Conversions not tracked**

* Postback not configured
* Incorrect parameter mapping
* Campaign not approved yet

**Duplicate conversions**

* Postback sent more than once for the same click

***

### Need Help?

If you need assistance with postback setup:

* Contact support
* Provide your campaign ID
* Share details about your tracking platform

Our team will help you verify the integration.