الأسئلة الشائعة حول حزمة تطوير البرامج (SDK)

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

من يدير وظيفة نشر المحتوى؟

يدير مطوّر التطبيقات مهمة نشر المحتوى ويرسل الطلبات إلى Engage Service. بهذه الطريقة، يتمكّن شركاء المطوّرين من التحكّم بشكل أكبر في وقت نشر المحتوى للمستخدمين و طريقة نشره. ويؤدي ذلك إلى تجنُّب تنشيط تطبيق الشريك بشكلٍ متكرّر لنشر المحتوى.

هل يحتاج المطوّر إلى نشر جميع أنواع المجموعات؟

على الرغم من أنّه يحقّ للمطوّرين من الناحية الفنية نشر مجموعة واحدة فقط، ننصحك بشدّة بتضمين المزيد. وفي حال عدم إجراء ذلك، سيفوّت المطوّرون فرصة تحسين تفاعل المستخدمين مع المحتوى الخاص بهم. ننصح بشدة بنشر كل أنواع المجموعات لكل مجال.

كم مرة يجب أن ينشر فيها شريك المطوّر البيانات باستخدام "مدير العمل" أثناء تشغيل التطبيق؟

يحدّد الشريك المطوِّر هذا المبلغ. تنصح Google بنشر المحتوى المتعلق بالاقتراحات العامة مرة أو مرتين في اليوم، واستخدام منهج قائم على الأحداث لمحتوى سلة التسوّق وإعادة الطلب وغيرها من محتوى المتابعة (على سبيل المثال، بدء العامل كإجراء استدعاء للمستخدم الذي يضيف سلعًا إلى سلة التسوّق أو يوقف فيلمًا في منتصفه). بالنسبة إلى تطبيقات التواصل الاجتماعي، من المهم نشر مجموعات الاقتراحات المعدَّلة بعد كل استخدام للتطبيق. يهتم مستخدمو التطبيقات الاجتماعية أكثر بالاقتراحات الأحدث، ويفضّلون في العادة رؤية مشاركة مرة واحدة على الأكثر.

متى يجب أن يطلب المطوّر حذف واجهات برمجة التطبيقات؟

يجب عدم استدعاء واجهات برمجة التطبيقات لحذف المحتوى إلا في حال عدم توفّر محتوى للنشر. لا تستخدِم واجهات برمجة التطبيقات لحذف المحتوى ونشره لاحقًا لاستبدال المحتوى، لأنّ واجهات برمجة التطبيقات لنشر المحتوى تزيل المحتوى السابق تلقائيًا.

الأسئلة الشائعة حول "نية البث"

لماذا يحتاج مطوّرو تطبيقات Android إلى التسجيل للحصول على أذونات البث؟

لعرض محتوى جديد للمستخدم، عليك استخدام نوايا البث لبدء مزامنة البيانات في الحالات التي قد لا يستخدم فيها المستخدمون التطبيق بشكل متكرر.

عدم السماح بتنفيذ التطبيق في الخلفية

أثناء تسجيل نية البث، قد تواجه الخطأ التالي:

Background execution not allowed: receiving Intent
{ act=com.google.android.engage.action.PUBLISH_RECOMMENDATION .. }

عليك تسجيل مستقبلي البث بشكل ديناميكي.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));
...

}

الأسئلة الشائعة حول سير العمل

أثناء الدمج مع حزمة SDK، قد تواجه الأخطاء التالية:

تكون الروابط لصفحات في التطبيق مرتبطة باسم الحزمة. من الطرق الجيدة لاختبار الروابط لصفحات في التطبيق هي استخدام أداة adb.

adb shell am start -W -a android.intent.action.VIEW -d <DEEPLINK URI> <PACKAGE NAME>

تشكّل الروابط لصفحات في التطبيق طريقة رائعة لتتبُّع مصدر الإحالة. يمكن تضمين عناوين URL للروابط لصفحات معيّنة التي تنقل المستخدمين إلى تطبيقك مع مَعلمات تتبُّع إضافية. على سبيل المثال، "http://xx/deeplink?source_tag=engage".

يمكن للمطوّرين إضافة مَعلمات التتبّع الخاصة بهم وتقديم مصدر المحتوى لحساب التأثير.

