SDK Diğer Sektörlerle Etkileşime Geçme: Üçü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ğinin tüketilmesi ve keşfedilmesi için yeni ve etkileyici bir deneyim sağlayan bir cihaz yüzeyi geliştirmektedir. Bu tam ekran deneyimi, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda gösterme fırsatı sunar.

Bu dokümanda, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak bu kategorilerden hiçbirine ait olmayabilecek rezervasyonlar, etkinlikler, konaklama, ilgilenilen yerler, insanlar ve diğer içerikler gibi yeni içerikleri entegre etmesine yönelik talimatlar yer almaktadır.

Entegrasyon ayrıntısı

Terminoloji

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

  • Öneri kümeleri, bağımsız bir geliştirici iş ortağından kişiselleştirilmiş öneriler gösterir. Bu, aynı geliştirici iş ortağının sunduğu bir grup öneriyi içeren bir kullanıcı arayüzü görünümüdür.

    • ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metne dayalı bir öneriyi temsil eden ArticleEntity. ArticleEntity öğesi, geliştiricilerin, bilgileri GenericFeaturedEntity ile karşılaştırıldığında kullanıcılara ifade etmek için daha fazla meta veri içeren çeşitli metin ve resim içerikleri sağlamalarına olanak tanır. Ör. Pazarlama içeriği, Haber snippet'i

      Şekil 1: Öneriler kümesi içindeki tek bir ArticleEntity'yi gösteren kullanıcı arayüzü.

    • EventEntity: EventEntity, gelecekte olacak bir etkinliği temsil eder. Etkinlik başlangıç zamanı, kullanıcılara aktarılması gereken kritik bir bilgidir.

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

    • LodgingEntity: LodgingEntity; kısa ve uzun vadeli kiralama için otel, apartman, tatil evi gibi bir konaklama tesisini temsil eder.

      Şekil 3: Öneriler kümesi içindeki tek bir LodgingEntity gösteren kullanıcı arayüzü.

    • StoreEntity: StoreEntity bir mağaza, restoran, kafe vb. temsil eder. Bir yemek mekanının veya mağazanın, kullanıcılara aktarılması gereken kritik bilgi parçası olduğu içeriği vurgular.

      Şekil 4: Öneriler kümesi içindeki 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üş yolu gibi ilgi çekici yerleri temsil eder. Konumun, kullanıcılara iletilmesi gereken önemli bir bilgi parçası olduğu içeriği vurgular. Konaklama, mağaza veya yemek mekanı için kullanılmamalıdır.

      Şekil 5: Öneriler kümesi içindeki tek bir PointOfinterestEntity'yi gösteren kullanıcı arayüzü.

    • PersonEntity: PersonEntity, bir kişiyi temsil eder. Bir kişiyi sağlık ve fitness, spor, flört gibi kategorilerde öne çıkarmanız önerilir.

      Şekil 5: Recommendations kümesindeki tek bir PersonEntity'yi 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çeriği gösterir. Her geliştirici iş ortağının Devam kümesinde en fazla 10 varlık yayınlamasına izin verilecek.

    Devam içeriğiniz şu yapıyı alabilir:

    • ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. Bu öğe, kullanıcının bıraktığı yerden tüketmeye devam etmek istediği tamamlanmamış haber makalelerini veya diğer içerikleri temsil etmek için kullanılabilir. Ör. Pazarlama içeriği, Haber snippet'i

      Şekil 6. Bir Devamlılık kümesi içindeki tek bir ArticleEntity öğesini gösteren kullanıcı arayüzü.

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

      Şekil 7. Devamlılık kümesi içindeki tek bir RestaurantReservationEntity öğesini gösteren kullanıcı arayüzü.

    • EventReservationEntity: EventReservationEntity, bir etkinlik için 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
      • E-spor rezervasyonu gibi oyun etkinlikleri
      • Sinema, konser, tiyatro, kitap imzalama veya film rezervasyonu gibi eğlence etkinlikleri
      • Rehberli turlar, müze biletleri gibi seyahat veya önemli yer rezervasyonları
      • Sosyal / Seminer / Konferans rezervasyonları
      • Eğitim / Öğretim seans rezervasyonları
      Şekil 8. Bir Devamlılık kümesi içindeki tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü.

    • LodgingReservationEntity: LodgingEntityReservation, bir seyahat konaklama yeri rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden otel ya da kiralık yer rezervasyonlarını takip etmesine yardımcı olur.

      Şekil 9. Bir Devamlılık kümesi içindeki tek bir LodgingReservationEntity'yi gösteren kullanıcı arayüzü.

    • TransportationReservationEntity: TransportationReservationEntity, herhangi bir modla ulaşım rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden uçuş, feribot, tren, otobüs, yolculuk rezervasyonu veya gemi seyahati rezervasyonlarını takip etmesine yardımcı olur.

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

    • VehicleRentalReservationEntity: VehicleRentalReservationEntity rezervasyonu, 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. Bir Continuation kümesi içindeki tek VehicleRentalReservationEntity öğesini gösteren kullanıcı arayüzü.

  • Öne Çıkanlar kümesi, tek bir kullanıcı arayüzü gruplandırmasında birçok geliştirici iş ortağının seçilen hero GenericFeaturedEntity'sini gösteren bir kullanıcı arayüzü görünümüdür. Kullanıcı arayüzünün üst kısmına yakın bir yerde gösterilen tek bir Öne Çıkan küme vardır. Bu küme, tüm Öneri kümelerinin üzerinde bir öncelik yerleşimine sahiptir. Her geliştirici iş ortağının Öne Çıkanlar kümesindeki birden fazla uygulama geliştiricisinden gelen birçok varlıkla (muhtemelen farklı türlerde) desteklenen türde tek bir varlık yayınlamasına izin verilir.

    • GenericFeatureEntity: Öneri öğesinden farklıdır. Öne çıkan öğenin geliştiricilerden tek bir üstteki içerik için kullanılması ve kullanıcılar açısından ilgi çekici ve alakalı olacak en önemli içeriği temsil etmesi gerekir.

      Şekil 12: Öne çıkan kümedeki tek bir hero GenericFeaturedEntity kartını gösteren kullanıcı arayüzü

