Engage SDK Travel: Üçüncü taraf teknik entegrasyon talimatları

Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriği tüketimi ve keşfi için yeni bir sürükleyici deneyim sunan cihaz üzerinde bir yüzey oluşturuyor. Bu tam ekran deneyim, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda sergileme fırsatı sunar. Bu kılavuzda, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak seyahat ve etkinlik içeriklerini entegre etme talimatları yer almaktadır.

Entegrasyon ayrıntısı

Terminoloji

Bu entegrasyon aşağıdaki üç küme türünü içerir: Öneri, Öne Çıkan ve Devam.

  • Öneri kümeleri, tek bir geliştirici iş ortağının kişiselleştirilmiş seyahat ve etkinlik önerilerini gösterir. Bu öneriler kullanıcıya göre kişiselleştirilebilir veya genelleştirilebilir (örneğin, trend öğeler). Makale, etkinlik, konaklama yeri veya ilgi çekici yer önerileri göstermek için bunları kullanın.

    • Öneri kümesi, ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity veya StoreEntity girişlerinden oluşabilir ancak farklı varlık türlerinin bir karışımı olamaz.

    Önerileriniz aşağıdaki yapıya sahiptir:

    • Öneri Kümesi: Aynı geliştirici iş ortağından gelen bir grup öneriyi içeren bir kullanıcı arayüzü görünümü.

    • Varlık: Bir kümedeki tek bir öğeyi temsil eden nesne. Bu entegrasyon, öneri kümesi kullanılarak gösterilecek bazı öğeler sunar:

      • ArticleEntity: ArticleEntity, seyahat ve etkinliklerle ilgili metin tabanlı içerik önerilerini temsil eder. Makaleler, blog yayınları, pazarlama içeriği, haber snippet'leri vb. için kullanılabilir.

        Şekil 1: Öneriler kümesinde tek bir ArticleEntity öğesinin gösterildiği kullanıcı arayüzü.

      • EventEntity: EventEntity, gelecekte gerçekleşecek bir etkinliği temsil eder. Etkinlik başlangıç zamanı, kullanıcılara iletilmesi gereken kritik bir bilgidir.

        Şekil 2: Öneriler kümesinde tek bir EventEntity'yi gösteren kullanıcı arayüzü.

      • LodgingEntity: LodgingEntity, kısa ve uzun süreli kiralama için otel, daire, tatil ev gibi bir konaklamayı temsil eder.

        Şekil 3: Öneriler kümesinde tek bir LodgingEntity'nin gösterildiği kullanıcı arayüzü.

      • StoreEntity: StoreEntity, bir mağazayı, restoranı, kafeyi vb. temsil eder. Bir yemek mekanının veya mağazanın kullanıcılara aktarılması gereken önemli bir bilgi olduğu içerikleri vurgular.

        Şekil 4: Öneriler kümesinde tek bir StoreEntity'yi gösteren kullanıcı arayüzü.

      • PointOfInterestEntity: PointOfInterestEntity, benzin istasyonu, etkinlik mekanı, tema parkı, müze, turistik yer, yürüyüş parkuru gibi önemli yerleri temsil eder. Konumun, kullanıcılara aktarılması gereken önemli bir bilgi olduğu içerikleri vurgular. Konaklama, mağaza veya yemek mekanı için kullanılmamalıdır.

        Şekil 5: Öneriler kümesinde tek bir PointOfinterestEntity gösteren kullanıcı arayüzü.

  • Devam kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağının kullanıcıları tarafından yakın zamanda etkileşimde bulunulan içerikleri gösterir. Her geliştirici iş ortağının, Devam kümesinde en fazla 10 öğe yayınlamasına izin verilir.

    Devam içeriğiniz aşağıdaki yapıda olabilir:

    • ArticleEntity: ArticleEntity, seyahat ve etkinliklerle ilgili içerik önerilerini temsil eder. Bu öğe, okunmamış haber makalelerini veya kullanıcının kaldığı yerden devam etmek istediği diğer içerikleri temsil etmek için kullanılabilir. Örnek: Seyahat destinasyonu veya etkinlikle ilgili haber snippet'i, blog yayını snippet'i.

      Şekil 6. Bir Devam kümesi içinde tek bir articleEntity gösteren kullanıcı arayüzü.

    • RestaurantReservationEntity: RestaurantReservationEntity, bir restoran veya kafe için rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden restoran rezervasyonlarını izlemesine yardımcı olur.

      Şekil 7. Devam kümesinde tek bir RestaurantReservationEntity gösteren kullanıcı arayüzü.

    • EventReservationEntity: EventReservationEntity, bir etkinlik rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden etkinlik rezervasyonlarını izlemesine yardımcı olur. Etkinlikler aşağıdakileri içerebilir ancak bunlarla sınırlı değildir:

      • Futbol maçı rezervasyonu gibi spor etkinlikleri
      • Espor rezervasyonu gibi oyun etkinlikleri
      • Sinemalarda film rezervasyonu, konser, tiyatro, imza etkinliği gibi eğlence etkinlikleri
      • Seyahat veya önemli yer rezervasyonları (ör. rehberli turlar, müze biletleri)
      • Sosyal / Seminer / Konferans rezervasyonları
      • Eğitim / Eğitim oturumu rezervasyonları
      Şekil 8. Devam kümesinde tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü.

    • KonaklamaRezervasyonuÖğesi: KonaklamaRezervasyonuÖğesi, seyahat konaklama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden otel ya da kiralık yer rezervasyonlarını izlemesine yardımcı olur.

      Şekil 9. Devam kümesinde tek bir LodgingReservationEntity'yi gösteren kullanıcı arayüzü.

    • TransportationReservationEntity: TransportationReservationEntity, herhangi bir ulaşım modu için rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden uçuş, feribot, tren, otobüs, araç çağırma veya kruvaziyer rezervasyonlarını takip etmesine yardımcı olur.

      Şekil 10. Bir Continuation kümesi içinde tek bir TransportationReservationEntity gösteren kullanıcı arayüzü.

    • VehicleRentalReservationEntity: VehicleRentalReservationEntity, araç kiralama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden araç kiralama rezervasyonlarını izlemesine yardımcı olur.

      Şekil 11. Devam kümesinde tek bir VehicleRentalReservationEntity'yi gösteren kullanıcı arayüzü.

  • Öne Çıkan kümesi, birden fazla geliştirici iş ortağından seçilen öğeleri tek bir kullanıcı arayüzü gruplandırmasında gösterir. Tek bir Öne Çıkan küme bulunur. Bu küme, kullanıcı arayüzünün üst kısmına yakın bir yerde, tüm Öneriler kümelerinin üzerinde öncelikli olarak yerleştirilir. Her geliştirici iş ortağının, Öne Çıkanlar kümesinde en fazla 10 öğe yayınlamasına izin verilir.

    • GenericFeaturedEntity: GenericFeaturedEntity, Öne Çıkan Öğe'nin geliştiricilerin sunduğu tek bir popüler içerik için kullanılması ve kullanıcılar için ilgi çekici ve alakalı olacak en önemli içeriği temsil etmesi bakımından Önerilen Öğe'den farklıdır.

      Şekil 12: GenericFeaturedEntity listesini içeren bir FeaturedCluster gösteren kullanıcı arayüzü

