واجهات API للتحويلات

1. لماذا جانب الخادم أصلًا؟

على بكسل المتصفح تجاوز ثلاثة عوائق قبل الإبلاغ عن تحويل: مانع إعلانات وإعداد منع تتبع وإغلاق الزائر للتبويب قبل تشغيله. ينجو استدعاء الخادم من الثلاثة لأنه لا يحدث في المتصفح أصلًا.

يعرف MousePlayer بالفعل تحقق أهدافك — هذا غرض الأهداف. تمرر واجهات API للتحويلات تلك الحقيقة للشبكة من خادمنا ببساطة.

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 النقرة الإعلانية أو ملف _uetmsclkid الذي يكتبه وسم UET

بموافقة فقط

كل استدعاء خلف بوابة الموافقة نفسها للتسجيل. لا تُنتج جلسة دون موافقة تقرير تحويل، بغض النظر عن مفتاح إعدادات المشروع.

3. لـ Google Ads ثلاثة معرّفات لا واحد

هذا يفاجئ الناس، لذا نوضحه. يستخدم Google gclid لنقرة إعلانية فردية. حين يمنع تتبع Apple إسناد نقرة فردية، يرسل Google wbraid أو gbraid بدلًا منه، ليمثلا مجموعة نقرات.

الثلاثة متنافية — يرفض Google تحويلًا يحمل اثنين. نرسل واحدًا بالضبط، وتكون الأولوية لـ gclid عند وجود أكثر من واحد لأنه الأدق.

توجد في URL مرة واحدة فقط

يظهر المعرّف في عنوان أول صفحة بعد النقرة الإعلانية فقط. يحفظه وسم Google بعدها في ملف _gcl_aw . نقرأ الملف كبديل — دونه لا يجد تحويل في الصفحة الثالثة للزيارة أي معرّف.

4. الإعداد

Meta وLinkedIn وTikTok

حقلان لكل منها: معرّف البكسل أو قاعدة التحويل ورمز وصول تنشئه في واجهة الشبكة. يُخزّن كلاهما بتشفير AES-256-GCM ولا يُعرضان مجددًا بعد الحفظ.

يتطلب Google Ads ستة

Google استثناء، ويستحق السبب معرفته قبل البدء: بخلاف الثلاثة الأخرى لا يصدر رمز وصول بسيطًا. يجري الوصول عبر OAuth برمز تحديث، وتتطلب Ads API أيضًا رمز مطور.

الحقل	مكانه
معرّف العميل	أعلى اليمين في Google Ads. أرقام فقط دون الشرطات.
معرّف إجراء التحويل	الأهداف والتحويلات ثم الإجراء الذي تريد تسجيله فيه.
رمز المطور	حسابك الإداري في Google Ads، مركز API.
معرّف عميل OAuth وسره	Google Cloud Console، بيانات الاعتماد، عميل OAuth من نوع «تطبيق سطح مكتب».
رمز التحديث	تنشئه بنفسك مرة للنطاق adwords.

مساران في LinkedIn، وتحتاج القصير

في مدير الحملات: البيانات، مدير الإشارات، Direct API، إنشاء رمز وصول. هذا مسار المعلنين لإرسال بياناتهم — دون تطبيق مطور أو مراجعة. لا ينتهي الرمز، ولن يُعرض ثانية، فانسخه فورًا.

المسار الآخر عبر تطبيق مطور مطلوب من بوابة LinkedIn للمطورين مخصص لمنصات ترسل نيابة عن معلنين كثيرين. يتطلب التحقق من صفحة الشركة واعتماد حالة استخدام، ولا تحتاج أيًا منه هنا.

Microsoft Advertising هو الأسهل

بعد Google Ads تتوقع التعقيد نفسه — OAuth ورمز مطور واعتمادًا. العكس تمامًا: حقلان. معرّف وسم UET المستخدم في المتصفح ورمز تنسخه من Microsoft Advertising تحت وسم UET، «استخدام Conversions API»، «نسخ الرمز». لا طلب اعتماد.

استخدم معرّف الوسم نفسه في المتصفح. يتيح ذلك لـ Microsoft عد الحدثين في الخادم والمتصفح تحويلًا واحدًا لا اثنين.

5. متى يُبلغ عن تحويل

مرة واحدة بالضبط لكل هدف وجلسة. يمنع MousePlayer التكرار قبل الاستدعاء، وتحمل الحمولة أيضًا معرّفًا لتمنعه الشبكة من جهتها. زائر يضيف خمسة منتجات للسلة ينتج تحويلًا واحدًا لا خمسة.

ما تراه في حساب الإعلان

يحمل التحويل اسم هدفك وقيمته وعملته إن حددتهما ووقت حدوثه. يصل خلال دقيقة في التشغيل العادي.

إذا لم يصل شيء

• لا معرّف نقرة. لم يأتِ الزائر من إعلان للشبكة، أو وصل قبل وضع البكسل لملف الارتباط. لا يُرسل شيء — متوقع وليس خطأ.
• لا موافقة. البوابة تأتي أولًا.
• قبلت الشبكة الاستدعاء لكنها رفضت التحويل. تجيب Google وTikTok وأخرى بـ HTTP 200 وخطأ داخل الرد. نقرأ الجسم لا الحالة فقط، ويظهر السبب في سجل التسليم.