Çalışma öncesi

Minimum API düzeyi: 19

com.google.android.play:engage 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.4.1'
}

Özet

Tasarım, bağlı bir 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 varlık sınırları Bir kümedeki maksimum varlık sınırları
Öneri Kümeleri En fazla 5 En az 5 En fazla 25 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity, PointOfInterestEntity veya PersonEntity)
Devam Kümesi En fazla 1 En az 1 En fazla 10 (ArticleEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity veya VehicleRentalReservationEntity)
Öne Çıkan Küme En fazla 1 En az 1 En fazla 10 (GenericFeaturedEntity)

1. adım: Varlık verileri sağlayın

SDK, her bir öğe türünü temsil edecek farklı varlıklar tanımlamıştır. Diğer kategorisi için aşağıdaki varlıkları destekliyoruz:

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

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

GenericFeaturedEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

URI
Poster resimleri Zorunlu

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

Not: Rozet verilmişse lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir.

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

  • Ör. "Canlı güncelleme"
  • Ör. 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: maks. 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde 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

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

ArticleEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Serbest metin

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

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

Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğ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 bildirenin adı

Serbest metin

Önerilen metin boyutu: 25 karakterin altında
Kaynak - Resim İsteğe bağlı Yazar, kuruluş, muhabir gibi kaynağın resmi Yardım için Resim Özellikleri bölümüne bakın.
Açıklama İsteğe bağlı

Varlığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Rozetler İsteğe bağlı

Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir.

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

  • Ör. "Canlı güncelleme"
  • Ör. 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: maks. 15 karakter
Rozet - Resim İsteğe bağlı

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde 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ı İçeriğin uygulamada yayınlandığı / güncellendiği zamanı gösteren milisaniye cinsinden sıfır zaman damgasıdır. Milisaniye cinsinden dönem zaman damgası
Son Etkileşim Zamanı Koşula Bağlı Olarak Gerekli

Kullanıcının bu varlıkla en son etkileşim kurduğunda oluşan milisaniye cinsinden sıfır zaman damgası.

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

 Milisaniye cinsinden dönem zaman damgası
İlerleme Yüzdesi Koşula Bağlı Olarak Gerekli

Bugüne kadar kullanıcı tarafından tüketilen tüm içeriğin yüzdesi.

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

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

Sıralama Listesi

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

EventEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Dize

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

Etkinliğin başlamasının beklendiği dönem zaman damgası.

Not: Bu, milisaniye cinsinden gösterilir.

 Milisaniye cinsinden dönem zaman damgası
Etkinlik modu Zorunlu

Etkinliğin sanal mı, yüz yüze mi yoksa her ikisini de mi olacağını belirten bir alan.

 Sıralama: VIRTUAL, IN_PERSON veya HYBRID
