کنورژنز کی APIs

1. سرور سے بھیجنا کیوں؟

براؤزر پکسل کو کنورژن بتانے سے پہلے تین چیزوں سے بچنا پڑتا ہے: اشتہار روکنے والا ٹول، ٹریکنگ روکنے کی ترتیب، اور پکسل چلنے سے پہلے ملاحظہ کار کا ٹیب بند کرنا۔ سرور کی کال تینوں سے بچتی ہے، کیونکہ وہ براؤزر میں ہوتی ہی نہیں۔

MousePlayer کو پہلے ہی معلوم ہوتا ہے کہ آپ کا ہدف کب پورا ہوا — اہداف اسی لیے ہیں۔ کنورژنز کی APIs صرف یہ واقعہ ہمارے سرور سے اشتہاری نیٹ ورک کو پہنچاتی ہیں۔

2. ہم کیا بھیجتے ہیں — اور کیا کبھی نہیں بھیجتے

ان کالز میں ملاحظہ کار کی شناخت کرنے والی واحد چیز ہے: نیٹ ورک کی اپنی مقرر کردہ کوکی یا کلک شناخت کنندہ۔ شخص کی کوئی اور معلومات ہمارے سرور سے نہیں نکلتی۔

نیٹ ورک	استعمال کردہ شناخت کنندہ	کہاں سے آتا ہے
Meta	_fbp، _fbc	Meta پکسل کی مقرر کردہ فرسٹ پارٹی کوکیز
LinkedIn	li_fat_id	LinkedIn Insight Tag کی مقرر کردہ فرسٹ پارٹی کوکی
TikTok	_ttp، ttclid	_ttp ایک کوکی ہے، ttclid اشتہار کے کلک والے URL سے آتا ہے
Google Ads	gclid، wbraid، gbraid	اشتہار کے کلک والے URL سے، یا بعد میں اس کوکی سے: _gcl_aw۔
Microsoft Advertising	msclkid	اشتہار کے کلک والے URL سے، یا UET ٹیگ کی لکھی اس کوکی سے: _uetmsclkid۔

صرف رضامندی کے ساتھ

ہر کال اسی رضامندی کی شرط کے پیچھے ہے جو ریکارڈنگ پر لاگو ہے۔ رضامندی کے بغیر سیشن کنورژن رپورٹ نہیں بناتا، پروجیکٹ کی ترتیب کا سوئچ کچھ بھی ہو۔

3. Google Ads میں ایک نہیں، تین شناخت کنندگان ہیں

یہ بات حیران کرتی ہے، اس لیے واضح کرتے ہیں۔ Google ایک اشتہاری کلک کے لیے یہ استعمال کرتا ہے: gclid۔ Apple کی ٹریکنگ روکنے کی وجہ سے انفرادی کلک کی نسبت ممکن نہ ہو تو Google اس کے بجائے یہ بھیجتا ہے: wbraid یا gbraid، جو کلکس کے گروہ کو ظاہر کرتے ہیں۔

تینوں ایک دوسرے کو خارج کرتے ہیں — Google دو شناخت کنندگان والے کنورژن کو مسترد کرتا ہے۔ ہم بالکل ایک بھیجتے ہیں، اور gclid کو ایک سے زیادہ موجود ہونے پر ترجیح ملتی ہے، کیونکہ یہ سب سے درست ہے۔

وہ URL میں صرف ایک بار آتے ہیں

شناخت کنندہ اشتہار پر کلک کرنے کے بعد صرف پہلے صفحے کے پتے میں آتا ہے۔ پھر Google ٹیگ اسے اس کوکی میں محفوظ کرتا ہے: _gcl_aw۔ ہم کوکی کو متبادل کے طور پر پڑھتے ہیں — اس کے بغیر دورے کے تیسرے صفحے پر کنورژن کو کوئی شناخت کنندہ نہیں ملے گا۔

4. ترتیب دینا

Meta، LinkedIn اور TikTok

ہر ایک کے دو خانے: پکسل یا کنورژن قاعدے کی ID، اور نیٹ ورک کے اپنے انٹرفیس میں بنایا گیا رسائی ٹوکن۔ دونوں AES-256-GCM رمز شدہ محفوظ ہوتے ہیں اور محفوظ ہونے کے بعد پھر نہیں دکھتے۔

