Push Bildirimlerini Tetikle

İş Ortağı Tarafından Tetiklenen Bildirimler

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üne (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, yeni okunmamış mesajların vurgulandığı kartın arkası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 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ç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. Kartla ilgili 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ıyla ilgili 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örebildiğ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

FlightObject
  • boardingAndSeatingInfo.seatNumber
  • boardingAndSeatingInfo.seatAssignment

Google Cüzdan tarafından tetiklenen otomatik bildirimler

Yaklaşan Bildirim

Google Cüzdan, uçuştan üç saat önce kullanıcıya bildirim gönderir. Uçuş süresi class.localScheduledDepartureDateTime 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 etkin olup olmadığını kontrol edebilir.

Bildirim, kullanıcı kilit ekranında bildirimleri etkinleştirdiyse bildirim alanında ve kilit ekranında gösterilir.

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

  Boarding pass for your flight to class.destination.airportIataCode

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

Kullanıcının birden fazla geçişi varsa yalnızca en kısa sürede kullanılabilecek geçiş gösterilir. Birden fazla biniş kartını gruplandırma bölümünde açıklandığı şekilde gruplandırılmış kartlar eklediyse bildirimde gruptaki kartlardan yalnızca biri gösterilir. Ancak kullanıcı, buna dokunduğunda gruptaki diğer kartları görmek için sola ve sağa kaydırabilir.

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

Uçuş Güncellemesi Bildirimi

Bir uçuşla ilgili belirli alanlar değiştirildiğinde, bir veya daha fazla biniş kartı eklemiş olan kullanıcılara cihazlarında push bildirimi gönderilir. Bu durum yalnızca belirli koşullar karşılanırsa gerçekleşir.

Kalkış terminali ve kapısı

class.origin.terminal veya class.origin.gate değerini değiştirirseniz ve aşağıdaki koşul karşılanırsa alanın değiştiğine dair bir bildirim gönderilir.

  • class.localScheduledDepartureDateTime olarak ayarladığınız uyku vaktinizin dolmasına üç saatten az kaldı.

Bildirim şu biçimdedir: "Sample Airlines, giriş kapınızı A1 olarak güncelledi." Biçim değiştirilemez.

Biniş ve kalkış saatleri

class.localBoardingDateTime veya class.localEstimatedOrActualDepartureDateTime değerini değiştirirseniz ve aşağıdaki koşullar karşılanırsa alanın değiştiğine dair bir bildirim gönderilir.

  • class.localScheduledDepartureDateTime'e 24 saatten az kaldı.
  • İlgili zaman en az 10 dakika veya daha fazla değişir.

Bildirim şu biçimdedir: "_Sample Airlines, biniş saatinizi 18:00 olarak güncelledi._" Biçim veya dil özelleştirilemez.