Ready2GEO إعلانات ChatGPT

pixel ChatGPT Ads وConversions API: تثبيت تتبّع التحويلات

آخر تحديث: 24 أغسطس 2026، مُتحقَّق منه انطلاقاً من وثائق OpenAI الرسمية. أسماء الأحداث والمعاملات المذكورة هنا مأخوذة من وثائق OpenAI للمطوّرين، وهي قابلة للتغيّر خلال مرحلة بيتا.

من دون قياس للتحويلات، تبقى حملة ChatGPT Ads عمياء: تعرف ما تنفقه، لا ما تحصل عليه. والأهم أنك لا تستطيع تفعيل التحسين نحو التحويل. تغطي هذه الصفحة الطريقتين الرسميتين، pixel المتصفح وConversions API من جهة الخادم، وكيفية جعلهما يتعايشان. أما الإطار العام فتجده في دليلنا حول ChatGPT Ads.

2 دقيقة قراءة
J Josh خبير SEO وGEO في Ready2GEO

محركات الذكاء الاصطناعي التي تتناولها هذه الصفحة

2 مصدران رسميان للقياس: pixel جافاسكريبت وConversions API من جهة الخادم

لماذا القياس شرط مسبق لا خيار

ثلاثة أسباب، أحدها مانع:

  • مانع: يشترط التحسين نحو التحويل (oCPC) أن يكون التتبّع مُعدّاً سلفاً، عبر pixel جافاسكريبت، أو Conversions API، أو كليهما. فمن دون إشارة، لا يجد النظام ما يحسّنه.
  • يشمل تقرير Ads Manager عمود التحويلات الذي يبقى فارغاً إن لم يكن شيء موصولاً.
  • يتوقف حساب كلفة الاكتساب لديك على هذه البيانات كلياً: فمن دونها تدير الحملة بـ CPC، أي بالإنفاق لا بالنتيجة.

والمبدأ العام الذي تضعه OpenAI بسيط: تنشئ مصدر بيانات (data source) في Ads Manager، ثم ترسل إليه أحداث التحويل عبر pixel، أو عبر API، أو عبر كليهما.

pixel أم Conversions API: أيّهما تختار؟

pixel جافاسكريبتConversions API
أين ينفَّذفي متصفح الزائرعلى خادمك، حصراً
التنفيذسكريبت يُوضَع في headتطوير من جهة الواجهة الخلفية
المتانةحسّاس للحاجبات ولقيود المتصفحاتتقدّمه OpenAI بوصفه مصدراً أوثق من pixel وحده
توصية OpenAIنقطة انطلاقيُستخدَم كلما أمكن، للحصول على بيانات أدقّ

والجواب العملي ليس «هذا أو ذاك» بل «كلاهما، مع إزالة التكرار». فـ pixel يُثبَّت في ساعة ويُحيي الحملات فوراً؛ ثم يُوصَل الـ API لاحقاً فيؤمّن القياس على المدى الطويل.

تثبيت pixel القياس

pixel القياس الخاص بـ ChatGPT Ads هو SDK للمتصفح غايته قياس أحداث موقعك القابلة للإسناد إلى إعلانات داخل ChatGPT. ويُحمَّل السكريبت بشكل غير متزامن من https://bzrcdn.openai.com/sdk/oaiq.min.js، ويوضَع في قسم <head>، ثم يُهيَّأ بمعرّف pixel الخاص بك:

oaiq("init", { pixelId: "PIXEL-ID-الخاص-بك" });

المعامل pixelId إلزامي، ويُنشَأ في Ads Manager. أما المعامل الاختياري debug فيكتب نشاط الـ SDK في وحدة تحكم المتصفح، وهو مفيد أثناء مرحلة الاختبار.

ويمرّ القياس كله بعد ذلك عبر أمر واحد: oaiq("measure", اسم_الحدث, بيانات_الحدث, الخيارات).

الأحداث القياسية والأحداث المخصّصة وقيودها

ينتظر كل حدث قياسي كائن بيانات يجب أن يطابق حقل type فيه. وتصنّفها وثائق OpenAI للمطوّرين على النحو التالي:

العائلةالأحداثحقل type المتوقَّع
التجارةorder_created, items_added, checkout_startedcontents
المحتوىpage_viewed, contents_viewedcontents
العميل المحتمل والتسجيلlead_created, registration_completed, appointment_scheduledcustomer_action
الاشتراكsubscription_created, trial_startedplan_enrollment

وبالنسبة للأحداث من نوع contents، تشمل الحقول الموثّقة amount وcurrency ومصفوفة contents مؤلَّفة من مدخلات تحتوي على id وname وcontent_type وquantity. أما الأحداث من نوع plan_enrollment فتنتظر plan_id. وتوضّح الوثائق استخدام قيم صحيحة لـ amount وquantity.

وحين لا يطابق أي حدث قياسي حاجتك، يُصرَّح بحدث مخصّص عبر وسيط ثالث وكائن خيارات:

oaiq("measure", "custom", { type: "custom" }, { custom_event_name: "quote_requested" })

ويجب أن تحترم أسماء الأحداث المخصّصة قواعد دقيقة: من 1 إلى 64 حرفاً، وحروف وأرقام وشرطات سفلية وشرطات فقط، وأن تبدأ وتنتهي بمحرف أبجدي رقمي.

وانتبه لقيد بنيوي: لا يمكن لحدث مخصّص أن يكون هدفاً للتحسين في oCPC. فإن كان تحويلك التجاري هو ما ينبغي أن يقود التحسين، فيجب رفعه بوصفه حدثاً قياسياً.

وصل Conversions API من جهة الخادم

يُستخدَم الـ API من خادمك حصراً. ونقاط التنفيذ الموثّقة:

  • تنشئ مصدر تحويل ويب ومعرّف Pixel ID الخاص به عبر نقطة الدخول POST /conversions/pixels.
  • تولّد مفتاحاً قادراً على إرسال أحداث من جهة الخادم نيابةً عن الحساب الإعلاني الحالي.
  • يجب تخزين هذا المفتاح في مدير أسرار من جهة الخادم. والوثائق قاطعة: لا تضعه أبداً في كود المتصفح، ولا في متغيّرات بيئة ظاهرة من جهة العميل، ولا في السجلات، ولا في مستودع كود.
  • يقبل الـ API دفعات تصل إلى 1000 حدث. ونقطة حرجة لإدارة الأخطاء لديك: إذا أخفق حدث واحد من الدفعة، أخفقت الدفعة بأكملها.

وتستحق هذه القاعدة الأخيرة المعالجة منذ مرحلة التصميم: فدفعة تُرفض جملةً بسبب حقل سيّئ التنسيق في طلب واحد قد تُخفي 999 تحويلاً صالحاً من تقريرك.

إزالة التكرار بين pixel وAPI: القاعدة التي يجب ألا تفوتك

إذا أرسلت التحويل نفسه من pixel ومن Conversions API، فيجب إبلاغ النظام بذلك، وإلا حسبته مرتين. والطريقة الموثّقة:

  • إعادة استخدام القيمة نفسها كـ id في جهة الـ API وكـ event_id في جهة الـ pixel.
  • إرسال الحدثين بـ Pixel ID نفسه.
  • وبالنسبة للأحداث المخصّصة، استخدام custom_event_name نفسه في الجهتين.

وفي جهة الـ pixel، يبدو الأمر هكذا: oaiq("measure", "order_created", {...}, { event_id: "order_12345" }). وتستند المطابقة إلى Pixel ID واسم الحدث وevent_id؛ وبالنسبة لحدث مخصّص، يحلّ custom_event_name محل اسم الحدث في هذا المنطق.

عملياً: استخدم معرّف الطلب أو معرّف العميل المحتمل مفتاحاً لإزالة التكرار، فهو القيمة الوحيدة المتوفرة طبيعياً في الجهتين.

oppref: الحفاظ عليه حتى التحويل، لا مجرد التقاطه

يلتقط الـ pixel oppref، مرجع نقرة OpenAI، ويخزّنه في ملف تعريف ارتباط من الدرجة الأولى (__oppref). ولا يكفي توثيق التقاطه: تشدّد الوثائق الرسمية على نقطة تفوت كثيراً من التطبيقات، وهي أن oppref يجب أن يُحفَظ عبر عمليات إعادة التوجيه والتنقّل حتى الصفحة التي يُقاس فيها التحويل فعلياً. فتونيل دفع يمرّ عبر نطاق فرعي للدفع، أو إعادة توجيه بعد نموذج، أو سلة تغيّر النطاق، كلها تفقد ملف تعريف الارتباط في الطريق إن لم يُعَدّ شيء لنقله.