الأسئلة الشائعة حول Engage for TV 2.0

أسئلة عامة

ما هي ميزة "مواصلة المشاهدة 2.0"؟

تنقل ميزة "مواصلة المشاهدة 2.0" (Video Discovery API) تجربة "مواصلة المشاهدة من حيث توقفت" إلى المستوى التالي. هذه ميزة رائعة تتيح للمشاهدين استئناف المحتوى بسلاسة على مجموعة أكبر من الأجهزة. يمكنك بدء مشاهدة فيلم على Google TV ثم استئنافه بسهولة على هاتفك أثناء التنقّل، وذلك بفضل ميزة "متابعة المشاهدة 2.0".

تم تصميم هذا النظام الجديد لتعزيز تفاعل المشاهدين والاحتفاظ بهم من خلال تقديم تجربة سلسة وسهلة على مستوى منظومة Google المتكاملة.

ما هي مزايا استخدام ميزة "مواصلة المشاهدة 2.0"؟

الإجابة: تسهّل ميزة "مواصلة المشاهدة 2.0" على المشاهدين مواصلة مشاهدة المحتوى من حيث توقّفوا، بغض النظر عن الجهاز الذي يستخدِمونه. في ما يلي آلية عمل هذه الميزة:

  • تجربة سلسة على جميع خدمات Google: يمكنك بدء المشاهدة على Google TV ثم مواصلة المشاهدة بسلاسة على هاتف Android أو iPhone أو جهاز Android اللوحي. ويعمل التطبيق حتى على الأجهزة التي لم يتم تثبيته عليها بعد.
  • زيادة التفاعل والاحتفاظ بالمستخدمين: تساعد ميزة "مواصلة المشاهدة 2.0" في جذب المستخدمين مجددًا إلى تطبيقك، حتى على الأجهزة الجديدة. من خلال السماح للمستخدمين باستئناف برامجهم المفضّلة، تزيد من فرص مواصلة مشاهدتهم.
  • الوصول إلى جمهور أوسع: تعمل ميزة "مواصلة المشاهدة 2.0" على جميع تجارب وسائط Android الأخرى، مثل Play Cubes وتطبيقات وسائط Google الأخرى، بالإضافة إلى Google TV.
  • التوافق مع الإصدارات القديمة: إذا كنت تستخدم حاليًا ميزة "المشاهدة تاليًا" القديمة، لن يكون هناك أي مشكلة. إنّ ميزة "مواصلة المشاهدة 2.0" متوافقة مع الإصدارات القديمة، لذا سيظل دمج التطبيقات الحالي يعمل على النحو المعتاد.

ملاحظة مهمة: يجب أن تستخدم جميع عمليات دمج ميزة "مواصلة المشاهدة" الجديدة الإصدار 2.0 من ميزة "مواصلة المشاهدة". نحن بصدد إيقاف نظام "التشغيل التوالي على الأجهزة المختلفة" القديم نهائيًا.

ما هي مساحات العرض التي تتيح استخدام ميزة "مواصلة المشاهدة 2.0"؟

  1. Google TV
  2. Android TV (على الجهاز فقط، ولكنّه متوافق مع حزمة تطوير البرامج (SDK) لـ Engage)
  3. تطبيق Google TV المتوافق مع أجهزة Android الجوّالة
  4. تطبيق Google TV المتوافق مع أجهزة iOS الجوّالة
  5. مكعبات اللعب
  6. مساحة الترفيه من Google
  7. أجهزة iOS (مع دمج واجهة برمجة التطبيقات REST)

هل حزمة Engage SDK مخصّصة لميزة "متابعة المشاهدة" 2.0؟

نعم، حزمة Engage SDK مخصّصة لميزة "مواصلة المشاهدة 2.0". يجب دمج الميزة مع ميزة "مواصلة المشاهدة 2.0".

هل تتوفّر ميزة "مواصلة المشاهدة 2.0" للجميع؟

يتم طرح ميزة "مواصلة المشاهدة 2.0" على مراحل.

  • الاستخدام التجريبي: سنمنح إمكانية الوصول إلى هذه الميزة في البداية لمجموعة محدّدة من الشركاء من خلال برنامج استخدام المنتج قبل إطلاقه.
  • إتاحة الميزة لمزيد من المطوّرين: نحن نعمل جاهدين على إتاحة ميزة "مواصلة المشاهدة 2.0" لجميع المطوّرين قريبًا.

