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üresi yaklaşık bir hafta sürer. Daha fazla bilgi için işletme sitemizi ziyaret edin.
Bu belgede, geliştirici iş ortaklarının rezervasyonlar, etkinlikler, konaklama, ilgi çekici yerler, kişiler ve bu kategorilere ait olmayan diğer içerikler gibi yeni içerikleri entegre etme talimatları yer almaktadır.
Entegrasyon ayrıntıları
Terminoloji
Bu entegrasyon aşağıdaki üç küme türünü içerir: Öneri, Öne Çıkan ve Devam.
Öneri kümeleri, tek bir geliştirici iş ortağından kişiselleştirilmiş öneriler gösterir. Aynı geliştirici iş ortağının öneri grubunu içeren bir kullanıcı arayüzü görünümüdür.
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerikler için metin tabanlı bir öneriyi temsil eden ArticleEntity. ArticleEntity öğesi, geliştiricilerin GenericFeaturedEntity'ye kıyasla kullanıcılara bilgileri daha iyi aktarmak için daha fazla meta veri içeren çeşitli metin ve resim içerikleri sağlamasına olanak tanır. Ör. Pazarlama içeriği, Haber snippet'i
Ş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 önemli bir yeri 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ü. 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, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağının kullanıcılarının kısa süre önce etkileşimde bulunduğu içerikleri gösterir. Her geliştirici iş ortağı, Devam Kümesi'nde en fazla 10 öğe yayınlayabilir.
Devam niteliğindeki içeriğiniz aşağıdaki yapıda olabilir:
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerikler için metin tabanlı bir öneriyi temsil eden ArticleEntity. Bu öğe, kullanıcının kaldığı yerden devam etmek istediği bitmemiş haber makalelerini veya diğer içerikleri temsil etmek için kullanılabilir. Ör. Pazarlama içeriği, haber snippet'i
6.şekil Devam kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü. 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.
7.şekil Devam kümesinde tek bir RestaurantReservationEntity'nin gösterildiği 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 oturumu rezervasyonları
Şekil 8. Devamlılık kümesinde tek bir EventReservationEntity 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.
Şekil 9. Devamlılık kümesinde tek bir LodgingReservationEntity'nin gösterildiği kullanıcı arayüzü. TransportationReservationEntity: TransportationReservationEntity herhangi bir ulaşım şekliyle 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.
10. şekil. Devamlılık 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ı takip etmesine yardımcı olur.
Şekil 11. Devamlılık kümesinde tek bir VehicleRentalReservationEntity'nin gösterildiği kullanıcı arayüzü.
Öne Çıkanlar kümesi, birçok geliştirici iş ortağının seçilen öne çıkan uygulamasını tek bir kullanıcı arayüzü gruplandırmasında gösteren bir kullanıcı arayüzü görünümüdür.
GenericFeaturedEntityTek bir Öne Çıkan kümesi vardır. Bu küme, kullanıcı arayüzünün üst kısmına yakın bir yerde gösterilir ve tüm Öneri kümelerinin üzerinde öncelikli bir yerleşime sahiptir. Her geliştirici iş ortağı, Öne Çıkanlar'da desteklenen bir türün tek bir öğesini yayınlayabilir. Öne Çıkanlar kümesinde ise birden fazla uygulama geliştiricinin birçok öğesi (farklı türlerde olabilir) yer alır.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 12: Öne çıkarılan bir küme içinde tek bir öne çıkarılan öğeyi gösteren kullanıcı arayüzü Genel Öne Çıkarılan Öğeler kartı
Ö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,
PointOfInterestEntity veya PersonEntity) |
| Devamlılık 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: Tüzel kişi verilerini sağlayın
SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. Diğerleri kategorisi için aşağıdaki öğeleri destekliyoruz:
GenericFeaturedEntityArticleEntityEventEntityLodgingEntityStoreEntityPointOfInterestEntityPersonEntityRestaurantReservationEntityEventReservationEntityLodgingReservationEntityTransportationReservationEntityVehicleRentalReservationEntity
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 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ığı 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 |
| Altyazı 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: en fazla 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ı)
|
|
| 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. |
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: En fazla 50 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Resim 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 |
| Altyazı 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: en fazla 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ı)
|
|
| 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ı | Koşula bağlı olarak zorunlu | Kullanıcının bu öğeyle en son etkileşime girdiği zamana ait milisaniye cinsinden dönem zaman damgası. Not: Bu alan, bu öğe devamlılık kümesinin bir parçasıysa zorunludur. |
Milisaniye cinsinden dönem zaman damgası |
| İlerleme yüzdesi | Koşula bağlı olarak zorunlu | Kullanıcının bugüne kadar tükettiği tam içeriğin yüzdesi. Not: Bu alan, bu öğe devamlılık kümesinin bir parçasıysa zorunludur. |
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. |
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: En fazla 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen zamanın epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
| 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 zorunlu | 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 zorunlu | 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 zorunlu | 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 |
| Altyazı 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: en fazla 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ı | Etkinlik için biletin/kartın orijinal fiyatı. | Serbest metin |
| Fiyat açıklama metni | İsteğe bağlı | Varsa promosyon, etkinlik veya üye indirimini ö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
Rehberlik için İçerik Kategorisi bölümüne bakın. |
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: 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 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 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 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 |
| Altyazı 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: en fazla 50 karakter |
| AvailabilityTimeWindow - Start Time (Kullanım dönemi - Başlangıç zamanı) | İsteğe bağlı | Tesisin açık/kullanılabilir olması beklenen zamana ait milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| AvailabilityTimeWindow - End Time | İsteğe bağlı | Tesisin açık/kullanılabilir olması beklenen zamana kadar geçen milisaniye cinsinden dönem zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| 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 |
| Derecelendirme - 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, 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 daha küçük ekran boyutlarında sayının kesilmemesi için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Konaklama yerinin puan 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ş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 indirimini öne çıkarmak için 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'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 tanıtımını, 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) |
| 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 |
| Derecelendirme - 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ı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı'yı kullanırız. |
Uzun |
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: En fazla 50 karakter |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Resim 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 | İlgi çekici noktanın bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Zorunlu | İlgi çekici noktanın bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | Zorunlu | Kullanıcıya gösterilecek ilgi çekici yerin adresi. | Serbest metin Önerilen metin boyutu: en fazla 20 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ı | İ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ı | İ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 - Start Time (Kullanım dönemi - Başlangıç zamanı) | İsteğe bağlı | İlgi çekici yerin açık/kullanılabilir olması beklenen zamana ait milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| AvailabilityTimeWindow - End Time | İsteğe bağlı | İlgi çekici yerin açık/kullanılabilir olması beklenen zamana kadar geçen milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| 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 |
| Altyazı 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: en fazla 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 |
| Derecelendirme - 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, 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 daha küçük ekran boyutlarında sayının kesilmemesi için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | İlgi çekici yerin puanlarını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ş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 indirimini ö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
Rehberlik için İçerik Kategorisi bölümüne bakın. |
PersonEntity
| Ö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 |
| Profil - Ad | Zorunlu | Profil adı, kimliği veya herkese açık kullanıcı adı (ör. "John Doe", "@TeamPixel" vb.) | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metin. | Serbest metin Önerilen metin boyutu: En fazla 15 karakter |
| Profil - Ek Resim | İsteğe bağlı | Doğrulama rozeti gibi küçük bir resim. | Yardım için Resim Özellikleri bölümüne bakın. |
| Başlık resmi | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 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. |
| 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 Sayı hem de Sayı Değeri sağlanırsa Sayı kullanılır. |
Dize Önerilen metin boyutu: Sayı + etiket için en fazla 20 karakter birleştirilmiş |
| Popülerlik - Sayı Değeri | İsteğe bağlı | Takipçi sayısı veya popülerlik değeri. Not: Uygulamanız, çok sayıda öğenin farklı ekran boyutları için nasıl optimize edileceğiyle ilgili mantığı işlemek istemiyorsa Count Value (Sayı Değeri) sağlayın. Hem Sayı hem de Sayı Değeri sağlanırsa Sayı 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 birleşimi için en fazla 20 karakter |
| Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin amacını belirtin. Örneğin, beğenme simgesi ve emojilerin gösterildiği bir resim. Birden fazla resim sağlayabilirsiniz ancak tüm form faktörlerinde tüm resimler gösterilmeyebilir. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Puan - Maksimum değer | Zorunlu | 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 |
| Derecelendirme - Geçerli değer | Zorunlu | 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ı | Varlığın 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ı | Varlığın puan sayısı. Not: Gösterim kısaltma 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ı'yı kullanırız. |
Uzun |
| Konum - Ülke | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | İ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ı | Kişinin bulunduğu veya hizmet verdiği eyalet (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği yerin 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 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 |
| Altyazı 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: en fazla 50 karakter |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
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: En fazla 50 karakter |
| Rezervasyon Başlangıç Saati | Zorunlu | Rezervasyonun başlaması beklenen milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden dönem 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 - 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 |
| Altyazı 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: en fazla 50 karakter |
| Tablo Boyutu | İsteğe bağlı | Rezervasyon grubundaki kişi sayısı | Tamsayı > 0 |
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: En fazla 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen zamanın epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
| 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 zorunlu | 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 zorunlu | 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 zorunlu | 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. |
| 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ı |
| 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 |
| Altyazı 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: en fazla 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ı | Etkinlik için biletin/kartın orijinal fiyatı. | Serbest metin |
| Fiyat açıklama metni | İsteğe bağlı | Varsa promosyon, etkinlik veya üye indirimini ö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 |
| Derecelendirme - 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 derecelendirme 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 derecelendirme sayısı. Not: Gösterim kısaltma 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ı'yı kullanırız. |
Uzun |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
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: En fazla 50 karakter |
| Giriş Saati | Zorunlu | Rezervasyonun check-in zamanını temsil eden milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| Çıkış Saati | Zorunlu | Rezervasyonun ödeme zamanını temsil eden milisaniye cinsinden sıfır zaman damgası. | Milisaniye cinsinden dönem 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 - Adresi Göster | 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 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 |
| Altyazı 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: en fazla 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 |
| Derecelendirme - 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ı sağlayın. 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 indirimini öne çıkarmak için 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'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: En fazla 50 karakter |
| Ulaşım Türü | Zorunlu | Rezervasyon için ulaşım şekli/türü. | Enum: FLIGHT, TRAIN, BUS veya FERRY |
| Kalkış Saati | Zorunlu | Kalkış zamanını temsil eden milisaniye cinsinden epoch zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| Varış Zamanı | Zorunlu | Varış zamanını temsil eden milisaniye cinsinden epoch zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| 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 |
| Altyazı 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: en fazla 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 indirimini öne çıkarmak için 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/gemi numarası. | Serbest metin |
| Uçağa Biniş Saati | Zorunlu | Rezervasyonun biniş zamanını temsil eden dönem zaman damgası (varsa) | 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: En fazla 50 karakter |
| Teslim alma zamanı | Zorunlu | Rezervasyonun teslim alma zamanını temsil eden dönem zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| Dönüş Saati | İsteğe bağlı | Rezervasyonun çıkış saatini temsil eden dönem zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| 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 |
| Altyazı 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: en fazla 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 indirimini öne çıkarmak için 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 | 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.
İç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_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 erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir.
İçerik kategorilerini kullanma yönergeleri
- 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.
Bazı içerik kategorileri için genel öğeler ve ContentCategory kombinasyonu yerine belirli öğe türünü kullanın:
- TYPE_MOVIES_AND_TV_SHOWS: Genel öğeleri kullanmadan önce İzleme entegrasyonu kılavuzundaki öğeleri inceleyin.
- TYPE_BOOKS: Genel öğeleri kullanmadan önce EbookEntity'yi inceleyin.
- TYPE_AUDIOBOOKS: Genel öğeleri kullanmadan önce AudiobookEntity'yi inceleyin.
- TYPE_SHOPPING - Check out ShoppingEntity before using the generic entities.
- TYPE_FOOD_AND_DRINK: Genel öğeleri kullanmadan önce Yemek entegrasyonu kılavuzundaki öğeleri inceleyin.
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.
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 öğe eklediğinde) planlanması önerilir.
AppEngagePublishClient, kümelerin yayınlanmasından sorumludur.
İstemcide kümeleri yayınlamak için aşağıdaki API'ler kullanılabilir:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishContinuationClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteContinuationClusterdeleteUserManagementClusterdeleteClusters
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
RecommendationClusterverileri 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
FeaturedClusterverileri 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.
publishContinuationCluster
Bu API, ContinuationCluster nesnesini yayınlamak için kullanılır.
Kotlin
client.publishContinuationCluster(
PublishContinuationClusterRequest.Builder()
.setContinuationCluster(
ContinuationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
Java
client.publishContinuationCluster(
new PublishContinuationClusterRequest.Builder()
.setContinuationCluster(
new ContinuationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağından alınan mevcut
ContinuationClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen Continuation Cluster'da 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
UserAccountManagementClusterverileri 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, entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu açık durumu kullanan kontrol panellerini doldurmak açısından kritik öneme sahiptir.
- İç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ı uygulama içeriğini görebilmesi veya sorunu aşabilmesi için uygulamada belirli işlemleri yapmaya yönlendirmek amacıyla durum kodlarını kullanabilir.
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.
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 devamlılık 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.
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 mevcut verileri, belirtilen küme türleriyle eşleşen tüm kümelerden 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 BroadcastReceiver ayarlamanı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:
BroadcastReceiversınıfının bir örneğiniContext.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 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),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Featured Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Continuation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION),
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 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),
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 Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
}
<receiver>etiketiyle bir uygulamayıAndroidManifest.xmldosyanı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.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Hizmet tarafından aşağıdaki amaçlar gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONBu amaç alındığındapublishRecommendationClustersaraması başlatılması önerilir.com.google.android.engage.action.PUBLISH_FEATUREDBu amaç alındığındapublishFeaturedClustergörüşmesi başlatılması önerilir.com.google.android.engage.action.PUBLISH_CONTINUATIONBu amaç alındığındapublishContinuationClustergörüşmesi başlatılması önerilir.
Entegrasyon iş akışı
Entegrasyonunuz tamamlandıktan sonra doğrulama ile ilgili adım adım kılavuz için Geliştirici entegrasyonu iş akışını kullanma başlıklı makaleyi inceleyin.
SSS
SSS için Engage SDK ile ilgili sık sorulan sorular bölümüne bakın.
İletişim
Entegrasyon işlemi sırasında herhangi bir sorunuz olursa engage-developers@google.com ile iletişime geçin.
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonraki adımlarınız şunlardır:
engage-developers@google.comadresine 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 ve Devam kümeleriniz yayınlanabilir ve kullanıcılara gösterilebilir.