دليل تحديد المشاكل وحلّها في "حملات الأداء الأفضل"

اتّبِع هذا الدليل لتقديم المعلومات اللازمة لتحديد المشاكل المتعلّقة بميزة "الاستهداف بالاستناد إلى الجمهور المشابه" وحلّها.

تعذُّر إرسال رسائل RBM

يُرجى مشاركة أكبر عدد ممكن من التفاصيل التالية للمساعدة في تحديد المشكلة وحلّها بشكل أسرع:

  • عيّنات من معرّفات الرسائل مع الطوابع الزمنية
  • رقم تعريف الشريك (راجِع لقطة الشاشة)
  • عدد موظّفي الدعم المتأثّرين
  • أرقام تعريف الوكلاء (مفصولة بفواصل)
  • العدد المقدَّر للرسائل المتأثّرة أو التي يُحتمل أن تكون متأثّرة
  • طُرق واجهة برمجة التطبيقات التي تواجهك مشاكل فيها (على سبيل المثال: تحميل الملفات، إنشاء رسالة من موظّف دعم إلى مستخدم، إنشاء حدث من موظّف دعم إلى مستخدم، حذف رسالة من موظّف دعم إلى مستخدم، الحصول على الإمكانات، الحصول على البيانات دفعة واحدة)
  • نموذج لحِمل JSON للطلبات التي تعذّر تنفيذها
  • بالنسبة إلى مشاكل العميل: تقرير أخطاء العميل

  • سجلّات الأخطاء (الأخطاء التي تظهر في المحطة الطرفية عند طلب بيانات من واجهات برمجة تطبيقات RBM)، بما في ذلك رمز الخطأ ورسالة الخطأ على سبيل المثال:

    "error": {
"code": 403,
"message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
"status": "PERMISSION_DENIED",
}

وقت الاستجابة في تنفيذ إجراءات نموذج سلوك المستخدِم

يُرجى التحقّق مما يلي أولاً:

السؤال الإجراء المقترَح
هل وقت الاستجابة هو <5s؟ إذا كان الأمر كذلك، يعني ذلك أنّ القيمة ضمن النطاق المقبول.
هل حدث أي تراجع في وقت الاستجابة؟ إذا كان الأمر كذلك، متى بدأ؟ ما هو وقت الاستجابة المعتاد في السابق مقارنةً بالوقت الحالي؟
هل تستخدم واجهة برمجة التطبيقات لتحميل الملفات؟ جرِّب استخدام أرقام تعريف الملفات بدلاً من إرسال عناوين URL مباشرةً. تتطلّب معالجة عناوين URL الجديدة للوسائط عمليات تنزيل ومعالجة وصور مصغّرة وحماية من إساءة الاستخدام وحماية من الفيروسات، وتستغرق هذه العمليات الأخيرة حوالي% 50 من الوقت.
هل حمّلت وسائط الرسالة مسبقًا؟ لتسريع عملية المعالجة، ننصحك بتنفيذ ذلك من خلال طلب البيانات من واجهة برمجة التطبيقات التالي: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
هل أجريت عمليات التحقّق من الإمكانات؟ لتقليل وقت الاستجابة في إرسال الرسائل إلى المستخدمين الذين لا يمكن التواصل معهم من خلال خدمات الاتصالات التفاعلية (RCS)، عليك أولاً إجراء عمليات التحقّق من الإمكانات.

في حال استمرار المشكلة، يُرجى تقديم أكبر عدد ممكن من التفاصيل الإضافية لتحديد المشكلة وحلّها بشكل أسرع:

  • عدد الرسائل المتأثّرة
  • مصدر وقت الاستجابة (على سبيل المثال: تحميل الملفات، وإنشاء رسالة من موظّف الدعم إلى المستخدم، وإنشاء حدث من موظّف الدعم إلى المستخدم، وحذف رسالة من موظّف الدعم إلى المستخدم، والحصول على الإمكانات، والحصول على البيانات بشكل مجمّع)
  • نقطة نهاية الخدمة
  • توزيع وقت الاستجابة (p50 وp95 وp99)
  • تغيير وقت الاستجابة والإطار الزمني
  • رقم تعريف الشريك
  • أرقام تعريف موظّفي الدعم المتأثرين
  • معرّفات الرسائل التي تحتوي على طوابع زمنية
  • حمولة JSON

عدم تلقّي الأحداث أو الرسائل في رابط البيانات الديناميكية

لضمان تسليم الرسائل بسلاسة، تأكَّد من أنّ جميع أدوات وكيل webhooks في حساب الشريك تعمل بشكل صحيح ويمكنها معالجة الرسائل الواردة من Google. يشترك جميع موظّفي الدعم في حساب الشريك في قناة واحدة للرسائل والأحداث الواردة، لذلك يمكن أن يؤدي تعطُّل رابط webhook إلى إيقاف عمليات الإرسال لجميع موظّفي الدعم.

إذا استمرت المشكلة، يُرجى مشاركة التفاصيل التالية لتمكين خطوات تحديد المشكلة وحلّها بشكل أسرع:

  • متى بدأت المشكلة؟ هل كنت تتلقّى الرسائل والفعاليات بنجاح قبل ذلك؟
  • رقم تعريف الشريك
  • أرقام تعريف موظّفي الدعم
  • عنوان URL للردّ التلقائي على الويب
  • معرّفات الرسائل التي تحتوي على طوابع زمنية

وتشمل أمثلة هذه المشكلة تعذُّر التحميل وظهور شاشة سوداء وعدم اقتصاص الصور وعدم ظهور الإجراءات المقترَحة.