Ön çalışma

Minimum API düzeyi: 19

com.google.android.engage:engage-core kitaplığını uygulamanıza ekleyin:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

Özet

Tasarım, bağlı hizmetin uygulanmasına dayanır.

Bir istemcinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:

Küme türü Küme sınırları Bir kümedeki minimum öğe sınırları Bir kümedeki maksimum öğe sınırları
Öneri Kümeleri En fazla 5 En az 5 En fazla 25 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity veya PointOfInterestEntity)
Devam Kümesi En fazla 1 En az 1 En fazla 10 (ArticleEntity, RestaurantReservationEntity EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity veya VehicleRentalReservationEntity)
Öne Çıkan Küme En fazla 1 En az 1 En fazla 10 (GenericFeaturedEntity)

1. adım: Öğe verilerini sağlayın

SDK'da her öğe türünü temsil eden farklı varlıklar tanımlanmıştır. Seyahat ve Etkinlikler kategorisi için aşağıdaki öğeleri destekleriz:

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. EventEntity
  4. LodgingEntity
  5. StoreEntity
  6. PointOfInterestEntity
  7. RestaurantReservationEntity
  8. EventReservationEntity
  9. LodgingReservationEntity
  10. TransportationReservationEntity
  11. VehicleRentalReservationEntity

Aşağıdaki grafiklerde, her tür için kullanılabilen özellikler ve şartlar özetlenmiştir.

GenericFeaturedEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Poster resimleri Zorunlu

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Not: Rozet kullanılıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan bırakın.

 Yardım için Resim Özellikleri bölümüne bakın.
Başlık İsteğe bağlı Varlığın başlığı.

Serbest metin

Önerilen metin boyutu: 50 karakter
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir.

Resmin/videonun üzerinde özel kullanıcı deneyimi kullanımı (ör. resmin üzerinde rozet yer paylaşımı olarak)

  • "Canlı güncelleme"
  • Makale okuma süresi
Rozet - Metin İsteğe bağlı

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirmesi (ör. resim/video küçük resminde rozet yer paylaşımı).

Not: Rozet için metin veya resim gereklidir.

Yardım için Resim Özellikleri bölümüne bakın.
İçerik Kategorileri İsteğe bağlı Varlıktaki içeriğin kategorisini açıklayın.

Sıralama Listesi

Yol gösterici bilgiler için İçerik Kategorisi bölümüne bakın.

ArticleEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığı.

Serbest metin

Önerilen metin boyutu: En fazla 50 karakter
Poster resimleri İsteğe bağlı

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Not: Resim kesinlikle önerilir. Rozet sağlanıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan olduğundan emin olun

 Yardım için Resim Özellikleri bölümüne bakın.
Kaynak - Başlık İsteğe bağlı Yazarın, kuruluşun veya muhabirin adı

Serbest metin

Önerilen metin boyutu: 25 karakterden kısa
Kaynak - Resim İsteğe bağlı Kaynağın resmi (ör. yazar, kuruluş, muhabir) Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir.

Resim/videonun üstünde özel kullanıcı deneyimi işlemleri (ör. resim üzerinde rozet yer paylaşımı)

  • "Canlı güncelleme"
  • Makale okuma süresi
Rozet - Metin İsteğe bağlı

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirmesi (ör. resim/video küçük resminde rozet yer paylaşımı).

Not: Rozet için metin veya resim gereklidir

Yardım için Resim Özellikleri bölümüne bakın.
İçeriğin Yayınlanma Zamanı İsteğe bağlı Bu, içeriğin uygulamada yayınlandığı/güncellendiği zamanın milisaniye cinsinden çağ zaman damgası. Milisaniye cinsinden Epoch zaman damgası
Son Etkileşim Zamanı Koşullu Zorunlu

Kullanıcının bu öğeyle son etkileşimde bulunduğu zamanın milisaniye cinsinden çağ zaman damgası.

Not: Bu varlık devam kümesinin bir parçasıysa bu alan zorunludur.

 Milisaniye cinsinden Epoch zaman damgası
İlerleme Yüzdesi Koşullu Zorunlu

Kullanıcının bugüne kadar tükettiği toplam içeriğin yüzdesi.

Not: Söz konusu varlık, devamlılık kümesinin bir parçasıysa bu alan zorunludur.

 0 ile 100 arasında (0 ve 100 dahil) bir tam sayı.
İçerik Kategorileri İsteğe bağlı Varlıktaki içeriğin kategorisini açıklayın.

Sıralamalar listesi

Rehberlik için İçerik Kategorisi bölümüne bakın.

EventEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığı.

Dize

Önerilen metin boyutu: En fazla 50 karakter
Başlangıç zamanı Zorunlu

Etkinliğin başlaması beklenen epoch zaman damgası.

