اعلان‌های فشاری را فعال کنید

اعلان‌های فعال‌شده توسط شریک

اضافه کردن پیام و اطلاع رسانی

پیشینه

بعد از اینکه کاربر یک مجوز اضافه کرد، می‌توانید پیامی مرتبط با مجوز برای او ارسال کنید و مطمئن شوید که از این موضوع مطلع می‌شود. با استفاده از درخواست Add Message API با message_type برابر با TEXT_AND_NOTIFY موارد زیر رخ می‌دهد:

1. یک آیتم « پیام » به «پشت مجوز» (معروف به الگوی جزئیات ) اضافه می‌شود و یک اعلان فوری برای کاربرانی که مجوز ذخیره شده دارند ارسال می‌شود.
2. به محض اینکه کاربر روی اعلان ضربه بزند، گوگل والت در جلوی کارت (یا همان نمای کارت) باز می‌شود و کاربر در بالای صفحه، پیامی به همراه دکمه «مشاهده پیام» را مشاهده خواهد کرد.
3. کلیک روی این عبارت، کاربران را به پشت کارت می‌برد، جایی که پیام‌های جدید خوانده نشده هایلایت می‌شوند.

برخی ملاحظات هنگام ارسال پیام به همراه اعلان‌ها به کاربران

• کاربران برای دریافت اعلان‌های فوری مربوط به پیام‌ها، باید اعلان‌های مربوط به کارت‌های خود را فعال کرده باشند.
• پیام‌ها ممکن است حاوی آدرس‌های اینترنتی (URI) به وب‌سایت یا برنامه شما باشند. هایپرلینک‌ها باید مربوط به وب‌سایت یا برنامه‌ای باشند که به مجوز مربوط می‌شود. ارسال کاربران به لینک‌هایی که به مجوز مربوط نیستند، نقض سیاست استفاده قابل قبول است.
• شما می‌توانید حداکثر ۳ پیام ارسال کنید که در طول ۲۴ ساعت باعث ارسال اعلان فوری شود. اگر گوگل تشخیص دهد که شما برای کاربران خود هرزنامه ارسال می‌کنید، ممکن است سهمیه ارسال اعلان فوری شما را محدود کند.
• اعلان‌های فوری که کاربران روی صفحه قفل خود مشاهده می‌کنند توسط گوگل والت کنترل می‌شود.
• شما می‌توانید از متدهای UPDATE یا PATCH برای ویرایش یا حذف داده‌های پیام با استفاده از نقطه پایانی کلاس یا شیء معمولی استفاده کنید.

مراحل ادغام

وقتی می‌خواهید با استفاده از AddMessage API، کاربران را از اضافه شدن یک پیام جدید توسط صادرکننده مطلع کنید، باید AddMessageRequest را به‌روزرسانی کنید تا پیامی که حاوی متن جدید شماست، به جای TEXT، نوع پیام TEXT_AND_NOTIFY را داشته باشد.

مثال درخواست JSON برای افزودن پیام و اطلاع رسانی در کلاس Passes

  …
  "id": ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Class message header",
        "body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

مثال درخواست JSON برای افزودن پیام و اطلاع رسانی در شیء Passes

  …
  "id": OBJECT_ID",
  "classId": "ISSUER_ID.CLASS_ID",
  "message":
    {
        "header":"My Object message header",
        "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
        "id": "message_id",
        "message_type": "TEXT_AND_NOTIFY"
    },
  …

پاسخ نمونه برای افزودن پیام و اطلاع رسانی برای کلاس Pass

  // The updated resource
  …
    {
      "kind": "walletobjects#walletObjectMessage",
      "header": "My Object message header",
      "body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
      "id": "message_id",
      "messageType": "textAndNotify"
    },
  …

مدیریت استثنائات

هرگونه تلاش برای اطلاع‌رسانی بیش از ۳ بار، منجر به پاسخ QuotaExceededException خواهد شد. هرگونه به‌روزرسانی بیشتر در گذرگاه را می‌توان با استفاده از " TEXT " به جای " TEXT_AND_NOTIFY " همانطور که در مراحل ادغام مورد بحث قرار گرفته است، تنظیم کرد.