لضمان إطلاق سلس ونجاحه، اتّخذنا إجراءات وقائية لإدارة عملية الطرح. ويشمل ذلك قائمة مسموح بها من جانب ميزة "مواصلة المشاهدة 2.0" وفحصًا منفصلاً ضمن حزمة SDK لميزة "التفاعل". سواء كنت شريكًا في برنامج استخدام واجهة برمجة التطبيقات قبل إطلاقها (EAP) أو كنت تريد الانضمام قريبًا، يُرجى التواصل معنا حتى نتمكّن من إعداد أذونات الوصول قبل بدء دمج حزمة تطوير البرامج (SDK) لـ Engage.

تم تعديل متطلبات الصور في قسم إنشاء كيانات.

باستخدام مستندات واجهة برمجة التطبيقات الجديدة هذه، هل سيقوم خادم Google بسحب بيانات "متابعة المشاهدة" من العميل، وهل ستظهر في جميع الأجهزة؟

توفّر واجهة برمجة التطبيقات الجديدة مزايا مهمة لميزة "مواصلة المشاهدة"، بما في ذلك:

  • تجربة سلسة على جميع أجهزة Google TV: يمكن للمستخدمين بدء المشاهدة على أحد أجهزة Google TV واستئنافها على أي جهاز Google TV آخر تم تسجيل الدخول إليه باستخدام الحساب نفسه. تعمل هذه الميزة أيضًا مع الإصدارات القديمة من Android TV.

  • دمج التطبيقات المتوافقة مع الأجهزة الجوّالة: تتوفّر ميزة "مواصلة المشاهدة" في تطبيق Google TV المتوافق مع الأجهزة الجوّالة على Android وiOS، ما يتيح للمستخدمين التبديل بسلاسة بين التلفزيون والأجهزة الجوّالة.

  • زيادة معدل الاحتفاظ بالمستخدمين: حتى على الأجهزة التي لم يتم تثبيت التطبيق عليها أو التي لم يسجّل المستخدم الدخول إليها، يطلب زر "متابعة المشاهدة" من المستخدمين إعادة التفاعل مع تطبيقك، ما يؤدي إلى زيادة معدل الاحتفاظ بالمستخدمين.

  • التوسع إلى منصات أخرى: يتيح هذا الدمج ميزة "متابعة المشاهدة" على منصات وسائط Google الأخرى، مثل Android وPlay Cubes والأجهزة اللوحية وغيرها من تطبيقات وسائط Google وشاشاتها على Android، ما يزيد من تفاعل المستخدمين على جميع الأجهزة.

ما هو الحد الأقصى لعدد الكيانات التي يمكنني نشرها في مجموعة "المتابعة"؟

يمكن لكل شريك مطوّر استخدام 5 كيانات كحد أقصى في مجموعة "المتابعة". يضمن هذا الحدّ توزيع المحتوى بشكل عادل في صف "مواصلة المشاهدة" على Google TV، وهو مساحة مشترَكة لموفّري إعلام متعدّدين.

ماذا يحدث إذا حاولتُ نشر أكثر من 5 كيانات؟

سترفض EngageSDK طلب النشر إذا تجاوز الحد الأقصى المسموح به وهو 5 كيانات. يجب تقليل عدد الكيانات في طلبك لكي تتمكّن من النشر بنجاح. يجب عدم تضمين سوى العناصر التي توقّف المستخدمون عن مشاهدتها، لذا في معظم الحالات، لن يكون هناك سوى عدد قليل من هذه العناصر. عندما يكون هناك أكثر من 5 كيانات من هذا النوع، يمكنك اختيار أحدثها للنشر.

لماذا تمّ فرض حدّ أقصى لعدد الكيانات؟

يعرض صف "مواصلة المشاهدة" على Google TV محتوى من مقدّمي وسائط مختلفين. من خلال الحد من عدد الكيانات لكل مقدّم خدمة، نضمن للمستخدمين الاطّلاع على مجموعة متنوعة من المحتوى من جميع مصادرهم المفضّلة، ما يعزّز تجربة مستخدم adil ومتوازن.

