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

Kullanıcılarınıza bulundukları yerde ulaşarak uygulama etkileşimini artırın. Engage SDK'yı entegre ederek Koleksiyonlar, Entertainment Space ve Play Store gibi cihaz üzerindeki birden fazla yüzeyde kullanıcılara doğrudan kişiselleştirilmiş öneriler ve devam içerikleri sunun. Entegrasyon, ortalama APK boyutuna 50 KB'tan daha az (sıkıştırılmış) ekler ve çoğu uygulamanın geliştirici süresini yaklaşık bir hafta uzatır. Daha fazla bilgi için işletme sitemizi ziyaret edin.

Bu kılavuzda, geliştirici iş ortaklarının seyahat ve etkinlik içeriklerini Engage içerik yüzeylerinde yayınlamasıyla ilgili talimatlar yer almaktadır.

Entegrasyon ayrıntıları

Terminoloji

Bu entegrasyon aşağıdaki küme türlerini içerir: Öneri, Öne Çıkanlar, Rezervasyon ve Aramaya Devam Et.

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

    • Öneri grubu ArticleEntity, EventEntity, LodgingEntity, PointOfInterestEntity veya StoreEntity listelemelerinden oluşabilir ancak farklı varlık türlerinin karışımından oluşamaz.

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

    • Öneri Kümesi: Aynı geliştirici iş ortağının önerilerinden oluşan bir grubu içeren 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 önerisini temsil eder. Makaleler, blog yayınları, pazarlama içerikleri, haber snippet'leri vb. için kullanılabilir.

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

      • EventEntity: EventEntity, gelecekte gerçekleşecek bir etkinliği temsil eder. Etkinlik başlangıç saati, 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, apartman, kiralık yer gibi bir konaklama tesisini temsil eder.

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

      • StoreEntity: StoreEntity, mağaza, restoran, kafe vb. yerleri temsil eder. Bir yemek yerinin veya mağazanın, kullanıcılara iletilmesi gereken kritik 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 alanı, tema parkı, müze, turistik yer, yürüyüş parkuru gibi ilgi çekici yerleri temsil eder. Konumun, kullanıcılara iletilmesi gereken kritik bir bilgi olduğu içerikleri vurgular. Konaklama, mağaza veya yemek yenecek yerler için kullanılmamalıdır.

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

  • Rezervasyon kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağının kullanıcılarının son zamanlarda etkileşimde bulunduğu içerikleri gösterir. Her geliştirici iş ortağı, Rezervasyon kümesinde en fazla 10 öğe yayınlayabilir.

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

    • RestaurantReservationEntity: RestaurantReservationEntity, restoran veya kafe rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden restoran rezervasyonlarını takip etmesine yardımcı olur.

      6.şekil Rezervasyon kümesinde tek bir RestaurantReservationEntity'yi gösteren kullanıcı arayüzü.

    • EventReservationEntity: EventReservationEntity, bir etkinliğin rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden etkinlik rezervasyonlarını takip etmesine 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
      • Sinemada film rezervasyonu, konser, tiyatro, kitap imza günü gibi eğlence etkinlikleri
      • Rehberli turlar, müze biletleri gibi seyahat veya ilgi çekici yer rezervasyonları
      • Sosyal etkinlikler / seminerler / konferanslar için rezervasyonlar
      • Eğitim / öğretim oturumları rezervasyonları
      7.şekil Bir rezervasyon kümesinde tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü.

    • LodgingReservationEntity: LodgingEntityReservation, seyahat konaklaması için yapılan rezervasyonu 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.

      8. şekil. Rezervasyon kümesinde tek bir LodgingReservationEntity'nin gösterildiği kullanıcı arayüzü.

    • TransportationReservationEntity: TransportationReservationEntity herhangi bir ulaşım moduyla yapılan rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden uçuş, feribot, tren, otobüs, taksi ya da gemi rezervasyonlarını takip etmesine yardımcı olur.

      9.şekil Bir rezervasyon kümesinde 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ı takip etmesine yardımcı olur.

      10. şekil. Rezervasyon kümesinde tek bir VehicleRentalReservationEntity'nin gösterildiği kullanıcı arayüzü.

  • Öne çıkanlar kümesi, birden fazla geliştirici iş ortağının seçilmiş öğelerini tek bir kullanıcı arayüzü grubunda 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 Öneri kümelerinin üzerinde öncelikli bir yerleşimle gösterilir. Her geliştirici iş ortağı, Öne Çıkan kümede en fazla 10 öğe yayınlayabilir.

    • GenericFeaturedEntity: GenericFeaturedEntity, Recommendation item'dan farklıdır. Featured item, geliştiricilerin tek bir üst düzey içeriği için kullanılmalı ve kullanıcıların ilgisini çekecek ve alakalı olacak en önemli tek içeriği temsil etmelidir.

      Şekil 11: Bir GenericFeaturedEntity listesi içeren Öne Çıkan Küme'nin gösterildiği kullanıcı arayüzü

  • Aramaya Devam Et kümesi, kullanıcının tüm seyahat uygulamalarında son zamanlarda aradığı arama sorgularının listesini göstererek kullanıcının önceki seyahat arama yolculuğuna devam etmesine yardımcı olur. Küme, rezervasyonlardan sonra, öne çıkan ve öneri kümelerinden önce ikinci konuma sabitlenir. Her geliştirici iş ortağı, Arama Devam Ettir kümesinde en fazla 3 öğe yayınlayabilir.

    • PointOfInterestEntity: PointOfInterestEntity, benzin istasyonu, etkinlik mekanı, tema parkı, müze, turistik yer, yürüyüş parkuru vb. gibi ilgi çekici bir yeri temsil eder. Kullanıcının daha önce aradığı içeriği vurgular.