Poster resimleri Zorunlu

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

Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

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

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

Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Şehir Koşula Bağlı Olarak Gerekli

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

Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Görünen Adres Koşula Bağlı Olarak Gerekli

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

Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Posta kodu İsteğe bağlı Etkinliğin barındırıldığı konumun posta kodu (varsa).

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Bitiş zamanı İsteğe bağlı

Etkinliğin sona ermesinin beklendiği dönem zaman damgası.

Not: Bu, milisaniye cinsinden gösterilir.

 Milisaniye cinsinden dönem zaman damgası
Açıklama İsteğe bağlı

Varlığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Rozetler İsteğe bağlı

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

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

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

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde 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şula bağlı olarak gerekli

Etkinlik biletinin/kartın mevcut fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Etkinlik biletinin/kartın orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

Uygun Sıralamalar Listesi

  • TYPE_MovieS_AND_TV_SHOWS (ör. Sinema)
  • TYPE_DIGITAL_GAMES (ör. e-Spor)
  • TYPE_MUSIC (ör. Konser)
  • TYPE_TRAVEL_AND_LOCAL (Ör. Turne, festival)
  • TYPE_HEALTH_AND_FITENESS (ör. Yoga dersi)
  • TYPE_EDUCATION (ör. Sınıf)
  • TYPE_SPORTS (ör. Futbol maçı)
  • TYPE_DATING (ör. buluşma)

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

LodgingEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Dize

Önerilen metin boyutu: Maksimum 50 karakter
Poster resimleri Zorunlu

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

Not: Rozet verilmişse lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

Yardım için Resim Özellikleri bölümüne bakın.
Konum - Ülke Zorunlu Konaklama tesisinin bulunduğu ülke.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Şehir Zorunlu Konaklama tesisinin bulunduğu şehir.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Görünen Adres Zorunlu Kullanıcıya gösterilecek konaklama tesisinin adresidir.

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Rozetler İsteğe bağlı

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

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

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

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı).

Not: Rozet 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
AvailabilityWindow - Başlangıç Zamanı İsteğe bağlı Barınmanın açık/kullanılabilir olması beklendiğinde milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
AvailabilityWindow - Bitiş Zamanı İsteğe bağlı Konaklamanın açık/kullanılabilir olması beklenen milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Puan - Maksimum değer İsteğe bağlı

Kullanıcı oyu ölçeğinin maksimum değeri.

Puanın mevcut değeri de sağlanırsa sağlanmalıdır.

 Sayı >= 0,0
Puan - Geçerli değer İsteğe bağlı

Kullanıcı oyu ölçeğinin mevcut değeri.

Maksimum puan değeri de sağlanırsa sağlanmalıdır.

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

Konaklama tesisine ait puan sayısıdır.

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

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

Konaklama tesisine ait puan sayısıdır.

Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız

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

Konaklama tesisinin mevcut fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Konaklama biriminin, kullanıcı arayüzünde üstü çizili olan orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

StoreEntity

StoreEntity nesnesi, geliştirici iş ortaklarının yayınlamak istediği restoran veya market gibi bağımsız bir mağazayı 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'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: 45 karakterden az (Çok uzun olan metinlerde üç nokta gösterilebilir)
Açıklama metni İsteğe bağlı Varsa mağazayla ilgili bir tanıtımı, etkinliği veya güncellemeyi öne çıkaran açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden az (Çok uzun olan metinlerde üç nokta gösterilebilir)
Açıklama metni açıklama metni İsteğe bağlı Açıklama metni için hassas metin.

Serbest metin

Önerilen metin boyutu: 45 karakterden az (Çok uzun olan metinlerde üç nokta gösterilebilir)
Açıklama İsteğe bağlı Mağazayla ilgili açıklama.

Serbest metin

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

Kullanıcı oyu ölçeğinin maksimum değeri.

Puanın mevcut değeri de sağlanırsa sağlanmalıdır.

 Sayı >= 0,0
Puan - Geçerli değer İsteğe bağlı

Kullanıcı oyu ölçeğinin mevcut değeri.

Maksimum puan değeri de sağlanırsa sağlanmalıdır.

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

Konaklama tesisine ait puan sayısıdır.

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

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

Konaklama tesisine ait puan sayısıdır.

Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız

 Uzun

PointOfInterestEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Dize

Önerilen metin boyutu: Maksimum 50 karakter
Poster resimleri Zorunlu

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

Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

 Yardım için Resim Özellikleri bölümüne bakın.
