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

كيف يمكنني إنشاء مرفق رائع؟

ستعرض إشعارات الأجهزة المجاورة الرسائل في قسم "الأجهزة المجاورة" ضمن إعدادات Google، وتضيء مربع الإعدادات السريعة المجاورة على الأجهزة المتوافقة، وسيتم الترويج لأفضل المرفقات أداءً كإشعارات.

لتحقيق أقصى قدر من الفعالية، يجب أن تكون المرفقات:

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

لا يظهر المرفق في قسم الأجهزة المجاورة ضمن إعدادات Google. ما السبب؟

• هناك بعض القيود على الرسائل التي نعرضها، مثل السماح فقط بعناوين URL التي تستخدم HTTPS وعدم السماح بالمحتوى الذي ينتهك سياساتنا.
• الروابط إلى play.google.com غير متاحة. بدلاً من ذلك، يمكنك استخدام مرفقات intent للتطبيق لتمكين تجربة يدعمها أحد التطبيقات.

لا يتم عرض رسالتي كإشعار. ما السبب؟

هناك عدة أسباب لعدم ظهور الإشعار.

1. لن يظهر إشعار إذا لم يتلق المستخدمون المرفق جيدًا. يمكنك العثور أعلاه على نصائح لإنشاء مرفق رائع.
2. عادةً ما تبحث ميزة "إشعارات الأجهزة المجاورة" عن أجهزة المرشد لبضع ثوانٍ بعد تشغيل الشاشة. إذا لم يتم تشغيل الشاشة لفترة، لن يكتشف الجهاز إشارات جديدة.
3. يظهر المرفق في وضع تصحيح الأخطاء فقط على أجهزة وضع تصحيح الأخطاء. راجع أيضًا وضع تصحيح الأخطاء
4. إذا تم تجاهل الإشعار على أحد الأجهزة مؤخرًا، فقد لا يعرض هذا الجهاز إشعارًا آخر لفترة من الوقت. كما تتم إعادة تعيين سياسة التراجع إذا فتح المستخدم قسم المواقع القريبة من إعدادات Google.
5. قد لا يتم عرض الإشعار إذا كان ينتهك سياسات إشعارات الأجهزة المجاورة.

ما إصدارات Android التي تتوافق مع إشعارات الأجهزة المجاورة؟

يتم دعم إشعارات الأجهزة المجاورة في نظام التشغيل Android 4.4 (KitKat) والإصدارات الأحدث.

كيف ترتبط إشعارات الأجهزة المجاورة بعنوان Eddystone-URL أو الشبكة المادية؟

تعمل "إشعارات الأجهزة المجاورة" بالتوازي مع Eddystone-URL والشبكة المادية مع السلوك الدقيق اعتمادًا على حالات الاستخدام والإمكانات. على سبيل المثال، إذا كان لديك حالة استخدام واحدة متوفرة في موقعك على الويب، فيمكنك استخدام مرشد عنوان URL Eddystone-URL. إذا كانت حالة الاستخدام متاحة في تطبيقك، يمكنك استخدام "إشعارات الأجهزة المجاورة" بقصد من التطبيق.

ما هو التنسيق المطلوب لمرفقات "إشعارات الأجهزة المجاورة" في واجهة برمجة تطبيقات Proximity Beacon؟

انظر تنسيق بيانات المرفق لمزيد من التفاصيل. وباختصار، يجب أن تكون المرفقات بالشكل التالي:

    {
      "title": "Example",
      "url": "https://www.example.com"
    }

كيف يتم استخدام العنوان في مرفقات "إشعارات الأجهزة المجاورة"؟

سيظهر العنوان في الإشعارات والقوائم التي يتم عرضها بواسطة إشعارات الأجهزة المجاورة. على سبيل المثال، إذا تم ضبط العنوان على "مثال على إجراء في مكانه"، سيظهر نص الإشعار على أنه "Example action at place" بالإضافة إلى اسم التطبيق أو عنوان URL.

هل تعمل ميزة "إشعارات الأجهزة المجاورة" على تثبيت التطبيق في الخلفية؟

لا، ستعمل ميزة "إشعارات الأجهزة المجاورة" على إعادة توجيه المستخدمين إلى "متجر Google Play" للتثبيت من هناك.

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

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

هل تتوافق إشعارات الأجهزة المجاورة مع iBeacon؟

نعم، طالما أن المرشد يحتوي على معرّف iBeacon ثابت. يمكن تسجيل هذه المعرفات في واجهة برمجة تطبيقات Proximity Beacon، ويمكن أن تحتوي على مرفقات "إشعارات الأجهزة المجاورة".

أين ومتى يتم إجراء الفحص، إن لم يكن في تطبيقي؟

يتم إجراء الفحص من خلال "خدمات Google Play" وفقط في أحداث "تشغيل الشاشة".

من المسؤول عن تسجيل أجهزة المرشد في واجهة برمجة تطبيقات جهاز المرشد؟

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

ما تنسيق معرف الموارد المنتظم (URI) لقصد التطبيق؟

أولاً، باستخدام لوحة الإشارات، يمكنك السماح لواجهة الويب الأمامية بإنشاء عنوان URI صالح لك بشرط أن تفهم أجزاء المخطط والمضيف ومسار معرف الموارد المنتظم. وفي ما يلي مثال لذلك:

إذا كنت تريد أن تطلق ميزة "إشعارات الأجهزة المجاورة" النشاط في تطبيقك الذي يتضمن فلتر intent التالي:

    <data android:host="item"
          android:pathPrefix="/scanner"
          android:scheme="myapp" />

في ما يلي عنوان URL المقصود لـ intent:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;end

بمعنى أن عنوان URI يمكن تقسيمه على النحو التالي:

    intent://<host>/<path>#Intent;scheme=<scheme>;package=<package name>;end

إذا كان نشاطك يتطلّب عناصر إضافية مستندة إلى النية بالشراء، يجب إضافتها قبل ;end مباشرةً:

    intent://item/scanner#Intent;scheme=myapp;package=com.myapp;S.string_extra=value%20one;B.bool_extra=true;end

يمكن استخدام الأنواع التالية مع الإضافات:

• منطقي
• بايت
• تشار
• مزدوج
• نافذة عائمة
• Int
• طويلة
• فيديو Shorts قصير

راجع أيضًا Intent.java#parseUri() وIntent.java#toUri(int) في سياق URI_INTENT_SCHEME لمزيد من التفاصيل عن عنوان URL المقصود.

ماذا عن ترجمة العنوان الذي تستخدمه إشعارات الأجهزة المجاورة؟

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