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

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

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

پیشینه

بعد از اینکه کاربر یک مجوز اضافه کرد، می‌توانید پیامی مرتبط با مجوز برای او ارسال کنید و مطمئن شوید که از این موضوع مطلع می‌شود. با استفاده از درخواست 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 " همانطور که در مراحل ادغام مورد بحث قرار گرفته است، تنظیم کرد.

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

این ویژگی به کاربرانی که اعلان‌ها را فعال کرده و دسترسی دقیق و همیشه در دسترس به موقعیت مکانی را به برنامه 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 باز می‌شود. کاربران می‌توانند با کشیدن انگشت، اعلان را رد کنند. وقتی کاربر مکان را ترک می‌کند، اعلان ناپدید می‌شود.