بيكسل القياس من OpenAI يتيح لك إرسال أحداث التحويل من موقعك لمعرفة ما يحدث بعد نقر شخص على إعلان في ChatGPT. دليل عملي واضح لتثبيته وإرسال الأحداث وتحسين المطابقة - بدون تعقيدات تقنية.
إذا كنت تشغّل بالفعل (أو تخطط لتشغيل) إعلانات على ChatGPT، فالخطوة العملية التالية هي قياس ما يحدث فعلياً بعد النقرة. هذا بالضبط ما يفعله بيكسل القياس من OpenAI.
هو SDK خفيف يعمل في المتصفح. تضيف سكربت صغير إلى موقعك، تهيئه بمعرّف البيكسل (Pixel ID)، وتستدعي دالة بسيطة عندما يحدث تحويل (شراء، إرسال نموذج، بدء تجربة مجانية، وغيرها). بعد ذلك تستطيع OpenAI ربط هذه الأحداث بإعلاناتك في ChatGPT.
هذا الدليل يشرح الأساسيات بلغة بسيطة وواضحة. للمرجع الرسمي الكامل، راجع وثائق بيكسل القياس من OpenAI.
إذا كنت لا تزال تتعرّف على إعلانات ChatGPT نفسها، ابدأ بنظرتنا السابقة: إعلانات ChatGPT أصبحت متاحة: دليل مبسّط لأصحاب الأعمال.
ماذا يفعل بيكسل القياس؟
يعمل بيكسل قياس إعلانات ChatGPT في متصفح الزائر. يساعدك على قياس إجراءات الموقع التي يمكن ربطها بالإعلانات المعروضة في ChatGPT. تحصل على إسناد النقر (حسب نافذة النقر التي ضبطتها) وعند توفره لحسابك إسناد العرض (نافذة ثابتة ليوم واحد بعد ظهور الإعلان المؤهل). إذا كان التحويل مؤهلاً لكليهما، تكون الأولوية للنقر.
تظهر أرقام إسناد العرض كمقياس منفصل على مستوى الحملة في Ads Manager. ولا تغيّر طريقة عمل التحويلات أو CPA أو المزايدة أو التحسين - فهذه تبقى مبنية على النقر.
كيفية تثبيت البيكسل
أضف المقطع التالي قرب أعلى قسم <head> في كل صفحة تريد التقاط التحويلات فيها. وضعه مبكراً يساعد على عدم فقدان الأحداث التي تحدث أثناء تحميل المحتوى الآخر.
<script>
(function (w, d, s, u) {
if (w.oaiq) return;
var q = function () {
q.q.push(arguments);
};
q.q = [];
w.oaiq = q;
var js = d.createElement(s);
js.async = true;
js.src = u;
var f = d.getElementsByTagName(s)[0];
f.parentNode.insertBefore(js, f);
})(window, document, "script", "https://bzrcdn.openai.com/sdk/oaiq.min.js");
oaiq("init", {
pixelId: "<YOUR-PIXEL-ID>",
});
</script>pixelId مطلوب. تنشئه من تبويب التحويلات في Ads Manager. يمكنك أيضاً تمرير debug: true أثناء الاختبار ليُسجّل الـ SDK نشاطه في وحدة تحكم المتصفح.
الموافقة والخصوصية
إذا كان موقعك يتطلب موافقة قبل التتبع، اضبط الموافقة قبل تهيئة البيكسل:
oaiq("consent", false);
oaiq("init", {
pixelId: "<YOUR-PIXEL-ID>",
});
// بعد أن يمنح المستخدم موافقة القياس:
oaiq("consent", true);افتراضياً يبدأ البيكسل بالموافقة مفعّلة (ما لم يُعثر على رفض مخزّن). عندما تكون الموافقة false لا تُرسل أحداث القياس. تفعيلها مرة أخرى يسمح بالأحداث المستقبلية؛ الأحداث المحظورة لا تُعاد إرسالها.
نصائح سياسة أمان المحتوى (CSP)
إذا كنت تستخدم CSP، تأكد من السماح بهذه المصادر:
script-src: https://bzrcdn.openai.com (لتحميل الـ SDK)
connect-src: https://bzr.openai.com و https://bzrcdn.openai.com (لإرسال الأحداث وجلب الإعدادات)
img-src: https://bzr.openai.com (احتياطي الصور للأحداث)
يمكنك الاستمرار في استخدام nonces أو hashes؛ لا حاجة لإضافة unsafe-inline من أجل البيكسل فقط.
إرسال بيانات المستخدم لتحسين المطابقة
يمكنك اختيارياً تمرير كائن user عند استدعاء init. هذا مرتبط بالطلب ويساعد على مطابقة المزيد من التحويلات عند غياب معرّف النقر. أرسل فقط القيم المشفّرة (hashed) - ولا ترسل أبداً البريد أو الهاتف أو الاسم بشكل خام.
طبّق التطبيع أولاً (إزالة المسافات، تحويل البريد إلى أحرف صغيرة، إزالة علامات الترقيم من الهاتف والأسماء حسب القواعد الرسمية)، ثم احسب SHA-256 وأرسل الـ digests الست عشرية بأحرف صغيرة. الحقول المدعومة تشمل email_sha256 و phone_number_sha256 و external_id_sha256 و first_name_sha256 و last_name_sha256، بالإضافة إلى country و city و region و postal_code.
توفر OpenAI أيضاً المطابقة المتقدمة التلقائية: يستطيع البيكسل اكتشاف معلومات العميل المدعومة في الصفحة، وتطبيعها وتشفيرها في المتصفح، وإضافتها مع الأحداث. لا تُرسل البيانات الخام. لا تحتاج لتغيير تنفيذك لهذا الغرض.
كيفية إرسال الأحداث
عند حدوث تحويل، استدعِ oaiq("measure", ...). استخدم اسم حدث قياسي كلما أمكن (مثل order_created أو checkout_started أو page_viewed أو contents_viewed). يجب أن يتضمن كائن بيانات الحدث حقل type يطابق الشكل المتوقع لذلك الحدث.
مثال على عملية شراء مكتملة:
oaiq("measure", "order_created", {
type: "contents",
amount: 2599,
currency: "USD",
});يمكنك أيضاً تمرير خيارات مثل event_id (مفيد لإزالة التكرار عند إرسال نفس التحويل من بيكسل المتصفح وواجهة Conversions API من الخادم) و opt_out.
للإجراءات التي لا تطابق أي اسم قياسي، استخدم حدثاً مخصصاً:
oaiq(
"measure",
"custom",
{ type: "custom" },
{ custom_event_name: "quote_requested" }
);يجب أن تكون أسماء الأحداث المخصصة بين 1 و64 حرفاً، وتستخدم حروفاً وأرقاماً وشرطات سفلية أو عادية فقط، وألا تتطابق مع اسم حدث قياسي.
ملاحظة: app_installed و app_opened غير مدعومين في بيكسل JavaScript. أرسلهما عبر Conversions API مع تعيين action_source إلى mobile_app.
عدة معرّفات بيكسل
إذا كان نفس الموقع يحتاج لقياس أكثر من معلن أو علامة تجارية، حمّل الـ SDK مرة واحدة واستدعِ oaiq("init", { pixelId: "..." }) لكل معرّف. استخدم measure للإرسال إلى كل البيكسلات المهيأة، أو measureSingle عندما تريد أن يذهب الحدث إلى واحد منها فقط. راجع الدليل الرسمي لـ Multiple Pixel IDs للتفاصيل.
البيكسل مع Conversions API معاً
لقياس أكثر موثوقية، يستخدم كثير من المعلنين كلاً من بيكسل المتصفح وواجهة Conversions API من الخادم. عندما يُرسل نفس التحويل من المكانين، استخدم نفس اسم الحدث ونفس event_id حتى تتعرف OpenAI على التكرار وتتجنّب العدّ المزدوج.
قائمة تحقق عملية
أنشئ بيكسل / مصدر بيانات في Ads Manager وانسخ معرّف البيكسل.
ثبّت المقطع عالياً في
<head>على الصفحات ذات الصلة.تعامل مع الموافقة إذا كان موقعك يتطلبها.
أطلق الأحداث القياسية في اللحظات المناسبة (مشاهدات الصفحات، مشاهدات المنتجات، إضافة للسلة، بدء الدفع، الشراء، إلخ).
أضف بيانات المستخدم المشفّرة عندما تتوفر، أو اعتمد على المطابقة المتقدمة التلقائية.
استخدم
event_idمشتركاً إذا كنت ترسل أحداثاً أيضاً عبر Conversions API.اختبر باستخدام
debug: trueوتأكد من ظهور الأحداث في Ads Manager.
قراءات ذات صلة
للصورة الأوسع عن كيفية عمل إعلانات ChatGPT وخيارات التسعير وكيفية البدء، راجع إعلانات ChatGPT أصبحت متاحة: دليل مبسّط لأصحاب الأعمال.
المراجع الرسمية:
الخلاصة
بيكسل القياس من OpenAI هو الطريقة المباشرة لربط ما يحدث على موقعك بالإعلانات التي يراها الناس في ChatGPT. ثبّته مرة واحدة، وأرسل أحداثاً واضحة عند حدوث إجراءات حقيقية، وستحصل على التغذية الراجعة التي تحتاجها لتقييم الأداء مع حماية خصوصية المستخدم. اربطه مع Conversions API عندما تريد تغطية أقوى من جانب الخادم.