Konum - Ülke Zorunlu Önemli yerin bulunduğu ülke.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Şehir Zorunlu Önemli yerin bulunduğu şehir.

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Eyalet İsteğe bağlı Önemli yerin bulunduğu eyalet veya il (varsa).

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum: Mahalle İsteğe bağlı Önemli yerin bulunduğu mahalle (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
AvailabilityWindow - Başlangıç Zamanı İsteğe bağlı Önemli yerin açık/kullanılabilir olması beklenen milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
AvailabilityWindow - Bitiş Zamanı İsteğe bağlı Önemli yerin açık/kullanılabilir olması beklenen milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Rozetler İsteğe bağlı

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

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

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

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı).

Not: Rozet 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Puan - Maksimum değer İsteğe bağlı

Kullanıcı oyu ölçeğinin maksimum değeri.

Puanın mevcut değeri de sağlanırsa sağlanmalıdır.

 Sayı >= 0,0
Puan - Geçerli değer İsteğe bağlı

Kullanıcı oyu ölçeğinin mevcut değeri.

Maksimum puan değeri de sağlanırsa sağlanmalıdır.

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

Önemli noktaya ilişkin kullanıcı oylarının sayısı.

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

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

Önemli noktaya ilişkin kullanıcı oylarının sayısı.

Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız

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

Önemli yer için biletlerin/giriş biletinin geçerli fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Önemli yer için biletlerin/giriş biletinin orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

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

Uygun Sıralamalar Listesi

  • TÜR_TRAVEL_VE_YEREL
  • TYPE_MovieS_AND_TV_SHOWS (ör. sinema)
  • TYPE_MEDICAL (ör. hastane)
  • TYPE_EDUCATION (ör. okul)
  • TYPE_SPORTS (ör. stadyum)

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

PersonEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

URI
Profil - Ad Zorunlu Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Doğru", "@TeamPixel" vb.)

Dize

Önerilen metin boyutu: Maksimum 50 karakter
Profil - Avatar Zorunlu

Kullanıcının profil resmi veya avatar resmi.

Not: Kare 1:1 resim olmalıdır.

 Yardım için Resim Özellikleri bölümüne bakın.
Profil - Ek Metin İsteğe bağlı Profil herkese açık kullanıcı adı gibi serbest metinler.

Serbest metin

Önerilen metin boyutu: Maksimum 15 karakter
Profil - Ek Resim İsteğe bağlı Doğrulanmış rozet gibi küçük bir resim. Yardım için Resim Özellikleri bölümüne bakın.
Başlık resmi İsteğe bağlı

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

Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

 Yardım için Resim Özellikleri bölümüne bakın.
Popülerlik - Sayı İsteğe bağlı

Başlık resmini temsil eder. Profil resminden farklı olmalıdır. Bu, kişiyi çalışması gibi öne çıkarmaya yardımcı olacak ek bir resim varsa kullanılabilir.

Not: Resim 16:9 olmalıdır. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

Dize

Önerilen metin boyutu: Sayı ve etiket toplamı için maksimum 20 karakter
Popülerlik - Sayı Değeri İsteğe bağlı

Takipçi sayısı veya popülerlik değeri.

Not: Uygulamanız, büyük bir sayının farklı ekran boyutları için nasıl optimize edilmesi gerektiğiyle ilgili mantığı işlemek istemiyorsa Sayı Değeri sağlayın. Hem Sayım hem de Sayma Değeri sağlanırsa Sayım kullanılır.

Uzun
Popülerlik - Etiket İsteğe bağlı Popülerlik etiketinin ne olduğunu belirtin. Örneğin, "Beğeniler".

Dize

Önerilen metin boyutu: Sayı ve etiket toplamı için maksimum 20 karakter
Popülerlik - Görsel İsteğe bağlı

Etkileşimin ne için olduğunu belirtin. Örneğin, Beğeniler simgesinin, Emojilerin gösterildiği resim.

1'den fazla resim sağlanabilir ancak tüm form faktörlerinde tüm resimler gösterilmeyebilir.

Not: Kare 1:1 resim olmalıdır.

 Yardım için Resim Özellikleri bölümüne bakın.
Puan - Maksimum değer Zorunlu

Kullanıcı oyu ölçeğinin maksimum değeri.

Puanın mevcut değeri de sağlanırsa sağlanmalıdır.

 Sayı >= 0,0
Puan - Geçerli değer Zorunlu

