মিনিটের মধ্যে ইভেন্ট পাঠান

কুইক স্টার্ট

1. একটি ফ্রি অ্যাকাউন্ট তৈরি করুন। আপনার স্টোর একটি পাবলিশেবল কি (ব্রাউজার) এবং একটি সিক্রেট কি (সার্ভার) পাবে।
2. স্নিপেটটি প্রতিটি পেজে পেস্ট করুন। ড্যাশবোর্ড এটি আপনার কি দিয়ে পূরণ করে দেখাবে।
3. ডেস্টিনেশনস থেকে মেটা বা GA4 কানেক্ট করুন, তারপর “টেস্ট ইভেন্ট পাঠান” এ চাপুন।

<script>
  window.trakero=window.trakero||function(){(trakero.q=trakero.q||[]).push(arguments)};
  trakero('init', { key: 'pk_live_…' });
</script>
<script async src="https://track.yourstore.com/sdk/v1/trakero.js"></script>

স্ক্রিপ্ট লোড হওয়ার আগে করা কলগুলো কিউতে রাখা হয় এবং ক্রমানুসারে চালানো হয়। স্ক্রিপ্টটি async এবং পেজ লোডে বাধা দেয় না।

ব্রাউজার SDK

কুকিগুলো আপনার ডোমেইনে ফার্স্ট-পার্টি হিসেবে থাকে: _cdt_vid (ভিজিটর), _cdt_sid (৩০ মিনিটের সেশন), _cdt_clk (অ্যাড ক্লিক আইডি), _cdt_ft/_cdt_lt (ফার্স্ট ও লাস্ট টাচ), এবং _fbp/_fbc (যদি ads কনসেন্ট denied না হয়)। যে ইভেন্টগুলো পাঠানো যায় না (অফলাইন, 429, 5xx) সেগুলো সংরক্ষণ করা হয় এবং পরের পেজে আবার পাঠানো হয়।

বান্ডলারের জন্য: import { createTrakero } from "@trakero/browser"।

সার্ভার ইভেন্টস API

আপনার ট্র্যাকিং ডোমেইনে POST /v1/events, সাথে Authorization: Bearer sk_live_…। একটি ইভেন্ট অবজেক্ট পাঠান, অথবা { "events": [ … ] } দিয়ে সর্বোচ্চ ৫০টি। ওয়েব পেজ থেকে Origin হেডার থাকলে সিক্রেট কি প্রত্যাখ্যান করা হয়, তাই এগুলো পেজ থেকে ব্যবহার করা যাবে না।

POST https://track.yourstore.com/v1/events
Authorization: Bearer sk_live_…
Content-Type: application/json
Idempotency-Key: order-10023-confirmed        (ঐচ্ছিক)

{
  "event_name": "purchase",
  "event_id": "purchase_10023",
  "occurred_at": "2026-09-27T13:45:17Z",
  "source": "server",
  "visitor_id": "<অর্ডার থেকে _cdt_vid কুকি>",
  "context": { "ip": "<ক্রেতার ip>", "user_agent": "<ক্রেতার user agent>" },
  "attribution": { "fbp": "<_fbp>", "fbc": "<_fbc>", "ga_client_id": "<_ga থেকে>" },
  "identity": { "email": "[email protected]", "phone": "01712345678", "country": "BD" },
  "consent": { "ads": "granted", "analytics": "granted" },
  "ecommerce": {
    "order_id": "10023", "value": 2580, "currency": "BDT", "shipping": 80,
    "payment_method": "cod",
    "items": [{ "item_id": "SKU-RED-M", "name": "Red Dress", "price": 1250, "quantity": 2 }]
  }
}

আপনি প্রি-হ্যাশ করা email_sha256 / phone_sha256 (৬৪ হেক্স ক্যারেক্টার) পাঠাতে পারেন। টেস্ট কি (pk_test_, sk_test_) প্রতিটি ইভেন্টকে TEST হিসেবে চিহ্নিত করে।

সার্ভার SDKs

ইভেন্টস API এর উপর হালকা ক্লায়েন্ট: এরা event_id কে purchase_{order_id} এ সেট করে, রিকোয়েস্ট থেকে ব্রাউজার SDK-এর কুকি পড়ে যাতে অ্যাড ক্লিক অর্ডারের সাথে যায়, এবং 429/5xx/network এররে ইডেমপোটেন্সি কি দিয়ে আবার চেষ্টা করে। Next.js এবং Node.js এবং PHP এবং Laravel দেখুন।

// Node.js / Next.js  (@trakero/node)
import { Trakero, shopperFromRequest } from "@trakero/node";
const trakero = new Trakero({ secretKey: process.env.TRAKERO_SECRET_KEY!, endpoint: "https://track.yourstore.com" });
await trakero.purchase({ orderId: "10023", value: 2580, currency: "BDT", customer: { phone: "01712345678" }, shopper: shopperFromRequest(req) });

// PHP / Laravel  (trakero/trakero-php)
$trakero = new TrakeroClient(getenv('TRAKERO_SECRET_KEY'), 'https://track.yourstore.com');
$trakero->purchase(['order_id' => '10023', 'value' => 2580, 'currency' => 'BDT'], ['phone' => '01712345678'],
    TrakeroBrowserContext::shopperFromGlobals());