Not: Bu değer milisaniye cinsinden gösterilir.

 Milisaniye cinsinden Unix sıfır zaman damgası
Etkinlik modu Zorunlu

Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan.

 Liste: VIRTUAL, IN_PERSON veya HYBRID
Poster resimleri Zorunlu

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan olduğundan emin olun

 Yardım için Resim Özellikleri'ne bakın.
Konum - Ülke Koşula Bağlı Olarak Zorunlu

Etkinliğin gerçekleştiği ülke.

Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Koşula Bağlı Olarak Zorunlu

Etkinliğin gerçekleştiği şehir.

Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Görünen Adres Koşullu Zorunlu

Etkinliğin gerçekleşeceği adres veya mekan adı. Bu ad kullanıcıya gösterilmelidir.

Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Etkinliğin düzenlendiği konumun sokak adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet İsteğe bağlı Etkinliğin düzenlendiği eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu İsteğe bağlı Etkinliğin düzenlendiği konumun posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle İsteğe bağlı Etkinliğin düzenlendiği mahalle (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Bitiş zamanı İsteğe bağlı

Etkinliğin sona ermesinin beklendiği çağ zaman damgası.

Not: Bu değer milisaniye cinsinden gösterilir.

 Milisaniye cinsinden Unix sıfır zaman damgası
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir.
Rozet - Metin İsteğe bağlı

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirmesi (ör. resim/video küçük resminde rozet yer paylaşımı).

Not: Rozet için metin veya resim gereklidir.

Yardım için Resim Özellikleri bölümüne bakın.
Fiyat - CurrentPrice Koşullu olarak zorunlu

Etkinlik biletinin/geçişinin mevcut fiyatı.

Üstü çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Etkinlik biletinin/geçişinin orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
İçerik Kategorileri İsteğe bağlı Öğedeki içeriğin kategorisini açıklayın.

Uygun enumların listesi

  • TYPE_MOVIES_AND_TV_SHOWS (Örnek: Sinema)
  • TYPE_DIGITAL_GAMES (Örnek: Espor)
  • TYPE_MUSIC (Örnek: Konser)
  • TYPE_TRAVEL_AND_LOCAL (Örnek: Tur, festival)
  • TYPE_HEALTH_AND_FITENESS (Örnek: Yoga dersi)
  • TYPE_EDUCATION (Örnek - Sınıf)
  • TYPE_SPORTS (Örnek - Futbol maçı)
  • TYPE_DAting (Örnek - buluşma)

Rehberlik için İçerik Kategorisi bölümüne bakın.

LodgingEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığı.

Dize

Önerilen metin boyutu: En fazla 50 karakter
Poster resimleri Zorunlu

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun.

Yardım için Resim Özellikleri bölümüne bakın.
Konum - Ülke Zorunlu Konaklamanın gerçekleştiği ülke.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Zorunlu Konaklamanın gerçekleştiği şehir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Görünen Adres Zorunlu Kullanıcıya gösterilecek konaklama yerinin adresi.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Konaklama tesisinin açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet İsteğe bağlı Konaklama yerinin bulunduğu eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu İsteğe bağlı Konaklama yerinin posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle İsteğe bağlı Konaklama tesisinin bulunduğu mahalle (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir.
Rozet - Metin İsteğe bağlı

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirmesi (ör. resim/video küçük resminde rozet yer paylaşımı).

Not: Rozet için metin veya resim gereklidir.

Yardım için Resim Özellikleri'ne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
AvailabilityTimeWindow - Start Time İsteğe bağlı Konaklama tesisinin açık/kullanılabilir olmasının beklendiği zaman damgası (milisaniye cinsinden). Milisaniye cinsinden Unix sıfır zaman damgası
AvailabilityTimeWindow - Bitiş Saati İsteğe bağlı Konaklamanın açık/kullanılabilir olması beklenen milisaniye cinsinden dönem zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Puan - Maksimum değer İsteğe bağlı

Derecelendirme ölçeğinin maksimum değeri.

Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Mevcut değer İsteğe bağlı

Puan ölçeğinin mevcut değeri.

Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Sayı İsteğe bağlı

Konaklama biriminin aldığı puanların sayısı.

Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa ve öz dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1 milyon gibi kısaltmalar kullanabilirsiniz.

 Dize
Puan - Sayı Değeri İsteğe bağlı

Konaklama biriminin aldığı puanların sayısı.

Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız

 Uzun
Fiyat - CurrentPrice Koşula bağlı olarak gerekli

Konaklamanın mevcut fiyatı.

Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Konaklama yerinin orijinal fiyatı. Bu fiyat, kullanıcı arayüzünde üstü çizili olarak gösterilir. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinde üç nokta gösterilebilir)

StoreEntity

StoreEntity nesnesi, geliştirici iş ortaklarının yayınlamak istediği bağımsız bir mağazayı (ör. restoran veya market) temsil eder.

Özellik Şartlar Açıklama Biçim
Poster resimleri Zorunlu En az bir resim sağlanmalıdır. Yardım için Resim Özellikleri bölümüne bakın.
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık İsteğe bağlı Mağazanın adı.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinde üç nokta gösterilebilir)
Konum İsteğe bağlı Mağazanın konumu.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Açıklama metni İsteğe bağlı Mağazayla ilgili tanıtım, etkinlik veya güncellemeyi (varsa) öne çıkaran açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinde üç nokta gösterilebilir)
Açıklama metni ayrıntıları İsteğe bağlı Açıklama metni için küçük yazı metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Açıklama İsteğe bağlı Mağazanın açıklaması.

Serbest metin

Önerilen metin boyutu: 90 karakterden az (Çok uzun metinde üç nokta gösterilebilir)
Derecelendirme - Maksimum değer İsteğe bağlı

Derecelendirme ölçeğinin maksimum değeri.

Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Mevcut değer İsteğe bağlı

Puan ölçeğinin mevcut değeri.

Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Sayı İsteğe bağlı

Konaklama biriminin aldığı puanların sayısı.

Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa ve öz dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1 milyon gibi kısaltmalar kullanabilirsiniz.

 Dize