فیلد را به‌روزرسانی کنید و اطلاع دهید

پیشینه

بعد از اینکه کاربر یک مجوز اضافه کرد، ممکن است بخواهید هنگام به‌روزرسانی فیلدهای خاص، یک اعلان فوری (push notification) فعال شود. این اعلان روی صفحه قفل کاربر ظاهر می‌شود و به او اطلاع می‌دهد که به‌روزرسانی در مجوزش وجود دارد. این اعلان فقط برای زیرمجموعه خاصی از فیلدها که در زیر با استفاده از متدهای UPDATE و PATCH API تعریف شده‌اند، فعال می‌شود. پس از فراخوانی API برای به‌روزرسانی مجوز، موارد زیر رخ می‌دهد:

1. یک اعلان فوری فعال شده و روی صفحه قفل کاربر نمایش داده می‌شود و او را از به‌روزرسانی مجوز عبور مطلع می‌سازد.
2. به محض اینکه کاربر روی اعلان ضربه بزند، گوگل والت در جلوی کارت (یا همان نمای کارت) باز می‌شود و کاربر در بالای صفحه، پیامی به همراه دکمه «به‌روزرسانی بررسی» مشاهده خواهد کرد.
3. کلیک روی دکمه، کاربر را به صفحه‌ای می‌برد که در آن می‌تواند فیلدهایی را که توسط به‌روزرسانی تغییر کرده‌اند، ببیند.

برخی ملاحظات هنگام ارسال اعلان‌های به‌روزرسانی فیلد

• کاربران برای دریافت اعلان‌های مربوط به به‌روزرسانی‌ها، باید اعلان‌های مربوط به کارت‌های خود را فعال کرده باشند.
• شما می‌توانید حداکثر ۳ به‌روزرسانی که باعث ارسال اعلان فوری می‌شوند را در یک دوره ۲۴ ساعته ارسال کنید. اگر گوگل تشخیص دهد که شما در حال ارسال هرزنامه به کاربران خود هستید، ممکن است سهمیه ارسال اعلان فوری شما را محدود کند.
• اعلان‌های فوری که کاربران روی صفحه قفل خود مشاهده می‌کنند توسط گوگل والت کنترل می‌شوند.
• فیلد notifyPreference یک فیلد موقت است که فقط در این درخواست وجود دارد. برای درخواست‌های بعدی که می‌خواهید یک اعلان را فعال کنید، باید این فیلد را در درخواست کلاس یا شیء مجدداً تنظیم کنید.

مراحل ادغام

برای فعال کردن این اعلان‌ها، باید از فراخوانی‌های UPDATE یا PATCH موجود استفاده کنید و notifyPreference را مشخص کنید. هنگام به‌روزرسانی یک فیلد در یک کلاس یا شیء، می‌توانید یک فیلد جدید، notifyPreference ، را به درخواست کلاس یا شیء اضافه کنید تا اعلان فعال شود.

مثال درخواست JSON برای به‌روزرسانی و اطلاع‌رسانی در یک کلاس

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …
  

تنظیم notifyPreference روی notifyOnUpdate باعث ایجاد یک اعلان می‌شود، البته به شرطی که فیلد به‌روزرسانی‌شده در حال حاضر پشتیبانی شود.

فیلدهای پشتیبانی شده

کلاس بلیط رویداد

• نام رویداد
• نام محل برگزاری رویداد
• آدرس محل برگزاری رویداد
• رویدادتاریخ و زمان.درها باز هستند
• eventDateTime.start

شیء EventTicket

• صندلی رویداد
• ردیف صندلی رویداد
• بخش رویداد
• eventSeat.gate

اعلان‌های نزدیک

این ویژگی به کاربرانی که اعلان‌ها را فعال کرده و دسترسی دقیق و همیشه در دسترس به موقعیت مکانی را به برنامه Google Wallet اعطا کرده‌اند، یک اعلان فوری نشان می‌دهد که به آنها یادآوری می‌کند که یک کارت شناسایی مرتبط با موقعیت مکانی فعلی خود ذخیره کرده‌اند.

مراحل ادغام