نقطة ثانية كثيراً ما تفوت: Conversions API لا يلتقط oppref نيابةً عنك، على عكس الـ pixel. فإن استدعيت الـ API من جهة الخادم، فعلى كودك أن يجلب قيمة oppref بنفسه (وهي عادةً ما يودعها الـ pixel في ملف تعريف ارتباط أو تُنقل كمعامل في الرابط) وأن يُدرجها صراحةً في الاستدعاء، حين تكون متاحة. من دون هذه الخطوة، يفقد الحدث المُرسَل عبر الـ API وحده الصلة بالنقرة الإعلانية التي سبقته.

وتقوم البنية الموصى بها من OpenAI على ثلاثة عناصر: الـ pixel على كل صفحة لالتقاط oppref والأحداث الخفيفة، وConversions API للأحداث ذات القيمة العالية المُرسَلة من الواجهة الخلفية لديك (حيث يوجد الطلب، وحيث لا شيء يمكن أن يحجب الاستدعاء)، والقناتان معاً ترسلان التحويل نفسه بـ event_id نفسه.

advanced matching التلقائي

يُستخدَم advanced matching التلقائي (AAM) لربط التحويلات بإعلاناتك حين لا يتوفر أي معرّف نقرة. فيكتشف الـ pixel تلقائياً معلومات العميل القابلة للتعرّف في النماذج ومصادر أخرى في موقعك، ويوحّد صيغتها، ويجزّئها بخوارزمية SHA-256 داخل المتصفح مباشرةً. وتوضّح الوثائق أنه لا تُنقَل أي بيانات خام.

ويمكنك أيضاً أن تقدّم بنفسك معرّفات مجزَّأة في كائن user عند التهيئة: email_sha256 وphone_number_sha256 وexternal_id_sha256 وfirst_name_sha256 وlast_name_sha256، إضافةً إلى حقول غير مجزَّأة هي country وcity وregion وpostal_code.

وتمسّ هذه الوظيفة بيانات شخصية: لذا يجب أن يُبَتّ في تفعيلها مع مسؤول حماية البيانات لديك، ولا سيما في أوروبا.

الموافقة وحماية البيانات وإدارة الـ pixel

يعرض الـ SDK أمراً للموافقة، يُستدعى قبل التهيئة لمنع القياس ما لم يوافق المستخدم:

oaiq("consent", false); ثم oaiq("init", { pixelId: "..." }); ثم oaiq("consent", true); بعد الحصول على الموافقة.

ونقطتان جديرتان بالتذكّر. أولاً، قيمة الموافقة هي true افتراضياً، إلا إذا ضُبطت صراحةً على false أو إذا سُجِّل رفض: فعلى موقع أوروبي إذن يجب استدعاء oaiq("consent", false) صراحةً مسبقاً بدل الاتكال على السلوك الافتراضي. وثانياً، حين تكون القيمة false، لا تُرسَل أحداث القياس.

ويتيح المعامل opt_out إضافةً إلى ذلك استثناء حدث من التخصيص على مستوى المستخدم؛ وقيمته الافتراضية false. ويدير الـ SDK كذلك معرّفاً يحترم الخصوصية اسمه oppref، يُلتقَط من الرابط ويُخزَّن في ملف تعريف ارتباط __oppref.

تذكير بالسياق: الإعلانات المخصّصة غير متاحة عند الإطلاق في المنطقة الاقتصادية الأوروبية ولا في سويسرا. وهذا لا يعفي إطلاقاً من إدارة الموافقة على القياس نفسه.

Content Security Policy: النطاقات الواجب السماح بها

أكثر أسباب الأعطال الصامتة شيوعاً على المواقع التي تطبّق CSP صارمة: حجب الـ SDK قبل أن يُهيَّأ أصلاً. والتوجيهات الموثّقة:

التوجيهالمصدر الواجب السماح بهالدور
script-srchttps://bzrcdn.openai.comتحميل الـ SDK
connect-srchttps://bzr.openai.com وhttps://bzrcdn.openai.comإرسال الأحداث واستردادها
img-srchttps://bzr.openai.comالحل البديل عبر طلب صورة

وإن لم يرفع الـ pixel شيئاً رغم أن الكود موضوع في مكانه، فافتح وحدة التحكم مع تفعيل المعامل debug: سيظهر خطأ CSP فيها فوراً.

ما لا يستطيع الـ pixel فعله

قيد صريح ينبغي معرفته قبل تصميم خطة الوسم لديك: لا يدعم pixel القياس الحدثين app_installed وapp_opened. ويجب إرسال هذين الحدثين من جهة الخادم، عبر Conversions API.

وتوثّق OpenAI إضافةً إلى ذلك تكاملات مع شركاء قياس، بمن فيهم شركاء القياس على الهاتف المحمول (MMP)، للمعلنين الذين يقع تحويلهم داخل تطبيق.

ونقطة انتباه أخرى: استخدام عدة Pixel IDs على الموقع نفسه يتطلب إعداداً خاصاً، توثّقه OpenAI على حدة.

الإسناد: ما الذي يُحتسَب، وكيف

تقيّم OpenAI أحداث التحويل في ضوء الأحداث المُعدّة لحملتك ونافذة الإسناد المطبَّقة. وثمة قاعدتان يجب معرفتهما:

  • يستخدم الإسناد بعد النقر نافذة النقر المُعدّة.
  • وتستخدم التحويلات بعد الظهور (view-through) نافذة ثابتة مدتها يوم واحد بعد ظهور مؤهَّل، مستقلة عن نافذة النقر لديك.

وقاعدة القراءة التي تجنّبك أخطاء الحساب: لا يحتوي عمود التحويلات الرئيسي إلا على التحويلات بعد النقر. أما التحويلات بعد الظهور فهي تقرير إضافي منفصل، وبحسب OpenAI يجب عدم إضافته إلى التحويلات ولا استخدامه في مقاييس أداء أساسية مثل CPA.

قائمة تحقق قبل الإطلاق

  1. مصدر بيانات مُنشأ في Ads Manager، وPixel ID مسترجَع.
  2. سكريبت محمَّل في head، وتهيئة مستدعاة بالـ Pixel ID الصحيح.
  3. الموافقة موصولة قبل التهيئة على المواقع الأوروبية.
  4. أحداث قياسية تُطلَق في المواضع الصحيحة، بحقل type الصحيح.
  5. إزالة التكرار قائمة إن كنت تضاعف مع الـ API: القيمة نفسها في id وevent_id، وPixel ID نفسه.
  6. CSP محدَّثة للتوجيهات الثلاثة.
  7. وضع debug مفعَّل أثناء الاختبار، ثم مُعطَّل.
  8. صفحة الهبوط متاحة لـ OAI-AdsBot: فصفحة محجوبة قد تؤدي إلى رفض الإعلان، بصرف النظر عن جودة الوسم. ويتحقّق فاحص صفحة الهبوط لـ ChatGPT Ads من هذه النقطة.
  9. حدث قياسي نشط واحد فقط مُعتمَد هدفاً إن كنت تقصد oCPC، مع العلم أنه لن يكون قابلاً للتعديل بعد إنشاء الحملة.

الأسئلة الشائعة

