اپنی صارف آئی ڈی، والیٹ آئی ڈی، ٹرانزیکشن آئی ڈی، یا کلک حوالہ ہماری ٹریکنگ یو آر ایل میں پاس کریں تاکہ وہی قدر بعد میں پوسٹ بیک میں دوبارہ آپ تک پہنچے۔.

موبائل ایپ فلو کے لیے، آپ اپنے سب آئی ڈیز کے ساتھ IDFA (ایپل) یا GAID (گوگل) بھی پاس کر سکتے ہیں:

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

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

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

Start with {subid}, {lead_id}, {campaign_id}, {campaign_name}, and {payout}. For event-based offers, add {event_key}, {event_name}, and {event_payout} only if your system needs event details. In the current publisher postback flow, {virtual_currency} is typically 0.

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

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

یہ نمونہ ایک کسٹم انضمام کے لیے زیادہ محفوظ نقطۂ آغاز دکھاتا ہے: پاس ورڈ کی تصدیق کریں، idempotency کے لیے lead_id استعمال کریں، خام پی لود محفوظ کریں، اور صارف کو صرف ایک بار انعام دیں۔

<?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
);