إعلانات ChatGPT
ربط إعلانات ChatGPT يتيح لفلوفاي إرسال كل عملية شراء وإضافة للسلة وزيارة صفحة من متجرك مباشرة إلى خوادم OpenAI، لتعكس تقارير إعلاناتك المبيعات التي لم يرها بكسل المتصفح.
شاهد شرح ربط إعلانات ChatGPT
قبل أن تبدأ
- صلاحية الوصول إلى مدير إعلانات ChatGPT على ads.openai.com
- مصدر مربوط في فلوفاي. إن لم تفعل ذلك بعد، ابدأ من البداية.
ستخرج بقيمتين: معرّف البكسل ومفتاح Conversions API. كلاهما تحت Conversions، لكن كل واحدة تُنشأ من مكان مختلف في الصفحة.
Settings › API Keys — ذاك مفتاح إدارة الحملات، ويُرفض مع كل حدث. الجزء الثاني يوضّح المفتاح الصحيح.الجزء الأول · أنشئ مصدر البيانات
١. افتح Conversions
من مدير الإعلانات، افتح Tools في القائمة الجانبية واختر Conversions. إن لم تنشئ مصدرًا من قبل فالصفحة فارغة.
٢. أنشئ مصدر بيانات
اضغط + Create data source (أو + Create › Data Source في الأعلى إن كان لديك مصدر سابق). سمِّه اسمًا تتعرف عليه — الاسم لك وحدك ولا يعتمد عليه شيء.
يتولّد معرّف البكسل تلقائيًا بمجرد الضغط على Create.
٣. انسخ معرّف البكسل
افتح المصدر الذي أنشأته للتو. تعرض لوحة Set up your data source حقل Pixel ID ومعه زر نسخ — نص من ٢٢ خانة مثل MsLLVN8fT8zQX7nLQFhEcE.
لا يلزم تركيب كود الإعداد الظاهر تحته. فلوفاي ترسل الأحداث من خوادمها، وهذا وحده يكفي.
الجزء الثاني · احصل على مفتاح Conversions API
١. افتح Conversion keys
ارجع إلى صفحة Conversions، واستخدم أيقونة المفتاح في الأعلى (Conversion keys) وأنشئ المفتاح من هناك. انسخه فور ظهوره.
٢. لا تستخدم Settings › API Keys
هنا تخطئ أغلب عمليات الإعداد. Settings › API Keys فيها أيضًا زر Create New Key، والمفتاح الناتج يبدو سليمًا تمامًا — لكن OpenAI تقول في النافذة نفسها إنه يمنح صلاحية Ads Management API فقط:
المفتاح من هناك يبدأ بـ sk-svcacct-. لن تقبل OpenAI أي حدث يُرسل به، فتُحفَظ الوجهة لكنها لا توصّل شيئًا — وتُبلغك فلوفاي أن المفتاح غير صالح فور أن تقول OpenAI ذلك. إن لم تصل أحداثك، تحقّق أي المفتاحين لصقت.
الجزء الثالث · أنشئ الوجهة في فلوفاي
١. ابدأ وجهة جديدة
في فلوفاي، افتح الوجهات واضغط إنشاء وجهة.
٢. اختر إعلانات ChatGPT
٣. اربط متجرك
حدّد المصدر الذي يجب أن تتدفق أحداثه إلى إعلانات ChatGPT، ثم تابع.
٤. الصق القيمتين
ضع معرّف البكسل من الجزء الأول في معرّف البكسل، والمفتاح من الجزء الثاني في مفتاح Conversions API. ثم اضغط إنشاء.
تتحقق فلوفاي من القيمتين قبل الحفظ. هذا الفحص لا يسجّل أي حدث — تستطيع OpenAI التحقق من دفعة أحداث دون تسجيلها، فلا يكلّفك التحقق أي تحويل وهمي.
الجزء الرابع · تأكّد أنها تعمل
نفّذ طلبًا تجريبيًا، ثم افتح الوجهة في فلوفاي وراقب الأحداث المباشرة. يجب أن يظهر الطلب خلال ثوانٍ.
ومن جهة OpenAI، افتح تبويب Event Stream في صفحة Conversions وابحث عن الحدث وهو يصل.
ما الذي يُرسَل
تترجم فلوفاي أحداث متجرك إلى أسماء أحداث إعلانات ChatGPT تلقائيًا:
| حدث متجرك | حدث إعلانات ChatGPT |
|---|---|
| زيارة صفحة | page_viewed |
| مشاهدة منتج | contents_viewed |
| مشاهدة قائمة منتجات | contents_viewed |
| إضافة منتج | items_added |
| بدء الدفع | checkout_started |
| اكتمال الطلب | order_created |
| تسجيل حساب | registration_completed |
| حجز | appointment_scheduled |
| اشتراك | subscription_created |
| بدء تجربة | trial_started |
| فتح التطبيق | app_opened |
أي حدث خارج هذه القائمة يُرسَل كحدث مخصص باسمه، بحروف صغيرة وعلامات الترقيم مستبدلة بشرطات سفلية. لكن OpenAI لا تقبل في اسم الحدث سوى الحروف اللاتينية والأرقام و_ و-، فالاسم المكتوب بالعربية بالكامل لا يبقى منه شيء. وبدل إسقاط التحويل، ترسله فلوفاي باسم custom_ مولَّد يبقى ثابتًا لذلك الحدث دائمًا. فالمبيعة تُحتسب، لكنها تظهر في مدير الإعلانات بالاسم المولَّد. امنح الحدث اسمًا لاتينيًا إن أردت تمييزه هناك. وإن كان متجرك يستخدم أصلًا أسماء إعلانات ChatGPT مثل lead_created، فهي تمرّ كما هي.
وهناك أحداث تُسقَط بدل إرسالها: ما مضى عليه أكثر من سبعة أيام، وحدث ويب بلا رابط صفحة. فOpenAI ترفض الدفعة كاملة بسبب حدث واحد، لذا تزيلها فلوفاي أولًا.
ويمكنك تعديل أي ترجمة من ربط الأحداث داخل الوجهة، لكن الاسم البديل يجب أن يكون من أسماء أحداث إعلانات ChatGPT أعلاه، أو lead_created أو app_installed أو custom. وأي اسم غير ذلك يُتجاهل وتُستخدم الترجمة الافتراضية.
كما تُحوَّل قيم الطلبات إلى الوحدة التي تتوقعها OpenAI لعملتك، فتُسجَّل مبالغ الريال والدولار والدينار والين بشكل صحيح دون أي إعداد منك.
إذا حدث خطأ
فلوفاي تقول إن مفتاح API غير صالح. السبب الأشيع أن المفتاح جاء من Settings › API Keys بدل Conversion keys. أي مفتاح يبدأ بـ sk-svcacct- هو المفتاح الخطأ دائمًا.
فلوفاي تقول إن المفتاح لا يملك صلاحية الوصول إلى معرّف البكسل. المفتاح ومصدر البيانات في حسابين مختلفين. أنشئ المفتاح من الحساب نفسه الذي يملك البكسل.
لا تصل أي أحداث إلى الأحداث المباشرة في فلوفاي. المشكلة بين متجرك وفلوفاي، لا بين فلوفاي وOpenAI. تأكّد أن المصدر مربوط ونشط.
المبيعات تُحتسب مرتين. أنت تشغّل بكسل المتصفّح وفلوفاي معًا. تطابق معرّف البكسل شرط لازم لكنه غير كافٍ — فOpenAI تمنع التكرار بمعرّف البكسل ومعرّف الحدث معًا، وفلوفاي لا تنسّق معرّفات الأحداث مع البكسل الجاهز بعد. إلى أن تفعل، شغّل واحدًا منهما فقط.
الطلبات القديمة لا تصل. ترفض OpenAI الأحداث الأقدم من سبعة أيام، لذا تُسقطها فلوفاي بدل إرسال دفعة سترفض بالكامل. ولا يتأثر بذلك إلا تراكم يزيد على أسبوع.