Push Bildirimlerini Tetikle

Bildirim Türleri

Mesaj ekleme ve bildirim verme

Arka plan

Bir kullanıcı kart ekledikten sonra, kartla ilgili bir mesaj göndererek kullanıcının bu konuda bilgilendirilmesini sağlayabilirsiniz. TEXT_AND_NOTIFY değerine eşit bir message_type ile Add Message API isteği kullanıldığında aşağıdakiler gerçekleşir:

  1. "Kartın arkasına" (diğer adıyla Ayrıntılar Şablonu) bir "Mesaj" öğesi eklenir ve kart kayıtlı olan kullanıcılara bir push bildirimi gönderilir.
  2. Kullanıcı bildirime dokunduğunda Google Cüzdan, kartın ön yüzünde (kart görünümü) açılır ve ekranın üst kısmında "Mesajı Görüntüle" düğmesini içeren bir açıklama metni gösterilir.
  3. Açıklamayı tıklayan kullanıcılar, okunmamış yeni mesajların vurgulandığı kartın arka tarafına yönlendirilir.

Kullanıcılara bildirim içeren mesajlar gönderirken dikkat edilmesi gereken noktalar

  • Kullanıcıların, mesajlarla ilgili push bildirimleri alabilmesi için kartlarında bildirimlerin etkinleştirilmiş olması gerekir.
  • Mesajlar, web sitenizin veya uygulamanızın URI'lerini içerebilir. Köprüler, kartla ilgili bir web sitesi veya uygulama olmalıdır. Kullanıcıları geçişle ilgili olmayan bağlantılara yönlendirmek Kabul Edilebilir Kullanım Politikası'nı ihlal eder.
  • 24 saat içinde push bildirimi tetikleyen en fazla 3 mesaj gönderebilirsiniz. Google, kullanıcılarınıza spam gönderdiğinizi tespit ederse push bildirimi yayınlama kotanızı kısıtlayabilir.
  • Kullanıcıların kilit ekranlarında gördüğü push bildirimleri Google Cüzdan tarafından kontrol edilir.
  • Normal sınıf veya nesne uç noktasını kullanarak mesaj verilerini düzenlemek ya da kaldırmak için UPDATE veya PATCH yöntemlerini kullanabilirsiniz.

Entegrasyon Adımları

AddMessage API kullanılarak eklenen yeni bir veren mesajı hakkında kullanıcıları bilgilendirmek istediğinizde, yeni metninizi içeren Message öğesinin MessageType özelliğinin TEXT yerine TEXT_AND_NOTIFY değerini alması için AddMessageRequest öğesini güncellemeniz gerekir.

Geçişler sınıfına mesaj eklemek ve bildirim göndermek için örnek JSON isteği

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

Passes nesnesinde mesaj eklemek ve bildirim göndermek için örnek JSON isteği

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

Geçiş sınıfı için mesaj eklemek ve bildirim göndermek üzere örnek Yanıt

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

İstisna işleme

3'ten fazla bildirim gönderme girişimi QuotaExceededException yanıtı verir. Kartta yapılacak diğer güncellemeler, Entegrasyon Adımları bölümünde açıklandığı gibi "TEXT_AND_NOTIFY" yerine "TEXT" kullanılarak ayarlanabilir.

Alanı güncelleme ve bildirim gönderme

Arka plan

Kullanıcı bir geçiş ekledikten sonra belirli alanları güncellediğinizde push bildirimi tetiklemek isteyebilirsiniz. Bildirim, kullanıcının kilit ekranında gösterilir ve kullanıcıya kartında bir güncelleme olduğunu bildirir. Bu bildirim yalnızca UPDATE ve PATCH API yöntemleri kullanılarak aşağıda tanımlanan belirli bir alan alt kümesi için tetiklenir. Kartı güncellemek için bir API çağrısı yapıldığında aşağıdakiler gerçekleşir:

  1. Kullanıcının kilit ekranında, geçiş güncellemesi hakkında bilgilendiren bir push bildirimi tetiklenir ve görüntülenir.
  2. Kullanıcı bildirime dokunduğunda Google Cüzdan, kartın ön yüzüne (kart görünümü) açılır ve ekranın üst kısmında "Güncellemeyi incele" düğmesini içeren bir açıklama metni gösterilir.
  3. Düğmeyi tıklayan kullanıcı, güncellemeyle değiştirilen alanları görebileceği bir ekrana yönlendirilir.

Alan güncelleme bildirimleri gönderirken dikkat edilmesi gereken bazı noktalar

  • Kullanıcıların, güncellemelerle ilgili push bildirimlerini alabilmeleri için kartlarının bildirimlerinin etkinleştirilmiş olması gerekir.
  • 24 saat içinde push bildirimi tetikleyen en fazla 3 güncelleme gönderebilirsiniz. Google, kullanıcılarınıza spam gönderdiğinizi tespit ederse push bildirimi yayınlama kotanızı düşürebilir.
  • Kullanıcıların kilit ekranlarında gördüğü push bildirimleri Google Cüzdan tarafından kontrol edilir.
  • notifyPreference alanı, yalnızca bu istekte bulunan geçici bir alandır. Gelecekte bildirim tetiklemek istediğiniz isteklerde sınıf veya nesne isteğinde bu alanı sıfırlamanız gerekir.

Entegrasyon Adımları

Bu bildirimleri tetiklemek için mevcut UPDATE veya PATCH çağrılarını kullanmanız ve notifyPreference'yi belirtmeniz gerekir. Bir sınıf veya nesnenin alanını güncellerken bildirimi tetiklemek için sınıfa ya da nesne isteğine notifyPreference adlı yeni bir alan ekleyebilirsiniz.

Sınıfta güncelleme ve bildirim için örnek JSON isteği

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

notifyPreference değerini notifyOnUpdate olarak ayarlamak, güncellenen alanın şu anda desteklenmesi koşuluyla bir bildirim tetikler.

Desteklenen alanlar

LoyaltyClass
  • rewardsTier
  • secondaryRewardsTier
  • programName
LoyaltyObject
  • loyaltyPoints.balance
  • secondaryLoyaltyPoints.balance