Google Ads کو چھ درکار ہیں

Google مختلف ہے، اور وجہ آغاز سے پہلے جاننا مفید ہے: باقی تینوں کے برخلاف Google سادہ رسائی ٹوکن نہیں دیتا۔ رسائی OAuth اور تجدید کے ٹوکن سے ہوتی ہے، اور Ads API کو مزید یہ درکار ہے: ڈویلپر ٹوکن۔

خانہ	کہاں ملتا ہے
گاہک ID	Google Ads میں اوپر دائیں۔ صرف اعداد، ڈیش کے بغیر۔
کنورژن ایکشن ID	اہداف اور کنورژنز میں، پھر وہ ایکشن جس کے نام یہ درج کرنا ہو۔
ڈویلپر ٹوکن	آپ کے Google Ads مینیجر اکاؤنٹ کے API Center میں۔
OAuth کلائنٹ ID اور خفیہ قدر	Google Cloud Console میں Credentials، “desktop app” قسم کا OAuth کلائنٹ۔
تجدید کا ٹوکن	آپ اسے اس دائرے کے لیے ایک بار خود بناتے ہیں: adwords۔

LinkedIn کے دو راستے ہیں، آپ کو مختصر راستہ چاہیے

Campaign Manager میں: Data، Signals Manager، Direct API، Generate access token۔ اپنے ڈیٹا کو بھیجنے والے مشتہرین کا یہی راستہ ہے — نہ ڈویلپر ایپ، نہ جائزہ۔ ٹوکن ختم نہیں ہوتا، اور Campaign Manager اسے دوبارہ نہیں دکھائے گا، اس لیے فوراً نقل کریں۔

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

Microsoft Advertising آسان ہے

Google Ads کے بعد اسی بوجھ کی توقع ہوتی ہے — OAuth، ڈویلپر ٹوکن، منظوری۔ مگر یہاں صرف دو خانے ہیں: براؤزر میں پہلے سے استعمال شدہ UET ٹیگ ID، اور Microsoft Advertising میں UET ٹیگ کے تحت “Use Conversions API”، “Copy Token” سے نقل کردہ ٹوکن۔ کسی درخواست کی ضرورت نہیں۔

اپنے براؤزر ٹیگ کی وہی ٹیگ ID استعمال کریں۔ اسی سے Microsoft سرور اور براؤزر کے ایونٹ کو دو کے بجائے ایک کنورژن مانتا ہے۔

5. کنورژن کب رپورٹ ہوتا ہے

ہر ہدف اور سیشن کے لیے بالکل ایک بار۔ MousePlayer کال بھیجنے سے پہلے نقل روکتا ہے، اور پےلوڈ میں ID بھی ہوتی ہے تاکہ نیٹ ورک اپنی طرف دوبارہ نقل روک سکے۔ ٹوکری میں پانچ اشیا ڈالنے والا ملاحظہ کار ایک کنورژن بناتا ہے، پانچ نہیں۔

اشتہاری اکاؤنٹ میں کیا نظر آئے گا

کنورژن میں ہدف کا نام، مقرر ہونے پر قدر اور کرنسی، اور وقوع کا وقت ہوتا ہے۔ معمول کے حالات میں یہ ایک منٹ میں پہنچ جاتا ہے۔

اگر کچھ نہ پہنچے

• کلک شناخت کنندہ موجود نہیں۔ ملاحظہ کار اس نیٹ ورک کے اشتہار سے نہیں آیا، یا پکسل کی کوکی مقرر ہونے سے پہلے پہنچا۔ کچھ نہیں بھیجا جاتا — یہ متوقع ہے، خرابی نہیں۔
• رضامندی موجود نہیں۔ رضامندی کی شرط پہلے لاگو ہوتی ہے۔
• نیٹ ورک نے کال قبول کی مگر کنورژن مسترد کیا۔ Google، TikTok اور کئی دوسرے HTTP 200 کے ساتھ جواب کے متن میں خرابی دیتے ہیں۔ ہم صرف اسٹیٹس نہیں، متن پڑھتے ہیں، اور وجہ ترسیل کے لاگ میں آتی ہے۔