Katma Değerli Fırsatlar

Arka plan

Artık nesneleri ve sınıfları, katma değerli fırsat modüllerini içerecek şekilde güncelleyebilirsiniz. Modüller, ayrıntılar sayfasında gösterilir ve veren kuruluşun içeriğine bağlanabilir. Bu belgede, Google Cüzdan API'si kullanılarak modüllerin etkinleştirilmesi ve kullanılması için gereken temel adımlar açıklanmaktadır.

Özellik örneği


Tekli görünüm	Liste görünümü

Aşağıdaki rehberde, Google Cüzdan'ın temel kavramlarını bildiğiniz ve önerilen ön koşulları zaten tamamladığınız varsayılır. Sorularınızı veya geri bildirimlerinizi Google Cüzdan'daki ilgili kişinize gönderin.

Entegrasyon Adımları

Yeni bir modül eklemek için nesneyi ve/veya sınıfı ValueAddedModuleData'yı içerecek şekilde güncellemeniz gerekir. ValueAddedModuleData'da aşağıdaki alanlar bulunur:

[Zorunlu] LocalizedString üstbilgisi

Modülde gösterilen başlık. Karakter sınırı 60'tır ve daha uzun dizeler kısaltılır. Değer Fırsatı Başlığı Örneği

LocalizedString body

Modülde gösterilen gövde. Karakter sınırı 50'dir ve daha uzun dizeler kısaltılır.
Değer Fırsatı Gövdesi Örneği

Resim resmi

Modülde gösterilen resim. Önerilen resim oranı 1:1'dir ve resimler bu orana uyacak şekilde yeniden boyutlandırılır.
Değer Fırsatı Resim Örneği

[Zorunlu] string uri

Tıklandığında modülün yönlendirdiği URI. Bu, bir web bağlantısı veya derin bağlantı olabilir.

ModuleViewConstraints viewConstraints

Modülün gösterilmesi için tümünün karşılanması gereken kısıtlamalar. ModuleViewConstraints'te aşağıdaki alan bulunur:

TimeInterval displayInterval

Modülün kullanıcılara gösterileceği süre. Hem "startTime" hem de "endTime" tanımlayabilir. "startTime" ayarlanmadığı sürece modül, eklenir eklenmez gösterilir. `endTime` ayarlanmazsa modül süresiz olarak gösterilir.

int32 sortIndex

Modülleri sıralamak için kullanılan dizin. Sıralama dizini daha düşük olan modüller, sıralama dizini daha yüksek olan modüllerden önce gösterilir. Belirtilmemişse sıralama dizininin INT_MAX olduğu varsayılır. Aynı dizine sahip iki modül için sıralama davranışı tanımlanmamıştır.

Örnek ValueAddedModuleData:

  {
    "valueAddedModuleData": [
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off merch"
          }
        },
        "body": {
          "defaultValue": {
            "language": "en-US",
            "value": "Shirts, caps, mugs, and more"
          }
        },
        "image": {
          "sourceUri": {
            "uri": "http://www.images.google.com/opportunity"
          }
        },
        "uri": "http://www.google.com/opportunity",
        "viewConstraints": {
          "displayInterval": {
            "start": {
              "date": "2024-08-01T18:30:00"
            },
            "end": {
              "date": "2025-08-01T18:30:00"
            }
          }
        },
        "sortIndex": 0
      },
      {
        "header": {
          "defaultValue": {
            "language": "en-US",
            "value": "10% off concessions"
          }
        },
        "uri": "http://www.google.com/new_opportunity"
      }
    ]
  }

Beklenen Davranış

Nesneyi ve/veya sınıfı başarıyla güncelledikten sonra ilgili kartta modülleri görürsünüz. Yalnızca bir modül eklediyseniz bu modülü kartın ön yüzünde görürsünüz.

Değer Katan Fırsat Modülleriyle İlgili Yönergeler

Modüller, kullanıcılarınızın kart deneyimini ek işlemlerle zenginleştirmenizi sağlayan fırsatlardır. Modülleri oluşturup yönetirken aşağıdakileri göz önünde bulundurmanız gerekir:

Modüller, kullanıcıların bu modüllerin tıklanabilir olduğunu anlamasına yardımcı olmak için uygun bir dille tanımlanmalıdır.
Modüllerde, ilgili modülle alakalı uygun görüntüler tanımlanmalıdır.
Modüllerin kontrolü sizdedir ve önem ile alaka düzeyine bağlı olarak modülün önceliklendirilmesini proaktif bir şekilde yönetmeniz gerekir.
Kullanıcılara yalnızca etkin modülleri göstermelisiniz. Bunu, modülde displayInterval'ı ayarlayarak veya sınıf ya da nesneye proaktif olarak ekleyip kaldırarak kontrol edebilirsiniz.

İstisna işleme

Mesaj	Neden
ValueAddedModuleData bir başlık içermelidir.	ValueAddedModuleData'nın başlığı yok.
ValueAddedModuleData, boş olmayan bir URI içermelidir.	ValueAddedModuleData'nın boş olmayan bir URI'si yok.
Sınıf başına en fazla 15 katma değerli modüle izin verilir.	Sınıftaki katma değerli modüllerin azaltılması gerekir.
Nesne başına en fazla 15 katma değerli modüle izin verilir.	Nesnedeki katma değerli modüllerin azaltılması gerekir.