CPAlead.com অফারওয়ালের জন্য পোস্টব্যাক সেট আপ করার সহজ গাইড

লেখক: CPAlead

আপডেট করা হয়েছে Friday, September 20, 2024 at 8:34 AM CDT

CPAlead.com অফারওয়ালের জন্য পোস্টব্যাক সেট আপ করার সহজ গাইড

আপনার CPAlead Offerwall-এ ব্যবহারকারীরা অফার সম্পন্ন করলে স্বয়ংক্রিয়ভাবে পুরস্কৃত করার সবচেয়ে নির্ভরযোগ্য উপায় হলো একটি postback সেটআপ করা। কনভার্সন হাতে ধরে চেক করার বদলে, প্রতিবার একটি যোগ্য lead তৈরি হলে CPAlead আপনার endpoint-এ একটি server-to-server request পাঠায়।

সবচেয়ে নিরাপদ সেটআপটি সহজ: {subid}-এ আপনার নিজস্ব user বা transaction reference পাঠান, {lead_id} সংরক্ষণ করুন যাতে retry একই conversion-কে দু’বার credit না করে, এবং {payout} থেকে reward দিন। বেশিরভাগ ক্ষেত্রে, শুরু করতে আপনার এতটুকুই দরকার।

একটি Publisher Postback আসলে কী করে

যখন একজন user আপনার CPAlead tracking URL-এ ক্লিক করে এবং একটি offer সম্পন্ন করে, তখন CPAlead conversion data সহ আপনার server-এ call করতে পারে। ফলে আপনার app, website, বা game-এ কেউ হাতে conversion review না করেও স্বয়ংক্রিয়ভাবে user-কে reward দেওয়া যায়।

স্বয়ংক্রিয়ভাবে ব্যবহারকারীদের পুরস্কৃত করুন: conversion রেকর্ড হওয়ার সাথে সাথেই points, balance, coins, বা premium access credit করুন।
নিজস্ব ledger রাখুন: finance, support, এবং analytics-এর জন্য প্রতিটি conversion আপনার নিজের database-এ সংরক্ষণ করুন।
ডুপ্লিকেট reward এড়ান: retry নিরাপদে উপেক্ষা করতে CPAlead-এর unique {lead_id} ব্যবহার করুন।
আরও সমৃদ্ধ context ট্র্যাক করুন: আপনার workflow-এ দরকার হলে country, IP, device IDs, বা extra subids-এর মতো optional value অন্তর্ভুক্ত করুন।

ধাপ 1: Offerwall URL-এ আপনার নিজস্ব Reference পাঠান

postback URL নিয়ে ভাবার আগে নিশ্চিত করুন যে মূল CPAlead tracking URL-এর subid-এ আপনার নিজস্ব identifier আছে। এটি হতে পারে user ID, username, wallet ID, session key, বা যেকোনো internal reference, যেটা দিয়ে আপনি বুঝতে পারবেন কোন user-কে reward দিতে হবে।

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

আপনার যদি অতিরিক্ত context দরকার হয়, তাহলে subid2 এবং subid3-ও পাঠাতে পারেন। উদাহরণস্বরূপ, কিছু publisher subid ব্যবহার করেন user ID-এর জন্য, subid2 অ্যাপ placement-এর জন্য, এবং subid3 campaign বা A/B test label-এর জন্য।

ধাপ 2: একটি পরিষ্কার, নির্ভরযোগ্য Postback URL দিয়ে শুরু করুন

অনেক postback সেটআপ ব্যর্থ হয় কারণ তারা শুরুতেই খুব বেশি বিস্তৃত হয়ে যায়। আপনার প্রথম version ছোট এবং নির্ভরযোগ্য রাখুন। অধিকাংশ CPAlead publisher-এর জন্য এটি একটি শক্তিশালী starting pattern:

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

এই version-টি আপনাকে সেই fields দেয় যা বেশিরভাগ publisher-এর আসলে দরকার হয়: কাকে reward দিতে হবে, কোন lead conversion হয়েছে, কোন offer conversion হয়েছে, কত payout হয়েছে, এবং request যাচাই করার জন্য একটি shared secret।

ধাপ 3: Recommended Macro-গুলো বুঝুন

{subid}: আপনার নিজস্ব user ID বা transaction reference। এটি আপনার system-কে জানায় কাকে reward দিতে হবে।
{lead_id}: CPAlead-এর unique conversion ID। duplicate protection এবং retry safety-এর জন্য এটি সেরা field।
{campaign_id}: CPAlead offer বা campaign ID।
{campaign_name}: CPAlead offer বা campaign name।
{payout}: conversion-এর payout amount। অধিকাংশ publisher-কে reward input হিসেবে এটি ব্যবহার করা উচিত।
{password}: আপনার সংরক্ষিত postback secret, user-কে credit করার আগে আপনার endpoint-কে এটি যাচাই করতে হবে।

Optional macro-এর মধ্যে আছে {subid2}, {subid3}, {country_iso}, {ip_address}, {idfa}, {gaid}, এবং {gateway_id}। CPAlead compatibility alias-ও সমর্থন করে, যেমন {offer_id}, {offer_name}, {transaction_id}, {amount}, {ip}, এবং {country_code}, যদি আপনার বিদ্যমান endpoint-এ ওই নামগুলো প্রত্যাশিত হয়।

