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

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

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

پس زمینه

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

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

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

• برای دریافت اعلان‌های فشار مربوط به پیام‌ها، کاربران باید اعلان‌ها را برای پاس خود فعال کنند.
• پیام ها ممکن است حاوی URI به وب سایت یا برنامه شما باشند. هایپرلینک ها باید یک وب سایت یا برنامه مرتبط با پاس باشد. ارسال کاربران به پیوندهایی که به گذرنامه مرتبط نیستند، نقض خط مشی استفاده قابل قبول است.
• شما می توانید حداکثر 3 پیام ارسال کنید که باعث ایجاد یک اعلان فشار در یک دوره 24 ساعته شود. اگر فکر کند که شما در حال ارسال هرزنامه به کاربران خود هستید، ممکن است Google سهمیه ارسال اعلان فشار شما را کاهش دهد.
• Push notification که کاربران روی صفحه قفل خود می بینند توسط Google Wallet کنترل می شود.
• می‌توانید از روش‌های UPDATE یا PATCH برای ویرایش یا حذف داده‌های پیام با استفاده از نقطه پایانی کلاس یا شی معمولی استفاده کنید.

مراحل ادغام

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

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

  …
  "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 برای افزودن پیام و اطلاع رسانی در یک Object 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"
    },
  …

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

  // 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"
    },
  …

رسیدگی به استثنا

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

Nearby Notifications

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

مراحل ادغام

نحوه استفاده

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

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

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