Puan - Sayı Değeri İsteğe bağlı

Konaklama biriminin aldığı puanların sayısı.

Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız

 Uzun

PointOfInterestEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığı.

Dize

Önerilen metin boyutu: En fazla 50 karakter
Poster resimleri Zorunlu

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Not: Resim kesinlikle önerilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun

 Yardım için Resim Özellikleri'ne bakın.
Konum - Ülke Zorunlu Önemli yerin gerçekleştiği ülke.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Zorunlu Önemli yerin gerçekleştiği şehir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Görünen Adres Zorunlu Kullanıcıya gösterilecek önemli yerin adresi.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Önemli yerin açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet İsteğe bağlı İlgi çekici yerin bulunduğu eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu İsteğe bağlı Önemli yerin posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle İsteğe bağlı Önemli yerin mahallesi (varsa).

Serbest metin

Önerilen metin boyutu: Maksimum ~20 karakter
AvailabilityTimeWindow - Başlangıç Zamanı İsteğe bağlı Önemli yerin açık/kullanılabilir olmasının beklendiği zamana ait milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
AvailabilityTimeWindow - Bitiş Saati İsteğe bağlı Önemli yerin açık/kullanılabilir olmasının beklendiği zamana kadarki milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir.
Rozet - Metin İsteğe bağlı

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirmesi (ör. resim/video küçük resminde rozet yer paylaşımı).

Not: Rozet için metin veya resim gereklidir.

Yardım için Resim Özellikleri'ne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: maksimum 50 karakter
Derecelendirme - Maksimum değer İsteğe bağlı

Derecelendirme ölçeğinin maksimum değeri.

Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Mevcut değer İsteğe bağlı

Puan ölçeğinin mevcut değeri.

Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Sayı İsteğe bağlı

Önemli yer için verilen puanların sayısı.

Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa bir dize sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.

 Dize
Puan - Sayı Değeri İsteğe bağlı

Önemli yer için puan sayısı.

Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı öğesini kullanırız

 Uzun
Fiyat - CurrentPrice Koşullu olarak zorunlu

Önemli yer için biletlerin/giriş kartlarının mevcut fiyatı.

Üstü çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Önemli yer için biletlerin/giriş kartının orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

İçerik Kategorileri İsteğe bağlı Öğedeki içeriğin kategorisini açıklayın.

Uygun enumların listesi

  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_MOVIES_AND_TV_SHOWS (Örnek: sinema)
  • TYPE_MEDical (Örnek - hastane)
  • TYPE_EDUCATION (Örnek: okul)
  • TYPE_SPORTS (Örnek - stadyum)

Rehberlik için İçerik Kategorisi bölümüne bakın.

RestaurantReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığı.

Dize

Önerilen metin boyutu: Maksimum 50 karakter
Rezervasyon Başlangıç Saati Zorunlu Rezervasyonun başlamasının beklendiği milisaniye cinsinden epoch zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Konum - Ülke Zorunlu Restoranın bulunduğu ülke.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Zorunlu Restoranın bulunduğu şehir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Görünen Adres Zorunlu Kullanıcıya gösterilecek restoranın adresi.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Restoranın açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet İsteğe bağlı Restoranın bulunduğu eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu İsteğe bağlı Restoranın posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle İsteğe bağlı Restoranın bulunduğu mahalle (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Poster resimleri İsteğe bağlı Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: maksimum 50 karakter
Tablo boyutu İsteğe bağlı Rezervasyon grubundaki kişi sayısı 0'dan büyük tam sayı

EventReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığı.

Dize

Önerilen metin boyutu: En fazla 50 karakter
Başlangıç zamanı Zorunlu

Etkinliğin başlaması beklenen epoch zaman damgası.

Not: Bu değer milisaniye cinsinden gösterilir.

 Milisaniye cinsinden Unix sıfır zaman damgası
Etkinlik modu Zorunlu

Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan.

 Liste: VIRTUAL, IN_PERSON veya HYBRID
Konum - Ülke Koşula Bağlı Olarak Zorunlu

Etkinliğin gerçekleştiği ülke.

Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Koşula Bağlı Olarak Zorunlu

Etkinliğin gerçekleştiği şehir.

Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Görünen Adres Koşullu Zorunlu

Etkinliğin gerçekleşeceği adres veya mekan adı. Bu ad kullanıcıya gösterilmelidir.

Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Etkinliğin düzenlendiği konumun sokak adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet İsteğe bağlı Etkinliğin düzenlendiği eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu İsteğe bağlı Etkinliğin düzenlendiği konumun posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle İsteğe bağlı Etkinliğin düzenlendiği mahalle (geçerliyse).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Poster resimleri İsteğe bağlı

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanmışsa resmin hem üst hem de alt kısmında 24 d/sn güvenli alan olduğundan emin olun

 Yardım için Resim Özellikleri bölümüne bakın.
Bitiş zamanı İsteğe bağlı

Etkinliğin sona ermesinin beklendiği çağ zaman damgası.

Not: Bu değer milisaniye cinsinden gösterilir.

 Milisaniye cinsinden Unix sıfır zaman damgası
Servis Sağlayıcı - Ad İsteğe bağlı

Servis sağlayıcının adı.

Not: Servis sağlayıcı için metin veya resim gereklidir.

Serbest metin. Örneğin, etkinlik düzenleyenin/turun adı
Servis Sağlayıcı - Resim İsteğe bağlı

Servis sağlayıcının logosu/resmi.

Not: Servis sağlayıcı için metin veya resim gereklidir.

Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük resim olabilir.
Rozet - Metin İsteğe bağlı

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirmesi (ör. resim/video küçük resminde rozet yer paylaşımı).

Not: Rozet için metin veya resim gereklidir

Yardım için Resim Özellikleri bölümüne bakın.
Rezervasyon kimliği İsteğe bağlı Etkinlik rezervasyonunun rezervasyon kimliği. Serbest metin
Fiyat - CurrentPrice Koşullu olarak zorunlu

Etkinlik biletinin/geçişinin mevcut fiyatı.

Üstü çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Etkinlik biletinin/geçişinin orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinde üç nokta gösterilebilir)
Derecelendirme - Maksimum değer İsteğe bağlı