نحوه استفاده

برای استفاده از این ویژگی، باید مکان‌هایی را به کلاس‌ها و اشیاء خود اضافه کنید. می‌توانید تا 10 مکان برای هر کلاس و 10 مکان برای هر شیء اضافه کنید. MerchantLocations در تعریف کلاس یا شیء خود استفاده کنید. می‌توانید این مکان‌ها را هنگام استفاده از متدهای insert ، patch یا update اضافه کنید.

بعد از اینکه مکان‌ها را به یک کلاس یا شیء اضافه کردید، گوگل وقتی کاربران در نزدیکی شما باشند، اعلان‌هایی را برای آنها ارسال می‌کند. گوگل تصمیم می‌گیرد که کاربر چقدر باید به شما نزدیک باشد و چه مدت باید در آن منطقه بماند تا اعلان ارسال شود. گوگل همچنین متن اعلان را کنترل می‌کند.

مثالی از یک کلاس وفاداری (LoyaltyClass) با مجموعه MerchantLocations:

{
  "kind": "walletobjects#loyaltyClass",
  "programLogo": {
  "kind": "walletobjects#image",
  "sourceUri": {
    "uri":
    ...
  }
  },
  "localizedProgramName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Program Name",
    }
  },
  "id": Id1234,
  "version": "1",
  "allowMultipleUsersPerObject": true,
  "reviewStatus": "underReview",
  "enableSmartTap": false,
  "localizedIssuerName": {
    "kind": "walletobjects#localizedString",
    "defaultValue": {
      "kind": "walletobjects#translatedString",
      "language": "en",
      "value": "Issuer Name"
    }
  },
  "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
  "merchantLocations": [
    {
      "latitude": 37.79020867928078,
      "longitude": -122.39004
    },
    {
      "latitude": 37.42587,
      "longitude": -122.08620
    },
  ]
}

رفتار مورد انتظار

کاربران باید وقتی در یکی از MerchantLocations های مشخص شده هستند، اعلان‌های چسبنده‌ای در مورد کارت‌های اعتباری خود دریافت کنند. اگر روی اعلان کلیک کنند، کارت اعتباری آنها در Google Wallet باز می‌شود. کاربران می‌توانند با کشیدن انگشت، اعلان را رد کنند. وقتی کاربر مکان را ترک می‌کند، اعلان ناپدید می‌شود.

اعلان‌های خودکار که توسط گوگل والت (Google Wallet) فعال می‌شوند

اعلان آینده

گوگل والت سه ساعت قبل از رویداد، اعلانی برای کاربر ارسال می‌کند. زمان رویداد توسط class.dateTime.start تعریف می‌شود.

برای دریافت این اعلان، کاربر باید اعلان‌ها را فعال کرده باشد. برای بررسی این موضوع، می‌توانند به تنظیمات > اعلان‌ها بروند و ببینند که آیا به‌روزرسانی‌های مربوط به مجوزهای شما روشن است یا خیر.

این اعلان در قسمت اعلان‌ها و در صفحه قفل، در صورتی که کاربر اعلان‌ها را برای صفحه قفل فعال کرده باشد، نمایش داده می‌شود.

این اعلان دارای قالب غیرقابل تغییر زیر است:

  class.eventName
  

اگر روی اعلان ضربه بزنند و قفل دستگاه خود را باز کنند، رمز عبور آنها در برنامه Google Wallet ظاهر می‌شود.

اگر کاربر چندین مجوز داشته باشد، فقط اولین مجوز قابل استفاده نمایش داده می‌شود. اگر طبق تیکت‌های Group multiple Event ، مجوز‌های گروه‌بندی شده‌ای اضافه کرده باشد، اعلان فقط یکی از مجوزها را در گروه نشان می‌دهد. با این حال، وقتی روی آن ضربه می‌زند، کاربر می‌تواند برای دیدن سایر مجوزها در آن گروه، انگشت خود را به چپ و راست بکشد.

اعلان پین شده است و پس از باز شدن توسط کاربر، به طور خودکار حذف نمی‌شود. حذف خودکار ۶۰ دقیقه پس از class.dateTime.start رخ می‌دهد.