Ön çalışma

Minimum API düzeyi: 19

Uygulamanıza com.google.android.engage:engage-core kitaplığını 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 7 En az 1 En fazla 50 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity veya PointOfInterestEntity)
Rezervasyon kümesi En fazla 1 En az 1 En fazla 20 (RestaurantReservationEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity veya VehicleRentalReservationEntity)
Öne Çıkan Küme En fazla 1 En az 1 En fazla 20 (GenericFeaturedEntity)
Arama kümesine devam etme En fazla 1 En az 1 En fazla 3 (PointOfInterestEntity)

1. adım: Tüzel kişi verilerini sağlayın

SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. Seyahat ve Etkinlikler kategorisinde aşağıdaki öğeler desteklenir:

  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ılabilir özellikler ve şartlar özetlenmiştir.

GenericFeaturedEntity

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

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

Not: Derin bağlantıları ilişkilendirme için 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 sağlanı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ığı açıklayan tek bir metin paragrafı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

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

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

Resmin/videonun üstünde özel kullanıcı deneyimi uygulaması. Örneğin, resmin üstünde 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 uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak).

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ı Öğedeki içeriğin kategorisini açıklayın.

Sıralamaların Listesi

Rehberlik için İçerik Kategorisi bölümüne bakın.
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

ArticleEntity

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

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

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

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

Serbest metin

Önerilen metin boyutu: Maks. 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 eklemeniz önemle tavsiye edilir. 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.
Kaynak - Başlık İsteğe bağlı Yazarın, kuruluşun veya muhabirin adı

Serbest metin

Önerilen metin boyutu: 25 karakterden az
Kaynak - Resim İsteğe bağlı Kaynakla ilgili bir resim (ör. yazar, kuruluş, muhabir) 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 alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

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

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

Resmin/videonun üstünde özel kullanıcı deneyimi uygulaması (ör. resmin üstünde 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 uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak).

Not: Rozet için metin veya resim gereklidir.

Yardım için Resim Özellikleri bölümüne bakın.
İçerik Yayınlama Zamanı İsteğe bağlı Bu, içeriğin uygulamada yayınlandığı / güncellendiği zamana ait milisaniye cinsinden epoch zaman damgasıdır. Milisaniye cinsinden dönem zaman damgası
Son Etkileşim Zamanı İsteğe bağlı

Kullanıcının bu öğeyle en son etkileşime girdiği zamana ait milisaniye cinsinden dönem zaman damgası.

Milisaniye cinsinden dönem zaman damgası
İlerleme yüzdesi İsteğe bağlı

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

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

Sıralamaların Listesi

Rehberlik için İçerik Kategorisi bölümüne bakın.
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

EventEntity

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

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

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

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

Dize

Önerilen metin boyutu: Maks. 50 karakter
Yerelleştirilmiş Başlangıç Saati - Zaman Damgası Zorunlu

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

 Joda-Time Instant
Yerelleştirilmiş başlangıç zamanı - Saat dilimi Zorunlu

Etkinliğin başlamasının beklendiği saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Etkinlik modu Zorunlu

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

 Enum: 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: Resim eklemeniz önemle tavsiye edilir. 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 Koşula bağlı olarak gerekli

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

Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Koşula bağlı olarak gerekli

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

Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Adresi Göster Koşula bağlı olarak gerekli

