How to Set Up Postback for CPAlead.com Offerwall: A Simple Guide Paagi sa Pag-set Up sa Postback para sa CPAlead.com Offerwall: Usa ka Yano nga Giya

Awtor: CPAlead

Gi-update Friday, September 20, 2024 at 8:34 AM CDT

How to Set Up Postback for CPAlead.com Offerwall: A Simple Guide

Paagi sa Pag-set Up sa Postback para sa CPAlead.com Offerwall: Usa ka Yano nga Giya

Ang pag-set up og postback mao ang pinakamasaligan nga paagi aron awtomatikong gantihan ang mga user kung makakompleto sila og mga offer sa imong CPAlead Offerwall. Imbes nga mano-mano nimong susihon ang mga conversion, magpadala ang CPAlead og server-to-server nga request ngadto sa imong endpoint matag higayon nga adunay kwalipikadong lead nga mamugna.

Ang pinakaseguro nga setup yano ra: ipasa ang imong kaugalingong user o transaction reference sa {subid}, itipig ang {lead_id} aron ang mga retry dili makadoble og credit sa samang conversion, ug paghatag og reward gikan sa {payout}. Sa kadaghanang kaso, mao ra na ang imong gikinahanglan aron makasugod.

Unsa Gayud ang Ginabuhat sa Publisher Postback

Kung ang usa ka user mo-click sa imong CPAlead tracking URL ug makakompleto og offer, puwede tawagan sa CPAlead ang imong server dala ang conversion data. Niana, ang imong app, website, o game makahatag og reward sa user awtomatiko nga dili na kinahanglan nga adunay bisan kinsa nga manu-manong motan-aw sa conversions.

Awtomatikong gantihan ang mga user: i-credit ang points, balance, coins, o premium access sa dihang ma-record ang conversion.
Tipigi ang imong kaugalingong ledger: itipig ang matag conversion sa imong kaugalingong database para sa finance, support, ug analytics.
Likayi ang dobleng reward: gamita ang talagsaong {lead_id} sa CPAlead aron luwas nga ma-ignore ang retries.
Subaya ang mas dato nga context: apili og opsyonal nga values sama sa country, IP, device IDs, o dugang nga subids kung gikinahanglan sa imong workflow.

Lakang 1: Ipasa ang Imong Kaugalingong Reference sa Offerwall URL

Sa dili pa ka mabalaka sa postback URL, siguroha nga ang orihinal nga CPAlead tracking URL naglakip sa imong kaugalingong identifier sa subid. Kini mahimong user ID, username, wallet ID, session key, o bisan unsang internal nga reference nga imong gigamit aron mahibal-an kung kinsa nga user ang angay gantihan.

https://your-tracking-domain/view.php?id=1234&pub=1234&subid=USER_123

Kung gikinahanglan nimo og dugang nga context, puwede ka usab mopasa og subid2 ug subid3. Pananglitan, ang ubang publishers mogamit sa subid alang sa user ID, subid2 alang sa app placement, ug subid3 alang sa campaign o A/B test label.

Lakang 2: Sugdi sa Limpyo, Kasaligan nga Postback URL

Daghang postback setup ang mapakyas kay nagsugod sila og sobra ka lapad. Ibutang nga gamay ug kasaligan ang imong unang bersyon. Kini usa ka lig-on nga starting pattern alang sa kadaghanang CPAlead publishers:

https://example.com/postback/cpalead.php?subid={subid}&lead_id={lead_id}&campaign_id={campaign_id}&campaign_name={campaign_name}&payout={payout}&password={password}

Kini nga bersyon naghatag kanimo sa mga field nga tinuod nga gikinahanglan sa kadaghanang publishers: kinsa ang gantihan, unsang lead ang nag-convert, unsang offer ang nag-convert, pila ang bayad, ug usa ka shared secret aron mapamatud-an ang request.

Lakang 3: Sabta ang Girekomendar nga mga Macro

{subid}: imong kaugalingong user ID o transaction reference. Kini ang mosulti sa imong sistema kung kinsa ang angay makadawat sa reward.
{lead_id}: talagsaong conversion ID sa CPAlead. Kini ang pinakamaayong field para sa duplicate protection ug retry safety.
{campaign_id}: ang offer o campaign ID sa CPAlead.
{campaign_name}: ang offer o campaign name sa CPAlead.
{payout}: ang payout amount para sa conversion. Kadaghanang publishers angay mogamit niini isip reward input.
{password}: imong nasave nga postback secret, nga ang imong endpoint angay mag-validate sa dili pa i-credit ang user.

Ang opsyonal nga mga macro naglakip sa {subid2}, {subid3}, {country_iso}, {ip_address}, {idfa}, {gaid}, ug {gateway_id}. Gisuportahan usab sa CPAlead ang compatibility aliases sama sa {offer_id}, {offer_name}, {transaction_id}, {amount}, {ip}, ug {country_code} kung ang imong kasamtangang endpoint nagpaabot niana nga mga ngalan.

Usa ka importanteng nota: ayaw himoa nga basehan sa imong unang integration ang {virtual_currency}. Sa standard publisher postback flow sa CPAlead, kasagaran kana nga value kay 0. Kung kinahanglan nimo og points o in-app currency, mas maayo kasagaran nga kuwentahon kini gikan sa {payout} sulod sa imong kaugalingong sistema.

