مقصد جي تڪميل جون API
پنهنجا مقصد برائوزر بدران اسان جي سرور مان Meta، LinkedIn، TikTok ۽ Google Ads کي رپورٽ ڪريو — رڳو نيٽ ورڪ جي پنهنجي مقرر ڪيل ڪلڪ سڃاڻپ ڪوڊ سان ملايل.
1. سرور پاسي ڇو؟
برائوزر pixel کي مقصد جي تڪميل رپورٽ ڪرڻ کان اڳ ٽي شيون ٽپڻيون پون ٿيون: ad blocker، ٽريڪنگ روڪيندڙ سيٽنگ، ۽ pixel هلڻ کان اڳ مهمان جو ٽيب بند ڪرڻ. سرور پاسي ڪال ٽنهي کان بچي ٿي، ڇاڪاڻ ته برائوزر ۾ ٿئي ئي نٿي.
MousePlayer اڳ ئي ڄاڻي ٿو ته توهان جو مقصد ڪڏهن حاصل ٿيو — مقصد ان لاءِ ئي آهن. Conversions API رڳو اها حقيقت اسان جي سرور مان اشتهاري نيٽ ورڪ ڏانهن موڪلين ٿيون.
هي توهان جي pixel جو متبادل ناهي. برقرار رکو. هر نيٽ ورڪ ٻنهي کي هڪٻئي سان ملائي نقل ختم ڪري ٿو، ۽ اسان گهربل سڃاڻپ ڪوڊ موڪليون ٿا.
2. ڇا موڪليون ٿا — ۽ ڇا ڪڏهن نه
انهن ڪالن ۾ مهمان کي سڃاڻيندڙ اڪيلي شيءِ آهي نيٽ ورڪ جي پنهنجي مقرر ڪيل ڪوڪي يا ڪلڪ سڃاڻپ ڪوڊ. ماڻهو بابت ٻيو ڪجهه اسان جو سرور نٿو ڇڏي.
| نيٽ ورڪ | استعمال ٿيل سڃاڻپ ڪوڊ | ڪٿان اچي ٿو |
|---|---|---|
| Meta | _fbp، _fbc | Meta pixel جون مقرر ڪيل پنهنجي سائيٽ جون ڪوڪيون |
li_fat_id | LinkedIn Insight Tag جي مقرر ڪيل پنهنجي سائيٽ جي ڪوڪي | |
| TikTok | _ttp، ttclid | _ttp ڪوڪي آهي، ttclid اشتهاري ڪلڪ جي URL مان اچي ٿو |
| Google Ads | gclid، wbraid، gbraid | اشتهاري ڪلڪ جي URL مان، يا پوءِ هن _gcl_aw ڪوڪي مان |
| Microsoft Advertising | msclkid | اشتهاري ڪلڪ جي URL مان، يا هن _uetmsclkid ڪوڪي مان جيڪا UET tag لکي ٿو |
ڪڏهن به نه موڪليل: اي ميل پتو، فون نمبر، نالو يا IP پتو — hash ڪيل به نه. مهمان وٽ ڪلڪ سڃاڻپ ڪوڊ نه هجي ته ڪجهه به نٿو موڪليو وڃي. اڻملندڙ مقصد جي تڪميل توهان لاءِ صحيح ڳڻپ کان گهٽ قيمتي آهي.
رڳو رضامندي سان
انهن مان هر ڪال خود رڪارڊنگ واري ساڳي رضامندي روڪ پويان آهي. بنا رضامندي سيشن مقصد جي تڪميل رپورٽ نٿو ٺاهي، پروجيڪٽ سيٽنگن جو سوئچ ڪجهه به هجي.
3. Google Ads وٽ ٽي سڃاڻپ ڪوڊ آهن، هڪ نه
ماڻهو حيران ٿين ٿا، تنهنڪري صاف چوڻ گهرجي. Google هي استعمال ڪري ٿو gclid هڪ اشتهاري ڪلڪ لاءِ. Apple جي ٽريڪنگ روڪ هڪ ڪلڪ کي منسوب نه ٿيڻ لائق ڪري ته Google هي موڪلي ٿو wbraid يا gbraid ان جي بدران، جيڪي ڪلڪن جي گروپ لاءِ آهن.
ٽئي هڪٻئي کي خارج ڪن ٿا — Google ٻن ڪوڊن واري مقصد جي تڪميل رد ڪري ٿو. اسان بلڪل هڪ موڪليون ٿا، ۽ gclid هڪ کان وڌيڪ موجود هجي ته کٽي ٿو، ڇاڪاڻ ته سڀ کان صحيح آهي.
URL ۾ رڳو هڪ ڀيرو اچن ٿا
سڃاڻپ ڪوڊ پتي ۾ رڳو هن تي اچي ٿو پهرين صفحي تي، اشتهاري ڪلڪ کان پوءِ. پوءِ Google tag ان کي هن ۾ رکي ٿو _gcl_aw ڪوڪي. اسان ڪوڪي کي متبادل طور پڙهون ٿا — ان کان سواءِ آمد جي ٽئين صفحي تي مقصد جي تڪميل لاءِ ڪو سڃاڻپ ڪوڊ ئي نه ملي ها.
4. سيٽ اپ
Meta، LinkedIn ۽ TikTok
هر هڪ جا ٻه خانا: pixel يا مقصد جي قاعدي جو ID، ۽ نيٽ ورڪ جي پنهنجي انٽرفيس ۾ ٺاهيل access token. ٻئي AES-256-GCM سان انڪرپٽ ٿي محفوظ ٿين ٿا ۽ محفوظ ٿيڻ کان پوءِ وري نه ڏيکاريا وڃن ٿا.
Google Ads کي ڇهه گهرجن
Google استثنا آهي، ۽ شروع ڪرڻ کان اڳ سبب ڄاڻڻ سٺو آهي: ٻين ٽن جي ابتڙ Google ڪو سادو access token نٿو ڏئي. رسائي refresh token سان OAuth مان ٿئي ٿي، ۽ Ads API کي اضافي هي گهرجي developer token.
| خانو | ڪٿي ملي |
|---|---|
| گراهڪ ID | Google Ads ۾ مٿي ساڄي پاسي. رڳو انگ، بنا dash جي. |
| مقصد جي عمل جو ID | مقصد ۽ تڪميلون، پوءِ اهو عمل جنهن ۾ توهان هي ڳڻائڻ چاهيو ٿا. |
| ڊولپر token | توهان جي Google Ads manager اڪائونٽ جو API Center. |
| OAuth ڪلائنٽ ID ۽ secret | Google Cloud Console، Credentials، “desktop app” قسم جو OAuth client. |
| تجديد token | هي توهان پاڻ هڪ ڀيرو هن scope لاءِ ٺاهيو ٿا adwords. |
LinkedIn جا ٻه رستا آهن، توهان کي مختصر گهرجي
Campaign Manager ۾: ڊيٽا، Signals Manager، Direct API، access token ٺاهيو. پنهنجي ڊيٽا موڪليندڙ اشتهار ڏيندڙن لاءِ اهو رستو آهي — نه developer application، نه جائزو. token ختم نٿو ٿئي، ۽ Campaign Manager ٻيو ڀيرو نه ڏيکاريندو، تنهنڪري فوري ڪاپي ڪريو.
ٻيو رستو، LinkedIn جي Developer Portal مان گهريل developer app، گهڻن اشتهار ڏيندڙن جي طرفان موڪليندڙ پليٽ فارمن لاءِ آهي. ڪمپني صفحي جي تصديق ۽ منظور ٿيل استعمال گهرجي، ۽ هتي انهن مان ڪجهه به ضروري ناهي.
Microsoft Advertising سولو آهي
Google Ads کان پوءِ ساڳئي بار جي اميد هوندي — OAuth، developer token، منظوري جو قدم. پر ابتڙ آهي: ٻه خانا. اهو UET tag ID جيڪو اڳ ئي برائوزر ۾ استعمال ڪريو ٿا، ۽ token جيڪو Microsoft Advertising ۾ UET tag هيٺ “Conversions API استعمال ڪريو”، “Token ڪاپي ڪريو” مان وٺو ٿا. درخواست ڏيڻ لاءِ ڪجهه ناهي.
استعمال ڪريو ساڳيو tag ID جيڪو برائوزر tag ۾ آهي. ان سان Microsoft سرور پاسي واقعي ۽ برائوزر واقعي کي ٻن بدران هڪ مقصد جي تڪميل سڃاڻي ٿو.
Developer token لاءِ Google جي منظوري گهرجي (“Basic access”)، ۽ ان ۾ ڪجهه ڏينهن لڳن ٿا. اهو اڪيلو قدم آهي جيڪو هڪ منٽ ۾ مڪمل نٿا ڪري سگهو، تنهنڪري پهرين شروع ڪريو. اسان ڪڏهن به توهان جو Google پاس ورڊ نٿا ڏسون — رڳو refresh token، جيڪو ڪنهن به وقت واپس وٺي سگهو ٿا.
5. مقصد جي تڪميل ڪڏهن رپورٽ ٿئي ٿي
هر مقصد ۽ سيشن لاءِ بلڪل هڪ ڀيرو. MousePlayer ڪال موڪلڻ کان اڳ نقل روڪي ٿو، ۽ ڊيٽا ۾ اضافي ID به آهي ته نيٽ ورڪ پنهنجي پاسي ٻيهر نقل روڪي. ڪارٽ ۾ پنج شيون وجهندڙ مهمان هڪ مقصد جي تڪميل ٺاهي ٿو، پنج نه.
اشتهاري اڪائونٽ ۾ ڇا ڏسندا
مقصد جي تڪميل توهان جي مقصد جو نالو، قدر، مقرر هجي ته ڪرنسي ۽ ٿيڻ جو وقت کڻي ٿي. عام هلڻ ۾ هڪ منٽ اندر اچي ٿي.
ڪجهه نٿو پهچي ته
- ڪلڪ سڃاڻپ ڪوڊ ناهي. مهمان انهيءَ نيٽ ورڪ جي اشتهار مان نه آيو، يا pixel جي ڪوڪي رکڻ کان اڳ پهتو. ڪجهه نٿو موڪليو وڃي — هي متوقع آهي، غلطي نه.
- رضامندي ناهي. روڪ پهرين آئي.
- نيٽ ورڪ ڪال قبول ڪئي پر مقصد جي تڪميل رد ڪئي. Google، TikTok ۽ ٻيا ڪيترائي HTTP 200 سان جواب ڏين ٿا، پر جواب جي body ۾ غلطي هوندي آهي. اسان body پڙهون ٿا، رڳو status نه، ۽ سبب ترسيل لاگ ۾ اچي ٿو.
هتي ڄاڻايل سڀ تجارتي نشان پنهنجن مالڪن جا آهن. MousePlayer جو انهن فراهم ڪندڙن سان ڪو ڪاروباري لاڳاپو ناهي.