Etkinliğin yapılacağı ve kullanıcıya gösterilmesi gereken adres veya mekan adı.

Not: Bu, YÜZ YÜZE veya HİBRİT 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 yerin 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 dönemin zaman damgası.

Not: Bu değer 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 alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

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

Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir.
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 uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak).

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

Etkinliğin biletinin/kartının mevcut fiyatı.

Üstü çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Etkinliğin biletinin/kartının orijinal fiyatı. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için 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 Enum'ların Listesi

  • TYPE_MOVIES_AND_TV_SHOWS (Örnek: Sinema)
  • TYPE_DIGITAL_GAMES (Örnek: e-spor)
  • 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.
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

LodgingEntity

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

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

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

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

Dize

Önerilen metin boyutu: Maks. 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 bırakın.

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 - Adresi Göster Zorunlu Kullanıcıya gösterilecek adres. Çoğu kullanım alanı için şehir adını ve mümkünse eyalet veya ülke adını eklemenizi öneririz. Kullanıcı konumun yakınındaysa, konumu biliyorsa veya şehir küme başlığında yer alıyorsa yalnızca açık adresi ya da mahalleyi ekleyin. Açık adresi ekliyorsanız mümkün olduğunda kısaltmalar kullanarak (ör. "Cadde" için "Cad", "Bulvar" için "Blv") kısa bir adres girin.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Açık Adres İsteğe bağlı Konaklama yerinin 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 yerinin 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 bir resimdir.
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 uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak).

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 alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Her altyazı için önerilen metin boyutu: maks. 50 karakter
AvailabilityTimeWindow - Localized Start Time - Timestamp İsteğe bağlı Konaklama tesisinin açık/kullanılabilir olması beklenen dönemin zaman damgası. Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone İsteğe bağlı Konaklama tesisinin açık/kullanılabilir olması beklenen saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
AvailabilityTimeWindow - Localized End Time - Timestamp İsteğe bağlı Konaklama tesisinin açık/kullanılabilir olması beklenen dönemin sonundaki zaman damgası. Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone İsteğe bağlı Konaklama tesisinin açık/kullanılabilir olması beklenen saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Puan - Maksimum değer İsteğe bağlı

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

Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır.

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

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

Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir.

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

Konaklama yerinin puan sayısı.

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

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

Konaklama yerinin puan sayısı.

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

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

Konaklama yerinin mevcut fiyatı.

Üzeri çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Konaklamanın orijinal fiyatı, kullanıcı arayüzünde üstü çizili olarak gösterilir. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

StoreEntity

StoreEntity nesnesi, geliştirici iş ortaklarının yayınlamak istediği tek bir mağazayı temsil eder. Bu mağaza, kullanıcının seyahat deneyimiyle alakalı popüler bir yemek yeri veya restoran olabilir.

Ö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'si Zorunlu

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

Not: Derin bağlantıları ilişkilendirme için 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 metinlerde üç 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ı Varsa mağazanın promosyonunu, etkinliğini veya güncellemesini öne çıkaran açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Açıklama metnindeki ek bilgiler İsteğe bağlı Açıklama metninin 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 kısa (Çok uzun metinlerde üç nokta gösterilebilir)
Kategori İsteğe bağlı

Yemek yerleri bağlamında mağaza kategorisi, "Fransız", "Yeni Amerikan", "Ramen", "Fine Dining" gibi mutfak türleri olabilir.

Serbest metin

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

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

Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır.

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

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

Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir.

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

Konaklama yerinin puan sayısı.

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

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

Konaklama yerinin puan sayısı.

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

 Uzun
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

PointOfInterestEntity

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

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

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

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

Dize

Önerilen metin boyutu: Maks. 50 karakter
Poster resimleri Koşula bağlı olarak gerekli

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

Not: Öğenin öneri kümesinin bir parçası olması durumunda resim gereklidir. 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.
Son Etkileşim Zamanı Koşula bağlı olarak gerekli

Kullanıcının bu öğeyle en son etkileşimde bulunduğu anın epoch zaman damgası.

Not: Bu alan, öğe "arama kümesine devam et"in bir parçasıysa zorunludur.

 Joda-Time Instant
Konum - Ülke Koşula bağlı olarak gerekli

İlgi çekici noktanın bulunduğu ülke.

Not: Bu alan, varlık öneri kümesinin bir parçasıysa zorunludur.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Koşula bağlı olarak gerekli

İlgi çekici noktanın bulunduğu şehir.

Not: Bu alan, varlık öneri kümesinin bir parçasıysa zorunludur.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Adresi Göster Koşula bağlı olarak gerekli