أسئلة حول تطبيق إثبات الملكية

هل يجب اختبار تطبيقي باستخدام تطبيق التحقّق قبل إرساله؟

نعم، يجب اختبار تطبيقك باستخدام تطبيق التحقّق قبل إرسال حزمة APK.

ندرك أنّك قد تكون واثقًا من عملية التنفيذ، ولكن يتضمن دمج ميزة "مواصلة المشاهدة" 2.0 العديد من المكونات المعقدة. يعمل تطبيق التحقّق كشبكة أمان، حيث يرصد المشاكل المحتمَلة في وقت مبكر ويوفّر عليك الوقت والجهد على المدى الطويل.

يمكنك اعتبار هذه الخطوة بمثابة فحص سريع يساعد في ضمان عملية إطلاق سلسة وتجربة رائعة للمستخدمين.

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

لإرسال حزمة APK، عليك تضمين لقطة شاشة توضّح أنّ تطبيقك اجتاز عملية إثبات الهوية.

#### ما هي بعض الأخطاء الشائعة التي يجب الانتباه إليها أثناء الدمج؟

تم تصميم تطبيق التحقّق من أجل رصد المشاكل المحتمَلة في عملية دمج ميزة "مواصلة المشاهدة" 2.0. في ما يلي بعض الأخطاء الشائعة التي يواجهها المطوّرون عادةً:

بالنسبة إلى جميع أنواع المحتوى (الأفلام والحلقات التلفزيونية وأحداث البث المباشر ومقاطع الفيديو):

  • الروابط غير المتوفّرة: تأكَّد من تقديم معرّفات موارد منتظمة (روابط) صالحة خاصة بالمنصة لمحتوى موقعك الإلكتروني. وتُعلم هذه الروابط النظام بمكان العثور على المحتوى الخاص بك على كل منصّة.
  • عدم توفّر عناوين: احرص على تضمين عناوين لجميع فيديوهاتك. ويساعد ذلك المستخدمين في تحديد المحتوى الذي كانوا يشاهدونه.
  • نسب العرض إلى الارتفاع للصور: تأكَّد من أنّ جميع الصور المرتبطة بمحتوى قناتك تبلغ نسبتها عرض إلى ارتفاع قريبة من ‎16:9. يضمن ذلك عرض صورك بشكل صحيح على الشاشات المختلفة.

بالنسبة إلى الحلقات التلفزيونية:

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

بالنسبة إلى الأفلام:

  • موضع تشغيل دقيق: على غرار الحلقات التلفزيونية، تأكَّد من دقة موضع التشغيل الماضي.

بالنسبة إلى فيديوهات البث المباشر:

  • معلومات المشغّل: يجب تضمين اسم المشغّل في أحداث البث المباشر.

بالنسبة إلى مقاطع الفيديو:

  • معلومات صانع المحتوى: حدِّد صانع مقطع الفيديو.

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

أسئلة حول الحساب والملف الشخصي

يستخدم تطبيقي عمليات تسجيل دخول مجهولة الهوية للمستخدمين. هل لا يزال عنصر AccountProfile مطلوبًا لاستخدام ميزة "مواصلة المشاهدة 2.0"؟

تم تصميم AccountProfile للتطبيقات التي تستخدم حسابات مستخدمين فردية. ومع ذلك، ندرك أنّ بعض التطبيقات، مثل تطبيقك، قد تعتمد على عمليات تسجيل الدخول المجهولة الهوية. في ما يلي آلية عمل ميزة "مواصلة المشاهدة 2.0" في هذا السيناريو:

  • يجب استخدام AccountProfile من الناحية الفنية، ولكن لا يزال بإمكانك دمج ميزة "مواصلة المشاهدة 2.0" حتى إذا لم يكن تطبيقك يتضمّن نظامًا لحسابات المستخدمين.
  • تقتصر على الاستخدام على الجهاز: تعتمد إمكانات ميزة "مواصلة المشاهدة" 2.0 على تحديد المستخدمين على مختلف الأجهزة. وبما أنّ تسجيلات الدخول مجهولة الهوية لا توفّر هذه الميزة، ستقتصر الميزة على الجهاز الحالي للمستخدم.
  • كيفية الضبط: لإعداد هذه الميزة، عليك إيقاف المزامنة على جميع الأجهزة. يضمن ذلك عدم ظهور إدخالات "مواصلة المشاهدة" إلا على الجهاز المحدّد الذي تم تشغيل المحتوى عليه.