একটি গুরুত্বপূর্ণ নোট: আপনার প্রথম integration-টি {virtual_currency}-এর উপর ভিত্তি করে তৈরি করবেন না। CPAlead-এর standard publisher postback flow-এ, সেই মানটি সাধারণত 0 হয়। আপনার যদি points বা in-app currency দরকার হয়, তাহলে সাধারণত আপনার নিজের system-এর মধ্যে {payout} থেকে তা গণনা করাই ভালো।

ধাপ 4: Endpoint সঠিকভাবে সুরক্ষিত করুন

আপনার CPAlead dashboard-এ একটি postback password যোগ করুন এবং URL-এ {password} অন্তর্ভুক্ত করুন। আপনার server-এ user-কে reward দেওয়ার আগে এটি যাচাই করুন। অননুমোদিত request প্রত্যাখ্যান করার এটি একটি সহজ ও কার্যকর উপায়।

আপনার server যদি শুধুমাত্র অনুমোদিত IP গ্রহণ করে, তাহলে আপনার CPAlead postback dashboard-এর মধ্যে দেখানো relay IP whitelist করুন। এটি হল outbound IP যা CPAlead publisher postback-এর জন্য ব্যবহার করে। আপনি যদি IP whitelisting বাদ দেন, তাহলে password validation আরও গুরুত্বপূর্ণ হয়ে যায়।

আপনার endpoint-কে conversion process হওয়ার পর দ্রুত HTTP 2xx response-ও ফিরিয়ে দিতে হবে। ধীর response বা non-2xx response retry এবং postback error ঘটাতে পারে।

ধাপ 5: Real Traffic পাঠানোর আগে Postback Test করুন

আপনার postback URL সংরক্ষণ করার পর, CPAlead dashboard-এর Postback Testing page ব্যবহার করুন। একটি ভালো test চারটি বিষয় নিশ্চিত করে:

Request আপনার server-এ পৌঁছায়। যদি না পৌঁছায়, firewall rules, SSL, IP whitelisting, বা আপনার URL format পরীক্ষা করুন।
Response HTTP 2xx। Request process করার পর আপনার endpoint দ্রুত success ফেরত দেওয়া উচিত।
আপনার user mapping সঠিক। নিশ্চিত করুন যে {subid} আপনার system-এ সঠিক user বা wallet-এর সাথে map হয়েছে।
Duplicate protection কাজ করে। একই {lead_id} আবার পাঠানো হলে, আপনার endpoint-এর উচিত user-কে দু’বার reward না করে এটি উপেক্ষা করা।

টেস্ট করার পর, CPAlead dashboard-এর Postback Logs page পর্যালোচনা করুন। destination URL, response code, এবং সমাধান করা প্রয়োজন এমন delivery error নিশ্চিত করার এটি সবচেয়ে দ্রুত উপায়।

PHP Script-এর উদাহরণ

নিচে {subid} এবং {payout} থেকে সরাসরি balance আপডেট করার তুলনায় আরও নিরাপদ একটি starter example দেওয়া হলো। এটি password validate করে, retry safety-এর জন্য {lead_id} অনন্যভাবে সংরক্ষণ করে, এবং raw SQL-এর বদলে prepared statement ব্যবহার করে।

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

আপনি যদি cash balance-এর বদলে points system ব্যবহার করেন, তাহলে user আপডেট করার আগে {payout}-কে আপনার নিজস্ব points ratio-তে রূপান্তর করুন। উদাহরণস্বরূপ, যদি আপনার app-এ $1.00 earned-এর জন্য 100 points হয়, তাহলে আলাদা macro-এর উপর নির্ভর না করে আপনার নিজের code-এর মধ্যে সেই conversion হিসাব করুন।

যদি আপনি স্বয়ংক্রিয় Crediting না চান?

কিছু publisher-এর জন্য CPAlead একটি সহজ fallback পদ্ধতিও সমর্থন করে: আপনি visitor-কে email বা subID দিতে বলতে পারেন এবং completions হাতে review করতে পারেন। এটি খুব ছোট প্রকল্পে কাজ করতে পারে, তবে এটি ধীর, ভুল credit দেওয়ার সম্ভাবনা বেশি, এবং scale করা অনেক কঠিন। আপনি যদি নির্ভরযোগ্য user rewards চান, তাহলে automated postback crediting-ই ভালো বিকল্প।

চূড়ান্ত টিপস

সবসময় {subid}-এ আপনার নিজস্ব user reference পাঠান।
সবসময় {lead_id}-এ সংরক্ষণ করুন এবং dedupe করুন।
মূল reward input হিসেবে {payout} ব্যবহার করুন।
Credit দেওয়ার আগে {password} যাচাই করুন।
আসল traffic পাঠানোর আগে URL test করুন এবং Postback Logs পর্যালোচনা করুন।

আপনি যদি সেই pattern অনুসরণ করেন, তাহলে আপনার CPAlead Offerwall postback setup অনেক সহজে maintain করা যাবে, debug করা সহজ হবে, এবং user-দের double-credit করা বা conversion হারানোর সম্ভাবনা অনেক কমে যাবে।

আপনি কি এই পোস্টে একটি ত্রুটি বা সংশোধনের প্রয়োজনীয়তা লক্ষ্য করেছেন? দয়া করে পোস্টের লিঙ্ক প্রদান করুন এবং আমাদের সাথে যোগাযোগ করুন. আমরা আপনার প্রতিক্রিয়া মূল্যায়ন করি এবং সমস্যাটি দ্রুত সমাধান করব.