فرص القيمة المضافة

الخلفية

يمكنك الآن تعديل الكائنات والفئات لتضمين وحدات الفرص التي تضيف قيمة. سيتم عرض الوحدات في صفحة التفاصيل ويمكن ربطها بمحتوى المُصدِر. يشرح هذا المستند الخطوات الرئيسية المطلوبة لتفعيل الوحدات واستخدامها باستخدام Google Wallet API.

مثال على الميزة

مثال واحد على وحدة فرص القيمة مثال على قائمة وحدات فرص التحسين
عرض واحد عرض القائمة

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

خطوات الدمج

لإضافة وحدة جديدة، عليك تعديل العنصر و/أو الفئة لتضمين ValueAddedModuleData. تحتوي ValueAddedModuleData على الحقول التالية:

[سمة مطلوبة] عنوان LocalizedString

العنوان المعروض على الوحدة الحد الأقصى لعدد الأحرف هو 60 حرفًا، وسيتم اقتطاع السلاسل الأطول من ذلك. مثال على عنوان فرصة القيمة

LocalizedString body

النص المعروض في الوحدة الحد الأقصى لعدد الأحرف هو 50 حرفًا، وسيتم اقتطاع السلاسل الأطول من ذلك.
مثال على نص الفرصة

Image image

الصورة المعروضة على الوحدة النسبة المقترَحة للصورة هي 1:1، وسيتم تغيير حجم الصور لتتلاءم مع هذه النسبة.
مثال على صورة الفرصة

[مطلوب] معرّف الموارد المنتظم (URI) لسلسلة

معرّف الموارد المنتظم الذي تنقل إليه الوحدة عند النقر عليها. يمكن أن يكون رابطًا على الويب أو رابطًا لصفحة في التطبيق.

ModuleViewConstraints viewConstraints

القيود التي يجب استيفاؤها كلها لعرض الوحدة يحتوي ModuleViewConstraints على الحقل التالي:

TimeInterval displayInterval

الفترة الزمنية التي ستظهر فيها الوحدة للمستخدمين يمكن تحديد كلّ من "startTime" و "endTime". يتم عرض الوحدة فورًا بعد الإدراج ما لم يتم ضبط "startTime". يتم عرض الوحدات إلى أجل غير مسمى في حال عدم ضبط "endTime".

int32 sortIndex

الفهرس لفرز الوحدات. يتم عرض الوحدات التي لها مؤشر ترتيب أقل قبل الوحدات التي لها مؤشر ترتيب أعلى. إذا لم يتم تحديده، يُفترض أنّ فهرس الترتيب هو INT_MAX. أما بالنسبة إلى وحدتَين لهم الفهرس نفسه، فسيكون سلوك الترتيب غير محدد.

مثال على ValueAddedModuleData:

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

السلوك المتوقّع

بعد تعديل العنصر و/أو الفئة بنجاح، ستظهر الآن وحدات على البطاقة المناسبة. إذا أضفت وحدة واحدة فقط، ستظهر على الجهة الأمامية من البطاقة.

إرشادات حول وحدات الفرص التي تضيف قيمة

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

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

التعامل مع الاستثناءات

رسالة السبب
يجب أن يحتوي ValueAddedModuleData على عنوان. لا يحتوي العمود ValueAddedModuleData على عنوان.
يجب أن يحتوي ValueAddModuleData على معرف موارد منتظم (URI) غير فارغ. لا تحتوي سمة ValueAddedModuleData على معرّف موارد منتظم (URI) غير فارغ.
يُسمح بحد أقصى 10 وحدات ذات قيمة مضافة لكل فئة. يجب تقليل الوحدات ذات القيمة المضافة في الصف.
يُسمح بإضافة 10 وحدات مضافة قيمة كحد أقصى لكل عنصر. يجب تقليل الوحدات المضافة ذات القيمة على العنصر.