Derecelendirme ölçeğinin maksimum değeri.

Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Mevcut değer İsteğe bağlı

Puan ölçeğinin mevcut değeri.

Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Sayı İsteğe bağlı

Etkinliğin puanlarının sayısı.

Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa ve öz dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz.

 Dize
Puan - Sayı Değeri İsteğe bağlı

Etkinliğin puanlarının sayısı.

Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız

 Uzun
İçerik Kategorileri İsteğe bağlı Öğedeki içeriğin kategorisini açıklayın.

Uygun enumların listesi

  • TYPE_MOVIES_AND_TV_SHOWS (Örnek: Sinema)
  • TYPE_DIGITAL_GAMES (Örnek: Espor)
  • TYPE_MUSIC (Örnek: Konser)
  • TYPE_TRAVEL_AND_LOCAL (Örnek: Tur, festival)
  • TYPE_HEALTH_AND_FITENESS (Örnek: Yoga dersi)
  • TYPE_EDUCATION (Örnek - Sınıf)
  • TYPE_SPORTS (Örnek - Futbol maçı)
  • TYPE_DATING (Örnek: buluşma)

Rehberlik için İçerik Kategorisi bölümüne bakın.

LodgingReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığıdır.

Serbest metin. Örneğin, "12 Aralık'taki konaklamanız"

