فرصت‌های ارزش افزوده

پس‌زمینه

اکنون می‌توانید اشیا و کلاس‌ها را به‌روز کنید تا واحدهای فرصت ارزش افزوده را دربر بگیرد. ماژول‌ها در بخش پایین مجوز نمایش داده می‌شوند و می‌توانند به محتوای صادرکننده پیوند داده شوند. این سند مراحل کلیدی موردنیاز برای فعال کردن و استفاده از واحدها بااستفاده از Google Wallet API را توضیح می‌دهد.

نمونه ویژگی

نمونه واحد فرصت ارزش تکی نمونه فهرست واحد فرصت ارزش
نمای تکی نمای فهرستی

راهنمای زیر فرض می‌کند که شما با مفاهیم اولیه «کیف پول Google» آشنا هستید و قبلاً پیش‌نیازهای توصیه‌شده را تکمیل کرده‌اید. هرگونه سؤال یا بازخورد را به «نقطه تماس» «کیف پول Google» خود ارسال کنید.

مراحل یکپارچه‌سازی

برای افزودن واحد جدید، باید شیء و/یا کلاس را به‌روز کنید تا ValueAddedModuleData را دربرگیرد. ‫ValueAddedModuleData فیلدهای زیر را دارد:

[الزامی] سرایند LocalizedString

سرصفحه نمایش‌داده‌شده در واحد. حداکثر نویسه مجاز ۶۰ نویسه است و رشته‌های طولانی‌تر کوتاه‌سازی خواهند شد. نمونه سرایند فرصت مقدار

LocalizedString body

بدنه نمایش‌داده‌شده در واحد. حد نویسه ۵۰ است و رشته‌های طولانی‌تر کوتاه‌سازی خواهند شد.
Value Opportunity Body Example

تصویر Image

تصویر نمایش‌داده‌شده در واحد. نسبت تصویر توصیه‌شده ۱:۱ است و اندازه تصاویر برای مطابقت با این نسبت تغییر خواهد کرد.
نمونه تصویر فرصت ارزشمند

[الزامی] رشته 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 سرایند ندارد.
‫ValueAddedModuleData باید حاوی URI غیرخالی باشد. ‫ValueAddedModuleData نشانی وب غیرخالی ندارد.
حداکثر ۱۵ واحد افزودن مقدار در هر کلاس مجاز است. باید واحدهای ارزش افزوده را در کلاس کاهش دهید.
حداکثر ۱۵ واحد افزودنی مقدار مجاز برای هر شیء. باید واحدهای ارزش افزوده را در شیء کاهش دهید.