پیشینه
اکنون میتوانید اشیاء و کلاسها را بهروزرسانی کنید تا ماژولهای فرصت ارزش افزوده را نیز شامل شوند. ماژولها در صفحه جزئیات نمایش داده میشوند و میتوانند به محتوای صادرکننده پیوند داشته باشند. این سند مراحل کلیدی مورد نیاز برای فعالسازی و استفاده از ماژولها با استفاده از API کیف پول گوگل را شرح میدهد.
مثال ویژگی
 |  |
| نمای تکی | نمای فهرست |
راهنمای زیر فرض میکند که شما با مفاهیم اولیهی گوگل والت آشنا هستید و پیشنیازهای توصیهشده را قبلاً تکمیل کردهاید. هرگونه سوال یا بازخوردی را به مرکز پشتیبانی گوگل والت خود ارسال کنید.
مراحل ادغام
برای افزودن یک ماژول جدید، باید شیء و/یا کلاس را بهروزرسانی کنید تا ValueAddedModuleData را نیز شامل شود. ValueAddedModuleData دارای فیلدهای زیر است:
[الزامی] سرآیند LocalizedString
سربرگ نمایش داده شده در ماژول. محدودیت کاراکتر ۶۰ است و رشتههای طولانیتر کوتاه میشوند.
بدنهی رشتهی محلی
متن نمایش داده شده در ماژول. محدودیت کاراکتر ۵۰ است و رشتههای طولانیتر کوتاه میشوند.
تصویر تصویر
تصویر نمایش داده شده روی ماژول. نسبت تصویر پیشنهادی ۱:۱ است و تصاویر برای مطابقت با این نسبت تغییر اندازه خواهند داد.
[الزامی] رشته uri
آدرس اینترنتی (URI) که ماژول هنگام کلیک به آن هدایت میشود. این میتواند یک لینک وب یا یک لینک عمیق باشد.ماژولمشاهدهمحدودیتهامشاهدهمحدودیتها
محدودیتهایی که همه باید برای نمایش ماژول رعایت شوند. ModuleViewConstraints فیلد زیر را دارد:نمایش فاصله زمانی
مدت زمانی که ماژول به کاربران نمایش داده میشود. میتوان هم «زمان شروع» و هم «زمان پایان» را تعریف کرد. ماژول بلافاصله پس از درج نمایش داده میشود، مگر اینکه «زمان شروع» تنظیم شده باشد. اگر «زمان پایان» تنظیم نشده باشد، ماژول به طور نامحدود نمایش داده میشود.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 یک URI غیر خالی ندارد. |
| حداکثر ۱۵ واحد درسی با ارزش افزوده در هر کلاس مجاز است. | نیاز به کاهش ماژولهای ارزش افزوده در کلاس. |
| حداکثر ۱۵ ماژول ارزش افزوده برای هر شیء مجاز است. | نیاز به کاهش ماژولهای ارزش افزوده روی شیء. |