Önerilen metin boyutu: Maksimum 50 karakter
Giriş saati Zorunlu Rezervasyonun giriş zamanını milisaniye cinsinden gösteren sıfır zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Çıkış saati Zorunlu Rezervasyonun çıkış saatini temsil eden milisaniye cinsinden dönem zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Konum - Ülke Zorunlu Konaklama tesisinin bulunduğu ülkedir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Zorunlu Konaklama yerinin bulunduğu şehir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Görünen Adres Zorunlu Kullanıcıya gösterilecek konaklama yerinin adresi.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Konaklama tesisinin açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Eyalet İsteğe bağlı Konaklama yerinin bulunduğu eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Posta kodu İsteğe bağlı Konaklama yerinin posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Mahalle İsteğe bağlı Konaklama tesisinin bulunduğu mahalle (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Poster resimleri İsteğe bağlı

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur

Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun.

Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rezervasyon kimliği İsteğe bağlı Konaklama rezervasyonunun rezervasyon kimliği. Serbest metin
Derecelendirme - Maksimum değer İsteğe bağlı

Derecelendirme ölçeğinin maksimum değeri.

Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Mevcut değer İsteğe bağlı

Puan ölçeğinin mevcut değeri.

Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır.

 Sayı >= 0,0
Derecelendirme - Sayı İsteğe bağlı

Konaklama biriminin aldığı puanların sayısı.

Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa ve öz dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1 milyon gibi kısaltmalar kullanabilirsiniz.

 Dize
Puan - Sayı Değeri İsteğe bağlı

Konaklama biriminin aldığı puanların sayısı.

Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız

 Uzun
Fiyat - CurrentPrice Koşula bağlı olarak gerekli

Konaklamanın mevcut fiyatı.

Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Konaklama yerinin orijinal fiyatı. Bu fiyat, kullanıcı arayüzünde üstü çizili olarak gösterilir. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

TransportationReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığıdır.

Serbest metin. Örneğin, "SFO'dan SAN'ye"

Önerilen metin boyutu: En fazla 50 karakter
Ulaşım Türü Zorunlu Rezervasyon için ulaşım şekli/türü. Enum: UÇUŞ, TREN, OTOBÜS veya Vapur
Kalkış Saati Zorunlu Kalkış saatini milisaniye cinsinden gösteren sıfır zaman damgası. Milisaniye cinsinden Epoch zaman damgası
Varış Saati Zorunlu Varış zamanını temsil eden milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden Epoch zaman damgası
Kalkış Konumu - Ülke İsteğe bağlı Kalkış ülkesi.

Serbest metin

Önerilen metin boyutu: Maksimum ~20 karakter
Kalkış Konumu - Şehir İsteğe bağlı Kalkış şehri.

Serbest metin

Önerilen metin boyutu: Maksimum ~20 karakter
Kalkış Konumu - Görünen Adres İsteğe bağlı Kullanıcıya gösterilecek kalkış konumu.

Serbest metin

Önerilen metin boyutu: Maksimum ~20 karakter
Kalkış Konumu - Açık Adres İsteğe bağlı Kalkış konumunun açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Kalkış Konumu - Eyalet İsteğe bağlı Kalkış konumunun bulunduğu eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Kalkış Yeri - Posta kodu İsteğe bağlı Kalkış konumunun posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Kalkış Konumu - Mahalle İsteğe bağlı Kalkış noktasının mahallesi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Ülke İsteğe bağlı Varış ülkesi.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Şehir İsteğe bağlı Varış şehri.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - Görüntülenen adres İsteğe bağlı Kullanıcıya gösterilecek varış konumu.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - açık adres İsteğe bağlı Varış konumunun açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Eyalet İsteğe bağlı Varış konumunun eyaleti veya ili (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış yeri - Posta kodu İsteğe bağlı Varış konumunun posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Mahalle İsteğe bağlı Varış konumunun mahallesi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Servis Sağlayıcı - Ad İsteğe bağlı

Servis sağlayıcının adı.

Not: Servis sağlayıcı için metin veya resim gereklidir.

Serbest metin. Örneğin, Hava yolu şirketinin adı
Servis Sağlayıcı - Resim İsteğe bağlı

Servis sağlayıcının logosu/resmi.

Not: Servis sağlayıcı için metin veya resim gereklidir.

Yardım için Resim Özellikleri bölümüne bakın.
Poster resimleri İsteğe bağlı

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Rezervasyon kimliği İsteğe bağlı Ulaşım rezervasyonunun rezervasyon kimliği. Serbest metin
Fiyat - CurrentPrice Koşullu olarak zorunlu

Rezervasyonun mevcut fiyatı.

Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Rezervasyonun kullanıcı arayüzünde belirtilen orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Ulaşım Numarası Zorunlu Uçuş numarası, otobüs numarası, tren numarası veya feribot/kruiz numarası. Serbest metin
Uçağa Biniş Saati Zorunlu Rezervasyonun biniş zamanını temsil eden çağ zaman damgası (varsa) Milisaniye cinsinden Epoch zaman damgası

VehicleRentalReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem Uri Zorunlu

Sağlayıcı uygulamasındaki öğeye derin bağlantı.

Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın

URI
Başlık Zorunlu Varlığın başlığıdır.

Serbest metin. Örneğin, "Avis Union Square SF"

Önerilen metin boyutu: En fazla 50 karakter
Teslim Alma Zamanı Zorunlu Rezervasyonun teslim alma zamanını temsil eden çağ zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Dönüş Saati İsteğe bağlı Rezervasyonun çıkış saatini temsil eden çağ zaman damgası. Milisaniye cinsinden Unix sıfır zaman damgası
Teslim alma adresi - Ülke İsteğe bağlı Teslim alma konumunun bulunduğu ülke.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Teslim alma adresi - Şehir İsteğe bağlı Teslim alma konumunun bulunduğu şehir.

Serbest metin

Önerilen metin boyutu: Maksimum ~20 karakter
Alınacağı Adres - Görünen Adres İsteğe bağlı Kullanıcıya gösterilecek teslim alma konumu.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Teslim Alınacak Adres - Açık Adres İsteğe bağlı Teslim alma konumunun açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Teslim alma adresi - Eyalet İsteğe bağlı Teslim alma yerinin eyaleti veya ili (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Alınacağı Adres - Posta kodu İsteğe bağlı Teslim alma yerinin posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Teslim alma adresi - Mahalle İsteğe bağlı Teslim alma konumunun mahallesi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Ülke İsteğe bağlı İade konumunun bulunduğu ülke.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Şehir İsteğe bağlı İade konumunun bulunduğu şehir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Görünen Adres İsteğe bağlı Kullanıcıya gösterilecek iade konumu.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Açık Adres İsteğe bağlı İade konumunun açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
İade Adresi - Eyalet İsteğe bağlı İade konumunun eyaleti veya ili (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
İade adresi - Posta kodu İsteğe bağlı İade konumunun posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: Maksimum ~20 karakter
İade Adresi - Mahalle İsteğe bağlı İade konumunun mahallesi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Servis Sağlayıcı - Ad İsteğe bağlı

Servis sağlayıcının adı.

Not: Servis sağlayıcı için metin veya resim gereklidir.

Serbest metin. Örneğin, "Avis Rent A Car"
Servis Sağlayıcı - Resim İsteğe bağlı

Servis sağlayıcının logosu/resmi.

Not: Servis sağlayıcı için metin veya resim gereklidir.

Yardım için Resim Özellikleri bölümüne bakın.
Poster resimleri İsteğe bağlı

Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur.

Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlık için tek bir paragraflık metin.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Önerilen metin boyutu: 180 karakter
Altyazı listesi İsteğe bağlı

Her biri tek satırdan oluşan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya altyazı listesi gösterilir.

Serbest metin

Her altyazı için önerilen metin boyutu: en fazla 50 karakter
Onay Kimliği İsteğe bağlı Araç kiralama rezervasyonunun onay kimliği. Serbest metin
Fiyat - CurrentPrice Koşullu olarak zorunlu

Rezervasyonun mevcut fiyatı.

Üzeri çizili fiyat sağlanıyorsa belirtilmelidir.

Serbest metin
Fiyat - Üstü Çizili Fiyat İsteğe bağlı Rezervasyonun kullanıcı arayüzünde belirtilen orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)

Resim özellikleri

Resim öğeleri için gerekli özellikler bu tabloda listelenmiştir:

En boy oranı Minimum piksel sayısı Önerilen piksel sayısı

Kare (1x1)

Tercih edilen

 300x300 1.200x1.200
Yatay (1,91x1) 600x314 1.200x628
Dikey (4x5) 480x600 960x1200

Google'ın resimlere erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir.

Dosya biçimleri

PNG, JPG, statik GIF, WebP

Maksimum dosya boyutu

5.120 KB

Ek öneriler

  • Resim güvenli alanı: Önemli içeriklerinizi yatay ve dikey yönde ortalanmış olarak resmin %80'ini kaplayacak şekilde yerleştirin.
  • Resmin Koyu ve Açık tema ayarlarında düzgün bir şekilde gösterilebilmesi için şeffaf bir arka plan kullanın.

İçerik Kategorisi

İçerik kategorisi, uygulamaların birden fazla kategoriye ait içerik yayınlamasına olanak tanır. Bu işlem, içeriği önceden tanımlanmış kategorilerden bazılarıyla eşleştirir. Bu kategoriler şunlardır:

  • TYPE_EDUCATION
  • TYPE_SPORTS
  • TYPE_MOVIES_AND_TV_SHOWS
  • TYPE_BOOKS
  • TYPE_AUDIOBOOKS
  • TYPE_MUSIC
  • TYPE_DIGITAL_GAMES
  • TYPE_TRAVEL_AND_LOCAL
  • TYPE_HOME_AND_AUTO
  • TYPE_BUSINESS
  • TYPE_NEWS
  • TYPE_FOOD_AND_DRINK
  • TYPE_SHOPPING
  • TYPE_HEALTH_AND_FITENESS
  • TYPE_MEDICAL
  • TYPE_PARENTING
  • TYPE_DATING

Google'ın görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.

İçerik kategorilerini kullanma kuralları

  1. MakaleEntity ve GenelFeaturedEntity gibi bazı varlıklar, içerik kategorilerinin herhangi birini kullanmaya uygundur. EventEntity, EventReservationEntity, PointOfInterestEntity gibi diğer varlıklar için yalnızca bu kategorilerin bir alt kümesi uygundur. Listeyi doldurmadan önce bir varlık türü için uygun kategorilerin listesini kontrol edin.

  2. Bazı içerik kategorileri için genel öğeler ve ContentCategory öğesinin bir kombinasyonu yerine belirli öğe türünü kullanın:

  3. ContentCategory alanı isteğe bağlıdır ve içerik daha önce belirtilen kategorilerden hiçbirine ait değilse boş bırakılmalıdır.

  4. Birden fazla içerik kategorisi sağlanırsa bunları içerikle alaka düzeyine göre sıralayın. En alakalı içerik kategorisi listeye ilk sırada eklenir.

2. Adım: Küme verilerini sağlayın

İçerik yayınlama işinin arka planda (ör. WorkManager kullanılarak) yürütülmesi ve düzenli olarak veya etkinlik bazında (ör. kullanıcı uygulamayı her açtığında ya da sepete bir şey eklediğinde) planlanması önerilir.

AppEngagePublishClient, kümeleri yayınlamaktan sorumludur.

İstemcide kümeleri yayınlamak için aşağıdaki API'ler vardır:

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishContinuationCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteContinuationCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

Bu API, hizmetin entegrasyon için kullanılıp kullanılamadığını ve içeriğin cihazda sunulup sunulamayacağını kontrol etmek için kullanılır.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

Bu API, RecommendationCluster nesnelerin listesini yayınlamak için kullanılır.

Kotlin

client.publishRecommendationClusters(
      PublishRecommendationClustersRequest.Builder()
        .addRecommendationCluster(
          RecommendationCluster.Builder()
            .addEntity(entity1)
            .addEntity(entity2)
            .setTitle("Top Picks For You")
            .build()
        )
        .build()
    )

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Top Picks For You")
                        .build())
                .build());

Hizmet isteği aldığında, bir işlem içinde aşağıdaki işlemler gerçekleştirilir:

  • Geliştirici iş ortağının mevcut RecommendationCluster verileri kaldırılır.
  • İstekten gelen veriler ayrıştırılır ve güncellenmiş öneri kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

publishFeaturedCluster

Bu API, FeaturedCluster nesnelerin listesini yayınlamak için kullanılır.

Kotlin

client.publishFeaturedCluster(
    PublishFeaturedClusterRequest.Builder()
      .setFeaturedCluster(
        FeaturedCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClustersRequest.Builder()
                .addFeaturedCluster(
                    new FeaturedCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

  • Geliştirici iş ortağının mevcut FeaturedCluster verileri kaldırılır.
  • İstekten gelen veriler ayrıştırılır ve güncellenen Öne Çıkan Küme'de depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

publishContinuationCluster

Bu API, ContinuationCluster nesnesi yayınlamak için kullanılır.

Kotlin

client.publishContinuationCluster(
    PublishContinuationClusterRequest.Builder()
      .setContinuationCluster(
        ContinuationCluster.Builder()
          .addEntity(entity1)
          .addEntity(entity2)
          .build())
      .build())

Java

client.publishContinuationCluster(
            new PublishContinuationClusterRequest.Builder()
                .setContinuationCluster(
                    new ContinuationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .build())
                .build());

Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:

  • Geliştirici iş ortağının mevcut ContinuationCluster verileri kaldırılır.
  • İstekten elde edilen veriler ayrıştırılır ve güncellenmiş Devam Kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

publishUserAccountManagementRequest

Bu API, oturum açma kartı yayınlamak için kullanılır. Oturum açma işlemi, uygulamanın içerik yayınlayabilmesi (veya daha kişiselleştirilmiş içerik sunabilmesi) için kullanıcıları uygulamanın oturum açma sayfasına yönlendirir.

Aşağıdaki meta veriler, oturum açma kartının bir parçasıdır:

Özellik Şartlar Açıklama
İşlem Uri Zorunlu İşleme derin bağlantı (ör. uygulamanın oturum açma sayfasına yönlendirme)
Resim İsteğe bağlı: Sağlanmazsa başlık sağlanmalıdır

Kartta gösterilen resim

1264x712 çözünürlüğe sahip 16x9 en boy oranına sahip resimler
Başlık İsteğe bağlı: Sağlanmazsa resim sağlanmalıdır Karttaki başlık
İşlem metni İsteğe bağlı CTA'da (ör. Oturum Aç) gösterilen metin
Alt başlık İsteğe bağlı Kartta isteğe bağlı altyazı

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Hizmet isteği aldığında, bir işlem içinde aşağıdaki işlemler gerçekleştirilir:

  • Geliştirici iş ortağının mevcut UserAccountManagementCluster verileri kaldırılır.
  • İstekten gelen veriler ayrıştırılır ve güncellenen UserAccountManagementCluster kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

updatePublishStatus

Dahili bir işletme nedeniyle kümelerin hiçbiri yayınlanmıyorsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle tavsiye ederiz. Bu önemlidir, çünkü:

  • İçerik yayınlandığında bile tüm senaryolarda durumu belirtmek (STATUS == YAYINLANDI) entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu uygunsuz durumu kullanan kontrol panellerini doldurmak açısından çok önemlidir.
  • Hiçbir içerik yayınlanmamışsa ancak entegrasyon durumu bozulmamışsa (STATUS == NOT_PUBLISHED) Google, uygulama sağlığı kontrol panellerinde uyarı tetiklemekten kaçınabilir. Bu bildirim, sağlayıcı açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
  • Geliştiricilerin verilerin ne zaman yayınlandığı ve ne zaman yayınlanmadığı hakkında analizler sunmasına yardımcı olur.
  • Google, kullanıcının uygulama içeriğini görebilmesi veya bu içeriğin üstesinden gelmesi için uygulamada belirli işlemleri yapmasına yönlendirmek amacıyla durum kodlarını kullanabilir.

Uygun yayınlama durumu kodlarının listesi şunlardır:

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

İçerik, kullanıcının giriş yapmaması nedeniyle yayınlanmıyorsa Google, oturum açma kartının yayınlanmasını önerir. Sağlayıcılar herhangi bir nedenle oturum açma kartını yayınlayamıyorsa NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla updatePublishStatus API'sini çağırmanızı öneririz.

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

Bu API, öneri kümelerinin içeriğini silmek için kullanılır.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Hizmet, isteği aldığında mevcut verileri öneri kümelerinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteFeaturedCluster

Bu API, Öne Çıkan Küme'nin içeriğini silmek için kullanılır.

Kotlin

client.deleteFeaturedCluster()

Java

client.deleteFeaturedCluster();

Hizmet, isteği aldığında mevcut verileri Öne Çıkan Küme'den kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteContinuationCluster

Bu API, Devam Kümesinin içeriğini silmek için kullanılır.

Kotlin

client.deleteContinuationCluster()

Java

client.deleteContinuationCluster();

Hizmet, isteği aldığında mevcut verileri Devam Kümesinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteUserManagementCluster

Bu API, UserAccountManagement kümesinin içeriğini silmek için kullanılır.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Hizmet, isteği aldığında mevcut verileri UserAccountManagement Kümesinden kaldırır. Bir hata olması durumunda, isteğin tamamı reddedilir ve mevcut durum korunur.

deleteClusters

Bu API, belirli bir küme türünün içeriğini silmek için kullanılır.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_CONTINUATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_CONTINUATION)
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                .build());

Hizmet isteği aldığında, belirtilen küme türleriyle eşleşen tüm kümelerden mevcut verileri kaldırır. İstemciler bir veya daha fazla küme türünü iletmeyi seçebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

Hata işleme

Yayınlama API'lerinden görev sonucunu dinlemeniz önemle tavsiye edilir. Böylece, başarılı bir görevi kurtarıp yeniden göndermek için takip işlemi yapabilirsiniz.

Kotlin

client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }

Java

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

Hata, hata kodu olarak nedeni dahil edilerek AppEngageException olarak döndürülür.

Hata kodu Hata adı Not
1 SERVICE_NOT_FOUND Hizmet, belirtilen cihazda kullanılamıyor.
2 SERVICE_NOT_AVAILABLE Hizmet, belirli bir cihazda kullanılabilir ancak arama sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır).
3 SERVICE_CALL_EXECUTION_FAILURE Görev yürütme, mesaj dizileriyle ilgili sorunlar nedeniyle başarısız oldu. Bu durumda, işlem yeniden denenebilir.
4 SERVICE_CALL_PERMISSION_DENIED Arayan kullanıcının servis araması yapmasına izin verilmiyor.
5 SERVICE_CALL_INVALID_ARGUMENT İstek geçersiz veriler içeriyor (örneğin, izin verilenden daha fazla sayıda küme).
6 SERVICE_CALL_INTERNAL Hizmet tarafında bir hata var.
7 SERVICE_CALL_RESOURCE_EXHAUSTED Servis çağrısı çok sık yapılıyor.

