نظرة عامة
استعن بهذا الدليل إذا كانت هناك أحداث مفقودة، أو طلبات تفشل، أو اختلافات بين منصة إدارة الإعلانات وسجلات نشاطك التجاري. ابدأ بعملية شراء مكتملة واحدة، أو إرسال بيانات عميل محتمل، أو إجراء آخر. دوّن ما حدث ووقته، ثم اختر السؤال المناسب أدناه.
يسجّل الحدث إجراءً، مثل عملية شراء. يرسل البكسل الأحداث من متصفح الزائر، بينما ترسلها واجهة API للتحويلات (CAPI) من خادمك. تجمع منصة إدارة الإعلانات هذه الأحداث في مصدر بيانات. يحدّد الإسناد الإعلان الذي يُنسب إليه الإجراء. تحدّد فترة الإسناد المدة التي يمكن خلالها إسناد إجراء إلى إعلان بعد التفاعل معه.
الأسئلة الشائعة
1. من أين أبدأ؟
حدّد الإجراء الذي تريد قياسه، وما يرسل بياناته، وحساب الإعلانات ومعرّف البكسل المستخدمين. قد يستخدم إعدادك البكسل أو CAPI أو تكاملًا مع شريك، أو مزيجًا منها. تتطلب CAPI معرّف بكسل حتى لو لم تثبّت بكسل المتصفح.
للإعداد لأول مرة، راجع: قياس التحويلات وتتبّع التحويلات. يمكن للمطوّر لديك الاستعانة بأدلة البكسل وCAPI والأحداث المدعومة. أبقِ طلبات CAPI ومفاتيحها على خادمك.
إذا كان شريك يدير التكامل لديك، فاستعن بـدليل إعداد شريك القياس أو دليل إعداد شريك قياس الأجهزة المحمولة. للربط مع HubSpot، راجع: إعداد إعلانات ChatGPT في HubSpot.
إذا كان الإعداد قائمًا بالفعل، فتحقّق من كل خطوة:
هل أُرسل طلب حدث عند تنفيذ الإجراء؟
هل أعاد الطلب خطأً، أم جرى قبوله؟
هل يمكنك التأكد من أن مصدر البيانات الصحيح قد استلم الحدث؟
هل أُسنِد الحدث إلى إعلان في تقرير الحملة؟
2. لقد ثبّتُّ البكسل. لماذا لا أرى عمليات شراء أو عملاء محتملين؟
قد يُحمَّل البكسل دون إرسال حدث الشراء أو العميل المحتمل الذي تحتاج إليه. اطلب من المطوّر لديك فحص إجراء مكتمل واحد:
تحقّق من اسم الحدث ومعرّف البكسل والصفحة أو الدالة الراجعة التي ترسله. مشاهدة الصفحة ليست عملية شراء مكتملة.
تأكّد من تهيئة البكسل قبل إرسال الحدث، بما في ذلك عند تحميله بواسطة أداة إدارة الوسوم.
افحص وحدة تحكّم المتصفح وطلب الشبكة. رسالة «تم التشغيل» في أداة إدارة الوسوم وحدها لا تؤكد إرسال الحدث. قد يساعد وضع تصحيح الأخطاء في البكسل.
تحقّق مما إذا كانت خيارات الموافقة أو الحظر في المتصفح أو سياسة أمان موقعك قد منعت الطلب.
افحص الصفحات التي تتطلب تسجيل الدخول، وإتمام الشراء، ومواقع الحجز، وعمليات إعادة التوجيه، والنماذج المضمّنة. عمل البكسل على صفحة الوصول لا يؤكد عمل التتبّع في المواضع الأخرى.
إذا لم يُرسل أي طلب، فأصلح هذه الخطوة أولًا. لن يفيد انتظار ظهور البيانات في التقارير. استعن بـدليل استكشاف أخطاء البكسل وإصلاحها قبل إضافة تكامل آخر.
3. ماذا أفعل إذا رُفض حدث، أو انتهت مهلة طلبه، أو أعاد خطأً في الخادم؟
احفظ رمز الاستجابة ونص الخطأ كما هو ووقت الطلب ومعرّف الحدث. اطلب من المطوّر لديك التحقّق من تنسيق الحدث ومعرّف البكسل والمفتاح. تستخدم طلبات أحداث CAPI مفتاح واجهة API للتحويلات التابع لحساب الإعلانات نفسه. أما طلبات الإعداد والإدارة وإعداد التقارير فتستخدم مفتاح واجهة API للمعلنين المنفصل. لا ترسل مفاتيح API إلى فريق الدعم.
في دفعات CAPI، قد يتسبب حدث واحد غير صالح في فشل الدفعة بأكملها.
تتطلب CAPI وقت الإجراء الأصلي بصيغة توقيت Unix بالمللي ثانية. يجب ألا يتجاوز وقت الحدث 7 أيام في الماضي أو 10 دقائق في المستقبل. هذا الحد الزمني للإرسال منفصل عن فترة الإسناد. لا تغيّر وقت حدث قديم لجعله يجتاز التحقّق.
قد يجعلك انتهاء المهلة أو خطأ الخادم غير متأكد من وصول الحدث. راجع الطلب الأصلي وأي سجلات استلام. إذا أعدت محاولة إرسال الإجراء نفسه، فاحتفظ بمعرّف الحدث وطابعه الزمني الأصليين. قد يجعله المعرّف الجديد يبدو كأنه إجراء آخر.
تحقّق سريعًا من سبب الرفض أو الفشل المستمر للطلبات. لا تنطبق مدة ظهور البيانات في التقارير، المقدّرة بـ24–48 ساعة، على هذه الأخطاء. لمعرفة متطلبات الطلبات، راجع: واجهة API للتحويلات.
4. أرى أن الحدث قد قُبل. لماذا لا يظهر في التقرير؟
قبول الحدث لا يعني أنه أُسنِد إلى إعلان. تحقّق مما تؤكده الاستجابة، وما إذا كان الطلب قد استخدم مصدر البيانات الصحيح. في CAPI، يؤدي ضبط validate_only على true إلى التحقّق من الأحداث دون حفظها.
بالنسبة إلى حدث جديد، يمكن للمطوّر لديك مراجعة الأحداث الأخيرة، حيثما تتوفر. يعرض ذلك عينة حديثة، وليس سجلًا كاملًا أو نتيجة إسناد.
إذا تعذّر عليك التحقّق من الاستلام، فتواصل مع الدعم وأرفق الاستجابة الأصلية ومثالًا لحدث. أخبرنا بالفحوصات التي أكملتها؛ لا يلزمك معرفة السبب أولًا.
إذا تأكد الاستلام، فانتقل إلى السؤال 5. لا تُعِد إرسال الحدث بمعرّفات جديدة لمجرد أن تقرير الحملة لم يتغيّر.
قد تستغرق التحويلات المسندة إلى الإعلانات نحو 24–48 ساعة لتظهر، وقد تتغير الإجماليات الحديثة أثناء المعالجة. هذا لا يضمن ظهور كل حدث مقبول، ولا يؤكد استلامه. راجع: قياس النتائج.
5. يجري استلام الأحداث. لماذا لا يزال عدد التحويلات في الحملة صفرًا؟
قبل تغيير التكامل، تحقّق مما يلي:
هل مصدر البيانات المقصود متصل بالحساب الصحيح؟
هل يتطابق الحدث الذي ترسله مع إعداد التحويل في الحملة؟ بالنسبة إلى الأحداث المخصّصة، تحقّق من النوع المخصّص واسم الحدث بدقة. تطابق التسمية المعروضة لا يكفي.
هل رُبط التحويل الصحيح بالحملة قبل حدوث النشاط الذي تفحصه؟
هل وقع الإجراء بعد نقرة على إعلان أو مشاهدة له تستوفي شروط إعدادات الإسناد؟
هل تعرض الحملة الصحيحة وعمود الحدث والتواريخ والأساس الزمني الصحيح للتقارير؟
تساعد معلومات المطابقة في ربط الحدث بإعلان، لكنها لا تضمن إسناده إليه. احتفظ بمرجع نقرة OpenAI الفعلي، oppref، طوال الزيارة، وأدرجه في أحداث الخادم عند توفره. لا تختلق مرجعًا أبدًا، ولا تستخدم مرجع زائر آخر.
افحص أحداث المتصفح وأحداث الخادم كلًا على حدة. قد يتوفر للبكسل مرجع أو حقل بيانات عميل، بينما يغيب عن حدث الخادم.
لا يمكن تغيير الهدف المحدد لحملة محسّنة للتحويلات بعد إنشائها. لاستخدام هدف مختلف، أنشئ حملة جديدة. لا يمكن استخدام الأحداث المخصّصة كأهداف للتحسين. راجع: الحملات المحسّنة للتحويلات.
بعد إصلاح عدم التطابق في الإعدادات، افحص النشاط الجديد المؤهل للإسناد. لا تفترض أن التغيير يصحّح التقارير السابقة. لمعرفة قواعد المطابقة، راجع: قياس التحويلات.
6. لماذا تختلف البيانات بين منصة إدارة الإعلانات وأداة التحليلات ونظام إدارة علاقات العملاء لدينا؟
قارن الإجراءات نفسها باستخدام قواعد إعداد التقارير نفسها. قد يحتسب نظام إدارة علاقات العملاء كل عملية شراء، بينما يحتسب تقرير الإعلانات عمليات الشراء المنسوبة إلى تلك المنصة. قد تُسنِد المنصات المختلفة عملية الشراء نفسها بطرق مختلفة.
في منصة إدارة الإعلانات، يجمع مقياس التحويلات بين التحويلات بعد النقر والتحويلات المؤهلة بعد المشاهدة عندما تكون فترة الإبلاغ عن التحويلات بعد المشاهدة يومًا واحدًا. عند ضبط فترة المشاهدة على 0 يوم، فإنه يحتسب التحويلات بعد النقر فقط. استخدم الإعداد نفسه عند مقارنة التقارير.
مثلًا، قد ينقر شخص على إعلان، ثم يعود مباشرةً لاحقًا ويُجري عملية شراء. قد تصنّف أداة الزيارة على أنها «مباشرة»، بينما تنسب أداة أخرى عملية الشراء إلى الإعلان السابق. هذا الاختلاف وحده لا يعني أن عملية الشراء احتُسبت مرتين.
إذا اختلفت تسميات مصادر الزيارات، فتحقّق من عنوان URL لصفحة الوصول ومعلَمات التتبّع المستخدمة في تلك الزيارة. قد تختلف إعدادات الحملة الحالية عن الإعدادات المستخدمة سابقًا.
قارن ما يلي:
الحساب والحملة ونوع الحدث والفلاتر ومستوى إعداد التقارير.
النطاق الزمني والمنطقة الزمنية، وما إذا كانت التواريخ تشير إلى التفاعل مع الإعلان أم إلى التحويل نفسه.
إعدادات التحويلات بعد النقر وبعد المشاهدة، والمقياس أو العمود المحدد بدقة.
أي تأخيرات حديثة في المعالجة، وكيفية التعامل مع التكرار، والموافقة، ومعلومات المطابقة المتاحة.
التحويلات المقدّرة بالنمذجة، حيثما تتوفر، والتي قد تختلف عن المعاملات المسجّلة مباشرةً.
بالنسبة إلى القيم، قارن العملة والوحدات، وما إذا كانت المقارنة تشمل الطلب كاملًا أم العناصر كلًا على حدة.
بالنسبة إلى الإيرادات، قارن الضرائب والشحن والخصومات والرسوم. تحقّق من أن نسختَي الحدث في المتصفح والخادم ترسلان قيمة الطلب نفسها. يحتسب مقياسا مبيعات الطلبات المنشأة وعائد الإنفاق الإعلاني للطلبات المنشأة أحداث order_created المسندة إلى الإعلانات فقط.
يشمل النشاط المستورَد من GA4 أحداثًا من مختلف مصادر الزيارات في الموقع المحدد. لا تمثّل هذه الإجماليات تحويلات مسندة إلى الحملات. راجع: ربط Google Analytics 4 بمنصة إدارة الإعلانات من OpenAI.
عند إجراء مقارنات عبر API، سجّل نقطة النهاية واضبط خيارات إعداد التقارير صراحةً. قد لا يتطابق الإعداد الذي لم تحدده مع الإعداد المستخدم في منصة إدارة الإعلانات. قد تتضمن التقارير أيضًا أحداثًا مختلفة؛ فبعضها يغطي أهداف الحملات دون الإجراءات الأخرى التي يجري تتبّعها. غياب حدث عن تقرير واحد لا يثبت أنه لم يُستلم.
استخدم الإعدادات نفسها عند المقارنة بين ملفات CSV، واحتفظ بالملفات المصدّرة دون تعديل. راجع: قياس النتائج لمعرفة طرق العرض في منصة إدارة الإعلانات، وإعداد التقارير لمعرفة خيارات API.
7. هل يؤدي استخدام البكسل وCAPI إلى احتساب عملية الشراء مرتين؟
لتجنب احتساب الإجراء نفسه مرتين، استخدم معرّف البكسل واسم الحدث ومعرّف الحدث نفسها في نسختيه المرسلتين من المتصفح والخادم. حقل معرّف الحدث هو id في CAPI وevent_id في البكسل. استخدم اسم الحدث المخصّص نفسه على الجانبين أيضًا.
احتفظ بالمعرّف نفسه عند إعادة محاولة إرسال إجراء، واستخدم معرّفًا جديدًا لكل إجراء مختلف. تحقّق من وجود وسوم مكررة، أو تكرار تحميل الصفحات أو استدعاءات الدوال الراجعة، أو تكاملات مع شركاء قد ترسل الحدث بالفعل.
لا تُعِد إرسال نسخة مكررة لتغيير قيمة الحدث الأصلي أو معلومات المطابقة الخاصة به. راجع السلوك الموضّح في الوثائق قبل محاولة إجراء تصحيح. راجع: إزالة التكرار بين أحداث المتصفح والخادم.
8. نحن نستخدم Shopify. هل نحتاج إلى تكامل آخر؟
تحقّق من اتصال Shopify لديك قبل إضافة تكامل آخر. تأكّد من حساب الإعلانات والبكسل المتصلين، ثم تحقّق من الأحداث التي يرسلها التطبيق لمتجرك.
إذا كنت تستخدم أيضًا وسومًا مخصّصة، أو كودًا لإتمام الشراء، أو أداة إرسال من الخادم، فتحقّق مما إذا كانت ترسل الأحداث نفسها. يمكن أن تستخدم إعدادات Shopify توليفات مختلفة من التتبّع عبر المتصفح والخادم. راجع: إعداد إعلانات ChatGPT على Shopify.
9. كيف نتعامل مع الموافقة والاختبار؟
أرسل فقط البيانات المسموح لك بمشاركتها، واحترم خيارات موافقة الزوار. ينبغي للمطوّر لديك اتباع إرشادات التكامل بشأن الموافقة وبيانات المطابقة المدعومة، بما فيها أي متطلبات لتوحيد تنسيق البيانات وتجزئتها. لا تُزِل ضوابط الموافقة لزيادة التحويلات الظاهرة في التقارير أو لتحسين درجة التقييم.
تخدم الموافقة على القياس وخيار opt_out غرضين مختلفين. يتعلق خيار opt_out بالتخصيص؛ ولا يوقف جميع طلبات القياس. اطلب من المطوّر لديك التحقّق من كيفية التعامل مع الموافقة في تكاملات المتصفح والخادم معًا.
سجّل وقت إجراء اختباري واحد واسمه ومعرّفه. تحقّق مما إذا كان قد أُرسل، وجرى التحقّق من صحته، واستُلم. نجاح اختبار التنفيذ لا يثبت أن الإعلان مؤهل لإسناد الإجراء إليه.
يتحقّق خيار validate_only في CAPI من الأحداث دون حفظها. يسجّل وضع تصحيح الأخطاء في البكسل النشاط، لكنه لا يستبعد أحداث الاختبار من التقارير. ميّز الاختبارات في سجلاتك، ولا تختلق عمليات شراء أو تغيّر أوقات الأحداث لفرض نتيجة.
10. هل انخفاض درجة جودة الحدث أو عدم توفرها يعني أن التتبّع معطّل؟
ليس هذا وحده دليلًا على ذلك. يقيّم مقياس جودة الحدث المعلومات الواردة من مصدر بيانات. ولا يبيّن عدد التحويلات التي أُسنِدت إلى إعلانات. لا يكفي انخفاض الدرجة أو عدم توفرها وحده لتحديد ما إذا كان التتبّع يعمل.
تأكّد من تسجيل الإجراءات الفعلية الأخيرة بشكل صحيح، ثم تحقّق من سبب التحذير. لا ترسل أحداثًا إضافية أو معرّفات مختلقة لرفع الدرجة. لمعرفة الفحوصات وتوقيت التحديث، راجع: فهم جودة الأحداث وتحسينها.
11. ما المعلومات التي ينبغي تضمينها عند التواصل مع الدعم؟
أخبرنا بما كنت تتوقعه، وما حدث، ومتى بدأت المشكلة، وما تحقّقت منه. أرفق ما يتوفر لديك من هذه القائمة:
معرّف حساب الإعلانات، ومعرّف البكسل أو مصدر البيانات، ومعرّفات الحملات والإعلانات المتأثرة.
نوع التكامل واسم الحدث كما هو تمامًا، بما في ذلك أي اسم لحدث مخصّص.
مثال أو مثالان لمعرّفات أحداث موجودة وطوابع الإجراءات الزمنية، مع المنطقة الزمنية.
عند فشل الطلبات أو عدم التأكد من الاستلام: رمز الاستجابة، ونص الخطأ كما هو، ووقت الطلب، وأي معرّف طلب أو CF-Ray أُعيد في الاستجابة، وبيانات الطلب أو مقتطف من السجل بعد حجب المعلومات الحساسة.
عند وجود اختلافات بين التقارير: النطاق الزمني، والأساس الزمني للتقارير، وإعدادات الإسناد، والأعمدة المحددة، وملف تصدير CSV، ومقارنة تغطي النطاق نفسه.
لقطات الشاشة ذات الصلة وأي تغييرات حديثة في الإعداد، بما فيها استخدام صفحة منفصلة لإتمام الشراء أو تكامل مع شريك.
أخبرنا إن كنت قد تأكدت من إرسال الحدث أو قبوله أو استلامه، أم أنك اكتفيت بمراجعة التقرير. يمكنك طلب المساعدة حتى لو لم تتمكن من إكمال هذه الفحوصات.
أزل مفاتيح API وترويسات التفويض وكلمات المرور وملفات تعريف الارتباط ومعلومات العملاء غير الضرورية من المرفقات. أبلغ فورًا عن الأخطاء أو عن تكامل كان يعمل ثم توقف فجأة. لا تنتظر انقضاء مدة ظهور البيانات في التقارير.