Kullanıcı oyu ölçeğinin mevcut değeri.

Maksimum puan değeri de sağlanırsa sağlanmalıdır.

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

Varlığa ilişkin puan sayısı.

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

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

Varlığa ilişkin puan sayısı.

Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız

 Uzun
Konum - Ülke İsteğe bağlı Kişinin bulunduğu veya hizmet sunduğu ülke.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Şehir İsteğe bağlı Kişinin bulunduğu veya hizmet sunduğu şehir.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Görünen Adres İsteğe bağlı Kişinin bulunduğu veya hizmet sunduğu adres kullanıcıya gösterilir.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Açık Adres İsteğe bağlı Kişinin bulunduğu veya hizmet verdiği yerin açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Eyalet İsteğe bağlı Kişinin bulunduğu veya hizmet sunduğu eyalet (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Posta kodu İsteğe bağlı Kişinin bulunduğu veya servisi yaptığı yerin posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum: Mahalle İsteğe bağlı Kişinin bulunduğu veya hizmet sunduğu mahalle (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Rozetler İsteğe bağlı

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

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

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

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı).

Not: Rozet 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
İçerik Kategorileri İsteğe bağlı Varlıktaki içeriğin kategorisini açıklayın.

Uygun Sıralamalar Listesi

  • TYPE_HEALTH_AND_FITENESS (ör. Yoga/fitness eğitmeni)
  • TYPE_HOME_AND_AUTO (Ör. Tesisatçı)
  • TYPE_SPORTS (Ör. Oyuncu)
  • TYPE_DATING

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

RestaurantReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Dize

Önerilen metin boyutu: Maksimum 50 karakter
Rezervasyon Başlangıç Zamanı Zorunlu Rezervasyonun başlamasının beklendiği milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Konum - Ülke Zorunlu Restoranın açıldığı ülke.

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Poster resimleri İsteğe bağlı Birden fazla resim sağlandığında yalnızca 1 görsel 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Masa Boyutu İsteğe bağlı Rezervasyon grubundaki kişi sayısı Tam sayı > 0

EventReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Dize

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

Etkinliğin başlamasının beklendiği dönem zaman damgası.

Not: Bu, milisaniye cinsinden gösterilir.

 Milisaniye cinsinden dönem zaman damgası
Etkinlik modu Zorunlu

Etkinliğin sanal mı, yüz yüze mi yoksa her ikisini de mi olacağını belirten bir alan.

 Sıralama: VIRTUAL, IN_PERSON veya HYBRID
Konum - Ülke Koşula Bağlı Olarak Gerekli

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

Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Şehir Koşula Bağlı Olarak Gerekli

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

Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Görünen Adres Koşula Bağlı Olarak Gerekli

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

Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Posta kodu İsteğe bağlı Etkinliğin barındırıldığı konumun posta kodu (varsa).

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Poster resimleri İsteğe bağlı

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

Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğ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 dönem zaman damgası.

Not: Bu, milisaniye cinsinden gösterilir.

 Milisaniye cinsinden dönem 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. Ör. Etkinliği 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Rozetler İsteğe bağlı

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

Rozetin başlığı

Not: Rozet için metin veya resim gereklidir.

Serbest metin

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

Küçük resim

Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde 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şula bağlı olarak gerekli

Etkinlik biletinin/kartın mevcut fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Etkinlik biletinin/kartın orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

Kullanıcı oyu ölçeğinin maksimum değeri.

Puanın mevcut değeri de sağlanırsa sağlanmalıdır.

 Sayı >= 0,0
Puan - Geçerli değer İsteğe bağlı

Kullanıcı oyu ölçeğinin mevcut değeri.

Maksimum puan değeri de sağlanırsa sağlanmalıdır.

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

Etkinliğe ilişkin kullanıcı oylarının sayısı.

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

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

Etkinliğe ilişkin kullanıcı oylarının sayısı.

Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız

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

Uygun Sıralamalar Listesi

  • TYPE_MovieS_AND_TV_SHOWS (ör. Sinema)
  • TYPE_DIGITAL_GAMES (ör. e-Spor)
  • TYPE_MUSIC (ör. Konser)
  • TYPE_TRAVEL_AND_LOCAL (Ör. Turne, festival)
  • TYPE_HEALTH_AND_FITENESS (ör. Yoga dersi)
  • TYPE_EDUCATION (ör. Sınıf)
  • TYPE_SPORTS (ör. Futbol maçı)
  • TYPE_DATING (ör. buluşma)

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

LodgingReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Serbest metin. Ör. "12 Aralık'tan itibaren Konaklamanız"

Önerilen metin boyutu: Maksimum 50 karakter
Giriş Saati Zorunlu Rezervasyon için giriş zamanını temsil eden milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Çıkış Saati Zorunlu Rezervasyon için çıkış zamanını temsil eden milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Konum - Ülke Zorunlu Konaklama tesisinin bulunduğu ülke.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Şehir Zorunlu Konaklama tesisinin bulunduğu şehir.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Konum - Görünen Adres Zorunlu Kullanıcıya gösterilecek konaklama tesisinin adresidir.

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Poster resimleri İsteğe bağlı

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

Not: Rozet verilmişse lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun

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

Varlığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Rezervasyon Kimliği İsteğe bağlı Konaklama rezervasyonunun rezervasyon kimliği. Serbest metin
Puan - Maksimum değer İsteğe bağlı

Kullanıcı oyu ölçeğinin maksimum değeri.

Puanın mevcut değeri de sağlanırsa sağlanmalıdır.

 Sayı >= 0,0
Puan - Geçerli değer İsteğe bağlı

Kullanıcı oyu ölçeğinin mevcut değeri.

Maksimum puan değeri de sağlanırsa sağlanmalıdır.

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

Konaklama tesisine ait puan sayısıdır.

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

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

Konaklama tesisine ait puan sayısıdır.

Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız

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

Konaklama tesisinin mevcut fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Konaklama biriminin, kullanıcı arayüzünde üstü çizili olan orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

TransportationReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Serbest metin. Ör. "SFO'dan SAN'ye"

Önerilen metin boyutu: Maksimum 50 karakter
Ulaşım Türü Zorunlu Rezervasyona ilişkin ulaşım modu/türü. Sıralama: FLIGHT, TRAIN, BUS veya FERRY
Kalkış Zamanı Zorunlu Kalkış saatini temsil eden milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Varış Saati Zorunlu Varış saatini temsil eden, milisaniye cinsinden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Kalkış Konumu - Ülke İsteğe bağlı Kalkış ülkesi.

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Kalkış Konumu - Mahalle İsteğe bağlı Kalkış konumunun bulunduğu mahalle (varsa).

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Varış Konumu - Mahalle İsteğe bağlı Varış konumunun bulunduğu mahalle (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~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. Ör. Havayolu 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 görsel 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Rezervasyon Kimliği İsteğe bağlı Ulaşım rezervasyonunun rezervasyon kimliği. Serbest metin
Fiyat - CurrentPrice Koşula bağlı olarak gerekli

Rezervasyonun mevcut fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Rezervasyonun, kullanıcı arayüzünde üstü çizili olan orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

VehicleRentalReservationEntity

Özellik Şartlar Açıklama Biçim
İşlem URI'sı Zorunlu

Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı.

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

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

Serbest metin. Ör. "Avis Union Square SF"

Önerilen metin boyutu: Maksimum 50 karakter
Teslim Alma Zamanı Zorunlu Rezervasyonun teslim alınma zamanını temsil eden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Dönüş Saati İsteğe bağlı Rezervasyonun çıkış zamanını temsil eden sıfır zaman damgası. Milisaniye cinsinden dönem zaman damgası
Alınacağı Adres - Ülke İsteğe bağlı Teslim alma konumunun ülkesi.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Alınacağı Adres - Şehir İsteğe bağlı Teslim alınacağı yerin şehri.

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Alınacağı Adres - Eyalet İsteğe bağlı Teslim alma konumunun eyaleti veya ili (varsa).

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
Teslim Alma Adresi - Posta kodu İsteğe bağlı Teslim alma konumunun posta kodu (varsa).

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
İade Adresi - Ülke İsteğe bağlı İade konumunun ülkesi.

Serbest metin

Önerilen metin boyutu: maks. ~20 karakter
İade Adresi - Şehir İsteğe bağlı Dönüş konumunun şehri.

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: maks. ~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. Ör. "Avis Araç Kiralama"
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 görsel 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ığı açıklayan tek bir metin paragrafı.

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

Serbest metin

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

Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı.

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

Serbest metin

Her alt başlık için önerilen metin boyutu: maks. 50 karakter
Onay Kimliği İsteğe bağlı Araç kiralama rezervasyonunun onay kimliği. Serbest metin
Fiyat - CurrentPrice Koşula bağlı olarak gerekli

Rezervasyonun mevcut fiyatı.

Üstü çizili fiyat varsa sağlanmalıdır.

Serbest metin
Fiyat - Üstü çizili fiyat İsteğe bağlı Rezervasyonun, kullanıcı arayüzünde üstü çizili olan orijinal fiyatı. Serbest metin
Fiyat Açıklama Metni İsteğe bağlı Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni.

Serbest metin

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

Resim özellikleri

Resim öğeleri için gerekli özellikler aşağıdaki 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 960 x 1.200

Google'ın bu görüntülere erişebilmesi için görüntülerin 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örüntülenebilmesi için şeffaf bir arka plan kullanın.

İçerik Kategorisi

İçerik kategorisi, uygulamaların birden fazla kategoriye ait içerikleri yayınlamasına olanak tanır. Bu işlem, içeriği önceden tanımlanmış bazı kategorilerle eşler:

  • 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 bu 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. ArticleEntity ve GenericFeaturedEntity gibi bazı varlıklar, içerik kategorilerinden herhangi birini kullanmaya uygundur. EventEntity, EventReservationEntity, PointOfinterestEntity gibi diğer varlıklar için bu kategorilerin yalnızca bir alt kümesi uygundur. Listeyi doldurmadan önce bir varlık türü için uygun kategorilerin listesini kontrol edin.

  2. Genel varlıklar ve ContentCategory bir kombinasyonu yerine bazı içerik kategorileri için belirli öğe türünü kullanın:

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

  4. Birden fazla içerik kategorisi sağlanmışsa bunları içerikle alaka düzeyine göre sıralayarak en alakalı içerik kategorisi listede ilk sırada gösterin.

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

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

AppEngagePublishClient, kümeleri yayınlamaktan sorumludur.

Kümeleri istemcide yayınlamak için aşağıdaki API'ler mevcuttur:

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

isServiceAvailable

Bu API, hizmetin entegrasyon için uygun olup olmadığını ve içeriğin cihazda sunulup sunulmadığı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 nesnelerinin 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 tek işlem içinde aşağıdaki işlemler gerçekleştirilir:

  • Geliştirici iş ortağından alınan mevcut RecommendationCluster verileri kaldırılır.
  • İstekteki 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 nesnelerinin 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 işlem içinde aşağıdaki işlemler gerçekleştirilir:

  • Geliştirici iş ortağından alınan mevcut FeaturedCluster verileri kaldırılır.
  • İstekten elde edilen veriler ayrıştırılır ve güncellenmiş Öne Çıkan Küme'de depolanır.

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

publishContinuationCluster

Bu API bir ContinuationCluster nesnesini 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 işlem içinde aşağıdaki işlemler gerçekleştirilir:

  • Geliştirici iş ortağından alınan mevcut ContinuationCluster verileri kaldırılır.
  • İstekten elde edilen veriler ayrıştırılır ve güncellenen Devam Kümesi'nde 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 sağlayabilmesi) 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'sı Zorunlu İşlem için derin bağlantı (ör. uygulamada oturum açma sayfasına yönlendirir)
Resim İsteğe bağlı - Sağlanmamışsa başlık sağlanmalıdır

Kartta Gösterilen Resim

1264x712 çözünürlüklü 16x9 en boy oranına sahip resimler
Başlık İsteğe bağlı - Sağlanmazsa Resim sağlanmalıdır Kartın Başlığı
İşlem Metni İsteğe bağlı CTA'da gösterilen metin (ör. oturum açma)
Alt başlık İsteğe bağlı Kartta İsteğ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 tek işlem içinde aşağıdaki işlemler gerçekleştirilir:

  • Geliştirici iş ortağından alınan mevcut UserAccountManagementCluster verileri kaldırılır.
  • İstekteki veriler ayrıştırılır ve güncellenmiş UserAccountManagementCluster Kümesinde depolanır.

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

updatePublishStatus

İşle ilgili herhangi bir nedenle kümelerin hiçbiri yayınlanmazsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle öneririz. Bu önemlidir, çünkü :

  • İçerik yayınlandığında bile tüm senaryolarda durumun sağlanması (DURUM == YAYINLANDI), entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu uygunsuz durumu kullanan kontrol panellerinin doldurulması için kritik önem taşır.
  • Hiçbir içerik yayınlanmadıysa ancak entegrasyon durumu bozuk değilse (STATUS == NOT_PUBLISHED) Google, uygulama durumu kontrol panellerinde uyarı tetiklemekten kaçınabilir. Bu işlem, sağlayıcının açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
  • Geliştiricilerin, verilerin ne zaman yayınlanıp yayınlanmadığına dair analizler sağlamasına yardımcı olur.
  • Google, durum kodlarını kullanıcının uygulama içeriğini görüp aşması için uygulamada belirli işlemleri yapmasını teşvik etmek amacıyla kullanabilir.

Uygun yayınlama durum kodlarının listesi şu şekildedir :

// 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ı giriş yapmadığı için yayınlanmazsa Google, Oturum Açma Kartı'nın yayınlanmasını önerir. Sağlayıcılar Oturum Açma Kartını herhangi bir nedenle yayınlayamazsa updatePublishStatus API'sinin NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla çağrılmasını ö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ümenin 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ümesi içeriğini silmek için kullanılır.

Kotlin


client.deleteContinuationCluster()

Java


client.deleteContinuationCluster();

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

deleteUserManagementCluster

Bu API, UserAccountManagement Cluster'ın içeriğini silmek için kullanılır.

Kotlin


client.deleteUserManagementCluster()

Java


client.deleteUserManagementCluster();

Hizmet, isteği aldığında mevcut verileri UserAccountManagement Cluster'dan kaldırır. 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. Müşteriler bir veya daha fazla küme türünü geçirebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

Hata işleme

Yayınlama API'lerinden gelen 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 gerçekleştirilebilir.

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, neden hata kodu olarak eklenmiş şekilde AppEngageException biçiminde döndürülür.

Hata kodu Not
SERVICE_NOT_FOUND Hizmet belirtilen cihazda kullanılamıyor.
SERVICE_NOT_AVAILABLE Hizmet, belirtilen cihazda kullanılabilir ancak çağrı sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır).
SERVICE_CALL_EXECUTION_FAILURE İleti dizisi sorunları nedeniyle görev yürütülemedi. Bu durumda, işlem yeniden denenebilir.
SERVICE_CALL_PERMISSION_DENIED Arayanın servis araması yapma izni yok.
SERVICE_CALL_INVALID_ARGUMENT İstek geçersiz veriler içeriyor (örneğin, izin verilen küme sayısından fazla).
SERVICE_CALL_INTERNAL Hizmet tarafında bir hata var.
SERVICE_CALL_RESOURCE_EXHAUSTED Servis çağrısı çok sık yapılıyor.

3. Adım: Yayın amaçlarını ele alın

Bir iş aracılığıyla publish Content API çağrıları yapmaya ek olarak, bir içerik yayınlama isteğini almak için BroadcastReceiver kurulumu da gerekir.

Yayın amaçlarının amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın amaçları çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca İnternet Reklamcılığı Programı içeriğin eski olabileceğini (örneğin, bir haftalık) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süre çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimine sahip olabileceğine dair daha fazla güven duyulur.

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, hâlâ bellekte bulunan uygulamalardan iletişim kurulmasını sağlar.

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));

}
  • Statik olarak AndroidManifest.xml dosyanızda <receiver> etiketiyle bir uygulama tanımlayın. Bu, uygulamanın çalışmadığında yayın amaçlarını almasına ve aynı zamanda uygulamanın 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>