Kullanıcıya gösterilecek adres. Mümkün olduğunda kısaltmalar kullanarak kısa bir adres girin (örneğin, "Street" için "St", "Avenue" için "Ave"). Bu dize, kullanıcının cihazına ve ayarlarına bağlı olarak kısaltılabilir. Net bir tanımlama için şehir adını ekleyin.

Not: Bu alan, varlık öneri kümesinin bir parçasıysa zorunludur.

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

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

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
AvailabilityTimeWindow - Localized Start Time - Timestamp İsteğe bağlı İlgi çekici yerin açık/kullanılabilir olması beklenen dönemin zaman damgası. Joda-Time Instant
AvailabilityTimeWindow - Localized Start Time - Timezone İsteğe bağlı İlgi çekici yerin açık/kullanılabilir olması beklenen saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
AvailabilityTimeWindow - Localized End Time - Timestamp İsteğe bağlı İlgi çekici yerin açık/kullanılabilir olması beklenen dönemin zaman damgası. Joda-Time Instant
AvailabilityTimeWindow - Localized End Time - Timezone İsteğe bağlı İlgi çekici yerin açık/kullanılabilir olması beklenen saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Rozetler İsteğe bağlı

Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir.
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 uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak).

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 alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

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

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

Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır.

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

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

Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir.

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

İlgi çekici yerin puanlarının sayısı.

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

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

İlgi çekici yerin puanlarının sayısı.

Not: Kısaltma mantığını kendiniz yönetmek istemiyorsanız bu alanı doldurun. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı'yı kullanırız.

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

İlgili önemli yerin biletlerinin/giriş kartının mevcut fiyatı.

Üstü çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Önemli yerin biletlerinin/giriş kartının orijinal fiyatı. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için 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 Enum'ları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.
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

RestaurantReservationEntity

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

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

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

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

Dize

Önerilen metin boyutu: Maks. 50 karakter
Yerelleştirilmiş Rezervasyon Başlangıç Saati - Zaman Damgası Zorunlu Rezervasyonun başlaması beklenen dönemin zaman damgası. Joda-Time Instant
Yerelleştirilmiş Rezervasyon Başlangıç Saati - Saat Dilimi Zorunlu Rezervasyonun başlaması beklenen saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.

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

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Her altyazı için önerilen metin boyutu: maks. 50 karakter
Tablo Boyutu İsteğe bağlı Rezervasyon grubundaki kişi sayısı Tamsayı > 0
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

EventReservationEntity

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

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

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

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

Dize

Önerilen metin boyutu: Maks. 50 karakter
Yerelleştirilmiş Başlangıç Saati - Zaman Damgası Zorunlu

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

 Joda-Time Instant
Yerelleştirilmiş başlangıç zamanı - Saat dilimi Zorunlu

Etkinliğin başlamasının beklendiği saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Etkinlik modu Zorunlu

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

 Enum: VIRTUAL, IN_PERSON veya HYBRID
Konum - Ülke Koşula bağlı olarak gerekli

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

Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Şehir Koşula bağlı olarak gerekli

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

Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Konum - Adresi Göster Koşula bağlı olarak gerekli

Etkinliğin yapılacağı ve kullanıcıya gösterilmesi gereken adres veya mekan adı.

Not: Bu, YÜZ YÜZE veya HİBRİT 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 yerin 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
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 eklemeniz önemle tavsiye edilir. 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.
Yerelleştirilmiş bitiş zamanı - Zaman damgası İsteğe bağlı

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

 Joda-Time Instant
Yerelleştirilmiş bitiş zamanı - saat dilimi İsteğe bağlı

Etkinliğin sona ermesinin beklendiği saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
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, 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 alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

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

Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir.
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 uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak).

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

Etkinliğin biletinin/kartının mevcut fiyatı.

Üstü çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Etkinliğin biletinin/kartının orijinal fiyatı. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için fiyat açıklama metni.

Serbest metin

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

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

Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır.

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

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

Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir.

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

Etkinliğin puan sayısı.

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

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

Etkinliğin puan sayısı.

Not: Kısaltma mantığını kendiniz yönetmek istemiyorsanız bu alanı doldurun. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı'yı kullanırız.

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

Uygun Enum'ların Listesi

  • TYPE_MOVIES_AND_TV_SHOWS (Örnek: Sinema)
  • TYPE_DIGITAL_GAMES (Örnek: e-spor)
  • 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.
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

LodgingReservationEntity

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

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

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

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