في الملخّص: على الرغم من أنّه يمكنك دمج ميزة "مواصلة المشاهدة 2.0" مع عمليات تسجيل الدخول المجهولة الهوية، لن يتمكّن المستخدمون من استئناف مشاهدة المحتوى إلا على الجهاز نفسه.

هل يمكنني استخدام AccountProfile مع accountId فقط بدون profileId، حتى إذا كان تطبيقي يتيح كلاً من accountId وprofileId؟

تتطلّب سمة AccountProfile كلاً من accountId وprofileId لكي تعمل بشكل صحيح. وفي ما يلي السبب في ذلك:

  • تحديد الهوية بشكلٍ متّسق: يحدِّد accountId المستخدم، في حين يحدِّد profileId الفرق بين الملفات الشخصية المختلفة ضمن حساب هذا المستخدم (إذا كان ذلك منطبقًا). يضمن تقديم كلاهما تتبُّع ميزة "متابعة المشاهدة" بدقة وعرض المحتوى لكل ملف شخصي فردي.
  • منع الأخطاء: يمكن أن يؤدي استخدام accountId وprofileId بشكل غير متّسق في طلبات البيانات المختلفة من واجهة برمجة التطبيقات إلى حدوث سلوك وأخطاء غير متوقّعة. على سبيل المثال، إذا أدرجت كلا السمتَين عند إضافة محتوى إلى "المواصلة في المشاهدة" ولكن استخدمت accountId فقط عند حذف المحتوى، قد لا يتمكّن النظام من تحديد العناصر المقصودة وإزالتها بشكل صحيح.

هل profileId مطلوب لاستخدام ميزة "مواصلة المشاهدة 2.0"؟

  • يجب إدخال مَعلمة accountId. ويحدِّد ذلك هوية المستخدم على جميع الأجهزة.
  • إنّ مَعلمة profileId ضرورية لتوفير تجربة مستخدم جيدة. على الرغم من أنّه اختياري من الناحية الفنية، يُنصح بشدة باستخدام ملف التعريف profileId إذا كانت خدمتك تتيح استخدام ملفات شخصية متعدّدة (مثل العديد من خدمات البث). ما أهمية ذلك؟ وبدون profileId، قد يعرض خيار "متابعة المشاهدة" محتوًى من الملفات الشخصية الأخرى في الحساب نفسه. وقد يؤدي ذلك إلى تقديم تجربة استخدام مربكة ومحبطة للمستخدمين.
  • باختصار، يضمن تقديم profileId أن يعرض خيار "مواصلة المشاهدة" سجلّ مشاهدة كل مستخدم بدقة. يجب توفير هذا العنصر ما لم يكن تطبيقك لا يتيح مفهوم الملف الشخصي ضمن الحساب.

كيف تستخدم Google مَعلمة profileId من جانبها؟

إذا كانت الخدمة تقدّم ملفات شخصية مختلفة لمشاهدة المحتوى، سيتم استخدام accountId و profileId لربط المحتوى الذي تمت مشاهدته على الجهاز بحساب Google الذي تم تسجيل الدخول إليه على الجهاز. ستسجِّل Google بيانات ContinueWatching استنادًا إلى تركيبة accountId-profileId. أي جهاز Google تم تسجيل الدخول عليه باستخدام حساب Google نفسه، سيحصل على أحدث البيانات المعدَّلة من معرّفات ملف التعريف المرتبطة بـ accountId نفسها، في صف ContinueWatching.

هل يجب ربط الحسابات لاستخدام ميزة "مواصلة المشاهدة 2.0"؟

ربط الحساب غير مطلوب. وسيتم إيقاف هذه الواجهة نهائيًا، وستتولى واجهة برمجة التطبيقات Device Entitlements API الجديدة تغطية جميع حالات الاستخدام المتعلّقة بها.

أسئلة حول المزامنة على جميع الأجهزة

