Push Bildirimlerini Tetikle

İş Ortağı Tarafından Tetiklenen Bildirimler

Mesaj ekleme ve bildirim gönderme

Arka plan

Kullanıcılar kart ekledikten sonra onlara kartla ilgili bir mesaj göndermek ve bu mesajdan haberdar olmalarını sağlamak isteyebilirsiniz. Add Message API isteğini message_type ile eşit olacak şekilde kullandığınızda TEXT_AND_NOTIFY aşağıdakiler gerçekleşir:

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

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

• Kullanıcıların, mesajlarla ilgili anlık bildirimleri alabilmek için kartlarında bildirimleri etkinleştirmiş olması gerekir.
• İletiler, 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ı kartla ilgili olmayan bağlantılara yönlendirmek Kabul Edilebilir Kullanım Politikası'nın ihlalidir.
• 24 saatlik süre içinde en fazla 3 push bildirimi tetikleyen mesaj gönderebilirsiniz. Google, kullanıcılarınıza spam gönderdiğinizi düşünürse push bildirimi teslim kotanızı sınırlayabilir.
• Kullanıcıların kilit ekranında gördüğü anlık bildirim, 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ı

Kullanıcıları AddMessage API kullanılarak eklenen yeni bir veren mesajı hakkında bilgilendirmek istediğinizde, yeni metninizi içeren Message öğesinin AddMessageRequest'i TEXT yerine MessageType TEXT_AND_NOTIFY içerecek şekilde güncellemeniz gerekir.

Kart sınıfına ileti 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"
    },
  …

Kart nesnesine 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çme/Kalma sınıfı için mesaj ekleme ve bildirim gönderme Yanıtı örneği

  // 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şimleri QuotaExceededException yanıtı verir. Entegrasyon Adımları bölümünde belirtildiği gibi, kartla ilgili diğer tüm güncellemeler "TEXT_AND_NOTIFY" yerine "TEXT" kullanılarak ayarlanabilir.

Alanı Güncelleme ve Bildirim Gönderme

Arka plan

Kullanıcı bir kart ekledikten sonra belirli alanları güncellediğinizde push bildirimi tetiklemek isteyebilirsiniz. Bildirim, kullanıcının kilit ekranında görünür ve kartında 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 API çağrısı yapıldığında aşağıdakiler gerçekleşir:

1. Kullanıcının kilit ekranında, kart güncellemesi hakkında bilgi veren bir push bildirimi tetiklenir ve gösterilir.
2. Kullanıcı bildirime dokunduğunda Google Cüzdan, kartın ön tarafında (diğer adıyla kart görünümü) açılır ve ekranın üst kısmında "Güncellemeyi incele" düğmesi içeren bir açıklama metni gösterilir.
3. Düğmeyi tıkladığında kullanıcı, güncelleme ile 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 bildirimleri alabilmek için kartlarında bildirimleri etkinleştirmiş olması gerekir.
• 24 saatlik süre içinde en fazla 3 güncelleme gönderebilirsiniz. Bu güncellemeler, push bildirimi tetikler. Google, kullanıcılarınıza spam gönderdiğinizi düşünürse push bildirimi teslim kotanızı sınırlayabilir.
• Kullanıcıların kilit ekranında gördüğü anlık bildirim, Google Cüzdan tarafından kontrol edilir.
• notifyPreference alanı, yalnızca bu istekte bulunan geçici bir alandır. Gelecekte bildirim tetiklemek istediğiniz istekler için bu alanı sınıf veya nesne isteğinde 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'ı belirtmeniz gerekir. Bir sınıftaki veya nesnedeki alanı güncellerken bildirimi tetiklemek için sınıf veya nesne isteğine yeni bir alan notifyPreference ekleyebilirsiniz.

Bir 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 alanını notifyOnUpdate olarak ayarladığınızda, güncellenen alan şu anda destekleniyorsa bildirim tetiklenir.

Desteklenen alanlar

EventTicketClass

• eventName
• eventVenue.name
• eventvenue.address
• eventDateTime.doorsOpen
• eventDateTime.start

EventTicketObject

• eventSeat.seat
• eventSeat.row
• eventSeat.section
• eventSeat.gate

Nearby Notifications

Entegrasyon adımları

Nasıl kullanılır?

Bu özelliği kullanmak için sınıflarınıza ve nesnelerinize konum eklemeniz gerekir. Sınıf başına ve nesne başına en fazla 10 konum ekleyebilirsiniz. Sınıf veya nesne tanımınızda MerchantLocations kullanın. Bu konumları insert, patch veya update yöntemlerini kullanırken ekleyebilirsiniz.

Bir sınıfa veya nesneye konum ekledikten sonra Google, yakındaki kullanıcılara bildirim gönderir. Google, bildirimin gönderilmesi için kullanıcının ne kadar yakında olması ve bölgede ne kadar süre kalması gerektiğini belirler. Google, bildirimin metnini de kontrol eder.

{
  "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
    },
  ]
}

Beklenen Davranış

Kullanıcılar, belirtilen MerchantLocation'lardan birindeyken kartlarıyla ilgili sabit bildirimler almalıdır. Kullanıcılar bildirimi tıkladığında Google Cüzdan'da kartları açılır. Kullanıcılar, kaydırma hareketiyle bildirimi kapatabilir. Kullanıcı konumdan ayrıldığında bildirim kaybolur.

Google Cüzdan Tarafından Tetiklenen Otomatik Bildirimler

Yaklaşan Bildirim

Google Cüzdan, etkinlikten üç saat önce kullanıcıya bildirim gönderir. Etkinlik zamanı class.dateTime.start tarafından tanımlanır.

Bu bildirimi almak için kullanıcının bildirimleri etkinleştirmiş olması gerekir. Bunu kontrol etmek için Ayarlar > Bildirimler'e gidip Kartlarınızla ilgili güncellemeler'in açık olup olmadığını kontrol edebilirler.

Bildirim, bildirim alanında ve kullanıcı kilit ekranı için bildirimleri etkinleştirmişse kilit ekranında gösterilir.

Bildirim aşağıdaki değiştirilemeyen biçime sahiptir:

  class.eventName
  

Bildirime dokunup cihazlarının kilidini açarlarsa kartları Google Cüzdan uygulamasında görünür.

Kullanıcının birden fazla kartı varsa yalnızca en kısa sürede kullanılabilecek kart gösterilir. Kullanıcılar, Birden fazla etkinlik biletini gruplandırma bölümünde belirtildiği şekilde gruplandırılmış kartlar eklediyse bildirimde gruptaki kartlardan yalnızca biri gösterilir. Ancak kullanıcılar bu karta dokunduklarında sola ve sağa kaydırarak o gruptaki diğer kartları görebilir.

Bildirim sabitlenir ve kullanıcı açtıktan sonra otomatik olarak kapatılmaz. Otomatik kapatma, class.dateTime.start tarihinden 60 dakika sonra gerçekleşir.