Serbest metin. Örneğin, "12 Aralık'tan İtibaren Konaklamanız"

Önerilen metin boyutu: Maks. 50 karakter
Yerelleştirilmiş Giriş Saati - Zaman Damgası Zorunlu Rezervasyonun check-in zamanını temsil eden dönem zaman damgası. Joda-Time Instant
Yerelleştirilmiş Giriş Saati - Saat Dilimi Zorunlu Rezervasyonun check-in saatinin bulunduğu saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Yerelleştirilmiş Çıkış Saati - Zaman Damgası Zorunlu Rezervasyonun check-out zamanını temsil eden dönem zaman damgası. Joda-Time Instant
Yerelleştirilmiş Çıkış Saati - Saat Dilimi Zorunlu Rezervasyonun çıkış saatinin bulunduğu saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Konum - Ülke Zorunlu Konaklama yerinin bulunduğu ülke.

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 - Adresi Göster Zorunlu Kullanıcıya gösterilecek adres. Mümkün olduğunda kısaltmalar kullanarak kısa bir adres girin (örneğin, "Street" için "St", "Avenue" için "Ave"). Bu dize, kullanıcının cihazına ve ayarlarına bağlı olarak kısaltılabilir. Net bir tanımlama için şehir adını ekleyin.

Serbest metin

Önerilen metin boyutu: en fazla 35 karakter
Konum - Açık Adres İsteğe bağlı Konaklama yerinin 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 yerinin 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 bırakın.

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 alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Her altyazı 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ı

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

Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır.

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

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

Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir.

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

Konaklama yerinin puan sayısı.

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

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

Konaklama yerinin puan sayısı.

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

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

Konaklama yerinin mevcut fiyatı.

Üzeri çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Konaklamanın orijinal fiyatı, kullanıcı arayüzünde üstü çizili olarak gösterilir. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

TransportationReservationEntity

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

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

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

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

Serbest metin. Örneğin, "SFO - SAN"

Önerilen metin boyutu: Maks. 50 karakter
Ulaşım Türü Zorunlu Rezervasyon için ulaşım şekli/türü. Enum: FLIGHT, TRAIN, BUS veya FERRY
Yerelleştirilmiş Kalkış Saati - Zaman Damgası Zorunlu Kalkış zamanını temsil eden dönem zaman damgası. Joda-Time Instant
Yerelleştirilmiş Kalkış Saati - Saat Dilimi Zorunlu Kalkış saatinin saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Yerelleştirilmiş Varış Saati - Zaman Damgası Zorunlu Varış zamanını temsil eden dönem zaman damgası. Joda-Time Instant
Yerelleştirilmiş Varış Saati - Saat Dilimi Zorunlu Varış saatinin saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Ulaşım Numarası Zorunlu Uçuş numarası, otobüs numarası, tren numarası veya feribot/gemi numarası. Serbest metin
Yerelleştirilmiş Uçağa Biniş Saati - Zaman Damgası Zorunlu Rezervasyonun biniş zamanını temsil eden dönem zaman damgası (varsa) Joda-Time Instant
Yerelleştirilmiş Uçağa Biniş Saati - Saat Dilimi Zorunlu Rezervasyonun biniş zamanının saat dilimi (varsa)

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Kalkış Konumu - Ülke İsteğe bağlı Kalkış ülkesi.