يُرجى مشاركة أكبر عدد ممكن من التفاصيل التالية للمساعدة في تحديد المشكلة وحلّها بشكل أسرع:

  • معرّفات الرسائل التي تحتوي على طوابع زمنية
  • حمولة JSON
  • خطوات إعادة إنتاج المشكلة على الجهاز، إن وُجدت
  • تقرير الخطأ من الجهاز الذي يتلقّى الرسائل
  • تفاصيل حول الجهاز وإصدار تطبيق المراسلة المستخدَم
  • لقطة شاشة أو تسجيل فيديو للمشكلة

رسائل RBM المُرسَلة بتنسيق JSON أو المحوَّلة إلى رسائل قصيرة

يُرجى مشاركة أكبر عدد ممكن من التفاصيل التالية للمساعدة في تحديد المشكلة وحلّها بشكل أسرع:

  • معرّفات الرسائل التي تحتوي على طوابع زمنية
  • حمولة JSON
  • خطوات إعادة إنتاج المشكلة على الجهاز، إن وُجدت
  • تقرير الخطأ من الجهاز الذي يتلقّى الرسائل
  • تفاصيل حول الجهاز وإصدار تطبيق المراسلة المستخدَم
  • لقطة شاشة أو تسجيل فيديو للمشكلة

تعذُّر إنشاء عنوان URL أو رمز الاستجابة السريعة لميزة "الدفع إلى نقطة البيع"

يُرجى مشاركة أكبر عدد ممكن من التفاصيل التالية للمساعدة في تحديد المشكلة وحلّها بشكل أسرع:

يُرجى مشاركة أكبر عدد ممكن من التفاصيل التالية للمساعدة في تحديد المشكلة وحلّها بشكل أسرع:

  • معرّف الوكيل
  • رقم الهاتف
  • خطوات إعادة إنتاج المشكلة إذا كانت معروفة
  • تقرير الخطأ (من الجهاز الذي تم فتح الرابط عليه)
  • لقطة شاشة أو تسجيل فيديو للمشكلة

تعذُّر تلقّي الرسائل على جهاز مزوّد بخدمة RCS

يُرجى مشاركة أكبر عدد ممكن من التفاصيل التالية للمساعدة في تحديد المشكلة وحلّها بشكل أسرع:

  • تقرير خطأ من الجهاز الذي يتعذّر عليه تلقّي رسائل RBM
  • رقم الهاتف
  • تفاصيل عن الجهاز ونظام التشغيل
  • إصدار تطبيق المراسلة المستخدَم
  • خطوات إعادة إنتاج المشكلة إذا كانت معروفة
  • لقطة شاشة تعرض حالة RCS
  • لقطة شاشة أو تسجيل فيديو للمشكلة
  • اسم مشغِّل شبكة الجوّال والبلد

تعذّرت إضافة مختبِر

اتّبِع الخطوات الواردة في مقالة إعداد جهاز اختباري.

إذا استمرت المشكلة، يُرجى مشاركة التفاصيل التالية لتمكين خطوات تحديد المشكلة وحلّها بشكل أسرع:

  • معرّف الوكيل
  • رقم الهاتف
  • اسم مشغِّل شبكة الجوّال والبلد

عدم تلقّي الجهاز الاختباري دعوة أو رسائل من المختبِر

اتّبِع الخطوات الواردة في مقالة إعداد جهاز اختباري.

إذا استمرت المشكلة، يُرجى مشاركة التفاصيل التالية لتسهيل عملية تحديد المشكلة وحلّها بشكل أسرع:

  • معرّف الوكيل
  • رقم الهاتف
  • معرّف الرسالة مع الطابع الزمني
  • إرسال تقرير الخطأ في غضون 5 دقائق من إرسال الدعوة التجريبية

مشاكل متعلقة بعمليات التحقّق من الإمكانات

يُرجى مشاركة التفاصيل التالية لتسهيل تحديد المشاكل وحلّها بشكل أسرع:

  • قائمة بأرقام الهواتف مع رموز البلدان مضمّنة في ملف CSV
  • أرقام تعريف موظّفي الدعم
  • سجلّات الأخطاء
  • حالة خدمة الاتصالات التفاعلية (RCS) على الجهاز

عدم توفّر معلومات في تقارير أحداث الفوترة

يُرجى مشاركة التفاصيل التالية لتسهيل تحديد المشاكل وحلّها بشكل أسرع:

  • تواريخ عدم توفّر الملفات
  • أرقام تعريف موظّفي الدعم

يتعذّر على مشغّل شبكة الجوّال الموافقة على عمليات إطلاق موظّفي الدعم

أبلِغ عن المشكلة من وحدة تحكّم إدارة ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" (راجِع لقطة الشاشة).

بالنسبة إلى عمليات الإطلاق العاجلة، يُرجى تقديم ما يلي:

  • اسم مشغِّل شبكة الجوّال والبلد
  • رقم تعريف الوكيل المطلوب إطلاقه
  • تفويض مشغّل شبكة الجوّال لبدء الخدمة

طلب تعديل تفاصيل موظّف الدعم

شارِك التفاصيل التالية لتفعيل التحديثات بشكل أسرع:

  • معرّف الوكيل
  • تفاصيل البيانات الوصفية المطلوب تعديلها (على سبيل المثال: الاسم أو الشعار أو البانر أو الوصف أو تفاصيل الاتصال أو رابط سياسة الخصوصية أو رابط بنود الخدمة)

طلب نقل موظّفي الدعم إلى حساب شريك آخر

شارِك التفاصيل التالية لتفعيل التحديثات بشكل أسرع:

  • قائمة أرقام تعريف موظّفي الدعم
  • رقم تعريف الشريك القديم
  • رقم تعريف الشريك الجديد