بعد أن يوافق المستخدم على "المزامنة على جميع الأجهزة"، سيتم حفظ المحتوى الذي يشاهده على خوادم Google TV، ما يتيح له مواصلة المشاهدة من حيث توقف على أي جهاز سجّل الدخول عليه. وفي حال عدم الحصول على موافقة، سيبقى سجلّ المشاهدة محفوظًا على الجهاز الحالي فقط.

هل يمكننا ضبط "المزامنة بين الأجهزة" على "خطأ"؟

تتحكّم علامة UserConsentToSyncAcrossDevices في ما إذا كان سيتم مزامنة بيانات ContinuationCluster الخاصة بالمستخدم على جميع أجهزته (التلفزيون والهاتف والجهاز اللوحي وما إلى ذلك). إذا تم ضبط هذه العلامة على false، لن تتم مواصلة المشاهدة إلا على الجهاز نفسه.

للاستفادة إلى أقصى حد من ميزة "الوصول على جميع الأجهزة"، ننصحك بشدة بأن يحصل تطبيقك على موافقة المستخدم وأن يضبط SyncAcrossDevices على true.

الأجهزة؟ ما هي نقاط البيانات التي تتم مشاركتها مع خوادم الجهات الخارجية من الأجهزة غير المزوّدة بنظام التشغيل Android؟

يتم جمع الموافقة على مستوى المستخدم (على مستوى الملف الشخصي أو الحساب). بعد الحصول على الموافقة، يمكن إرسال حمولات مواصلة المشاهدة استنادًا إلى التفاعل في أي مكان حتى تتمكّن Google من عرض حالة استئناف المستخدمين للمحتوى على جميع الأجهزة التي يتفاعلون معها جزئيًا أو بشكل لاحق (بدون الحاجة إلى طلب الموافقة مرة أخرى على كل جهاز أو منصة). سيُرسِل الشركاء أحدث حالة لمواصلة المشاهدة للمستخدمين (وفقًا للمواصفات) المرتبطة بمعرّف الملف الشخصي (الذي تم إيداعه على Android).

أسئلة حول واجهة برمجة التطبيقات REST

هل تتوفّر مستندات حول واجهة برمجة التطبيقات REST API؟

من المتوقّع أن يتم إيقاف REST API نهائيًا في آذار (مارس) 2025، وقد تم توثيق ذلك في مستندات المطوّرين الخاصة بميزة "مواصلة المشاهدة" 2.0.

أسئلة قديمة حول ميزة "اقتراحات أخرى"

هل تحلّ واجهة برمجة التطبيقات Video Discovery API محلّ واجهة برمجة التطبيقات Watch Next API؟

ستكون Video Discovery API متوافقة مع الإصدارات القديمة على جميع أجهزة Android TV التي تتيح استخدام Watch Next API. على جميع المطوّرين استخدام Video Discovery API (Continue Watching 2.0) للنشر في صف "متابعة المشاهدة".

أسئلة حول الاختبار والدمج

ما الفرق بين LastPlayBackPositionTimeMillis وduration؟

يجب أن يعرض LastPlayBackPositionTimeMillis مدة التشغيل بالمليثواني التي توقّف فيها المستخدم عن المشاهدة (مثلاً، ‫605,000 ملي ثانية لمدة 10 دقائق و 5 ثوانٍ). ويجب ألا تزيد عن إجمالي مدة العنصر.

في حين أنّ LastEngagementTime هو الطابع الزمني لآخر تفاعل للمستخدِم مع المحتوى.

ما هي حالات الاختبار التي يجب إجراؤها؟

