Introduction

Content-Type: application/json
X-PF-Key: YOUR_API_KEY

{
  "event": "Purchase",
  "event_id": "unique-event-id-123",
  "value": 5000,
  "currency": "BDT",
  "order_id": "ORDER-123",
  "content_ids": ["SKU123"],
  "user_data": {
    "email": "customer@example.com",
    "phone": "+8801712345678"
  }
}

$response = Http::withHeaders([
    'X-PF-Key' => env('PIXELFLY_API_KEY'),
])->post('https://track.pixelfly.io/e', [
    'event' => 'Purchase',
    'event_id' => Str::uuid()->toString(),
    'value' => $order->total,
    'currency' => 'BDT',
    'order_id' => $order->id,
    'user_data' => [
        'email' => $order->email,
        'phone' => $order->phone,
    ],
]);

{
  "success": true,
  "event_id": "unique-event-id-123"
}

{
  "event": "purchase",
  "event_id": "purchase_12345_1699012345",
  "event_time": 1699012345,
  "action_source": "website",
  "event_source_url": "https://yoursite.com/thank-you/12345",

  "transaction_id": "12345",
  "value": 1500.00,
  "currency": "BDT",
  "tax": 0,
  "shipping": 60.00,
  "coupon": "SAVE10",

  "items": [
    {
      "item_id": "SKU-001",
      "item_name": "Product Name",
      "price": 750.00,
      "quantity": 2,
      "item_category": "Category",
      "item_variant": "Red / Large"
    }
  ],

  "content_ids": ["SKU-001"],

  "user_data": {
    "em": "customer@example.com",
    "ph": "01712345678",
    "fn": "john",
    "ln": "doe",
    "ct": "dhaka",
    "st": "Dhaka",
    "zp": "1205",
    "country": "BD",
    "external_id": "01712345678",
    "fbp": "fb.1.1234567890.987654321",
    "fbc": "fb.1.1234567890.AbCdEfGh",
    "ga_client_id": "1234567890.0987654321"
  },

  // Root level for easy access
  "fbp": "fb.1.1234567890.987654321",
  "fbc": "fb.1.1234567890.AbCdEfGh",
  "ga_client_id": "1234567890.0987654321",
  "gclid": "CjwKCAjw...",
  "fbclid": "IwAR3abc123xyz",
  "ttclid": "E.CP...",
  "msclkid": "abc123",

  "context": {
    "ip": "103.123.45.67",
    "user_agent": "Mozilla/5.0...",
    "is_delayed": true,
    "utm": {
      "utm_source": "facebook",
      "utm_medium": "cpc",
      "utm_campaign": "spring_sale"
    }
  }
}

function getTrackingData() {
  function getCookie(name) {
    const value = `; ${document.cookie}`;
    const parts = value.split(`; ${name}=`);
    if (parts.length === 2) return parts.pop().split(';').shift();
    return null;
  }

  function getUrlParam(param) {
    return new URLSearchParams(window.location.search).get(param);
  }

  // Facebook IDs
  let fbp = getCookie('_fbp');
  let fbc = getCookie('_fbc');
  const fbclid = getUrlParam('fbclid');
  if (!fbc && fbclid) {
    fbc = 'fb.1.' + Date.now() + '.' + fbclid;
  }

  // GA Client ID (last 2 parts of _ga cookie)
  let gaClientId = null;
  const gaCookie = getCookie('_ga');
  if (gaCookie) {
    const parts = gaCookie.split('.');
    if (parts.length >= 4) {
      gaClientId = parts[2] + '.' + parts[3];
    }
  }

  return {
    fbp: fbp,
    fbc: fbc,
    fbclid: fbclid,
    gclid: getUrlParam('gclid') || getCookie('_gcl_aw'),
    ga_client_id: gaClientId,
    ttclid: getUrlParam('ttclid') || getCookie('_ttp'),
    msclkid: getUrlParam('msclkid'),
    utm_source: getUrlParam('utm_source'),
    utm_medium: getUrlParam('utm_medium'),
    utm_campaign: getUrlParam('utm_campaign')
  };
}

function getTrackingCookies($request) {
    $data = [];

    // Facebook Browser ID
    $data['fbp'] = $request->cookie('_fbp') ?? $_COOKIE['_fbp'] ?? null;

    // Facebook Click ID
    $fbc = $request->cookie('_fbc') ?? $_COOKIE['_fbc'] ?? null;
    if (!$fbc && $request->has('fbclid')) {
        $fbc = 'fb.1.' . time() . '.' . $request->input('fbclid');
    }
    $data['fbc'] = $fbc;
    $data['fbclid'] = $request->input('fbclid');

    // GA Client ID (last 2 parts of _ga cookie)
    $gaCookie = $request->cookie('_ga') ?? $_COOKIE['_ga'] ?? null;
    if ($gaCookie) {
        $parts = explode('.', $gaCookie);
        if (count($parts) >= 4) {
            $data['ga_client_id'] = $parts[2] . '.' . $parts[3];
        }
    }

    // Click IDs
    $data['gclid'] = $request->input('gclid');
    $data['ttclid'] = $request->input('ttclid') ?? $request->cookie('_ttp');
    $data['msclkid'] = $request->input('msclkid');

    return array_filter($data);
}