3. Adım: Yayın intent'lerini işleme

İçerik yayınlama isteğini almak için bir iş üzerinden Content API çağrıları yapmanın yanı sıra bir BroadcastReceiver oluşturmak da gerekir.

Yayın niyetinin amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın niyeti, çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca Engage Hizmeti içeriğin güncel olmayabileceğini (ör. bir haftalık) belirlediğinde tetiklenir. Bu şekilde, uygulama uzun bir süredir çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimine sahip olabileceğine dair güven artar.

BroadcastReceiver aşağıdaki iki şekilde ayarlanmalıdır:

  • Context.registerReceiver() kullanarak BroadcastReceiver sınıfının bir örneğini dinamik olarak kaydedin. Bu sayede, bellekte hâlâ etkin olan uygulamalardan iletişim kurulabilir.

Kotlin

class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
  // is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
  // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
  // received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Continuation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION))
}

Java

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION));

}
  • AndroidManifest.xml dosyanızda <receiver> etiketiyle uygulamayı statik olarak beyan edin. Bu, uygulamanın çalışmadığında yayın intent'leri almasına ve içeriği yayınlamasına olanak tanır.
<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
      </intent-filter>
   </receiver>
</application>

Hizmet tarafından aşağıdaki intent'ler gönderilir:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Bu amacı aldığınızda publishRecommendationClusters çağrısı başlatmanız önerilir.
  • com.google.android.engage.action.PUBLISH_FEATURED Bu intent'i aldığınızda publishFeaturedCluster çağrısı başlatmanız önerilir.
  • com.google.android.engage.action.PUBLISH_CONTINUATION Bu intent'i aldığınızda publishContinuationCluster çağrısı başlatmanız önerilir.