في ما يلي حالات الاختبار التي يجريها فريق ضمان الجودة في Google TV. يمكن إجراء حالات اختبار مشابهة على مساحات عرض أخرى أيضًا.

  1. شاهِد فيديو تزيد مدّته عن 20 دقيقة لمدة 5 دقائق تقريبًا. اخرج من التطبيق. من المفترض أن تظهر بطاقة الفيديو في صف "متابعة المشاهدة". ملاحظة: لا نعرض سوى 5 بطاقات لكل تطبيق تابع لجهة خارجية في "الحملات على شبكة البحث".
  2. عند النقر على البطاقة التي ظهرت حديثًا في صف "متابعة المشاهدة"، من المفترض أن تتم مواصلة تشغيل الفيديو من النقطة المناسبة فيه. ملاحظة: من المفترض أن تتم مواصلة تشغيل أي محتوى جديد أو قديم من حيث توقفت آخر مرة.
  3. من المفترض أن يؤدي تغيير الحسابات على جهاز GTV إلى تغيير البطاقات في صف "متابعة المشاهدة". من المفترض أن تظهر الفيديوهات من الحساب الحالي فقط. تم ترتيبها في الترتيب حسب تاريخ الإنشاء. سيتم دمج CW لملف تطبيقات الجهات الخارجية. ملاحظة: سيعرض تقرير "الاستهداف من خلال المحتوى" لحساب GoogleAccount2 محتوى تابعًا لجهات خارجية شاهده GoogleAccount2.
  4. الخروج من التطبيق باستخدام زر الرجوع > التأكّد من ظهور البطاقة في صف "مواصلة المشاهدة"
  5. يمكنك إخفاء الفيديو في صف "متابعة المشاهدة"، ومن المفترض ألا يظهر مرة أخرى. اختبِر ما إذا كان المحتوى المخفي يظل مخفيًا بعد 24 ساعة وحتى بعد فتح التطبيق بعد 24 ساعة. تأكَّد من أنّ إخفاء عنصر واحد لا يؤدي إلى إخفاء عناصر متعددة.
    1. توفّر المحتوى في قسم "متابعة المشاهدة" مع البيانات الوصفية الكاملة: صورة البطاقة، اسم التطبيق، والعنوان، ورقم حلقة الموسم لمحتوى التلفزيون
  6. يظهر القسم "التحقّق من مستوى التقدّم" في شريط التقدّم.
  7. شاهد المستخدم المحتوى حتى ظهور الأسماء الختامية، ولا يظهر المحتوى في ميزة مواصلة المشاهدة.
  8. التأكّد من عدم ظهور أي عناصر لم تتم مشاهدتها في صف "متابعة المشاهدة"
  9. تأكَّد من أنّ عناصر CW مُرتَّبة زمنيًا استنادًا إلى وقت حدوث نشاط المشاهدة وليس وقت فتح التطبيق آخر مرة أو اليوم الأخير.
  10. تأكَّد من أنّ تفاصيل الحلقة والموسم في بطاقة CW تتطابق مع ما تمّت مشاهدته على المحتوى المرتبط بالحلقات.
  11. تأكَّد من أنّ العناصر المكتملة (العناصر التي تم استخدام رصيدها أو أكثر) لا تظهر في ميزة مواصلة المشاهدة.
  12. أوقِف الجهاز في منتصف مشاهدة الحلقة أو الفيلم أو البرنامج. "أطفئ الجهاز في منتصف مشاهدة الحلقة/الفيلم/البرنامج. يُرجى التأكّد من أنّه عند تشغيل الجهاز والتلفزيون الآخر، يعرض CW البطاقة الصحيحة في الموضع الصحيح وشريط التقدّم الصحيح.
  13. يُرجى إيقاف الجهاز بعد مشاهدة الحلقة 1 بالكامل، والتأكّد مما يلي:
    1. لا تظهر الحلقة 1 في صف "مواصلة المشاهدة" [على الجهاز الثاني وعند تشغيل الجهاز التجريبي]
    2. من المفترض أن تظهر الحلقة 2 (إذا كانت متاحة) في صف "مواصلة المشاهدة" [على الجهاز الثاني وعند تشغيل الجهاز التجريبي]

  14. السيناريو الأول: TV1: GoogleAccount: mom، حساب / ملف شخصي تابعَين لجهة خارجية: الحساب 1/ profile_1. شاهِد المحتوى وتأكَّد من أنّ بيانات CW تعرض المحتوى الذي تمت مشاهدته من خلال حساب/ملف شخصي تابعَين لجهة خارجية: account_1/profile_1

    1. TV2: GoogleAccount: mom. تحقّق من بيانات CW من السيناريو الأول. الآن، سجِّل الدخول إلى تطبيق الجهة الخارجية باستخدام حساب مختلف. حساب / ملف شخصي تابعَين لجهة خارجية: account_2 / profile_2. شاهِد المحتوى وتأكَّد من أنّ بيانات CW تعرض محتوًى شاهَده حساب_2/الملف الشخصي_2 التابعَين لجهة خارجية.

  15. حساب Google: mom. لم يتم تثبيت تطبيق تابع لجهة خارجية أو غطاء جهاز جديد. على جهاز جديد(FDR الجهاز)، يعرض تطبيق Verify CW بيانات من آخر تطبيق تابع لجهة خارجية استخدمه حساب Google. ملاحظة: يجب ألا يعرض صفّ CW محتوًى تابعًا لجهة خارجية إذا لم يكن GAIA مرتبطًا بعد بملف تجاري تابع لجهة خارجية على جهاز آخر.

    1. حساب Google: mom. تم تثبيت تطبيق تابع لجهة خارجية أو تم تثبيته على جهاز جديد ولكن لم يتم تسجيل الدخول. على جهاز جديد(FDR الجهاز)، يعرض تطبيق Verify CW بيانات من آخر تطبيق تابع لجهة خارجية استخدمه حساب Google.
    2. ملاحظة: عند تثبيت التطبيق وتسجيل الدخول إليه، ستعكس حالة CW مستخدم الجهة الخارجية النشط الذي سجّل الدخول إلى تطبيق الجهة الخارجية.
    3. ملاحظة: يجب ألا يعرض صف "متابعة المشاهدة" محتوًى تابعًا لجهة خارجية إذا لم يكن حساب Google مرتبطًا بعد بملف شخصي تابع لجهة خارجية.