Serbest metin

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

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Kalkış yeri - Adresi görüntüleme İsteğe bağlı Kullanıcıya gösterilecek kalkış yeri.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Kalkış Yeri - Açık Adres İsteğe bağlı Kalkış yerinin açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Kalkış yeri - eyalet İsteğe bağlı Kalkış yerinin 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 - Semt İsteğe bağlı Kalkış yerinin bulunduğu mahalle (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 - Adresi görüntüleme İsteğe bağlı Kullanıcıya gösterilecek varış yeri.

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış Yeri - Açık Adres İsteğe bağlı Varış yerinin açık adresi (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Varış Konumu - Eyalet İsteğe bağlı Varış konumunun bulunduğu eyalet veya il (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 bulunduğu mahalle (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 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ığı açıklayan tek bir metin paragrafı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Her altyazı 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ı.

Üzeri çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Rezervasyonun orijinal fiyatı, kullanıcı arayüzünde üstü çizili olarak gösterilir. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

VehicleRentalReservationEntity

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

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

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

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

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

Önerilen metin boyutu: Maks. 50 karakter
Yerelleştirilmiş Teslim Alma Saati - Zaman Damgası Zorunlu Rezervasyonun teslim alma zamanını temsil eden dönem zaman damgası. Joda-Time Instant
Yerelleştirilmiş Teslim Alma Saati - Saat Dilimi Zorunlu Rezervasyonun teslim alma zamanının saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Yerelleştirilmiş İade Zamanı - Zaman Damgası İsteğe bağlı Rezervasyonun çıkış saatini temsil eden dönem zaman damgası. Joda-Time Instant
Yerelleştirilmiş İade Süresi - Saat Dilimi İsteğe bağlı Rezervasyonun çıkış saatinin saat dilimi.

Joda-Time DateTimeZone

Yönergeler için Saat Dilimi Özellikleri'ne bakın.
Teslim alınacak adres - Ü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: en fazla 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: en fazla 20 karakter
Teslim Alma Adresi - 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 konumunun bulunduğu eyalet veya il (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Teslim alınacak adres - Posta kodu İsteğe bağlı Teslim alma konumunun posta kodu (varsa).

Serbest metin

Önerilen metin boyutu: en fazla 20 karakter
Teslim alınacak adres - Mahalle İsteğe bağlı Teslim alma konumunun bulunduğu mahalle (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 bulunduğu eyalet veya il (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: en fazla 20 karakter
İade Adresi - Mahalle İsteğe bağlı İade konumunun bulunduğu mahalle (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 Car Rental"
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ığı açıklayan tek bir metin paragrafı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Önerilen metin boyutu: 180 karakter
Alt başlık listesi İsteğe bağlı

Her biri tek satırlık metin olan en fazla 3 altyazı.

Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez.

Serbest metin

Her altyazı 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ı.

Üzeri çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır.

Serbest metin
Fiyat - StrikethroughPrice İsteğe bağlı Rezervasyonun orijinal fiyatı, kullanıcı arayüzünde üstü çizili olarak gösterilir. Serbest metin
Fiyat açıklama metni İsteğe bağlı Varsa promosyon, etkinlik veya üye indirimi gibi özellikleri öne çıkarmak için fiyat açıklama metni.

Serbest metin

Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir)
DisplayTimeWindow (İsteğe bağlı) - İçeriğin yüzeyde gösterileceği bir zaman aralığı belirleyin
Başlangıç Zaman Damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası
Bitiş zaman damgası İsteğe bağlı

İçeriğin yüzeyde gösterilmeyeceği dönemin zaman damgası.

Ayarlanmazsa içerik, yüzeyde gösterilmeye uygun olur.

 Milisaniye cinsinden dönem zaman damgası

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 1200x1200
Yatay (1,91x1) 600x314 1200x628
Dikey (4x5) 480x600 960x1200

Google'ın 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 şekilde gösterilebilmesi için şeffaf bir arka plan kullanın.

Saat dilimi özellikleri

Ofset yerine kimliği (örneğin, "America/Los_Angeles") tercih edin (örneğin, "-07:00").

Örnek kullanım: DateTimeZone.forID("America/Los_Angeles")

İç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şler. 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 erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir.

İçerik kategorilerini kullanma yönergeleri

  1. ArticleEntity ve GenericFeaturedEntity gibi bazı öğeler, içerik kategorilerinin herhangi birini kullanabilir. EventEntity, EventReservationEntity, PointOfInterestEntity gibi diğer öğeler için bu kategorilerin yalnızca bir alt kümesi uygundur. Listeyi doldurmadan önce bir öğe türü için uygun olan kategorilerin listesini kontrol edin.

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

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

  4. Birden fazla içerik kategorisi sağlanması durumunda, bunları içerikle alaka düzeyine göre sıralayın. En alakalı içerik kategorisi listede ilk sırada yer almalıdır.

2. adım: Küme verilerini sağlama

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

AppEngageTravelClient, yayınlama kümelerinden sorumludur.

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

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishReservationCluster
  • publishContinueSearchCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteReservationCluster
  • deleteContinueSearchCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

Bu API, hizmetin entegrasyona uygun olup olmadığı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 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 bir işlemde aşağıdaki işlemler gerçekleşir:

  • Geliştirici iş ortağından alınan mevcut RecommendationCluster verileri kaldırılır.
  • İstekten gelen veriler ayrıştırılır ve güncellenen RecommendationCluster'da depolanır.

Hata 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 bir işlemde aşağıdaki işlemler gerçekleşir:

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

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

publishReservationCluster

Bu API, ReservationCluster nesnesini yayınlamak için kullanılır.

Kotlin

client.publishReservationCluster(
    PublishReservationClusterRequest.Builder()
      .setReservationCluster(
        ReservationCluster.Builder()
          .addLodgingReservationEntity(lodgingReservationEntity)
          .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
          .addTransportationReservationEntity(transportationReservationEntity)
          .addEventReservationEntity(eventReservationEntity)
          .addRestaurantReservationEntity(restaurantReservationEntity)
          .build())
      .build())

Java

client.publishReservationCluster(
            new PublishReservationClusterRequest.Builder()
                .setReservationCluster(
                    new ReservationCluster.Builder()
                        .addLodgingReservationEntity(lodgingReservationEntity)
                        .addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
                        .addTransportationReservationEntity(transportationReservationEntity)
                        .addEventReservationEntity(eventReservationEntity)
                        .addRestaurantReservationEntity(restaurantReservationEntity)
                        .build())
                .build());

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

  • Geliştirici iş ortağından alınan mevcut ReservationCluster verileri kaldırılır.
  • İstekten gelen veriler ayrıştırılır ve güncellenen ReservationCluster'da depolanır.

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

publishContinueSearchCluster

Bu API, ContinueSearchCluster nesnelerinin listesini yayınlamak için kullanılır.

Kotlin

client.publishContinueSearchCluster(
    PublishContinueSearchClusterRequest.Builder()
      .setContinueSearchCluster(
        ContinueSearchCluster.Builder()
          .addPointOfInterestEntity(entity1)
          .addPointOfInterestEntity(entity2)
          .build())
      .build())

Java

client.publishContinueSearchCluster(
            new PublishContinueSearchClusterRequest.Builder()
                .setContinueSearchCluster(
                    new ContinueSearchCluster.Builder()
                        .addPointOfInterestEntity(entity1)
                        .addPointOfInterestEntity(entity2)
                        .build())
                .build());

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

  • Geliştirici iş ortağından alınan mevcut ContinueSearchCluster verileri kaldırılır.
  • İstekten gelen veriler ayrıştırılır ve güncellenen Arama Kümesine Devam Et'te depolanır.

Hata 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, kullanıcıları uygulamanın oturum açma sayfasına yönlendirir. Böylece uygulama, içerik yayınlayabilir (veya daha kişiselleştirilmiş içerikler sunabilir).

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

Özellik Şartlar Açıklama
İşlem URI'si Zorunlu İşleme derin bağlantı (ör. uygulama oturum açma sayfasına yönlendirir)
Resim İsteğe bağlıdır. Sağlanmazsa Başlık sağlanmalıdır.

Kartta Gösterilen Resim

1264x712 çözünürlüğünde 16:9 en boy oranına sahip resimler
Başlık İsteğe bağlıdır. Sağlanmazsa resim sağlanmalıdır. Kart üzerindeki başlık
İşlem Metni İsteğe bağlı CTA'da Gösterilen Metin (ör. Oturum açın)
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 bir işlemde aşağıdaki işlemler gerçekleşir:

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

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

updatePublishStatus

Herhangi bir dahili ticari nedenden dolayı kümelerin hiçbiri yayınlanmazsa updatePublishStatus API'yi kullanarak yayın durumunu güncellemenizi şiddetle tavsiye ederiz. Bu önemlidir, çünkü :

  • İçerik yayınlanmış olsa bile (STATUS == PUBLISHED) tüm senaryolarda durumu sağlamak, bu açık durumu kullanarak entegrasyonunuzun durumunu ve diğer metriklerini ileten kontrol panellerini doldurmak için kritik öneme sahiptir.
  • Hiçbir içerik yayınlanmamış ancak entegrasyon durumu bozulmamışsa (STATUS == NOT_PUBLISHED), Google, uygulama sağlığı kontrol panellerinde uyarı tetiklemeyi önleyebilir. İçeriğin, sağlayıcının bakış açısıyla beklenen bir durum nedeniyle yayınlanmadığını onaylar.
  • Geliştiricilerin, verilerin ne zaman yayınlandığına dair bilgi vermesine yardımcı olur.
  • Google, kullanıcıyı uygulamada belirli işlemleri yapmaya yönlendirmek için durum kodlarını kullanabilir. Böylece kullanıcılar uygulama içeriğini görebilir veya sorunu çözebilir.

Uygun yayınlama durumu kodlarının listesi :

// 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, oturum açmamış bir kullanıcı nedeniyle yayınlanmıyorsa Google, oturum açma kartının yayınlanmasını önerir. Herhangi bir nedenle sağlayıcılar Oturum Açma Kartı'nı yayınlayamıyorsa updatePublishStatus API'sinin NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla çağrılması önerilir.

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 Grupları'nın içeriğini silmek için kullanılır.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Hizmet isteği aldığında mevcut verileri Öneri Kümeleri'nden kaldırır. Hata 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 durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteReservationCluster

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

Kotlin

client.deleteReservationCluster()

Java

client.deleteReservationCluster();

Hizmet isteği aldığında mevcut verileri rezervasyon kümesinden kaldırır. Hata 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. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteContinueSearchCluster

Bu API, Arama Kümesine Devam Etme'nin içeriğini silmek için kullanılır.

Kotlin

client.deleteContinueSearchCluster()

Java

client.deleteContinueSearchCluster();

Hizmet, isteği aldığında mevcut verileri Arama Kümesine Devam Et'ten kaldırır. Hata 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_RESERVATION)
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      .addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
      .build())

Java

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

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

Hata işleme

Başarılı bir görevi kurtarmak ve yeniden göndermek için takip işlemi yapılabilmesi amacıyla, yayınlama API'lerinden gelen görev sonucunu dinlemeniz önemle tavsiye edilir.

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, nedenini içeren bir 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, söz konusu 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 İş parçacığı sorunları nedeniyle görev yürütme başarısız oldu. Bu durumda, işlem yeniden denenebilir.
4 SERVICE_CALL_PERMISSION_DENIED Arayan kullanıcının hizmet çağrısı yapmasına izin verilmiyor.
5 SERVICE_CALL_INVALID_ARGUMENT İstek geçersiz veriler içeriyor (örneğin, izin verilen küme sayısından daha fazla küme).
6 SERVICE_CALL_INTERNAL Hizmet tarafında bir hata var.
7 SERVICE_CALL_RESOURCE_EXHAUSTED Hizmet çağrısı çok sık yapılıyor.

3. adım: Yayın amaçlarını işleme

İçerik yayınlama API çağrılarını bir iş aracılığıyla yapmanın yanı sıra, içerik yayınlama isteğini almak için bir BroadcastReceiver oluşturmanız da gerekir.

Yayın niyetlerinin temel amacı, uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın amaçları çok sık gönderilmek üzere tasarlanmamıştır. Bu özellik yalnızca Engage Hizmeti, içeriğin eski olabileceğini (örneğin, bir hafta önce yayınlanmış) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süredir çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimi yaşayabileceğine dair daha fazla güven duyulur.

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

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

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 continue search cluster publish when PUBLISH_CONTINUE_SEARCH
  // broadcast is received
  // Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
  // received
}

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

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Continue Search Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)

// Register Reservation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                           com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                           /*scheduler=*/null)
}

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 continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received

// Trigger reservation cluster publish when PUBLISH_RESERVATION 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),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
                         new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
                         com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
                         /*scheduler=*/null);

}

  • <receiver> etiketiyle bir uygulamayı AndroidManifest.xml dosyanızda statik olarak bildirin. Bu, uygulamanın çalışmadığı zamanlarda yayın amaçlarını almasına ve içeriği yayınlamasına olanak tanır.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
      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.travel.PUBLISH_CONTINUE_SEARCH" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
      </intent-filter>
   </receiver>
</application>

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

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Bu amaç alındığında publishRecommendationClusters araması başlatılması önerilir.
  • com.google.android.engage.action.PUBLISH_FEATURED Bu amaç alındığında publishFeaturedCluster görüşmesi başlatılması önerilir.
  • com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH Bu amaç alındığında publishContinueSearchCluster araması başlatılması önerilir.
  • com.google.android.engage.action.travel.PUBLISH_RESERVATION Bu amaç alındığında publishReservationCluster araması başlatılması önerilir.

Entegrasyon iş akışı

Entegrasyonunuz tamamlandıktan sonra doğrulama ile ilgili adım adım kılavuz için Engage geliştirici entegrasyonu iş akışı başlıklı makaleyi inceleyin.

SSS

SSS için Engage SDK 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 adresiyle iletişime geçin.

Sonraki adımlar

Bu entegrasyonu tamamladıktan sonraki adımlarınız şunlardır:

  • engage-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 doğrulama yapar ve şirket içinde inceleme gerçekleştirir. Değişiklik yapılması gerekiyorsa Google, gerekli ayrıntıları paylaşmak için sizinle iletişime geçer.
  • Test tamamlandığında ve herhangi bir değişiklik yapılması gerekmediğinde Google, güncellenmiş ve entegre edilmiş 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 Çıkanlar, Rezervasyon ve Aramaya Devam Et kümeleriniz yayınlanabilir ve kullanıcılara gösterilebilir.