Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriği tüketimi ve keşfi için yeni bir sürükleyici deneyim sunan cihaz üzerinde bir yüzey oluşturuyor. Bu tam ekran deneyimi, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda sergileme fırsatı sunar.
Bu doküman, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak rezervasyonlar, etkinlikler, konaklama yerleri, ilgi çekici yerler, kişiler ve bu kategorilerin hiçbirine ait olmayan diğer içerikler gibi yeni içerikler entegre etmelerine yönelik talimatlar içerir.
Entegrasyon ayrıntısı
Terminoloji
Bu entegrasyon aşağıdaki üç küme türünü içerir: Öneri, Öne Çıkan ve Devam.
Öneri kümeleri, geliştirici iş ortaklarından kişiselleştirilmiş öneriler gösterir. Aynı geliştirici iş ortağının bir öneri grubunu içeren bir kullanıcı arayüzü görünümüdür.
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. ArticleEntity öğesi, geliştiricilerin GenericFeaturedEntity'ye kıyasla kullanıcılara bilgileri daha net bir şekilde aktarmak için daha fazla meta veri içeren çeşitli metin ve resim içerikleri sunmasına olanak tanır. Ör. Pazarlama içeriği, Haber snippet'i
Şekil 1: Öneriler kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü. EventEntity: EventEntity, gelecekte gerçekleşecek bir etkinliği temsil eder. Etkinlik başlangıç zamanı, kullanıcılara iletilmesi gereken kritik bir bilgidir.
Şekil 2: Öneriler kümesinde tek bir EventEntity'yi gösteren kullanıcı arayüzü. Konaklama birimi: Konaklama birimi, otel, apartman, kısa ve uzun süreli kiralık tatil evi gibi bir konaklama birimini temsil eder.
Şekil 3: Öneriler kümesinde tek bir LodgingEntity'yi gösteren kullanıcı arayüzü. StoreEntity: StoreEntity, bir mağazayı, restoranı, kafeyi vb. temsil eder. Bir yemek mekanının veya mağazanın kullanıcılara aktarılması gereken 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 mekanı, tema parkı, müze, turistik yer, yürüyüş parkuru gibi önemli yerleri temsil eder. Konumun, kullanıcılara aktarılması gereken kritik bir bilgi olduğu içerikleri vurgular. Konaklama, mağaza veya yemek mekanı için kullanılmamalıdır.
Şekil 5: Öneriler kümesinde tek bir PointOfInterestEntity gösteren kullanıcı arayüzü. PersonEntity: PersonEntity bir kişiyi temsil eder. Öneriler; sağlık ve fitness, spor, flört gibi kategorilerde bir kişiyi öne çıkarmak için olabilir.
Şekil 5: Öneriler kümesinde tek bir PersonEntity'yi gösteren kullanıcı arayüzü.
Devam kümesi, birden fazla geliştirici iş ortağının kullanıcılarının kısa süre önce etkileşimde bulunduğu içerikleri tek bir kullanıcı arayüzü gruplandırmasında gösterir. Her geliştirici iş ortağının, Devam kümesinde en fazla 10 öğe yayınlamasına izin verilir.
Devam içeriğiniz aşağıdaki yapıda olabilir:
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. Bu öğe, okunmamış haber makalelerini veya kullanıcının kaldığı yerden devam etmek istediği diğer içerikleri temsil etmek için kullanılabilir. Ör. Pazarlama içeriği, Haber snippet'i
Şekil 6. Devam kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü. RestaurantReservationEntity: RestaurantReservationEntity, bir restoran veya kafe için rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden restoran rezervasyonlarını izlemesine yardımcı olur.
Şekil 7. Devam kümesinde tek bir RestaurantReservationEntity'yi gösteren kullanıcı arayüzü. EventReservationEntity: EventReservationEntity, bir etkinlik rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden etkinlik rezervasyonlarını izlemesine yardımcı olur. Etkinlikler aşağıdakileri içerebilir ancak bunlarla sınırlı değildir:
- Futbol maçı rezervasyonu gibi spor etkinlikleri
- Espor rezervasyonu gibi oyun etkinlikleri
- Sinema rezervasyonu, konser, tiyatro, imza etkinliği gibi eğlence etkinlikleri
- Seyahat veya önemli yer rezervasyonları (ör. rehberli turlar, müze biletleri)
- Sosyal / Seminer / Konferans rezervasyonları
- Eğitim / eğitim oturumu rezervasyonları
Şekil 8. Devam kümesinde tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü. KonaklamaRezervasyonuÖğesi: KonaklamaRezervasyonuÖğesi, seyahat konaklama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden otel ya da kiralık yer rezervasyonlarını izlemesine yardımcı olur.
Şekil 9. Devam kümesinde tek bir LodgingReservationEntity'yi gösteren kullanıcı arayüzü. TransportationReservationEntity: TransportationReservationEntity, herhangi bir ulaşım modu için rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden uçuş, feribot, tren, otobüs, araç çağırma veya kruvaziyer rezervasyonlarını takip etmesine yardımcı olur.
Şekil 10. Devam kümesinde tek bir TransportationReservationEntity'yi gösteren kullanıcı arayüzü. VehicleRentalReservationEntity: VehicleRentalReservationEntity, araç kiralama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden araç kiralama rezervasyonlarını izlemesine yardımcı olur.
Şekil 11. Devam kümesinde tek bir VehicleRentalReservationEntity'yi gösteren kullanıcı arayüzü.
Öne Çıkan kümesi, birçok geliştirici iş ortağının seçili kahramanını
GenericFeaturedEntitytek bir kullanıcı arayüzü gruplandırmasında gösteren bir kullanıcı arayüzü görünümüdür. Tek bir Öne Çıkan küme vardır. Bu küme, kullanıcı arayüzünün üst kısmında, tüm Öneriler kümelerinin üzerinde öncelikli olarak gösterilir. Her geliştirici iş ortağının, Öne Çıkan'da desteklenen bir türde tek bir öğe yayınlamasına izin verilir. Bu öğe, Öne Çıkan kümesinde birden fazla uygulama geliştiriciye ait birçok öğeyle (muhtemelen farklı türlerde) birlikte yayınlanır.GenericFeaturedEntity: GenericFeaturedEntity, Öne Çıkan Öğe'nin geliştiricilerin en iyi içeriklerinden biri için kullanılması ve kullanıcılar için ilgi çekici ve alakalı olacak en önemli içeriği temsil etmesi bakımından Önerilen Öğe'den farklıdır.
Şekil 12: Öne Çıkan kümedeki tek bir hero GenericFeaturedEntity kartını gösteren kullanıcı arayüzü
Ön çalışma
Minimum API düzeyi: 19
com.google.android.engage:engage-core kitaplığını uygulamanıza ekleyin:
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.2'
}
Özet
Tasarım, bağlı hizmet uygulaması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,
PointOfInterestEntity veya PersonEntity) |
| Devam Kümesi | En fazla 1 | En az 1 | En fazla 20 (ArticleEntity,
EventReservationEntity,
LodgingReservationEntity,
TransportationReservationEntity veya
VehicleRentalReservationEntity) |
| Öne Çıkan Küme | En fazla 1 | En az 1 | En fazla 20 (GenericFeaturedEntity) |
1. adım: Öğe verilerini sağlayın
SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. Diğer kategorisi için aşağıdaki varlıkları destekleriz:
GenericFeaturedEntityArticleEntityEventEntityLodgingEntityStoreEntityPointOfInterestEntityPersonEntityRestaurantReservationEntityEventReservationEntityLodgingReservationEntityTransportationReservationEntityVehicleRentalReservationEntity
Aşağıdaki grafiklerde, her tür için kullanılabilen özellikler ve koşullar özetlenmiştir.
GenericFeaturedEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Rozet 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. |
| Başlık | İsteğe bağlı | Varlığın başlığı. | Serbest metin Önerilen metin boyutu: 50 karakter |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. Resim/videonun üstünde özel kullanıcı deneyimi işlemleri (ör. resim üzerinde rozet yer paylaşımı)
|
|
| 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 Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. 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 listesi Rehberlik için İçerik Kategorisi bölümüne bakın. |
ArticleEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Serbest metin Önerilen metin boyutu: En fazla 50 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel 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 kısa |
| Kaynak - Resim | İsteğe bağlı | Kaynağın resmi (ör. yazar, kuruluş, muhabir) | Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. Resim/videonun üstünde özel kullanıcı deneyimi işlemleri (ör. resime yerleştirilmiş rozet yer paylaşımı)
|
|
| 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 Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. 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 zamanın milisaniye cinsinden çağ zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Son Etkileşim Zamanı | Koşullu Olarak Zorunlu | Kullanıcının bu öğeyle son etkileşimde bulunduğu zamanın milisaniye cinsinden çağ zaman damgası. Not: Bu varlık devam kümesinin bir parçasıysa bu alan zorunludur. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| İlerleme Yüzdesi | Koşullu Olarak Zorunlu | Kullanıcının bugüne kadar tükettiği toplam içeriğin yüzdesi. Not: Bu varlık devam kümesinin bir parçasıysa bu alan zorunludur. |
0 ile 100 arasında (0 ve 100 dahil) bir tam sayı. |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Sıralamalar listesi Rehberlik için İçerik Kategorisi bölümüne bakın. |
EventEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan. |
Liste: VIRTUAL, IN_PERSON veya HYBRID |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin 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şullu Olarak Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Koşullu Olarak Zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görüntülenen Adres | Koşullu Olarak Zorunlu | Etkinliğin gerçekleşeceği adres veya mekan adı. Bu ad kullanıcıya gösterilmelidir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Etkinliğin düzenlendiği konumun sokak adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Etkinliğin düzenlendiği eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Etkinliğin düzenlendiği konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük 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 Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Fiyat - CurrentPrice | Koşullu olarak gerekli |
Etkinlik biletinin/geçişinin mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Etkinlik biletinin/geçişinin orijinal fiyatı. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun enumların listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
LodgingEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Poster resimleri | Zorunlu |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Konum - Ülke | Zorunlu | Konaklamanın gerçekleştiği ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Zorunlu | Konaklamanın gerçekleştiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görüntülenen Adres | Zorunlu | Kullanıcıya gösterilecek konaklama yerinin adresi. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Konaklama 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 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 Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. 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ık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| AvailabilityTimeWindow - Start Time | İsteğe bağlı | Konaklama tesisinin açık/kullanılabilir olmasının beklendiği zaman damgası (milisaniye cinsinden). | Milisaniye cinsinden Unix sıfır zaman damgası |
| AvailabilityTimeWindow - End Time | İsteğe bağlı | Konaklama tesisinin açık/kullanılabilir olmasının beklendiği zaman damgası (milisaniye cinsinden). | Milisaniye cinsinden Unix sıfır zaman damgası |
| Derecelendirme - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Mevcut değer | İsteğe bağlı | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Sayı | İsteğe bağlı | Konaklama biriminin aldığı puanların sayısı. Not: Uygulamanız sayının kullanıcılara nasıl gösterileceğini kontrol ediyorsa bu alanı sağlayın. Kısa bir dize kullanın. Örneğin, sayı 1.000.000 ise sayının daha küçük ekran boyutlarında kısaltılmaması için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Konaklama biriminin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara Sayı gösterilir. |
Uzun |
| Fiyat - CurrentPrice | Koşullu olarak gerekli | Konaklama yerinin mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Konaklama yerinin orijinal fiyatı. Bu fiyat, kullanıcı arayüzünde üstü çizili olarak gösterilir. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
StoreEntity
StoreEntity nesnesi, geliştirici iş ortaklarının yayınlamak istediği bağımsız bir mağazayı (ör. restoran veya market) temsil eder.
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| Poster resimleri | Zorunlu | En az bir resim sağlanmalıdır. | Yardım için Resim Özellikleri bölümüne bakın. |
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | İsteğe bağlı | Mağazanın adı. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun 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ı | Mağazanın promosyonunu, etkinliğini veya güncellemesini öne çıkaran açıklama metni (varsa). | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Açıklama metni ayrıntıları | İsteğe bağlı | Açıklama metni için küçük yazı metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Açıklama | İsteğe bağlı | Mağazanın açıklaması. | Serbest metin Önerilen metin boyutu: 90 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Derecelendirme - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Mevcut değer | İsteğe bağlı | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Sayı | İsteğe bağlı | Konaklama biriminin aldığı puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Konaklama biriminin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız |
Uzun |
PointOfInterestEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel 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 | Zorunlu | Önemli yerin bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Zorunlu | Önemli yerin gerçekleştiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görüntülenen Adres | Zorunlu | Kullanıcıya gösterilecek önemli yerin adresi. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Önemli yerin açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | İlgi çekici yerin bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Önemli yerin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Önemli yerin bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| AvailabilityTimeWindow - Start Time | İsteğe bağlı | Önemli yerin açık/kullanılabilir olmasının beklendiği zamana ait milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| AvailabilityTimeWindow - End Time | İsteğe bağlı | Önemli yerin açık/kullanılabilir olmasının beklendiği zaman (milisaniye cinsinden). | Milisaniye cinsinden Unix sıfır zaman damgası |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 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: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. 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ık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Derecelendirme - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Mevcut değer | İsteğe bağlı | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Sayı | İsteğe bağlı | Önemli yer için verilen puanların sayısı. Not: Uygulamanız sayının kullanıcılara nasıl gösterileceğini kontrol ediyorsa bu alanı sağlayın. Kısa bir dize kullanın. Örneğin, sayı 1.000.000 ise sayının daha küçük ekran boyutlarında kısaltılmaması için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Önemli yer için verilen puanların sayısı. Not: Gösterim kısaltma mantığını kendiniz yönetmiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara Sayı gösterilir |
Uzun |
| Fiyat - CurrentPrice | Koşullu olarak gerekli |
Önemli yer için biletlerin/giriş kartlarının mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Önemli yer için biletlerin/giriş kartlarının orijinal fiyatı. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. |
Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun enumların listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
PersonEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Profil - Ad | Zorunlu | Profil adı, kimliği veya herkese açık kullanıcı adı (ör. "Can Demir", "@TeamPixel" vb.). | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: 1:1 kare 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 metin. | Serbest metin Önerilen metin boyutu: En fazla 15 karakter |
| Profil - Ek Resim | İsteğe bağlı | Doğrulanmış rozet gibi küçük 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 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel 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. |
| Popülerlik - Sayı | İsteğe bağlı |
Takipçi sayısını veya popülerlik değerini belirtin.Örneğin: "3, 7 M". Not: Hem Count hem de Count Value sağlanırsa Count kullanılır. |
Dize Önerilen metin boyutu: sayı + etiket için en fazla 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 edileceğiyle ilgili mantığı işlemek istemiyorsa sayı değerini sağlayın. Hem Count hem de Count Value sağlanırsa Count 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ı + etiket için en fazla 20 karakter |
| Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin neyle ilgili olduğunu belirtin. Örneğin: Beğenme simgesini ve emojileri gösteren resim. 1'den fazla resim sağlanabilir ancak bunların hepsi tüm form faktörlerinde gösterilmeyebilir. Not: 1:1 kare resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Derecelendirme - Maksimum değer | Zorunlu | Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Mevcut değer | Zorunlu | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Sayı | İsteğe bağlı | Öğenin aldığı puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Öğenin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız |
Uzun |
| Konum - Ülke | İsteğe bağlı | Kullanıcının bulunduğu veya hizmet verdiği ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | İsteğe bağlı | Kullanıcının bulunduğu veya hizmet verdiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görüntülenen Adres | İsteğe bağlı | Kullanıcıya, kişinin bulunduğu veya hizmet verdiği adres gösterilir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği açık adres (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Kullanıcının bulunduğu veya hizmet verdiği eyalet (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Kullanıcının bulunduğu veya hizmet verdiği posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği 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 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 Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. 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ık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun enumların listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
RestaurantReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Rezervasyon Başlangıç Saati | Zorunlu | Rezervasyonun başlamasının beklendiği zaman damgası (milisaniye cinsinden). | Milisaniye cinsinden Unix sıfır zaman damgası |
| Konum - Ülke | Zorunlu | Restoranın bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Zorunlu | Restoranın bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görüntülenen Adres | Zorunlu | Kullanıcıya gösterilecek restoranın adresi. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Restoranın açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Restoranın bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Restoranın posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Restoranın bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. | Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Tablo boyutu | İsteğe bağlı | Rezervasyon grubundaki kişi sayısı | 0'dan büyük tam sayı |
EventReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal, yüz yüze veya her ikisi olacağını belirten bir alan. |
Liste: VIRTUAL, IN_PERSON veya HYBRID |
| Konum - Ülke | Koşullu Olarak Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Koşullu Olarak Zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Görüntülenen Adres | Koşullu Olarak Zorunlu | Etkinliğin gerçekleşeceği adres veya mekan adı. Bu ad kullanıcıya gösterilmelidir. Not: Bu, IN_PERSON veya HYBRID olan etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Etkinliğin düzenlendiği konumun sokak adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Etkinliğin düzenlendiği eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Etkinliğin düzenlendiği konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Görsel eklemeniz önemle tavsiye edilir. Rozet sağ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. |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Unix sıfır zaman damgası |
| Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Serbest metin. Örneğin, etkinlik düzenleyenin/turun adı |
| Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük 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 Resim/video küçük resminde rozet yer paylaşımı gibi özel kullanıcı deneyimi işlemleri. Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Rezervasyon kimliği | İsteğe bağlı | Etkinlik rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşullu olarak gerekli |
Etkinlik biletinin/geçişinin mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Etkinlik biletinin/geçişinin orijinal fiyatı. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Derecelendirme - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Mevcut değer | İsteğe bağlı | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Sayı | İsteğe bağlı | Etkinliğe verilen puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Etkinliğe verilen puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız |
Uzun |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun enumların listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
LodgingReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Serbest metin. Örneğin, "12 Aralık'taki konaklamanız" Önerilen metin boyutu: En fazla 50 karakter |
| Giriş saati | Zorunlu | Rezervasyonun giriş zamanını milisaniye cinsinden gösteren sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Çıkış saati | Zorunlu | Rezervasyonun çıkış saatini milisaniye cinsinden gösteren sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| 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 - Görüntülenen Adres | Zorunlu | Kullanıcıya gösterilecek konaklama yerinin adresi. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Konaklama 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 kullanılıyorsa resmin üst ve alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rezervasyon kimliği | İsteğe bağlı | Konaklama rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Derecelendirme - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Derecelendirmenin mevcut değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Mevcut değer | İsteğe bağlı | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Sayı | İsteğe bağlı | Konaklama biriminin aldığı puanların sayısı. Not: Uygulamanız bu öğenin kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1M gibi kısaltmalar kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Konaklama biriminin aldığı puanların sayısı. Not: Gösterim kısaltması mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı değerini kullanırız |
Uzun |
| Fiyat - CurrentPrice | Koşullu olarak gerekli | Konaklama yerinin mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Konaklama yerinin orijinal fiyatı. Bu fiyat, kullanıcı arayüzünde üstü çizili olarak gösterilir. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
TransportationReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Serbest metin. Örneğin, "SFO'dan SAN'a" Önerilen metin boyutu: En fazla 50 karakter |
| Ulaşım Türü | Zorunlu | Rezervasyon için ulaşım şekli/türü. | Enum: UÇUŞ, TREN, OTOBÜS veya Vapur |
| Kalkış Saati | Zorunlu | Kalkış saatini milisaniye cinsinden gösteren sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Varış Saati | Zorunlu | Varış zamanını temsil eden, milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Kalkış yeri - Ü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 - Görüntülenen adres | İsteğe bağlı | Kullanıcıya gösterilecek kalkış konumu. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Kalkış Konumu - Açık Adres | İsteğe bağlı | Kalkış konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Kalkış yeri - Eyalet | İsteğe bağlı | Kalkış noktasının bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Kalkış yeri - Posta kodu | İsteğe bağlı | Kalkış noktasının posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Kalkış Konumu - Semt | İsteğe bağlı | Kalkış yerinin mahallesi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış yeri - Ülke | İsteğe bağlı | Varış ülkesi. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış yeri - Şehir | İsteğe bağlı | Varış şehri. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış yeri - Görüntülenen adres | İsteğe bağlı | Kullanıcıya gösterilecek varış konumu. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış yeri - açık adres | İsteğe bağlı | Varış konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış Konumu - Eyalet | İsteğe bağlı | Varış konumunun eyaleti veya ili (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış yeri - Posta kodu | İsteğe bağlı | Varış konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Varış Konumu - Mahalle | İsteğe bağlı | Varış konumunun mahallesi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Serbest metin. Örneğin, Hava yolu şirketinin adı |
| Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Poster resimleri | İsteğe bağlı |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rezervasyon kimliği | İsteğe bağlı | Ulaşım rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşullu olarak gerekli | Rezervasyonun mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Rezervasyonun orijinal fiyatı. Kullanıcı arayüzünde üstü çizilir. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Ulaşım Numarası | Zorunlu | Uçuş numarası, otobüs numarası, tren numarası veya feribot/kruiz numarası. | Serbest metin |
| Uçağa Biniş Saati | Zorunlu | Rezervasyonun biniş zamanını temsil eden çağ zaman damgası (varsa) | Milisaniye cinsinden Unix sıfır zaman damgası |
VehicleRentalReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem Uri | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Serbest metin. Örneğin, "Avis Union Square SF" Önerilen metin boyutu: En fazla 50 karakter |
| Teslim alma zamanı | Zorunlu | Rezervasyonun teslim alma zamanını temsil eden çağ zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Dönüş zamanı | İsteğe bağlı | Rezervasyonun çıkış saatini temsil eden çağ zaman damgası. | Milisaniye cinsinden Unix sıfır zaman damgası |
| Teslim alma adresi - Ülke | İsteğe bağlı | Teslim alma konumunun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim alma adresi - Şehir | İsteğe bağlı | Teslim alma konumunun bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim Alınacak Adres - Görünen Adres | İsteğe bağlı | Kullanıcıya gösterilecek teslim alma konumu. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim Alınacak Adres - Açık Adres | İsteğe bağlı | Teslim alma konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim alma adresi - Eyalet | İsteğe bağlı | Teslim alma yerinin eyaleti veya ili (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim alınacak adres - Posta kodu | İsteğe bağlı | Teslim alma yerinin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim alma adresi - Mahalle | İsteğe bağlı | Teslim alma konumunun mahallesi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Ülke | İsteğe bağlı | İade konumunun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Şehir | İsteğe bağlı | İade konumunun bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Görünen Adres | İsteğe bağlı | Kullanıcıya gösterilecek iade konumu. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Açık Adres | İsteğe bağlı | İade konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Eyalet | İsteğe bağlı | İade konumunun eyaleti veya ili (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade adresi - Posta kodu | İsteğe bağlı | İade konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Mahalle | İsteğe bağlı | İade konumunun mahallesi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Serbest metin. Örneğin, "Avis Rent a Car" |
| Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Poster resimleri | İsteğe bağlı |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlık için tek bir paragraflık metin. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırdan oluşan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Onay kimliği | İsteğe bağlı | Araç kiralama rezervasyonunun onay kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşullu olarak gerekli | Rezervasyonun mevcut fiyatı. Üzeri çizili fiyat sağlanıyorsa belirtilmelidir. |
Serbest metin |
| Fiyat - Üstü Çizili Fiyat | İsteğe bağlı | Rezervasyonun orijinal fiyatı. Kullanıcı arayüzünde üstü çizilir. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi (varsa) içeren fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
Resim özellikleri
Resim öğeleri için gerekli özellikler bu tabloda listelenmiştir:
| En boy oranı | Minimum piksel sayısı | Önerilen piksel sayısı |
|---|---|---|
Kare (1x1) Tercih edilen |
300x300 | 1.200x1.200 |
| Yatay (1,91x1) | 600x314 | 1.200x628 |
| Dikey (4x5) | 480x600 | 960x1200 |
Google'ın 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 şekilde gösterilmesi için şeffaf arka plan kullanın.
İçerik Kategorisi
İçerik kategorisi, uygulamaların birden fazla kategoriye ait içerik yayınlamasına olanak tanır. Bu işlem, içeriği önceden tanımlanmış kategorilerden bazılarıyla eşleştirir. Bu kategoriler şunlardır:
TYPE_EDUCATIONTYPE_SPORTSTYPE_MOVIES_AND_TV_SHOWSTYPE_BOOKSTYPE_AUDIOBOOKSTYPE_MUSICTYPE_DIGITAL_GAMESTYPE_TRAVEL_AND_LOCALTYPE_HOME_AND_AUTOTYPE_BUSINESSTYPE_NEWSTYPE_FOOD_AND_DRINKTYPE_SHOPPINGTYPE_HEALTH_AND_FITENESSTYPE_MEDICALTYPE_PARENTINGTYPE_DATING
Google'ın görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.
İçerik kategorilerini kullanmayla ilgili kurallar
- ArticleEntity ve GenericFeaturedEntity gibi bazı varlıklar, içerik kategorilerinden herhangi birini kullanmaya uygundur. EventEntity, EventReservationEntity, PointOfInterestEntity gibi diğer varlıklar için yalnızca bu kategorilerin bir alt kümesi uygundur. Listeyi doldurmadan önce bir varlık türü için uygun kategorilerin listesini kontrol edin.
Bazı içerik kategorileri için genel öğeler ve ContentCategory öğesinin bir kombinasyonu yerine belirli öğe türünü kullanın:
- TYPE_MOVIES_AND_TV_SHOWS: Genel varlıkları kullanmadan önce İzle entegrasyon kılavuzundaki varlıkları inceleyin.
- TYPE_BOOKS: Genel öğeleri kullanmadan önce EbookEntity öğesine göz atın.
- TYPE_AUDIOBOOKS: Genel öğeleri kullanmadan önce AudiobookEntity'ye göz atın.
- TYPE_SHOPPING: Genel öğeleri kullanmadan önce ShoppingEntity'ye göz atın.
- TYPE_FOOD_AND_DRINK: Genel varlıkları kullanmadan önce Gıda Entegrasyonu Kılavuzu'ndaki varlıklara göz atın.
ContentCategory alanı isteğe bağlıdır ve içerik daha önce belirtilen kategorilerden hiçbirine ait değilse boş bırakılmalıdır.
Birden fazla içerik kategorisi sağlanırsa bunları içerikle alaka düzeyine göre sıralayın. En alakalı içerik kategorisi listeye ilk sırada eklenmelidir.
2. adım: Küme verilerini sağlayın
İçerik yayınlama işinin arka planda (ör. WorkManager kullanılarak) yürütülmesi ve düzenli olarak veya etkinlik bazında (ör. kullanıcı uygulamayı her açtığında ya da sepete bir şey eklediğinde) planlanması önerilir.
AppEngagePublishClient, kümeleri yayınlamaktan sorumludur.
İstemcide kümeleri yayınlamak için aşağıdaki API'ler vardır:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishContinuationClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteContinuationClusterdeleteUserManagementClusterdeleteClusters
isServiceAvailable
Bu API, hizmetin entegrasyon için kullanılıp kullanılamayacağı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ğının mevcut
RecommendationClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenmiş öneri kümesinde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishFeaturedCluster
Bu API, FeaturedCluster 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ğının mevcut
FeaturedClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen Öne Çıkan Küme'de depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishContinuationCluster
Bu API, ContinuationCluster nesnesi yayınlamak için kullanılır.
Kotlin
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishContinuationCluster( new PublishContinuationClusterRequest.Builder() .setContinuationCluster( new ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağının mevcut
ContinuationClusterverileri kaldırılır. - İstekten gelen 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 sunabilmesi) için kullanıcıları uygulamanın oturum açma sayfasına yönlendirir.
Aşağıdaki meta veriler, oturum açma kartının bir parçasıdır:
| Özellik | Şartlar | Açıklama |
|---|---|---|
| İşlem Uri | Zorunlu | İşleme derin bağlantı (ör. uygulamada oturum açma sayfasına yönlendirme) |
| Resim | İsteğe bağlı: Sağlanmazsa Başlık sağlanmalıdır |
Kartta gösterilen resim 1264x712 çözünürlüğe sahip 16x9 en boy oranına sahip resimler |
| Başlık | İsteğe bağlı: Sağlanmazsa resim sağlanmalıdır | Karttaki başlık |
| İşlem metni | İsteğe bağlı | CTA'da Gösterilen Metin (ör. Oturum aç) |
| Alt başlık | İsteğe bağlı | Kartta isteğe bağlı altyazı |
Kotlin
var SIGN_IN_CARD_ENTITY = SignInCardEntity.Builder() .addPosterImage( Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build() client.publishUserAccountManagementRequest( PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY = new SignInCardEntity.Builder() .addPosterImage( new Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build(); client.publishUserAccountManagementRequest( new PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağının mevcut
UserAccountManagementClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen UserAccountManagementCluster kümesinde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
updatePublishStatus
Dahili bir işletme nedeniyle kümelerin hiçbiri yayınlanmıyorsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle tavsiye ederiz. Bu önemlidir, çünkü :
- İçerik yayınlandığında bile (STATUS == PUBLISHED) tüm senaryolarda durumu sağlamak, entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu açık durumu kullanan kontrol panellerini doldurmak açısından çok önemlidir.
- Hiçbir içerik yayınlanmamışsa ancak entegrasyon durumu bozulmamışsa (STATUS == NOT_PUBLISHED) Google, uygulama sağlığı kontrol panellerinde uyarı tetiklemekten kaçınabilir. Sağlayıcı açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
- Geliştiricilerin verilerin ne zaman yayınlandığı ve ne zaman yayınlanmadığı hakkında analizler sunmasına yardımcı olur.
- Google, kullanıcının uygulama içeriğini görebilmesi veya bu içeriğin üstesinden gelmesi için uygulamada belirli işlemleri yapmasına yönlendirmek amacıyla durum kodlarını kullanabilir.
Uygun yayınlama durumu kodlarının listesi şunlardır :
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
İçerik, kullanıcının giriş yapmaması nedeniyle yayınlanmıyorsa Google, oturum açma kartının yayınlanmasını önerir. Sağlayıcılar herhangi bir nedenle oturum açma kartını yayınlayamıyorsa NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla updatePublishStatus API'sini çağırmanızı öneririz.
Kotlin
client.updatePublishStatus( PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build())
Java
client.updatePublishStatus( new PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build());
deleteRecommendationClusters
Bu API, öneri kümelerinin içeriğini silmek için kullanılır.
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
Hizmet, isteği aldığında mevcut verileri öneri kümelerinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteFeaturedCluster
Bu API, Öne Çıkan Küme'nin içeriğini silmek için kullanılır.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Hizmet, isteği aldığında Öne Çıkan Küme'deki mevcut verileri kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteContinuationCluster
Bu API, Devam Kümesi'nin 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 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 istek tamamen 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ümelerdeki mevcut verileri kaldırır. İstemciler bir veya daha fazla küme türünü iletmeyi seçebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
Hata işleme
Yayınlama API'lerinden görev sonucunu dinlemeniz önemle tavsiye edilir. Böylece, başarılı bir görevi kurtarıp yeniden göndermek için takip işlemi yapabilirsiniz.
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster(..) .build()) .addOnCompleteListener { task -> if (task.isSuccessful) { // do something } else { val exception = task.exception if (exception is AppEngageException) { @AppEngageErrorCode val errorCode = exception.errorCode if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) { // do something } } } }
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster(...) .build()) .addOnCompleteListener( task -> { if (task.isSuccessful()) { // do something } else { Exception exception = task.getException(); if (exception instanceof AppEngageException) { @AppEngageErrorCode int errorCode = ((AppEngageException) exception).getErrorCode(); if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) { // do something } } } });
Hata, hata kodu olarak nedeni dahil edilerek AppEngageException olarak döndürülür.
| Hata kodu | Hata adı | Not |
|---|---|---|
1 |
SERVICE_NOT_FOUND |
Hizmet, belirtilen cihazda kullanılamıyor. |
2 |
SERVICE_NOT_AVAILABLE |
Hizmet, belirli bir cihazda kullanılabilir ancak arama sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır). |
3 |
SERVICE_CALL_EXECUTION_FAILURE |
Görev yürütme, mesaj dizileriyle ilgili sorunlar nedeniyle başarısız oldu. Bu durumda, işlem yeniden denenebilir. |
4 |
SERVICE_CALL_PERMISSION_DENIED |
Arayan kullanıcının servis araması yapmasına izin verilmiyor. |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
İstek geçersiz veriler içeriyor (örneğin, izin verilenden daha fazla sayıda küme). |
6 |
SERVICE_CALL_INTERNAL |
Hizmet tarafında bir hata var. |
7 |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Servis çağrısı çok sık yapılıyor. |
3. Adım: Yayın intent'lerini işleme
Bir iş aracılığıyla içerik yayınlama API çağrıları yapmanın yanı sıra, içerik yayınlama isteğini almak için bir BroadcastReceiver oluşturmanız da gerekir.
Yayın niyetinin amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın niyetleri çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca Engage Hizmeti içeriğin güncel olmayabileceğini (ör. bir haftalık) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süre çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimi yaşayabileceğinden emin olabilirsiniz.
BroadcastReceiver aşağıdaki iki şekilde ayarlanmalıdır:
Context.registerReceiver()sınıfının bir örneğiniContext.registerReceiver()kullanarak dinamik olarak kaydedin.BroadcastReceiverBu sayede, bellekte hâlâ etkin olan uygulamalardan iletişim kurulabilir.
Kotlin
class AppEngageBroadcastReceiver : BroadcastReceiver(){ // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast // is received // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is // received } fun registerBroadcastReceivers(context: Context){ var context = context context = context.applicationContext // Register Recommendation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION)) // Register Featured Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_FEATURED)) // Register Continuation Cluster Publish Intent context.registerReceiver(AppEngageBroadcastReceiver(), IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION)) }
Java
class AppEngageBroadcastReceiver extends BroadcastReceiver { // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast // is received // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received // Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is // received } public static void registerBroadcastReceivers(Context context) { context = context.getApplicationContext(); // Register Recommendation Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION)); // Register Featured Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED)); // Register Continuation Cluster Publish Intent context.registerReceiver(new AppEngageBroadcastReceiver(), new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION)); }
AndroidManifest.xmldosyanızda<receiver>etiketiyle uygulamayı statik olarak beyan edin. Bu, uygulamanın çalışmadığında yayın intent'leri almasına ve içeriği yayınlamasına olanak tanır.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Hizmet tarafından aşağıdaki intent'ler gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONBu amacı aldığınızdapublishRecommendationClustersçağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_FEATUREDBu intent'i aldığınızdapublishFeaturedClusterçağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_CONTINUATIONBu intent'i aldığınızdapublishContinuationClusterçağrısı başlatmanız önerilir.
Entegrasyon iş akışı
Entegrasyonunuz tamamlandıktan sonra doğrulamayla ilgili adım adım açıklamalı bir kılavuz için Engage geliştirici entegrasyon iş akışı başlıklı makaleyi inceleyin.
SSS
SSS için Engage SDK Sık Sorulan Sorular başlıklı makaleyi inceleyin.
İletişim
Entegrasyon işlemi sırasında sorularınız olursa engage-developers@google.com adresiyle iletişime geçebilirsiniz.
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonra uygulayacağınız adımlar ş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 bir doğrulama ve şirket içi inceleme gerçekleştirir. Değişiklik yapılması gerekirse Google gerekli tüm bilgileri sizinle paylaşır.
- Test tamamlandığında ve herhangi bir değişiklik gerekmediğinde Google, güncellenmiş ve entegre APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
- Google, güncellenmiş APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneri, Öne Çıkan ve Devam kümeleriniz yayınlanabilir ve kullanıcılar tarafından görülebilir.