Entegrasyon iş akışı

Entegrasyonunuz tamamlandıktan sonra doğrulamayla ilgili adım adım açıklamalı bir kılavuz için Engage geliştirici entegrasyon iş akışı başlıklı makaleyi inceleyin.

SSS

SSS'ler için Etkileşim SDK'sıyla İlgili Sık Sorulan Sorular bölümüne bakın.

İletişim

Entegrasyon işlemi sırasında sorularınız olursa engage-developers@google.com adresinden bizimle iletişime geçebilirsiniz.

Sonraki adımlar

Bu entegrasyonu tamamladıktan sonra uygulayacağınız adımlar şunlardır:

  • engagement-developers@google.com adresine e-posta gönderin ve Google tarafından test edilmeye hazır olan entegre APK'nızı ekleyin.
  • Google, entegrasyonun beklendiği gibi çalıştığından emin olmak için bir doğrulama ve şirket içi inceleme gerçekleştirir. Değişiklik yapılması gerekiyorsa Google gerekli tüm bilgileri sizinle paylaşır.
  • Test tamamlandığında ve herhangi bir değişiklik gerekmediğinde Google, güncellenmiş ve entegre APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
  • Google, güncellenmiş APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneri, Öne Çıkan ve Devam kümeleriniz yayınlanabilir ve kullanıcılar tarafından görülebilir.