لا يظهر خيار "مواصلة المشاهدة" في تطبيق Google TV على أجهزة iOS. ما الذي حدث؟

عليك إرسال روابط لصفحات في تطبيق iOS لكي تظهر ميزة "متابعة المشاهدة" على أجهزة iOS.

ما هي وتيرة تعديل معلومات "متابعة المشاهدة"؟ هل يجب تعديل معلومات "مواصلة المشاهدة" بشكل متكرّر، مثلاً كل 15 ثانية؟

لا، لا يُنصح بإجراء تعديلات متكرّرة. وفي ما يلي السبب في ذلك:

  • تأثير الأداء: يؤدي إرسال التحديثات باستمرار إلى زيادة غير ضرورية في الضغط على خوادمنا، ما قد يؤدي إلى إبطاء النظام للجميع.
  • البيانات غير الضرورية: عندما يشاهد المستخدم المحتوى بشكل نشط، يتغيّر موضع التشغيل باستمرار. يؤدي إرسال التعديلات كل بضع ثوانٍ إلى إنشاء الكثير من البيانات المكرّرة التي لا تساعد في استئناف التشغيل.

حالات تعديل معلومات "مواصلة المشاهدة":

ركِّز على تسجيل التغييرات المهمة في مستوى تقدّم المشاهدة لدى المستخدم. في ما يلي السيناريوهات الرئيسية:

  • التشغيل متوقف مؤقتًا أو متوقف: عندما يوقف المستخدم المشاهدة مؤقتًا أو يتوقف عن المشاهدة، أرسِل ملفًا شخصيًا لحفظ موضع المشاهدة الحالي.
  • التطبيق مغلق أو مُشغَّل في الخلفية: إذا خرج المستخدم من التطبيق أو غيّر إلى تطبيق آخر أثناء مشاهدة فيديو، أرسِل تحديثًا لحفظ مستوى تقدّمه.
  • عندما يزيل المستخدم محتوى من صف "مواصلة المشاهدة" داخل التطبيق

كيفية إجراء التعديلات بفعالية:

بدلاً من التحديثات المبرمَجة، استخدِم الأحداث ضمن دورة حياة مشغّل الفيديو أو التطبيق لتشغيل التحديثات. مثلاً:

  • onPause وonStop: عند إيقاف تشغيل الفيديو مؤقتًا أو إيقافه
  • onAppClose وonAppBackgrounded: عند إغلاق التطبيق أو نقله إلى الخلفية

من خلال اتّباع هذه الإرشادات، يمكنك ضمان استخدام الموارد بكفاءة مع مواصلة توفير تجربة سلسة لميزة "متابعة المشاهدة" للمستخدمين.