Engage SDK للصحة واللياقة: تعليمات الدمج الفني التابعة لجهات خارجية

تنشئ Google مساحة عرض على الجهاز ينظّم تطبيقات المستخدمين حسب المجالات وتتيح تجربة غامرة جديدة لاستهلاك محتوى التطبيق المخصّص واكتشافه. تتيح هذه التجربة للشركاء من المطوّرين فرصة عرض أفضل محتوى وافٍ لهم في قناة مخصَّصة خارج التطبيق.ويتضمّن هذا الدليل تعليمات للشركاء من المطوّرين حول كيفية دمج المحتوى المتعلّق بالصحة واللياقة البدنية لديهم باستخدام حزمة Engage SDK لتعبئة هذه المساحة الجديدة.

تفاصيل عملية الدمج

المصطلحات

يشمل هذا الدمج أنواع المجموعات الثلاثة التالية: الاقتراح والمميزة والمتابعة.

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

  • يمكن أن تتألف مجموعة الاقتراحات من ArticleEntity أو PersonEntity أو EventEntity، ولكن لا يمكن أن تتألف من أنواع مختلفة من الكيانات.

  تأخذ توصياتك البنية التالية:

  • مجموعة الاقتراحات: طريقة عرض لواجهة مستخدم تتضمّن مجموعة من الاقتراحات من الشريك المطوّر نفسه.

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

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

      

    • كيان الشخص: يمثل الكيان الشخصي شخصًا. يمكن أن تكون الاقتراحات تسليط الضوء على مدرب أو أي شخص يتعلق بالصحة واللياقة البدنية، وما إلى ذلك.

      

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

      

• تعرض مجموعة المتابعة المحتوى الذي تفاعل معه المستخدمون مؤخرًا من عدة شركاء مطوِّرين في مجموعة واحدة لواجهة مستخدم. سيُسمح لكل شريك مطوِّر ببث ما لا يزيد عن 10 كيانات في مجموعة Continuation API.

  يمكن أن يتخذ المحتوى اللاحق البنية التالية:

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

    

  • EventBookEntity: يمثل EventBookEntity حجز موعد معيّن ويساعد المستخدمين في تتبّع الحجوزات القادمة أو المستمرة بشأن اللياقة البدنية والأحداث الصحية. مثال: الجلسات التدريبية

    

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

  • GenericFeaturedEntity: يختلف عنصر GenericFeaturedEntity عن عنصر التوصية في هذا العنصر المميز لأهم محتوى واحد من مطوري البرامج، ويجب أن يمثل المحتوى الوحيد الأكثر أهمية الذي سيكون مثيرًا للاهتمام وذا صلة بالمستخدمين.

    

المرحلة التمهيدية

الحد الأدنى لمستوى واجهة برمجة التطبيقات: 19

إضافة مكتبة com.google.android.play:engage إلى تطبيقك:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.4.1'
}

الملخّص

يستند التصميم إلى تنفيذ خدمة محددة.

تخضع البيانات التي يمكن للعميل نشرها للحدود التالية لأنواع المجموعات المختلفة:

الخطوة 1: تقديم بيانات الكيان

حدّدت حزمة SDK كيانات مختلفة لتمثيل كل نوع من أنواع العناصر. ندعم الكيانات التالية لفئة الصحة واللياقة البدنية:

1. GenericFeaturedEntity
2. ArticleEntity
3. PersonEntity
4. EventEntity
5. EventReservationEntity

توضّح الرسوم البيانية أدناه السمات والمتطلبات المتاحة لكل نوع.

GenericFeaturedEntity

ArticleEntity

PersonEntity

EventEntity

EventReservationEntity

مواصفات الصور

يتضمّن هذا الجدول المواصفات المطلوبة لمواد عرض الصور:

يجب استضافة الصور على شبكات توصيل محتوى (CDN) عامة لكي تتمكّن Google من الوصول إليها.

تنسيقات الملفات

PNG أو JPG أو GIF ثابت أو WebP

الحد الأقصى لحجم الملف

5120 كيلوبايت

اقتراحات إضافية

• المنطقة الآمنة للصور: ضَع المحتوى المهم في الوسط بحيث يشغل 80% من الصورة.
• استخدام خلفية شفافة لكي يتم عرض الصورة بشكل صحيح في إعدادات المظهر الداكن والفاتح

فئة المحتوى

تسمح فئة المحتوى للتطبيقات بنشر محتوى ينتمي إلى فئات متعددة. يؤدي هذا إلى ربط المحتوى ببعض الفئات المحددة مسبقًا، وهي:

• TYPE_EDUCATION
• TYPE_SPORTS
• TYPE_MOVIES_AND_TV_SHOWS
• TYPE_BOOKS
• TYPE_AUDIOBOOKS
• TYPE_MUSIC
• TYPE_DIGITAL_GAMES
• TYPE_TRAVEL_AND_LOCAL
• TYPE_HOME_AND_AUTO
• TYPE_BUSINESS
• TYPE_NEWS
• TYPE_FOOD_AND_DRINK
• TYPE_SHOPPING
• TYPE_HEALTH_AND_FITENESS
• TYPE_MEDICAL
• TYPE_PARENTING
• TYPE_DATING

يجب استضافة الصور على شبكات توصيل محتوى (CDN) عامة لكي تتمكّن Google من الوصول إليها.

إرشادات حول استخدام فئات المحتوى

1. تكون بعض الكيانات مثل ArticleEntity وGenericFeaturedEntity مؤهلة لاستخدام أي من فئات المحتوى. بالنسبة إلى الكيانات الأخرى، مثل EventEntity وEventBookEntity وPersonEntity، فقط مجموعة فرعية من هذه الفئات مؤهلة. تحقَّق من قائمة الفئات المؤهَّلة لنوع الكيان قبل تعبئة القائمة.

2. استخدم نوع الكيان المحدد لبعض فئات المحتوى على مجموعة من الكيانات العامة وContentCategory:

   • TYPE_AVERAGES_AND_TV_SHOWS: يمكنك الاطّلاع على الكيانات من خلال مشاهدة دليل الدمج قبل استخدام العناصر العامة.
   • TYPE_BOOKS - يمكنك الاطلاع على EbookEntity قبل استخدام الكيانات العامة.
   • TYPE_AUDIOBOOKS - راجع AudiobookEntity قبل استخدام الكيانات العامة.
   • TYPE_SHOPPING - يُرجى مراجعة ShoppingEntity قبل استخدام الكيانات العامة.
   • TYPE_FOOD_AND_DRINK - يُرجى الاطّلاع على الكيانات من Food Integration guide قبل استخدام العناصر العامة.

3. يعد حقل ContentCategory حقلاً اختياريًا وينبغي تركه فارغًا إذا كان المحتوى لا ينتمي إلى أي من الفئات المذكورة سابقًا.

4. في حال توفير فئات محتوى متعددة، يجب توفيرها بترتيب مدى صلتها بالمحتوى مع وضع فئة المحتوى الأكثر صلة فيه أولاً في القائمة.

الخطوة 2: تقديم بيانات المجموعة

من المستحسن تنفيذ مهمة نشر المحتوى في الخلفية (على سبيل المثال، باستخدام WorkManager) وجدولتها بشكل منتظم أو حسب الحدث (على سبيل المثال، في كل مرة يفتح فيها المستخدم التطبيق أو عندما يضيف المستخدم للتو سلعة إلى سلة التسوّق).

تقع على عاتق AppEngagePublishClient مسؤولية نشر المجموعات.

تتوفّر واجهات برمجة التطبيقات التالية لنشر المجموعات في الجهاز العميل:

• isServiceAvailable
• publishRecommendationClusters
• publishFeaturedCluster
• publishContinuationCluster
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteFeaturedCluster
• deleteContinuationCluster
• deleteUserManagementCluster
• deleteClusters

isServiceAvailable

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

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

تُستخدَم واجهة برمجة التطبيقات هذه لنشر قائمة تتضمّن عناصر RecommendationCluster.

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية في معاملة واحدة:

• وستتم إزالة بيانات RecommendationCluster الحالية من الشريك المطوّر.
• يتم تحليل البيانات الواردة من الطلب وتخزينها في مجموعة الاقتراحات المحدَّثة.

وفي حال حدوث خطأ، يتم رفض الطلب بأكمله والحفاظ على الحالة الحالية.

publishFeaturedCluster

تُستخدَم واجهة برمجة التطبيقات هذه لنشر قائمة تتضمّن عناصر FeaturedCluster.

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية في معاملة واحدة:

• وستتم إزالة بيانات FeaturedCluster الحالية من الشريك المطوّر.
• يتم تحليل البيانات من الطلب وتخزينها في "المجموعة المميزة" المعدّلة.

وفي حال حدوث خطأ، يتم رفض الطلب بأكمله والحفاظ على الحالة الحالية.

publishContinuationCluster

تُستخدَم واجهة برمجة التطبيقات هذه لنشر عنصر ContinuationCluster.

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية في معاملة واحدة:

• وستتم إزالة بيانات ContinuationCluster الحالية من الشريك المطوّر.
• يتم تحليل البيانات من الطلب وتخزينها في مجموعة المتابعة المحدثة.

وفي حال حدوث خطأ، يتم رفض الطلب بأكمله والحفاظ على الحالة الحالية.

publishUserAccountManagementRequest

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

البيانات الوصفية التالية هي جزء من بطاقة تسجيل الدخول:

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

عندما تتلقّى الخدمة الطلب، يتم تنفيذ الإجراءات التالية في معاملة واحدة:

• ستتم إزالة بيانات UserAccountManagementCluster الحالية من الشريك المطوّر.
• يتم تحليل البيانات من الطلب وتخزينها في المجموعة المحدّثة UserAccountManagementCluster.

وفي حال حدوث خطأ، يتم رفض الطلب بأكمله والحفاظ على الحالة الحالية.

updatePublishStatus

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

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

قائمة رموز حالة النشر المؤهّلة هي :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

إذا لم يتم نشر المحتوى لأنّ مستخدمًا لم يسجّل الدخول، تنصح Google بنشر "بطاقة تسجيل الدخول". إذا تعذّر على مقدّمي الخدمات نشر "بطاقة تسجيل الدخول" لأي سبب من الأسباب، نقترح عليك طلب البيانات من واجهة updatePublishStatus API التي تحتوي على رمز الحالة NOT_MANAGEED_REQUIRES_SIGN_IN

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

تُستخدَم واجهة برمجة التطبيقات هذه لحذف محتوى مجموعات الاقتراحات.

client.deleteRecommendationClusters()

client.deleteRecommendationClusters();

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

deleteFeaturedCluster

يتم استخدام واجهة برمجة التطبيقات هذه لحذف محتوى "المجموعة المميزة".

client.deleteFeaturedCluster()

client.deleteFeaturedCluster();

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

deleteContinuationCluster

يتم استخدام واجهة برمجة التطبيقات هذه لحذف محتوى مجموعة Continuation Cluster.

client.deleteContinuationCluster()

client.deleteContinuationCluster();

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

deleteUserManagementCluster

يتم استخدام واجهة برمجة التطبيقات هذه لحذف محتوى مجموعة UserAccountManagement.

client.deleteUserManagementCluster()

client.deleteUserManagementCluster();

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

deleteClusters

تُستخدَم واجهة برمجة التطبيقات هذه لحذف محتوى نوع مجموعة معيّن.

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_CONTINUATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .build())

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .build());

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

خطأ أثناء المعالجة

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

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

يتم عرض الخطأ على أنّه AppEngageException مع تضمين السبب كرمز خطأ.

الخطوة 3: التعامل مع أهداف البث

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

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

يجب إعداد جهاز BroadcastReceiver بالطريقتَين التاليتَين:

• تسجيل مثيل من الفئة BroadcastReceiver ديناميكيًا باستخدام Context.registerReceiver() يتيح ذلك الاتصال من التطبيقات التي لا تزال مباشرة في الذاكرة.

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

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

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION 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));

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

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

}

• أعلن بشكل ثابت عن عملية تنفيذ باستخدام العلامة <receiver> في ملف AndroidManifest.xml. ويتيح ذلك للتطبيق تلقّي أهداف البث عندما لا يكون قيد التشغيل، كما يسمح للتطبيق بنشر المحتوى.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

ترسل الخدمة الإشارات التالية:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION من المستحسن بدء مكالمة publishRecommendationClusters عند تلقّي هذا الغرض.
• com.google.android.engage.action.PUBLISH_FEATURED من المستحسن بدء مكالمة publishFeaturedCluster عند تلقّي هذا الغرض.
• com.google.android.engage.action.PUBLISH_CONTINUATION من المستحسن بدء مكالمة publishContinuationCluster عند تلقّي هذا الغرض.

سير عمل عملية الدمج

للحصول على دليل مفصّل حول التحقّق من عملية الدمج بعد اكتمالها، يُرجى الاطّلاع على التفاعل مع سير عمل دمج المطوّرين.

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

يُرجى الاطّلاع على الأسئلة الشائعة حول Engage SDK للتعرّف على الأسئلة الشائعة.

Contact

يُرجى التواصل مع Engage-developers@google.com إذا كانت لديك أي أسئلة خلال عملية الدمج.

الخطوات التالية

بعد إكمال عملية الدمج هذه، ستكون خطواتك التالية هي التالية:

• أرسِل رسالة إلكترونية إلى Engagement-developers@google.com وإرفاق حِزمة APK المدمجة والجاهزة للاختبار من قِبل Google.
• تُجري Google عملية تحقق ومراجعات داخليًا للتأكّد من أنّ عملية الدمج تعمل على النحو المتوقّع. إذا لزم الأمر، ستتصل بك Google بأي تفاصيل ضرورية.
• عند اكتمال الاختبار وعدم الحاجة إلى أي تغييرات، تتواصل معك Google لإعلامك بأنّه يمكنك بدء نشر حِزمة APK المُحدَّثة والمدمجة على "متجر Play".
• بعد أن تتأكد Google من نشر حِزمة APK المُعدَّلة على "متجر Play"، قد يتم نشر مجموعات الاقتراحات والمميزة ومتابعة وإتاحتها للمستخدمين.