اپنی صارف شناخت, والٹ شناخت, لین دین شناخت, یا کلک حوالہ ہماری ٹریکنگ یو آر ایل میں بھیجیں تاکہ وہی قدر بعد میں پوسٹ بیک میں آپ کو واپس ملے۔.

موبائل ایپ عملیات کے لیے, آپ اپنے ذیلی شناخت کے ساتھ آئی ڈی ایف اے (ایپل) یا جی اے آئی ڈی (گوگل) بھی بھیج سکتے ہیں:

پوسٹ بیک تشکیل کے اندر، وہ یو آر ایل محفوظ کریں جو آپ کی تبدیلی اطلاعات موصول کرے گی۔ کم سے کم درکار میکروز سے شروع کریں، پھر صرف وہی مزید فیلڈز شامل کریں جنہیں آپ کا نظام استعمال کرتا ہے۔:

اگر آپ ہر فی الحال مدد شدہ معیاری فیلڈ چاہتے ہیں، تو آپ کی پوسٹ بیک یو آر ایل کچھ یوں نظر آ سکتی ہے:

CPAlead HTTP اور HTTPS دونوں اختتامی نکات پر پبلشر پوسٹ بیکس بھیج سکتا ہے.

Start with {subid}, {lead_id}, {campaign_id}, {campaign_name}, and {payout}. In the current publisher postback flow, {virtual_currency} is typically 0.

یہ CPAlead کے بنیادی میکروز ہیں جنہیں آپ اپنی یو آر ایل میں رکھ سکتے ہیں۔ جب آپ کا پوسٹ بیک بھیجا جائے گا، یہ حقیقی وقت کی تبدیلی قدروں سے بدل جائیں گے:

اگر آپ کا اختتامی نکتہ آنے والی ٹریفک پر پابندی لگاتا ہے، تو نیچے دکھائے گئے CPAlead ریلے آئی پی کو وائٹ لسٹ کریں تاکہ آپ کا سرور پوسٹ بیک ترسیل قبول کر لے۔

یہ نمونہ حسب منشا انضمام کے لیے ایک زیادہ محفوظ ابتدائی نکتہ دکھاتا ہے: پاس ورڈ کی تصدیق کریں، شناختی دہراؤ کے لیے لیڈ شناخت استعمال کریں، خام مواد محفوظ کریں، اور صرف ایک بار صارف کو انعام دیں۔

<?php
declare(strict_types=1);

/*
 * CPAlead publisher postback example.
 *
 * Recommended CPAlead URL:
 * https://example.com/postback/cpalead.php?subid={subid}&lead_id={lead_id}&campaign_id={campaign_id}&campaign_name={campaign_name}&payout={payout}&password={password}
 *
 * Notes:
 * - {subid} should usually be your internal user ID or click/reference ID.
 * - {lead_id} should be stored uniquely so retries do not double-credit a user.
 * - {payout} is the most reliable reward input in the current publisher flow.
 * - {virtual_currency} is currently sent as 0 in the standard publisher postback flow.
 */

const DB_HOST = '127.0.0.1';
const DB_PORT = '3306';
const DB_NAME = 'your_database';
const DB_USER = 'your_user';
const DB_PASS = 'your_password';
const POSTBACK_PASSWORD = 'replace_with_your_secret';

$subid = trim((string) ($_GET['subid'] ?? ''));
$leadId = (int) ($_GET['lead_id'] ?? 0);
$campaignId = (int) ($_GET['campaign_id'] ?? 0);
$campaignName = trim((string) ($_GET['campaign_name'] ?? ''));
$payout = (float) ($_GET['payout'] ?? 0);
$countryIso = strtoupper(substr((string) ($_GET['country_iso'] ?? ''), 0, 2));
$ipAddress = trim((string) ($_GET['ip_address'] ?? ''));
$password = (string) ($_GET['password'] ?? '');

if (POSTBACK_PASSWORD !== '' && !hash_equals(POSTBACK_PASSWORD, $password)) {
    http_response_code(403);
    exit('Invalid postback password.');
}

if ($subid === '' || $leadId <= 0) {
    http_response_code(400);
    exit('Missing subid or lead_id.');
}

$dsn = sprintf('mysql:host=%s;port=%s;dbname=%s;charset=utf8mb4', DB_HOST, DB_PORT, DB_NAME);
$pdo = new PDO($dsn, DB_USER, DB_PASS, [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

$pdo->beginTransaction();

try {
    /*
     * Create a table like:
     * CREATE TABLE cpalead_postbacks (
     *   id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
     *   lead_id BIGINT UNSIGNED NOT NULL UNIQUE,
     *   user_id VARCHAR(100) NOT NULL,
     *   campaign_id BIGINT UNSIGNED NOT NULL,
     *   campaign_name VARCHAR(255) NOT NULL,
     *   payout DECIMAL(10,4) NOT NULL DEFAULT 0,
     *   country_iso CHAR(2) NULL,
     *   ip_address VARCHAR(45) NULL,
     *   raw_query TEXT NULL,
     *   created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
     * );
     */
    $insert = $pdo->prepare(
        'INSERT INTO cpalead_postbacks
            (lead_id, user_id, campaign_id, campaign_name, payout, country_iso, ip_address, raw_query, created_at)
         VALUES
            (:lead_id, :user_id, :campaign_id, :campaign_name, :payout, :country_iso, :ip_address, :raw_query, NOW())'
    );
    $insert->execute([
        ':lead_id' => $leadId,
        ':user_id' => $subid,
        ':campaign_id' => $campaignId,
        ':campaign_name' => $campaignName,
        ':payout' => $payout,
        ':country_iso' => $countryIso ?: null,
        ':ip_address' => $ipAddress ?: null,
        ':raw_query' => json_encode($_GET, JSON_UNESCAPED_SLASHES),
    ]);
} catch (PDOException $e) {
    // MySQL duplicate-key error: the lead was already processed.
    if (($e->errorInfo[1] ?? null) === 1062) {
        $pdo->rollBack();
        http_response_code(200);
        exit('Duplicate lead ignored.');
    }

    $pdo->rollBack();
    throw $e;
}

/*
 * Example reward logic:
 * - If you run a cash-back system, you may choose to credit $payout directly.
 * - If you run a points system, convert $payout to your own point value here.
 */
$rewardAmount = $payout;

$updateUser = $pdo->prepare('UPDATE users SET balance = balance + :amount WHERE id = :user_id');
$updateUser->execute([
    ':amount' => $rewardAmount,
    ':user_id' => $subid,
]);

if ($updateUser->rowCount() !== 1) {
    $pdo->rollBack();
    http_response_code(404);
    exit('User not found.');
}

$pdo->commit();

http_response_code(200);
echo sprintf(
    'OK lead_id=%d user=%s campaign_id=%d payout=%.4f',
    $leadId,
    $subid,
    $campaignId,
    $payout
);