هل تتبّع التحويلات إلزامي على ChatGPT Ads؟
ليس للعرض بنموذج CPM أو CPC، لكنه إلزامي للتحسين نحو التحويل: فـ oCPC يشترط أن يكون التتبّع مُعدّاً سلفاً عبر pixel جافاسكريبت أو Conversions API أو كليهما، وأن يخدم حدث تحويل قياسي نشط بوصفه هدفاً.
هل يجلب Conversions API قيمة oppref من تلقاء نفسه؟
لا. الـ pixel وحده يلتقط تلقائياً oppref، مرجع نقرة OpenAI، ويخزّنه في ملف تعريف ارتباط. ويجب أن يُدرجه استدعاء Conversions API صراحةً حين يكون متاحاً: فعلى كودك أن يجلبه بنفسه، إذ لا يفعل الـ API ذلك نيابةً عنك. ولهذا السبب بالتحديد توصي OpenAI بتشغيل الـ pixel والـ API معاً، لا أحدهما بدل الآخر.
هل يجب الاختيار بين pixel وConversions API؟
لا، يمكن أن يتعايشا. تقدّم OpenAI الـ Conversions API بوصفه مصدراً أوثق من pixel وحده وتوصي باستخدامه كلما أمكن. وإن أرسلت التحويل نفسه من الجهتين، فيجب إزالة التكرار.
كيف أتجنّب احتساب تحويل مرتين؟
بإعادة استخدام القيمة نفسها كـ id في جهة الـ API وكـ event_id في جهة الـ pixel، وبإرسال الحدثين بـ Pixel ID نفسه، وباستخدام custom_event_name نفسه في الجهتين للأحداث المخصّصة.
هل يمكن لحدث مخصّص أن يكون هدفاً لـ oCPC؟
لا. توضّح الوثائق أن الأحداث المخصّصة لا يمكن أن تكون أهدافاً للتحسين في oCPC. بل يلزم حدث تحويل قياسي نشط واحد بالضبط هدفاً، ولا يعود قابلاً للتعديل بعد إنشاء الحملة.
هل يحترم الـ pixel موافقة المستخدم؟
يعرض الـ SDK أمراً للموافقة. ونقطة يجب معرفتها: قيمة الموافقة هي true افتراضياً، إلا إذا ضُبطت صراحةً على false أو إذا سُجِّل رفض. فعلى موقع أوروبي إذن يجب استدعاء الأمر صراحةً بقيمة false قبل التهيئة، ثم الانتقال إلى true بعد جمع الموافقة.
الـ pixel لا يرفع شيئاً، ما الذي أتحقّق منه أولاً؟
من Content Security Policy. فالـ SDK يحتاج إلى https://bzrcdn.openai.com في script-src، وإلى https://bzr.openai.com وhttps://bzrcdn.openai.com في connect-src، وإلى https://bzr.openai.com في img-src. فعّل المعامل debug عند التهيئة لرؤية الخطأ في وحدة التحكم.
كيف أقيس تثبيت تطبيق؟
ليس بالـ pixel: فهو لا يدعم app_installed ولا app_opened. ويجب إرسال هذين الحدثين من جهة الخادم عبر Conversions API. وتوثّق OpenAI أيضاً تكاملات مع شركاء القياس على الهاتف المحمول.
ما هي نافذة الإسناد؟
يستخدم الإسناد بعد النقر نافذة النقر المُعدّة. أما التحويلات بعد الظهور فتستخدم نافذة ثابتة مدتها يوم واحد بعد ظهور مؤهَّل، مستقلة عن نافذة النقر، وتُقدَّم في تقرير منفصل عن عمود التحويلات الرئيسي.
اختبر موقعك خلال 30 ثانية

درجة SEO، درجة GEO، الأداء والتصميم المتجاوب: 49 نقطة مفحوصة، وحكم AI Overviews فوري.

ابدأ اختبار SEO وGEO

أدلة ذات صلة

إعلانات ChatGPT: الدليل الكامل لعام 2026 للإعلان داخل ChatGPT

كيف تعمل ChatGPT Ads، وأين تتوفر، وكيف تنشئ حساباً وتبني حملة وتستهدف عبر context hints وتقدّر ميزانيتك: الدليل المرجعي، محدَّث باستمرار.

قراءة الدليل

أسعار ChatGPT Ads: المزايدات والميزانيات والكلفة الفعلية للحملة

كم تكلّف حملة ChatGPT Ads فعلاً: نماذج المزايدة الثلاثة، ومزايدة البداية التي توصي بها OpenAI، والحد الأدنى للإنفاق اليومي، والفوترة عبر عتبة الدفع.

قراءة الدليل

ChatGPT Ads للتجارة الإلكترونية: حملات انطلاقاً من product feed

ربط كتالوجك بـ ChatGPT Ads: طرق إرسال الخلاصة الثلاث، وانتهاء صلاحية العناصر، وحقل is_ads_eligible، والفرق بينها وبين نتائج المنتجات الطبيعية.

قراءة الدليل