Aşağıdaki amaçlar hizmet tarafından gönderilir:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Bu niyeti alırken bir publishRecommendationClusters çağrısı başlatmanız önerilir.
  • com.google.android.engage.action.PUBLISH_FEATURED Bu amacı alırken bir publishFeaturedCluster çağrısı başlatmanız önerilir.
  • com.google.android.engage.action.PUBLISH_CONTINUATION Bu amacı alırken bir publishContinuationCluster çağrısı başlatmanız önerilir.

Entegrasyon iş akışı

Entegrasyonun tamamlandıktan sonra doğrulanmasıyla ilgili adım adım açıklamalı bir kılavuz için Geliştirici entegrasyonu iş akışını etkileşim kurma başlıklı makaleyi inceleyin.

SSS

SSS için Engage SDK'sı ile İlgili Sık Sorulan Sorular bölümüne bakın.

İletişim

Entegrasyon işlemi sırasında herhangi bir sorunuz olursa lütfen engagement-developers@google.com ile iletişime geçin.

Sonraki adımlar

Bu entegrasyonu tamamladıktan sonra uygulamanız gereken 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 gerçekleştirir ve dahili incelemeler yapar. Değişiklik yapılması gerekirse Google gerekli bilgileri vermek için sizinle iletişime geçer.
  • 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üncellenen 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.