Lakang 4: Seguruha nga Protektado ang Endpoint

Pagdugang og postback password sa imong CPAlead dashboard ug ilakip ang {password} sa URL. Sa imong server, i-verify kini sa dili pa nimo gantihan ang user. Kini usa ka yano ug epektibong paagi aron balibaran ang dili awtorisadong requests.

Kung ang imong server modawat ra og approved IPs, i-whitelist ang relay IP nga gipakita sulod sa imong CPAlead postback dashboard. Mao kana ang outbound IP nga gigamit sa CPAlead para sa publisher postbacks. Kung imo kining laktawan, mas importante pa gyud ang password validation.

Ang imong endpoint kinahanglan usab nga mo-return og paspas nga HTTP 2xx response sa dihang maproseso na ang conversion. Ang hinay nga responses o non-2xx responses mahimong hinungdan sa retries ug postback errors.

Lakang 5: Sulayi ang Postback Sa Dili Pa Magpadala og Tinuod nga Traffic

Human nimo masave ang imong postback URL, gamita ang Postback Testing page sa imong CPAlead dashboard. Ang maayong test nagkumpirma sa upat ka butang:

Ang request makaabot sa imong server. Kung dili, susiha ang firewall rules, SSL, IP whitelisting, o ang format sa imong URL.
Ang response kay HTTP 2xx. Ang imong endpoint angay mo-return og success dayon human maproseso ang request.
Husto ang imong user mapping. Kumpirmaha nga ang {subid} mo-map sa hustong user o wallet sa imong sistema.
Molihok ang duplicate protection. Kung ang parehas nga {lead_id} ipadala pag-usab, ang imong endpoint angay mo-ignore niini imbes nga gantihan ang user kaduha.

Human sa testing, susiha ang Postback Logs page sa imong CPAlead dashboard. Mao kini ang pinakapaspas nga paagi aron makumpirma ang destination URL, response code, ug bisan unsang delivery errors nga kinahanglan ayuhon.

Pananglitan nga PHP Script

Sa ubos mao ang mas luwas nga starter example kaysa basta-basta lang pag-update og balance gikan sa {subid} ug {payout}. Gi-validate niini ang password, gitipigan ang {lead_id} nga unique para sa retry safety, ug mogamit og prepared statements imbes nga raw SQL.

<?php

declare(strict_types=1);

const POSTBACK_PASSWORD = 'replace_with_your_secret';

$subid = trim((string) ($_GET['subid'] ?? ''));
$leadId = (int) ($_GET['lead_id'] ?? 0);
$campaignId = (int) ($_GET['campaign_id'] ?? 0);
$payout = (float) ($_GET['payout'] ?? 0);
$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.');
}

$pdo = new PDO('mysql:host=127.0.0.1;dbname=your_database;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);

$pdo->beginTransaction();

try {
    $insert = $pdo->prepare(
        'INSERT INTO cpalead_postbacks (lead_id, user_id, campaign_id, payout, created_at)
         VALUES (:lead_id, :user_id, :campaign_id, :payout, NOW())'
    );
    $insert->execute([
        ':lead_id' => $leadId,
        ':user_id' => $subid,
        ':campaign_id' => $campaignId,
        ':payout' => $payout,
    ]);
} catch (PDOException $e) {
    if (($e->errorInfo[1] ?? null) === 1062) {
        $pdo->rollBack();
        http_response_code(200);
        exit('Duplicate lead ignored.');
    }

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

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

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

$pdo->commit();
http_response_code(200);
echo 'OK';

Kung mogamit ka og points system imbes nga cash balance, i-convert ang {payout} ngadto sa imong kaugalingong points ratio sa dili pa i-update ang user. Pananglitan, kung ang imong app mogamit og 100 points matag $1.00 nga nakuha, kalkulaha kana nga conversion sulod sa imong kaugalingong code imbes nga magsalig sa lahi nga macro.

Unsa Kung Dili Ka Ganahan sa Awtomatikong Pag-credit?

Ang CPAlead nagsuporta usab og mas simple nga fallback approach para sa ubang publishers: puwede nimo pahimangnoan ang bisita nga magbutang og email o subID ug mano-manong i-review ang mga completions. Mahimo kini sa gagmay kaayong projects, pero mas hinay kini, mas sayon og sayop ang pag-credit, ug mas lisod kaayo i-scale. Kung gusto ka og kasaligan nga user rewards, ang automated postback crediting mao ang mas maayong opsyon.

Katapusang mga Tip

Kanunay ipasa ang imong kaugalingong user reference sa {subid}.
Kanunay itipig ug i-dedupe ang {lead_id}.
Gamita ang {payout} isip main reward input.
I-validate ang {password} sa dili pa mag-credit.
Sulayi ang URL ug susiha ang Postback Logs sa dili pa magpadala og tinuod nga traffic.

Kung sundon nimo kana nga pattern, ang imong CPAlead Offerwall postback setup mahimong mas sayon i-maintain, mas sayon i-debug, ug mas moubos ang posibilidad nga madoble ang pag-credit sa mga user o mawala ang mga conversion.

Nakamatikod ka ba ug sayop o usa ka aspeto sa kining post nga nanginahanglan pagtul-id? Palihug ihatag ang link sa post ug pakigsulti kanamo. Gina-apresyar namo ang inyong mga feedback ug atimanon namo ang mga isyu sa madali.