// .NET / ASP.NET Core  (Trakero.Client)
var trakero = new TrakeroClient(new TrakeroOptions { SecretKey = config["Trakero:SecretKey"]!, Endpoint = "https://track.yourstore.com" });
var shopper = Shopper.From(ctx.Connection.RemoteIpAddress?.ToString(), ctx.Request.Headers.UserAgent, ctx.Request.Headers.Referer, ctx.Request.Headers.Cookie);
await trakero.PurchaseAsync("10023", 2580m, "BDT", customer: new Customer(Phone: "01712345678"), shopper: shopper);

গুগল ট্যাগ ম্যানেজার এবং dataLayer

dataLayer: true থাকলে, SDK আপনার সাইট বা GTM কন্টেইনারের আগে থেকেই থাকা GA4 ই-কমার্স ইভেন্টগুলো পড়ে (dataLayer.push({ event, ecommerce }) এবং gtag("event", …)), এমনকি লোড হওয়ার আগের ইভেন্টগুলোও। পারচেজের জন্য transaction_id দরকার; এটি purchase_{transaction_id} এ পরিণত হয় যাতে এটি আপনার সার্ভারের কপির সাথে মিলে যায়। GTM-এ, এটি একটি Custom HTML ট্যাগে পেস্ট করুন যা Initialization - All Pages এ ফায়ার হয়। অন্য নামের অ্যারে পড়তে true এর বদলে স্ট্রিং দিন। গুগল ট্যাগ ম্যানেজার গাইড দেখুন।

<script>
  window.trakero=window.trakero||function(){(trakero.q=trakero.q||[]).push(arguments)};
  trakero("init", { key: "pk_live_…", dataLayer: true });
</script>
<script async src="https://track.yourstore.com/sdk/v1/trakero.js"></script>

একই ইভেন্টের জন্য trakero("purchase", …) কল করবেন না, নতুবা ইভেন্টগুলো দুবার গোনা হবে।

ওয়েবহুক (Webhooks)

আপনার নিজস্ব https এন্ডপয়েন্টে (আপনার ERP, ডেটা ওয়্যারহাউস, স্ল্যাক বট) প্রতিটি ইভেন্ট JSON হিসেবে পেতে একটি ওয়েবহুক ডেস্টিনেশন যোগ করুন। কাস্টমার ডেটা হিসেবে শুধু SHA-256 হ্যাশ পাঠানো হয়। প্রাইভেট এবং ইন্টারনাল অ্যাড্রেস প্রত্যাখ্যান করা হয়। প্রতিটি রিকোয়েস্টে Trakero-Signature: t=<unix>,v1=<hex> থাকে, যেখানে v1 হলো আপনার সাইনিং সিক্রেট দিয়ে {t}.{raw body} এর HMAC-SHA256। ৫ মিনিটের বেশি পুরনো t যুক্ত রিকোয়েস্ট বাতিল করুন। 2xx রেসপন্স দিন; 5xx এবং টাইমআউটে আবার চেষ্টা করা হয়, 410 পেলে ডেস্টিনেশন পজ হয়ে যায়।

// Node.js
import { createHmac, timingSafeEqual } from "node:crypto";
export function verify(rawBody: string, header: string, secret: string) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

// PHP
function trakero_verify(string $raw, string $header, string $secret): bool {
    parse_str(str_replace(',', '&', $header), $p);
    if (abs(time() - (int) $p['t']) > 300) return false;
    return hash_equals(hash_hmac('sha256', $p['t'] . '.' . $raw, $secret), $p['v1']);
}

স্ট্যান্ডার্ড ইভেন্টস

page_view, view_content, search, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_payment_info, purchase, refund, cancel, lead, generate_lead, sign_up, login, contact, complete_registration, subscribe, start_trial, add_to_wishlist। অন্য যেকোনো নামকে কাস্টম ইভেন্ট ধরা হয়।

ডিডুপ্লিকেশন (Deduplication)

একটি পারচেজ purchase:order:{order_id} দিয়ে শনাক্ত করা হয়; অন্য ইভেন্টগুলো {event_name}:id:{event_id} দিয়ে। ৪৮ ঘণ্টার মধ্যে একই সোর্স থেকে আসা হুবহু রিপিট ইনজেশনে বাতিল করা হয় (রেসপন্সে duplicates এ দেখানো হয়)। ভিন্ন সোর্স থেকে (ব্রাউজার এবং সার্ভার) আসা কপিগুলো একটি ইভেন্টে মার্জ হয়। ডেস্টিনেশনগুলো সবসময় একই লজিক্যাল event_id পায়, এবং GA4 অর্ডার আইডিকে transaction_id হিসেবে পায়, ফলে তাদের নিজস্ব ডিডুপ্লিকেশনও ঠিক থাকে। পিক্সেল + CAPI ডিডুপ্লিকেশন দেখুন।

লিমিটস

রেসপন্স এবং এরর

একটি সঠিক রিকোয়েস্ট 202 রিটার্ন করে, সাথে প্রতি-ইভেন্টের রেজাল্ট থাকে। একটি ইনভ্যালিড ইভেন্ট শুধু নিজেই বাতিল হয়; ব্যাচের বাকি অংশ গ্রহণ করা হয়।

202 Accepted
{ "request_id": "…", "accepted": 1, "duplicates": 0,
  "errors": [ { "index": 1, "code": "missing_order_id", "message": "purchase requires ecommerce.order_id." } ] }