Google, cihaz üzerinde kullanıcıların cihazlarını ve sektörlere göre uygulamalar Ayrıca kişiselleştirilmiş uygulama içeriği tüketimi için yeni ve etkileyici bir deneyim sunar. keşfedeceğiz. Bu tam ekran deneyim, geliştirici iş ortaklarının En iyi zengin içeriklerini YouTube dışındaki özel bir kanalda sergileme fırsatı en iyi yoludur.
Bu belge, geliştirici iş ortaklarının yeni rezervasyonlar, etkinlikler, konaklama, ilgi çekici yerler, kişiler ve içerik. Engage SDK'sını kullanarak bu kategorilerden herhangi birine ait olmayabilecek yeni yüzey alanını doldurun.
Entegrasyon ayrıntıları
Terminoloji
Bu entegrasyon şu üç küme türünü içerir: Öneri, Öne Çıkanlar ve Devam.
Öneri kümeleri, bir kullanıcıdan gelen kişiselleştirilmiş önerileri gösterir. geliştirici iş ortağınız. Bir dizi öneri içeren bir kullanıcı arayüzü görünümüdür. aynı geliştirici iş ortağından gelir.
MakaleEntity: Metin tabanlı bir makaleyi temsil eden ArticleEntity birden fazla kategoriyle alakalı içerik önerisi yardımcı olur. ArticleEntity öğesi, geliştiricilerin çeşitli bilgiler sağlamalarına olanak tanır: Bilgileri ifade etmek için daha fazla meta veri içeren metin ve resim içeriği GenelFeatureEntity ile karşılaştırmalı olarak elde edilmiştir. Ör. Pazarlama içeriği, Haber snippet'i
Şekil 1: Öneriler'de tek bir ArticleEntity öğesinin gösterildiği kullanıcı arayüzü kümesidir. EventEntity: EventEntity, şurada gerçekleşen bir etkinliği temsil eder: duymuş olabilirsiniz. Etkinliğin başlangıç saati, projenizin başarısını etkileyebilecek ve kullanıcılara iletilmesi gerekir.
Şekil 2: Öneri kümesi. LodgingEntity: LodgingEntity, bir konaklama yerini temsil eder. kısa ve uzun vadeli otel, daire, tatil evi olarak kiralama.
Şekil 3: Tek bir LodgingEntity gösteren kullanıcı arayüzü Öneriler kümesine dahil edilir. StoreEntity: StoreEntity bir mağazayı, restoranı, kafeyi temsil eder. Örneğin, bir yemek mekanının veya mağazanın nerede bulunduğunu vurgular. müşteriye aktarılması gereken önemli bir bilgidir. yardımcı olur.
Şekil 4: Öneri kümesi. PointOfinterestEntity: PointOfinterestEntity, bir benzin istasyonu, etkinlik mekanı, tema parkı, müze, turistik yer, yürüyüş yolu vb. gibi kritik bir bilgi parçası olduğu için bu, her zaman aynı şeyi ifade eder. Konaklama, mağaza veya bir restoran.
Şekil 5: Tek bir sayfada görünen kullanıcı arayüzü Öneriler kümesindeki PointOfinterestEntity. PersonEntity: PersonEntity bir kişiyi temsil eder. Öneriler sağlık ve fitness gibi kategorilerde bir kişiyi öne çıkarmak spor, flört vb.
Şekil 5: Kullanıcı arayüzünde tek bir PersonEntity (Kişi Varlığı) gösteriliyor Öneri kümesi.
Devam kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden çok geliştirici iş ortağı ile çalışır. Her bir geliştirici iş ortağı Devamında en fazla 10 varlık yayınlamasına izin verilir kümesidir.
Devam içeriğiniz aşağıdaki yapıyı alabilir:
MakaleEntity: Metin tabanlı bir makaleyi temsil eden ArticleEntity birden fazla kategoriyle alakalı içerik önerisi yardımcı olur. Bu öğe, tamamlanmamış haberleri göstermek için kullanılabilir kullanıcının tüketmeye devam etmek istediği makaleler veya diğer içerikler kaldığı yerden devam edebilir. Ör. Pazarlama içeriği, Haber snippet'i
Şekil 6. Şurada tek bir Makale Varlığının gösterildiği kullanıcı arayüzü bir Devam kümesi oluşturuyor. RestaurantReservationEntity: RestaurantReservationEntity temsil eder rezervasyonları yaptırmalarına yardımcı olur ve kullanıcıların yaklaşan devam eden restoran rezervasyonları.
Şekil 7. Tek bir tane gösteren kullanıcı arayüzü Bir Devam kümesi içindeki RestaurantReservationEntity. EventReservationEntity: EventReservationEntity, bir ve kullanıcıların yaklaşan ya da devam eden etkinlikleri izlemelerine yardımcı olur. etkinlik rezervasyonları. Etkinlikler şunları içerebilir ancak bunlarla sınırlı değildir: takip etmek için:
- Futbol maçı rezervasyonu gibi spor etkinlikleri
- E-spor rezervasyonu gibi oyun etkinlikleri
- Sinemada film rezervasyonu gibi eğlence etkinlikleri konser, tiyatro, kitap imzası
- Rehberli turlar, müze gibi seyahat veya önemli yer rezervasyonları biletler
- Sosyal / Seminer / Konferans rezervasyonları
- Eğitim / Eğitim oturumu rezervasyonları
Şekil 8. Tek bir tane gösteren kullanıcı arayüzü Bir Devam kümesi içindeki EventReservationEntity. LodgingReservationEntity: LodgingEntityReservation, bir ve kullanıcıların konaklama rezervasyonlarını takip etmelerine yardımcı olur. devam eden otel veya kiralık yer rezervasyonları.
Şekil 9. Tek bir tane gösteren kullanıcı arayüzü Bir Devam kümesi içindeki LodgingReservationEntity. TransportationReservationEntity: TransportationReservationEntity herhangi bir ulaşım şekline yönelik ulaşım için bir rezervasyon temsil eder ve kullanıcılara yaklaşan veya devam eden uçuş, feribot, tren, otobüs ya da araç kiralama veya deniz yolculuğu.
Şekil 10. Tek bir tane gösteren kullanıcı arayüzü Bir Continuation kümesi içindeki TransportationReservationEntity. VehicleRentalEntity: Araç Kiralama Rezervasyonu Bir araç kiralama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden araç kiralama rezervasyonları anlamına gelir.
Şekil 11. Tek bir tane gösteren kullanıcı arayüzü Bir Devam kümesi içindeki VehicleRentalReservationEntity.
Öne Çıkan kümesi, seçilen kahramanın gösterildiği bir kullanıcı arayüzü görünümüdür. Bir kullanıcı arayüzü gruplandırmasında çok sayıda geliştirici iş ortağından
GenericFeaturedEntity. Sayfanın üst kısmına yakın bir yerde, öne çıkan tek bir küme bulunur. Tüm öneri kümelerinin üzerinde öncelikli yerleşime sahip kullanıcı arayüzü. Her biri Geliştirici iş ortağının, desteklenen bir platformda tek bir tüzel kişiyi yayınlamasına izin verilir. Öne Çıkan bölümünde, web sitenizden birçok varlık (potansiyel olarak farklı türde) Öne Çıkanlar kümesinde birden fazla uygulama geliştirici bulunur.GenelFeaturedEntity: GenelFeaturedEntity şundan farklıdır: Öne çıkan öğedeki öneri öğesi, tek bir ve en fazla tek içeriği temsil etmesi gerekir. Böylece kullanıcılar ilgi çekici ve alakalı olabilir.
Şekil 12: Tek bir kahramanın gösterildiği kullanıcı arayüzü Öne çıkan bir kümedeki GenelFeaturedEntity kartı
Ö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, Google Analytics 4'teki bağlı hizmet.
Bir müşterinin yayınlayabileceği veriler, farklı için aşağıdaki sınırlara tabidir: küme türleri:
| Küme türü | Küme sınırları | Bir kümedeki minimum varlık sınırları | Bir kümedeki maksimum varlık sınırları |
|---|---|---|---|
| Öneri Kümeleri | En çok 5 | En az 5 | En çok 25 (ArticleEntity, EventEntity,
LodgingEntity, StoreEntity,
PointOfInterestEntity veya PersonEntity) |
| Devam Kümesi | En fazla 1 | En az 1 | En çok 10 (ArticleEntity,
EventReservationEntity,
LodgingReservationEntity,
TransportationReservationEntity veya
VehicleRentalReservationEntity) |
| Öne Çıkan Küme | En fazla 1 | En az 1 | En çok 10 (GenericFeaturedEntity) |
1. adım: Öğe verilerini sağlayın
SDK'da her öğe türünü temsil eden farklı varlıklar tanımlanmıştır. Destek verdiğimiz yerler diğer kategorisi için aşağıdaki varlıklar:
GenericFeaturedEntityArticleEntityEventEntityLodgingEntityStoreEntityPointOfInterestEntityPersonEntityRestaurantReservationEntityEventReservationEntityLodgingReservationEntityTransportationReservationEntityVehicleRentalReservationEntity
Aşağıdaki grafiklerde, her tür için kullanılabilir özellikler ve gereksinimler özetlenmektedir.
GenericFeaturedEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
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ırsa Resmin hem üstünde hem altında 24 d/sn |
Yardım için Resim Özellikleri'ne bakın. |
| Başlık | İsteğe bağlı | Varlığın başlığıdır. | Serbest metin Önerilen metin boyutu: 50 karakter |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. Resmin/videonun üzerinde rozet gibi özel bir kullanıcı deneyimi kullanımı (ör. resmin üzerinde yer paylaşımı
|
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Sıralama Listesi İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
ArticleEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Serbest metin Önerilen metin boyutu: Maksimum 50 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kesinlikle önerilir. Rozet hem üst hem de alt kısımda 24 dps'lik güvenli bir alan resim |
Yardım için Resim Özellikleri'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ı | Yazar, kuruluş, muhabir gibi kaynağın resmi | Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. Resmin/videonun üzerinde özel kullanıcı deneyimi kullanımı (ör. rozet olarak) resmin üzerinde yer paylaşımı
|
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| İçeriğin Yayınlanma Zamanı | İsteğe bağlı | İçeriğin kullanıldığı zaman, milisaniye cinsinden, dönem zaman damgasıdır. Uygulamada yayınlanmış / güncellenmiş. | Milisaniye cinsinden Epoch zaman damgası |
| Son Etkileşim Zamanı | Koşula Bağlı Olarak Zorunlu | Kullanıcının etkileşimde bulunduğu milisaniye cinsinden dönem zaman damgası bu öğe için istekli olabilir. Not: Bu alan, söz konusu tüzel kişiliğin ve devamı kümesidir. |
Milisaniye cinsinden Epoch zaman damgası |
| İlerleme Yüzdesi | Koşula Bağlı Olarak Zorunlu | Bugüne kadar kullanıcı tarafından tüketilen tam içeriğin yüzdesi. Not: Bu alan, söz konusu tüzel kişiliğin ve devamı kümesidir. |
0~100 dahil olmak üzere bu değerler arasında bir tam sayı değeri. |
| İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Sıralama Listesi İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
EventEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlamasının beklendiği zamanın zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Epoch zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa yüz yüze mi olacağını belirten bir alan her ikisini de seçebilirsiniz. |
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 kesinlikle önerilir. Rozet hem üst hem de alt kısımda 24 dps'lik güvenli bir alan resim |
Yardım için Resim Özellikleri'ne bakın. |
| Konum - Ülke | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştirileceği yerin adı ve kullanıcıya gösterilecektir. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Etkinliğin yapıldığı konumun açık adresi (varsa) budur. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Etkinliğin gerçekleştiği eyalet veya il (geçerliyse) barındırılır. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Etkinliğin gerçekleştiği konumun posta kodu (varsa) barındırılır. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (geçerliyse). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönem zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Epoch zaman damgası |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa sağlanmalıdır. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Etkinlik biletinin/kartın orijinal fiyatı. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
| İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamaların Listesi
İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
LodgingEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
| Poster resimleri | Zorunlu |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilir. en boy oranı 16:9'dur Not: Rozet sağlanırsa Resmin hem üstünde hem altında 24 d/sn |
Yardım için Resim Özellikleri'ne bakın. |
| Konum - Ülke | Zorunlu | Konaklamanın yapılacağı ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Konaklama tesisinin gerçekleştirildiği şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | Zorunlu | Kullanıcıya gösterilecek konaklamanın adresi. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Konaklama tesisinin açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Konaklama tesisinin bulunduğu eyalet veya il (geçerliyse) bulabilirsiniz. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Konaklama tesisinin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Konaklama tesisinin bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| AvailabilityTimeWindow - Başlangıç Zamanı | İsteğe bağlı | Konaklamanın gerçekleşmesi beklenen milisaniye cinsinden sıfır zaman damgası açık/kullanılabilir durumdadır. | Milisaniye cinsinden Epoch zaman damgası |
| AvailabilityTimeWindow - Bitiş Saati | İsteğe bağlı | Konaklamanın beklenene kadar geçen milisaniye cinsinden sıfır zaman damgası olmasını sağlayabilirsiniz. | Milisaniye cinsinden Epoch zaman damgası |
| Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Konaklama tesisi için puan sayısıdır. Not: Uygulamanız için bu alanı sağlayın sayımın kullanıcılara nasıl görüntüleneceğini kontrol eder. Kısa ve öz bir dize kullanın. Örneğin, sayı 1.000.000 ise kısaltma kullanabilirsiniz. Örneğin 1 milyon gibi. Böylece daha küçük ekran boyutlarında sayı kısaltılmaz. |
Dize |
| Puan - Sayı Değeri | İsteğe bağlı | Konaklama tesisi için puan sayısıdır. Not: Siz bu alanla ilgili işlem yapmıyorsanız ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri varsa kullanıcılara Sayı gösterilir. |
Uzun |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli | Konaklamanın mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de belirtilmelidir. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Konaklama ücretinin bahsi geçen ve Kullanıcı arayüzü. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
StoreEntity
StoreEntity nesnesi, geliştiricinin iş ortağı olduğu bağımsız bir mağazayı temsil eder
yayınlamak istedikleriniz olabilir.
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| Poster resimleri | Zorunlu | En az bir resim sağlanmalıdır. | Yardım için Resim Özellikleri'ne bakın. |
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | İsteğe bağlı | Mağazanın adı. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa ( çok uzunsa üç nokta görüntülenebilir) |
| Konum | İsteğe bağlı | Mağazanın konumu. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa ( çok uzunsa üç nokta görüntülenebilir) |
| Açıklama metni | İsteğe bağlı | Mağazayla ilgili tanıtım, etkinlik veya güncellemeyi öne çıkaran açıklama metni (varsa) kullanılabilir. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa ( çok uzunsa üç nokta görüntülenebilir) |
| Ek bilgi açıklama metni | İsteğe bağlı | Açıklama metnine ilişkin ayrıntılı metin. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa ( çok uzunsa üç nokta görüntülenebilir) |
| Açıklama | İsteğe bağlı | Mağazayla ilgili açıklama. | Serbest metin Önerilen metin boyutu: 90 karakterden az ( çok uzunsa üç nokta görüntülenebilir) |
| Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Konaklama tesisi için puan sayısıdır. Not: Uygulamanız aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa ve öz bir dize girin. büyük bir kısmıdır. Örneğin, sayı 1.000.000 varsa, 1 milyon gibi kısaltmalar kullanabilirsiniz. daha küçük ekran boyutlarında kısaltılır. |
Dize |
| Puan - Sayı Değeri | İsteğe bağlı | Konaklama tesisi için puan sayısıdır. Not: İşlem yapmak istemiyorsanız bu alanı sağlayın. ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri kullanıcılara göstermek için Sayı'yı kullanacağız. |
Uzun |
PointOfInterestEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kesinlikle önerilir. Rozet hem üst hem de alt kısımda 24 dps'lik güvenli bir alan resim |
Yardım için Resim Özellikleri'ne bakın. |
| Konum - Ülke | Zorunlu | Önemli yerin gerçekleştiği ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Önemli yerin bulunduğu şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | Zorunlu | Görülecek önemli yerin adresi belirtir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Önemli yerin açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Önemli yerin bulunduğu eyalet veya il (varsa) bulabilirsiniz. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Önemli yerin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Önemli yerin mahallesi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| AvailabilityTimeWindow - Başlangıç Zamanı | İsteğe bağlı | Önemli noktanın açık/kullanılabilir olması bekleniyor. | Milisaniye cinsinden Epoch zaman damgası |
| AvailabilityTimeWindow - Bitiş Saati | İsteğe bağlı | Önemli noktanın belirleneceği zamana kadar geçen milisaniye cinsinden sıfır zaman damgası açık/kullanılabilir olması bekleniyor. | Milisaniye cinsinden Epoch zaman damgası |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Önemli yer için puan sayısı. Not: Uygulamanız için bu alanı sağlayın sayımın kullanıcılara nasıl görüntüleneceğini kontrol eder. Kısa ve öz bir dize kullanın. Örneğin, sayı 1.000.000 ise kısaltma kullanabilirsiniz. Örneğin 1 milyon gibi. Böylece daha küçük ekran boyutlarında sayı kısaltılmaz. |
Dize |
| Puan - Sayı Değeri | İsteğe bağlı | Önemli yer için puan sayısı. Not: Siz bu alanla ilgili işlem yapmıyorsanız kısaltma mantığını kendiniz görüntüleyin. Hem Sayım hem de Sayım Değeri varsa kullanıcılara Sayaç gösterilir |
Uzun |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Şu nokta için biletlerin/giriş kartının geçerli fiyatı: ilgi alanı. Üstü çizili fiyat sağlanıyorsa sağlanmalıdır. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Önemli yer için biletlerin/giriş kartının orijinal fiyatı. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. |
Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metin üç nokta simgesi gösterilir) |
| İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamaların Listesi
İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
PersonEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Profil - Ad | Zorunlu | Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Doğru", "@TeamPixel" vb.) | Dize Önerilen metin boyutu: Maksimum 50 karakter |
| Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri'ne bakın. |
| Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metinler olmalıdır. | Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Profil - Ek Resim | İsteğe bağlı | Doğrulanmış rozet gibi küçük bir resim. | Yardım için Resim Özellikleri'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 kesinlikle önerilir. Rozet hem üst hem de alt kısımda 24 dps'lik güvenli bir alan resim |
Yardım için Resim Özellikleri'ne bakın. |
| Popülerlik - Sayı | İsteğe bağlı |
Üstbilgi resmini temsil eder. Profil resminden farklı olmalıdır. Bu özellik, bazı insanlar var. Not: Resim en boy oranı 16:9 olmalıdır. Rozet sağlanırsa Resmin hem üstünde hem de altında 24 d/sn güvenli alan sağlanmalıdır |
Dize Önerilen metin boyutu: Sayı + etiket için maksimum 20 karakter birleşik |
| Popülerlik - Sayı Değeri | İsteğe bağlı | Takipçi sayısı veya popülerlik değeri. Not: Uygulamanız bunu istemiyorsa Sayı Değeri sağlayın büyük bir sayının optimize edilmesi için ne kadar farklı ekran boyutlarına sahip. Hem Sayı hem de Sayı Değeri sağlanırsa Adet kullanılacak. |
Uzun |
| Popülerlik - Etiket | İsteğe bağlı | Popülerlik etiketinin ne olduğunu belirtin. Örneğin - "Beğenilenler". | Dize Önerilen metin boyutu: Sayı + etiket için maksimum 20 karakter birleşik |
| Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin ne için olduğunu belirtin. Örneğin - Gösterilen resim Beğenme simgesi, Emoji'ler. 1'den fazla resim eklenebilir ancak bunların tümü, tüm resimlerde gösterilmeyebilir olabilir. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri'ne bakın. |
| Puan - Maksimum değer | Zorunlu | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Geçerli değer | Zorunlu | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Varlık için puan sayısıdır. Not: Uygulamanız aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa ve öz bir dize girin. büyük bir kısmıdır. Örneğin, sayı 1.000.000 varsa, 1 milyon gibi kısaltmalar kullanabilirsiniz. daha küçük ekran boyutlarında kısaltılır. |
Dize |
| Puan - Sayı Değeri | İsteğe bağlı | Varlık için puan sayısıdır. Not: İşlem yapmak istemiyorsanız bu alanı sağlayın. ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri kullanıcılara göstermek için Sayı'yı kullanacağız. |
Uzun |
| Konum - Ülke | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | İsteğe bağlı | Kullanıcının bulunduğu veya reklam sunduğu adres, gösterir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Söz konusu kişinin bulunduğu açık adres (varsa) veya yardımcı olur. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği eyalet (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~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: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Söz konusu kişinin bulunduğu veya hizmet verdiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamaların Listesi
İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
RestaurantReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
| Rezervasyon Başlangıç Zamanı | Zorunlu | Rezervasyonun beklenen zaman damgası (milisaniye cinsinden) başlatabilirsiniz. | Milisaniye cinsinden Epoch zaman damgası |
| Konum - Ülke | Zorunlu | Restoranın bulunduğu ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Restoranın bulunduğu şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | Zorunlu | Kullanıcılara gösterilecek olan lokantanın adresi belirtir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Restoranın açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Restoranın bulunduğu eyalet veya il (geçerliyse) bulabilirsiniz. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Restoranın posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Restoranın bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilir. en boy oranı 16:9'dur | Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Masa Boyutu | İsteğe bağlı | Rezervasyon grubundaki kişi sayısı | Tam sayı > 0 |
EventReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlamasının beklendiği zamanın zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Epoch zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa yüz yüze mi olacağını belirten bir alan her ikisini de seçebilirsiniz. |
Enum: VIRTUAL, IN_PERSON veya HYBRID |
| Konum - Ülke | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştirileceği yerin adı ve kullanıcıya gösterilecektir. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Etkinliğin yapıldığı konumun açık adresi (varsa) budur. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Etkinliğin gerçekleştiği eyalet veya il (geçerliyse) barındırılır. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Etkinliğin gerçekleştiği konumun posta kodu (varsa) barındırılır. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (geçerliyse). | Serbest metin Önerilen metin boyutu: Maksimum ~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 kesinlikle önerilir. Rozet hem üst hem de alt kısımda 24 dps'lik güvenli bir alan resim |
Yardım için Resim Özellikleri'ne bakın. |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönem zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Epoch zaman damgası |
| Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Hizmet için metin veya resim gereklidir sağlar. |
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: Hizmet için metin veya resim gereklidir sağlar. |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
| Rezervasyon Kimliği | İsteğe bağlı | Etkinlik rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa sağlanmalıdır. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Etkinlik biletinin/kartın orijinal fiyatı. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
| Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Etkinlik için verilen puan sayısı. Not: Uygulamanız aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa ve öz bir dize girin. büyük bir kısmıdır. Örneğin, sayı 1.000.000 varsa, 1 milyon gibi kısaltmalar kullanabilirsiniz. daha küçük ekran boyutlarında kısaltılır. |
Dize |
| Puan - Sayı Değeri | İsteğe bağlı | Etkinlik için verilen puan sayısı. Not: İşlem yapmak istemiyorsanız bu alanı sağlayın. ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri kullanıcılara göstermek için Sayı'yı kullanacağız. |
Uzun |
| İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamaların Listesi
İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
LodgingReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Serbest metin. Örneğin, "12 Aralık'taki Konaklamanız" Önerilen metin boyutu: Maksimum 50 karakter |
| Giriş Saati | Zorunlu | Giriş saatini temsil eden, milisaniye cinsinden dönem zaman damgası bir seçenek. | Milisaniye cinsinden Epoch zaman damgası |
| Çıkış Saati | Zorunlu | Çıkış zamanını temsil eden milisaniye cinsinden dönem zaman damgası bir seçenek. | Milisaniye cinsinden Epoch zaman damgası |
| Konum - Ülke | Zorunlu | Konaklama tesisinin bulunduğu ülkedir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Şehir | Zorunlu | Konaklama tesisinin bulunduğu şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Görünen Adres | Zorunlu | Kullanıcıya gösterilecek konaklamanın adresi. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Konaklama tesisinin açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Eyalet | İsteğe bağlı | Konaklama tesisinin bulunduğu eyalet veya il (geçerliyse) bulabilirsiniz. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Konaklama tesisinin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Konum - Mahalle | İsteğe bağlı | Konaklama tesisinin bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Poster resimleri | İsteğe bağlı |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilir. en boy oranı 16:9'dur Not: Rozet sağlanmışsa güvenli bir yerde 24 Resmin hem üstünde hem de altında dps |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Rezervasyon Kimliği | İsteğe bağlı | Konaklama rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Konaklama tesisi için puan sayısıdır. Not: Uygulamanız aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa ve öz bir dize girin. büyük bir kısmıdır. Örneğin, sayı 1.000.000 varsa, 1 milyon gibi kısaltmalar kullanabilirsiniz. daha küçük ekran boyutlarında kısaltılır. |
Dize |
| Puan - Sayı Değeri | İsteğe bağlı | Konaklama tesisi için puan sayısıdır. Not: İşlem yapmak istemiyorsanız bu alanı sağlayın. ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri kullanıcılara göstermek için Sayı'yı kullanacağız. |
Uzun |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli | Konaklamanın mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de belirtilmelidir. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Konaklama ücretinin bahsi geçen ve Kullanıcı arayüzü. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
TransportationReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Serbest metin. Örneğin, "SFO'dan SAN'ye" Önerilen metin boyutu: Maksimum 50 karakter |
| Ulaşım Türü | Zorunlu | Rezervasyon için ulaşım şekli/türü. | Enum: Uçuş, TRAIN, BUS veya FERRY |
| Kalkış Saati | Zorunlu | Kalkış saatini temsil eden milisaniye cinsinden dönem zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Varış Saati | Zorunlu | Varış saatini temsil eden milisaniye cinsinden dönem zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Kalkış Konumu - Ülke | İsteğe bağlı | Kalkış ülkesi. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış Konumu - Şehir | İsteğe bağlı | Kalkış şehri. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış Konumu - Görünen Adres | İsteğe bağlı | Kullanıcıya gösterilecek kalkış konumu. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış Konumu - Açık Adres | İsteğe bağlı | Kalkış konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış Konumu - Eyalet | İsteğe bağlı | Kalkış konumunun bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış Yeri - Posta kodu | İsteğe bağlı | Kalkış konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Kalkış Konumu - Mahalle | İsteğe bağlı | Kalkış konumunun bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Ülke | İsteğe bağlı | Varış ülkesi. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Şehir | İsteğe bağlı | Varış şehri. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Görünen Adres | İsteğe bağlı | Kullanıcıya gösterilecek varış konumu. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Açık Adres | İsteğe bağlı | Varış konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Eyalet | İsteğe bağlı | Varış konumunun bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Posta kodu | İsteğe bağlı | Varış konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Varış Konumu - Mahalle | İsteğe bağlı | Varış konumunun bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Hizmet için metin veya resim gereklidir sağlar. |
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: Hizmet için metin veya resim gereklidir sağlar. |
Yardım için Resim Özellikleri'ne bakın. |
| Poster resimleri | İsteğe bağlı |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilir. en boy oranı 16:9'dur |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Rezervasyon Kimliği | İsteğe bağlı | Ulaşım rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli | Rezervasyonun mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de belirtilmelidir. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Rezervasyonun belirtilen orijinal fiyatı üzerinden Kullanıcı arayüzü. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
| Ulaşım Numarası | Zorunlu | Uçuş numarası, otobüs numarası, tren numarası veya feribot/seyahat numarası. | Serbest metin |
| Uçağa Biniş Saati | Zorunlu | Rezervasyonun biniş saatini temsil eden dönem zaman damgası (varsa) | Milisaniye cinsinden Epoch zaman damgası |
VehicleRentalReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
| Başlık | Zorunlu | Varlığın başlığıdır. | Serbest metin. Örneğin, "Avis Union Square SF" Önerilen metin boyutu: Maksimum 50 karakter |
| Teslim Alma Zamanı | Zorunlu | Rezervasyonun teslim alınma zamanını temsil eden dönem zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Dönüş Saati | İsteğe bağlı | Rezervasyonun çıkış saatini temsil eden dönem zaman damgası. | Milisaniye cinsinden Epoch zaman damgası |
| Alınacağı Adres - Ülke | İsteğe bağlı | Teslim alma konumunun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Alınacağı Adres - Şehir | İsteğe bağlı | Teslim alma konumunun bulunduğu şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Alınacağı Adres - Görünen Adres | İsteğe bağlı | Kullanıcıya gösterilecek teslim alma konumu. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Alınacağı Adres - Açık Adres | İsteğe bağlı | Teslim alma konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Alınacağı Adres - Eyalet | İsteğe bağlı | Teslim alma konumunun bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Alınacağı Adres - Posta kodu | İsteğe bağlı | Teslim alma konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Alınacağı Adres - Mahalle | İsteğe bağlı | Teslim alma konumunun mahallesi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Ülke | İsteğe bağlı | İade konumunun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Şehir | İsteğe bağlı | İade konumunun bulunduğu şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Görünen Adres | İsteğe bağlı | Kullanıcıya gösterilecek iade konumu. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Açık Adres | İsteğe bağlı | İade konumunun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Eyalet | İsteğe bağlı | İade konumunun bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Posta kodu | İsteğe bağlı | İade konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| İade Adresi - Mahalle | İsteğe bağlı | İade konumunun bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
| Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Hizmet için metin veya resim gereklidir sağlar. |
Serbest metin. Örneğin, "Avis Araç Kiralama" |
| Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Hizmet için metin veya resim gereklidir sağlar. |
Yardım için Resim Özellikleri'ne bakın. |
| Poster resimleri | İsteğe bağlı |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilir. en boy oranı 16:9'dur |
Yardım için Resim Özellikleri'ne bakın. |
| Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
| Onay Kimliği | İsteğe bağlı | Araç kiralama rezervasyonunun onay kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli | Rezervasyonun mevcut fiyatı. Üstü çizili fiyat sağlanmışsa bu değer de belirtilmelidir. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Rezervasyonun belirtilen orijinal fiyatı üzerinden Kullanıcı arayüzü. | Serbest metin |
| Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
Resim özellikleri
Resim öğeleri için gerekli özellikler aşağıdaki tabloda listelenmiştir:
| En boy oranı | Minimum piksel sayısı | Önerilen piksel sayısı |
|---|---|---|
Kare (1x1) Tercih edilen |
300x300 | 1.200x1.200 |
| Yatay (1,91x1) | 600x314 | 1.200x628 |
| Dikey (4x5) | 480x600 | 960 x 1.200 |
Google'ın erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir. oluşturabilirsiniz.
Dosya biçimleri
PNG, JPG, statik GIF, WebP
Maksimum dosya boyutu
5.120 KB
Ek öneriler
- Resim güvenli alanı: Önemli içeriğinizi yatay ve dikey yönde ortalanmış olarak görüntüsüdür.
- Resmin ekranda düzgün gösterilebilmesi için şeffaf bir arka plan kullanın. Koyu ve Açık tema ayarları.
İçerik Kategorisi
İçerik kategorisi, uygulamaların birden fazla kullanıcıya ait içeriği yayınlamasına olanak tanır tıklayın. Bu işlem, içeriği önceden tanımlanmış kategorilerden bazılarıyla eşler. Örneğin:
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. oluşturabilirsiniz.
İçerik kategorilerini kullanma kuralları
- ArticleEntity ve GenelFeaturedEntity gibi bazı varlıklar uygun olup olmadığını sorun. Örneğin, Yalnızca EventEntity, EventReservationEntity, PointOfinterestEntity, yalnızca bu kategorilerin bir alt kümesi uygun. Kategori listesini kontrol edin uygun olması gerekir.
Bazı içerik kategorileri için bir kombinasyon yerine belirli bir öğe türünü kullanın. ve ContentCategory (İçerik Kategorisi) arasında şunlar bulunur:
- TYPE_MovieS_AND_TV_SHOWS - Şunlara göz atın: anlamına gelir.
- TYPE_BOOKS - Şuna göz atın: EbookEntity anlamına gelir.
- TYPE_AUDIOBOOKS - Ödeme Şundan önce AudiobookEntity: emin olmanız gerekir.
- TYPE_SHOPPING - Ödeme Şu tarihten önce ShoppingEntity: emin olmanız gerekir.
- TYPE_FOOD_AND_DRINK - Şuradaki varlıkları incele: Gıda Entegrasyonu Kılavuzu anlamına gelir.
ContentCategory alanı isteğe bağlıdır ve içerik daha önce belirtilen kategorilerden hiçbirine ait değildir.
Birden fazla içerik kategorisi sağlanmışsa bunları sırasıyla sağlayın. en alakalı içerik kategorisine yerleştirilen içerikle alaka düzeyi ilk sırada yer alıyor.
2. Adım: Küme verilerini sağlayın
İçerik yayınlama işinin arka planda yürütülmesi önerilir (örneğin, WorkManager kullanarak) düzenlenecek ve düzenli olarak veya etkinlik temelli olarak (örneğin, Kullanıcı uygulamayı açtığında veya kullanıcı sepetine yeni bir ürün eklediğinde).
AppEngagePublishClient, kümeleri yayınlamaktan sorumludur.
İstemcide küme yayınlamak için aşağıdaki API'lerden yararlanabilirsiniz:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishContinuationClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteContinuationClusterdeleteUserManagementClusterdeleteClusters
isServiceAvailable
Bu API, hizmetin entegrasyon için uygun olup olmadığını kontrol etmek ve içeriğin cihazda sunulup sunulamayacağını belirler.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task ->
if (task.isSuccessful) {
// Handle IPC call success
if(task.result) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
Java
client.isServiceAvailable().addOnCompleteListener(task - > {
if (task.isSuccessful()) {
// Handle success
if(task.getResult()) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
publishRecommendationClusters
Bu API, RecommendationCluster nesnelerin listesini yayınlamak için kullanılır.
Kotlin
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build()
)
.build()
)
Java
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
new RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build())
.build());
Hizmet isteği aldıktan sonra, bir işlem:
- Geliştirici iş ortağındaki mevcut
RecommendationClusterverileri kaldırılır. - İstekten elde edilen veriler ayrıştırılır ve güncellenen Öneride depolanır Küme.
Bir hata olması durumunda isteğin tamamı reddedilir ve mevcut durum elde edilir.
publishFeaturedCluster
Bu API, FeaturedCluster nesnelerin listesini yayınlamak için kullanılır.
Kotlin
client.publishFeaturedCluster(
PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
Java
client.publishFeaturedCluster(
new PublishFeaturedClustersRequest.Builder()
.addFeaturedCluster(
new FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
Hizmet isteği aldıktan sonra, bir işlem:
- Geliştirici iş ortağındaki mevcut
FeaturedClusterverileri kaldırılır. - İstekteki veriler ayrıştırılır ve güncellenmiş Öne Çıkan Kümede depolanır.
Bir hata olması durumunda isteğin tamamı reddedilir ve mevcut durum elde edilir.
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ıktan sonra, bir işlem:
- Geliştirici iş ortağındaki mevcut
ContinuationClusterverileri kaldırılır. - İstekten elde edilen veriler ayrıştırılır ve güncellenmiş Devamlılık'ta depolanır Küme.
Bir hata olması durumunda isteğin tamamı reddedilir ve mevcut durum elde edilir.
publishUserAccountManagementRequest
Bu API, bir Oturum Açma kartı yayınlamak için kullanılır . Oturum açma işlemi, kullanıcıları şuraya yönlendirir: uygulamanın içerik yayınlayabilmesi (veya daha fazla bilgi sağlayabilmesi için) kişiselleştirilmiş içerik)
Aşağıdaki meta veriler, Oturum Açma Kartının bir parçasıdır:
| Özellik | Şartlar | Açıklama |
|---|---|---|
| İşlem URI'sı | Zorunlu | İşlem için derin bağlantı (ör. uygulamada oturum açma sayfasına gider) |
| Resim | İsteğe bağlı: Sağlanmamışsa başlık belirtilmelidir |
Kartta Gösterilen Resim 1264x712 çözünürlüklü, 16x9 en boy oranında resimler |
| Başlık | İsteğe bağlı: Sağlanmamışsa resim sağlanmalıdır | Karttaki Başlık |
| İşlem Metni | İsteğe bağlı | CTA'da (ör. Oturum Aç) gösterilen metin |
| Alt başlık | İsteğe bağlı | Kartta İsteğe Bağlı Alt Başlık |
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ıktan sonra, bir işlem:
- Geliştirici iş ortağındaki mevcut
UserAccountManagementClusterverileri: emin olun. - İstekten elde edilen veriler ayrıştırılır ve güncellenen UserAccountManagementCluster Kümesi.
Bir hata olması durumunda isteğin tamamı reddedilir ve mevcut durum elde edilir.
updatePublishStatus
Şirket içi işle ilgili herhangi bir nedenle kümelerden hiçbiri yayınlanmazsa kesinlikle yayınlanma durumunu updatePublishStatus API'si. Bu önemlidir, çünkü :
- İçerik yayınlandığında bile tüm senaryolarda durumu bildirmek (STATUS == YAYINLANDI), bunu kullanan gösterge tablolarının doldurulması için açık durumunu kullanarak entegrasyonunuzun durumunu ve diğer metriklerini aktarın.
- İçerik yayınlanmadıysa ancak entegrasyon durumu bozuk değilse (STATUS == NOT_PUBLISHED) kullanıyorsanız Google, uygulamada uyarıları tetiklemekten kaçınabilir. sağlık kontrol panelleridir. İçeriğin şu nedenden dolayı yayınlanmadığını onaylar: beklenen durumu ifade eder.
- Geliştiricilerin verilerin ne zaman yayınlandığı ve ne zaman yayınlandığı değil.
- Google, durum kodlarını kullanarak kullanıcıyı belirli işlemleri gerçekleştirmeye teşvik etmek için uygulama içeriğini görebilmeleri veya üstesinden gelebilmeleri için uygulamayı kullanabilirler.
Uygun yayınlama durum 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, bir kullanıcının giriş yapmaması nedeniyle yayınlanmazsa Google Oturum Açma Kartı'nı yayınlamanızı öneririz. Sağlayıcılar herhangi bir nedenle kartı yayınlamak için Google Ad Manager'ı Durum kodunu içeren updatePublishStatus API'si NOT_PUBLISHED_REQUIRES_SIGN_IN
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ümeleri. Bir hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteFeaturedCluster
Bu API, Öne Çıkan Küme'nin içeriğini silmek için kullanılır.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Hizmet isteği aldığında, mevcut verileri Öne Çıkan Küme. Bir hata olması durumunda, isteğin tamamı reddedilir ve mevcut durumun sürdürülmesini sağlar.
deleteContinuationCluster
Bu API, Devam Kümesinin içeriğini silmek için kullanılır.
Kotlin
client.deleteContinuationCluster()
Java
client.deleteContinuationCluster();
Hizmet isteği aldığında, mevcut verileri Devam Kümesi. Bir 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ümesi. Bir hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteClusters
Bu API, belirli bir küme türünün içeriğini silmek için kullanılır.
Kotlin
client.deleteClusters(
DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_CONTINUATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.build())
Java
client.deleteClusters(
new DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_CONTINUATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.build());
Hizmet isteği aldıktan sonra, tüm hizmetlerden mevcut verileri belirtilen küme türleriyle eşleşen kümeler. Müşteriler, tek bir veya daha fazla bulunur. Bir hata olması durumunda, isteğin tamamı reddedilir ve mevcut durumun sürdürülmesini sağlar.
Hata işleme
Örneğin, yayınlanan API'lerin görev sonucunu dinlemeniz önerilir. bir takip eylemi uygulanarak başarılı bir görevi kurtarıp yeniden gönderin.
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, nedeni bir AppEngageException olarak döndürülür.
hata kodu.
| Hata kodu | Not |
|---|---|
SERVICE_NOT_FOUND |
Hizmet, belirtilen cihazda kullanılamıyor. |
SERVICE_NOT_AVAILABLE |
Hizmet belirtilen cihazda kullanılabilir ancak kullanılamıyor (örneğin, açıkça devre dışı bırakılmışsa). |
SERVICE_CALL_EXECUTION_FAILURE |
Görev yürütülemedi, ileti dizisi sorunları nedeniyle başarıs��z oldu. Bu durumda, tekrar deneyin. |
SERVICE_CALL_PERMISSION_DENIED |
Arayanın hizmet çağrısı yapmasına izin verilmiyor. |
SERVICE_CALL_INVALID_ARGUMENT |
İstek, geçersiz veri içeriyor (örneğin, izin verilenden daha fazla) küme sayısı) ekleyebilirsiniz. |
SERVICE_CALL_INTERNAL |
Hizmet tarafında bir hata oluştu. |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Hizmet çağrısı çok sık yapılıyor. |
3. Adım: Yayın amaçlarını ele alın
Bir iş üzerinden publish Content API çağrıları yapmanın yanı sıra
ayarlamak için gereken
Almak için BroadcastReceiver
içerik yayınlama isteği.
Amaca dayalı yayınların amacı, temel olarak uygulamanın yeniden etkinleştirilmesi ve verilerin zorunlu kılınmasıdır. senkronize edin. Yayın amaçları çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca Etkileşim Hizmeti içeriğin eski olabileceğini belirlediğinde ( örneğin bir hafta önce oluşturulmuş olmalıdır). Bu şekilde kullanıcının uygulama yalnızca bir kez çalıştırılmamış olsa bile, uzun süre korunuyor.
BroadcastReceiver aşağıdaki iki şekilde ayarlanmalıdır:
BroadcastReceiversınıfının bir örneğiniContext.registerReceiver(). Bu, uygulamalardan iletişim kurulmasını hale getirebilirsiniz.
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));
}
<receiver>AndroidManifest.xmldosya Bu, uygulamanın yayın almasına izin verir amaçlarına ulaşmasını sağlar ve ayrıca uygulamanın, uygulama daha iyi olur.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Aşağıdaki intentler, hizmet:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONÖnerilirpublishRecommendationClustersaraması başlatın.com.google.android.engage.action.PUBLISH_FEATUREDÖnerilir. Bu niyeti alırkenpublishFeaturedClusteraraması başlatın.com.google.android.engage.action.PUBLISH_CONTINUATIONÖnerilir. Bu niyeti alırkenpublishContinuationClusteraraması başlatın.
Entegrasyon iş akışı
İşlem tamamlandıktan sonra entegrasyonunuzu doğrulamayla ilgili adım adım açıklamalı kılavuz için Etkileşim kurma geliştirici entegrasyonu iş akışı
SSS
Etkileşim SDK'sıyla İlgili Sık Sorulan Sorular bölümüne bakın. SSS
İletişim
İletişim varsa engagement-developers@google.com entegrasyon sürecinde herhangi bir sorunuz olursa
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonra şu adımları uygulayabilirsiniz:
- Şu adrese e-posta gönder: engagement-developers@google.com ve Google tarafından teste hazır olan entegre APK'nızı ekleyin.
- Google, web sitenizin entegrasyonun beklendiği gibi çalıştığından emin olun. Değişiklik gerekirse Google sizinle e-posta gönderin.
- Test tamamlandığında ve değişiklik gerekmiyorsa Google, Güncellenmiş ve entegre APK'yı şurada yayınlamaya başlayabileceğinizi size bildiren: Play Store'da bulabilirsiniz.
- Google, güncellenen APK'nızın Play Store, Öneriniz, Öne Çıkanlar ve Devam kümeler yayınlanabilir ve kullanıcılar tarafından görülebilir.