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'ya 50 KB'tan daha az (sıkıştırılmış) boyut ekler ve çoğu uygulamanın geliştirici süresini yaklaşık bir hafta uzatır. Daha fazla bilgi için işletme sitemizi ziyaret edin.
Bu 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.
Android becerileri
GitHub'da görüntüleEngage SDK'sını entegre etme
android skills add engage-sdk-integrationEntegrasyon ayrıntıları
Terminoloji
Bu entegrasyon aşağıdaki üç küme türünü içerir: Öneri, Öne Çıkanlar ve Devam.
Öneri kümelerinde, tek bir geliştirici iş ortağından kişiselleştirilmiş öneriler gösterilir. Aynı geliştirici iş ortağının önerilerinden oluşan bir grubu içeren kullanıcı arayüzü görünümüdür.
ArticleEntity: Birden fazla içerik kategorisiyle alakalı içerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. ArticleEntity öğesi, geliştiricilerin GenericFeaturedEntity'ye kıyasla kullanıcılara bilgi vermek 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'yi 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 önemli bir bilgidir.
Şekil 2: Öneriler kümesinde tek bir EventEntity gösteren kullanıcı arayüzü. LodgingEntity: LodgingEntity, otel, apartman dairesi, kısa ve uzun süreli kiralık tatil evi gibi konaklama yerlerini temsil eder.
Şekil 3: Öneriler kümesinde tek bir LodgingEntity'yi gösteren kullanıcı arayüzü. StoreEntity: StoreEntity, mağazayı, restoranı, kafeyi vb. temsil eder. Yemek yenebilecek bir yerin veya mağazanın, kullanıcılara iletilmesi gereken önemli bilgi olduğu içerikleri vurgular.
Şekil 4: Öneriler kümesinde tek bir StoreEntity'nin gösterildiği kullanıcı arayüzü. PointOfInterestEntity: PointOfInterestEntity, benzin istasyonu, etkinlik alanı, tema parkı, müze, turistik yer, yürüyüş parkuru vb. 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 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 çıkarma şeklinde olabilir.
Şekil 5: Öneriler kümesinde tek bir PersonEntity'yi gösteren kullanıcı arayüzü.
Devam kümesinde, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağının kullanıcılarının son zamanlarda etkileşimde bulunduğu içerikler gösterilir. Her geliştirici iş ortağı, Devamlılık kümesinde 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çerik için metin tabanlı bir öneriyi temsil eden ArticleEntity. Bu öğe, tamamlanmamış haber makalelerini veya kullanıcının kaldığı yerden devam etmek istediği diğer içerikleri temsil etmek için kullanılabilir. Ör. Pazarlama içeriği, haber snippet'i
Şekil 6. Devamlılık kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü. RestaurantReservationEntity: RestaurantReservationEntity, bir restoran veya kafe rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden restoran rezervasyonlarını takip etmesine yardımcı olur.
Şekil 7. Devam kümesinde tek bir RestaurantReservationEntity'yi gösteren kullanıcı arayüzü. EventReservationEntity: EventReservationEntity, bir etkinliğin rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden etkinlik rezervasyonlarını takip etmesine yardımcı olur. Etkinlikler aşağıdakileri içerebilir ancak bunlarla sınırlı değildir:
- Futbol maçı rezervasyonu gibi spor etkinlikleri
- E-spor rezervasyonu gibi oyun etkinlikleri
- Sinemada film rezervasyonu, konser, tiyatro, kitap imza günü gibi eğlence etkinlikleri
- Rehberli turlar ve müze biletleri gibi seyahat veya önemli yer rezervasyonları
- Sosyal etkinlik / seminer / konferans rezervasyonları
- Eğitim / Eğitim oturumları rezervasyonları
Şekil 8. Devamlılık kümesinde tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü. LodgingReservationEntity: LodgingEntityReservation, seyahat konaklaması için yapılan rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden otel ya da kiralık yer rezervasyonlarını takip etmesine yardımcı olur.
Şekil 9. Devamlılık kümesinde tek bir LodgingReservationEntity'yi gösteren kullanıcı arayüzü. TransportationReservationEntity: TransportationReservationEntity, herhangi bir ulaşım şekliyle yapılan ulaşım rezervasyonunu 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.
Şekil 10. Devamlılık kümesinde tek bir TransportationReservationEntity'nin gösterildiği kullanıcı arayüzü. VehicleRentalReservationEntity: VehicleRentalReservationEntity bir 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ümesi içinde tek bir VehicleRentalReservationEntity gösteren kullanıcı arayüzü.
Öne Çıkanlar kümesi, birçok geliştirici iş ortağının seçilen öne çıkan uygulamasını
GenericFeaturedEntitytek bir kullanıcı arayüzü gruplandırmasında gösteren bir kullanıcı arayüzü görünümüdür. Tek bir Öne Çıkan kü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 en çok görüntülenen 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: Tek bir öne çıkan öğeyi gösteren kullanıcı arayüzü Öne çıkan öğe kümesindeki GenericFeaturedEntity 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.6.0'
}
Özet
Tasarım, bağlı bir hizmetin uygulanmasına dayanır.
Bir müşterinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:
| Küme türü | Küme sınırları | Bir kümedeki minimum öğe sınırları | Bir kümedeki maksimum öğe sınırları |
|---|---|---|---|
| Öneri kümeleri | En fazla 7 | En az 1 | En fazla 50 (ArticleEntity, EventEntity,
LodgingEntity, StoreEntity,
PointOfInterestEntity veya PersonEntity) |
| Devam Kümesi | En fazla 1 | En az 1 | En fazla 20 (ArticleEntity,
EventReservationEntity,
LodgingReservationEntity,
TransportationReservationEntity veya
VehicleRentalReservationEntity) |
| Öne Çıkan Küme | En fazla 1 | En az 1 | En fazla 20 (GenericFeaturedEntity) |
1. adım: 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 koşullar ö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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. Resmin/videonun üzerinde özel kullanıcı deneyimi uygulaması (ör. resmin üzerinde rozet yer paylaşımı)
|
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| İçerik Kategorileri | İsteğe bağlı | Varlığın içerdiği içeriğin kategorisini açıklayın. | Enum listesi Yol gösterici bilgiler 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 kesinlikle önerilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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) | Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. Resmin/videonun üzerinde özel kullanıcı deneyimi uygulaması (ör. resmin üzerinde rozet yer paylaşımı)
|
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| İçerik yayınlama zamanı | İsteğe bağlı | Bu, içeriğin uygulamada yayınlandığı / güncellendiği zamana ait milisaniye cinsinden Unix zamanı zaman damgasıdır. | Milisaniye cinsinden dönem zaman damgası |
| Son Etkileşim Zamanı | Koşullu 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şullu 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 (bu değerler dahil) bir tam sayı değeri. |
| İçerik Kategorileri | İsteğe bağlı | Varlığın içerdiği içeriğin kategorisini açıklayın. | Enum listesi Yol gösterici bilgiler 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 kesinlikle önerilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Konum - Ülke | Koşullu olarak zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID etkinlikleri için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Koşullu olarak zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya HYBRID etkinlikleri için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | Koşullu olarak zorunlu | Etkinliğin yapılacağı ve kullanıcıya gösterilmesi gereken adres veya mekan adı. Not: Bu, IN_PERSON veya HYBRID etkinlikleri 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 yerin 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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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ı | Varlığın içerdiği içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Yol gösterici bilgiler 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Poster resimleri | Zorunlu |
Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en-boy oranı 16:9'dur. Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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 tesisinin bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Konaklama yerinin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Konaklama yerinin bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| AvailabilityTimeWindow - Start Time (KullanılabilirlikZamanAralığı - Başlangıç Zamanı) | İsteğe bağlı | Tesisin açık/kullanılabilir olmasının beklendiği zamanın milisaniye cinsinden epoch zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| AvailabilityTimeWindow - End Time (Kullanım zaman aralığı - bitiş zamanı) | İsteğe bağlı | Tesisin açık/kullanılabilir olmasının beklendiği, milisaniye cinsinden epoch zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| Puan - Maksimum değer | İsteğe bağlı | Puan ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa belirtilmesi gerekir. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Puan ölçeğinin geçerli değeri. Puanın maksimum değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Konaklama tesisinin 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 kısaltılmaması için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Konaklama tesisinin puan sayısı. Not: Görüntüleme 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ı. Üstü ç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. | Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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ğazayla ilgili bir tanıtımı, etkinliği veya güncellemeyi öne çıkaran açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Açıklama metnindeki küçük yazı | İsteğe bağlı | Açıklama metninin küçük puntolu 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ı | Puan ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa belirtilmesi gerekir. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Puan ölçeğinin geçerli değeri. Puanın maksimum değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Konaklama tesisinin puan sayısı. Not: Uygulamanızın, bu bilginin 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 tesisinin 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 kesinlikle önerilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Konum - Ülke | Zorunlu | Önemli yerin bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Zorunlu | Önemli yerin bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | Zorunlu | Kullanıcıya gösterilecek önemli yerin adresi. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Önemli yerin açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | İlgi çekici yerin bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Önemli yerin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Önemli yerin bulunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| AvailabilityTimeWindow - Start Time (KullanılabilirlikZamanAralığı - Başlangıç Zamanı) | İsteğe bağlı | Önemli yerin açık/kullanılabilir olması beklenen zamana ait milisaniye cinsinden Unix zamanı damgası. | Milisaniye cinsinden dönem zaman damgası |
| AvailabilityTimeWindow - End Time (Kullanım zaman aralığı - bitiş zamanı) | İsteğe bağlı | İlgi çekici noktanın 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 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 yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Puan - Maksimum değer | İsteğe bağlı | Puan ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa belirtilmesi gerekir. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Puan ölçeğinin geçerli değeri. Puanın maksimum değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Önemli yerin 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 kısaltılmaması için 1M gibi bir kısaltma kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Önemli yerin puan sayısı. Not: Görüntüleme 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 yerin biletlerinin/giriş kartının güncel fiyatı. Üstü çizili fiyat sağlanıyorsa bu özellik de 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ı | 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ı | Varlığın içerdiği içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Yol gösterici bilgiler 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metinler. | Serbest metin Önerilen metin boyutu: En fazla 15 karakter |
| Profil - Ek Resim | İsteğe bağlı | Doğrulama rozeti gibi küçük bir resim. | Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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 kesinlikle önerilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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 maksimum 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, büyük bir sayının farklı ekran boyutları için nasıl optimize edileceğiyle ilgili mantığı işlemek istemiyorsa Count Value (Sayı Değeri) özelliğini 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 için maksimum 20 karakter birleştirilmiş |
| Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin amacını belirtin. Örneğin, beğen simgesi ve emojilerin gösterildiği bir resim. Tüm form faktörlerinde gösterilmeyebilecek olsa da birden fazla resim sağlayabilir. Not: Kare 1:1 resim olmalıdır. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Puan - Maksimum değer | Zorunlu | Puan ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa belirtilmesi gerekir. |
Sayı >= 0,0 |
| Puan - Geçerli değer | Zorunlu | Puan ölçeğinin geçerli değeri. Puanın maksimum değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Varlığın derecelendirme sayısı. Not: Uygulamanızın, bu bilginin 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 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 |
| 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 sokak adresi (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 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 yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| İçerik Kategorileri | İsteğe bağlı | Varlığın içerdiği içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Yol gösterici bilgiler 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 Unix zaman damgası (milisaniye cinsinden). | 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 (geçerliyse). | 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. | Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Tablo Boyutu | İsteğe bağlı | Rezervasyon grubundaki kişi sayısı | Tam sayı > 0 |
EventReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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şullu olarak zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya HYBRID etkinlikleri için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Koşullu olarak zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya HYBRID etkinlikleri için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | Koşullu olarak zorunlu | Etkinliğin yapılacağı ve kullanıcıya gösterilmesi gereken adres veya mekan adı. Not: Bu, IN_PERSON veya HYBRID etkinlikleri 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 yerin 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 kesinlikle önerilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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, etkinlik organizatörünün/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. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yerleşimi). Not: Rozet için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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ı | Puan ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa belirtilmesi gerekir. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Puan ölçeğinin geçerli değeri. Puanın maksimum değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Etkinliğin derecelendirme sayısı. Not: Uygulamanızın, bu bilginin 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ı | Varlığın içerdiği içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Yol gösterici bilgiler 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 tesisinin 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 tesisinin 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 olduğundan emin olun. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rezervasyon kimliği | İsteğe bağlı | Konaklama rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Puan - Maksimum değer | İsteğe bağlı | Puan ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa belirtilmesi gerekir. |
Sayı >= 0,0 |
| Puan - Geçerli değer | İsteğe bağlı | Puan ölçeğinin geçerli değeri. Puanın maksimum değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Konaklama tesisinin puan sayısı. Not: Uygulamanızın, bu bilginin 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 tesisinin 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ı. Üstü ç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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 | Rezervasyonun ulaşım şekli/türü. | Enum: FLIGHT, TRAIN, BUS veya FERRY |
| Kalkış Zamanı | Zorunlu | Kalkış zamanını temsil eden milisaniye cinsinden epoch zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| Varış saati | 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öster | İ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ış konumunun 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ış yeri: Mahalle | İ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 - Görünen adres | İ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ış yerinin 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ış yerinin 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. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rezervasyon kimliği | İsteğe bağlı | Ulaşım rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli | Rezervasyonun mevcut fiyatı. Üstü ç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) |
| Taşıma Numarası | Zorunlu | Uçuş numarası, otobüs numarası, tren numarası veya feribot/gemi numarası. | Serbest metin |
| Biniş Zamanı | Zorunlu | Rezervasyonun biniş zamanını temsil eden epoch 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: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümüne 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 Saati | 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 gösteren dönem zaman damgası. | Milisaniye cinsinden dönem zaman damgası |
| Teslim Alma Adresi - Ülke | İsteğe bağlı | Teslim alma konumunun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim Alma Adresi - Şehir | İsteğe bağlı | Teslim alma konumunun bulunduğu şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim 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 alma adresi - Posta kodu | İsteğe bağlı | Teslim alma konumunun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Teslim alma adresi - 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ı | İadenin yapılacağı konumun bulunduğu ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Şehir | İsteğe bağlı | İadenin yapılacağı konumun 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 iadenin yapılacağı konum. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Açık Adres | İsteğe bağlı | İadenin yapılacağı konumun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Eyalet | İsteğe bağlı | İadenin yapılacağı konumun bulunduğu eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Posta kodu | İsteğe bağlı | İadenin yapılacağı konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| İade Adresi - Mahalle | İsteğe bağlı | İadenin yapılacağı konumun 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 Araç Kiralama" |
| Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| 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. |
Yönergeler için Resim Özellikleri başlıklı makaleyi inceleyin. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
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 hem açıklama hem de altyazı listesi değil, yalnızca biri gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Onay kimliği | İsteğe bağlı | Araç kiralama rezervasyonunun onay kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli | Rezervasyonun mevcut fiyatı. Üstü ç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 | 1.200x628 |
| 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
5120 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ış bazı kategorilerle 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 öğesini 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 listenin başında yer almalıdır.
2. adım: Küme verilerini sağlayın
İç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ılır:
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.
Engage SDK v1.6.0 ve sonraki sürümler için (önerilir)
Android becerileri
GitHub'da görüntüleEngage SDK entegrasyonu
android skills add engage-sdk-integrationUse the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.Yayınlamayı planladığınız her küme türü için hizmetin kullanılabilirliğini kontrol edebilirsiniz. isServiceAvailable API, hizmet kullanılabilirliğinin kontrol edilmesi gereken küme türlerini içeren bir istek nesnesi, ServiceAvailabilityRequest kabul eder. ClusterType enum değerlerini
ServiceAvailabilityRequest için aşağıdaki tablodan bulabilirsiniz.
| Küme Türü | Küme Türü Sabiti | Tam Sayı Değeri |
|---|---|---|
| Bilinmiyor | TYPE_UNKNOWN |
0 |
| Öneri Kümesi | TYPE_RECOMMENDATION |
1 |
| Öne Çıkan Küme | TYPE_FEATURED |
2 |
| Devam Kümesi | TYPE_CONTINUATION |
3 |
| Alışveriş Sepeti Kümesi | TYPE_SHOPPING_CART |
4 |
| Yemek Yeniden Sipariş Kümesi | TYPE_FOOD_REORDER |
5 |
| Gıda Alışveriş Sepeti Kümesi | TYPE_FOOD_SHOPPING_CART |
6 |
| Yemek Alışverişi Listesi Kümesi | TYPE_FOOD_SHOPPING_LIST |
7 |
| Kullanıcı Yönetimi Kümesi | TYPE_ENGAGEMENT |
8 |
| Alışveriş Listesi Kümesi | TYPE_SHOPPING_LIST |
9 |
| Alışveriş yeniden sipariş kümesi | TYPE_SHOPPING_REORDER |
10 |
| Alışveriş Siparişi Takibi Kümesi | TYPE_SHOPPING_ORDER_TRACKING |
11 |
| Abonelik Kümesi | TYPE_SUBSCRIPTION |
12 |
| Arama ağı anahtar kelime kümesine devam etme | TYPE_CONTINUE_SEARCH |
13 |
| Rezervasyon kümesi | TYPE_RESERVATION |
14 |
Kotlin
val request = ServiceAvailabilityRequest.Builder()
.addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
.addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
.build()
client.isServiceAvailable(request).addOnCompleteListener { task ->
if (task.isSuccessful) {
val availabilityMap = task.result
if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
// Proceed with publishing continuation content
}
if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
// Proceed with publishing recommendation content
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
Java
ServiceAvailabilityRequest request =
new ServiceAvailabilityRequest.Builder()
.addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
.addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
.build();
client.isServiceAvailable(request).addOnCompleteListener(task -> {
if (task.isSuccessful()) {
Map<Integer, Boolean> availabilityMap = task.getResult();
if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
// Proceed with publishing continuation content
}
if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
// Proceed with publishing recommendation content
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
Koşullu Hizmet Kullanılabilirliği Özelliği
Bazı entegre uygulamalar, yayın maliyetlerini düşürmek için Engage hizmetini aralıklı olarak etkinleştiren ve devre dışı bırakan özel bir yapılandırma ister. Bu aralıklı içerik alımı stratejisi mümkün olsa da kullanıcıyı ve ürünü olumsuz etkiler. Eski içerikler gösterilmez ve bazı yüzeyler hiç sunulmaz.
Engage SDK, v1.6.0 sürümünden itibaren belirli küme türlerinin kullanılabilirliğini kontrol etmeye olanak tanır. Bu sayede, belirli bir uygulama aralıklı içerik stratejisini benimsediyse bazı küme türleri bu aralıklı stratejiyi takip edebilirken diğer küme türleri her zaman etkin olabilir (ör. devamlılık kümeleri).
Engage hizmetinin herhangi bir nedenle desteklenen tüm cihazlarda "sürekli" etkinleştirilmemesi ve herhangi bir cihaz grubu için aralıklı alım üzere yapılandırılması durumunda, tüm devamlılık kümesi yayınları (ör. Okumaya Devam Et ve Rezervasyonlar) varsayılan yapılandırmayla etkinleştirilmeye devam eder ve küme türlerinin geri kalanı aralıklı olarak etkinleştirilir ve devre dışı bırakılır. Aralıklı alım sizin için geçerliyse ancak bu varsayılan yapılandırma ihtiyaçlarınıza uygun değilse lütfen engage-developers@google.com adresiyle iletişime geçin.
v1.6.0'dan önceki SDK sürümleri için (desteği sonlandırıldı)
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 alınan 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 depolanı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. Bu özellik sağlanmazsa Başlık özelliği 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ı. Sağlanmazsa resim sağlanmalıdır. | Kartın üzerindeki ad |
| İşlem Metni | İsteğe bağlı | CTA'da Gösterilen Metin (ör. Oturum aç) |
| Alt başlık | İsteğe bağlı | Kartta isteğe bağlı altyazı |
Kotlin
var SIGN_IN_CARD_ENTITY =
SignInCardEntity.Builder()
.addPosterImage(
Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build()
client.publishUserAccountManagementRequest(
PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY =
new SignInCardEntity.Builder()
.addPosterImage(
new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build();
client.publishUserAccountManagementRequest(
new PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağı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ümelerden hiçbiri yayınlanmazsa updatePublishStatus API'sini kullanarak yayın durumunu güncellemenizi önemle tavsiye ederiz. Bu önemlidir, çünkü :
- İçerik yayınlanmış olsa bile (STATUS == PUBLISHED) tüm senaryolarda durumu sağlamak, entegrasyonunuzun durumu 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.
- Bu, geliştiricilerin verilerin ne zaman yayınlandığına dair analizler sunmasına yardımcı olur.
- Google, kullanıcıyı uygulamada belirli işlemleri yapmaya yönlendirmek için durum kodlarını kullanabilir. Böylece kullanıcı, uygulama içeriğini görebilir veya sorunu çözebilir.
Uygun yayınlama durumu kodlarının listesi :
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
İçerik, oturum açmamış bir kullanıcı nedeniyle yayınlanmıyorsa Google, oturum açma kartının yayınlanmasını önerir. Sağlayıcılar herhangi bir nedenle oturum açma kartını yayınlayamıyorsa durum kodu NOT_PUBLISHED_REQUIRES_SIGN_IN ile updatePublishStatus API'sinin ç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 Grupları'ndan kaldırır. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteFeaturedCluster
Bu API, öne çıkarılan kümenin içeriğini silmek için kullanılır.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Hizmet, isteği aldığında mevcut verileri Öne Çıkan Küme'den kaldırır. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteContinuationCluster
Bu API, Devam Ettirme 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. Müşteriler bir veya daha fazla küme türü iletebilir. 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ılabiliyor ancak arama sırasında kullanılamıyor (örneğin, açıkça devre dışı bırakılmış). |
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ın hizmet araması yapmasına izin verilmiyor. |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
İstek geçersiz veriler içeriyor (ör. izin verilen küme sayısından fazla). |
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şleyin
İçerik yayınlama API çağrılarını bir iş aracılığıyla yapmanın yanı sıra, içerik yayınlama isteğini almak için bir BroadcastReceiver ayarlamanız da gerekir.
Yayın amaçlarının temel hedefi, 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 (ör. 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şayacağından daha fazla emin olunabilir.
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 gelen iletişime olanak tanır.
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>dosyanızdaAndroidManifest.xmletiketiyle statik olarak bir uygulama beyan edin. 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şlatmanız önerilir.com.google.android.engage.action.PUBLISH_CONTINUATIONBu amaç alındığındapublishContinuationClustergörüşmesi başlatmanız önerilir.
Entegrasyon iş akışı
Entegrasyonunuz tamamlandıktan sonra doğrulama ile ilgili adım adım kılavuz için Engage geliştirici entegrasyonu iş akışı başlıklı makaleyi inceleyin.
SSS
Sık sorulan sorular için Engage SDK ile ilgili sık sorulan sorular bölümüne bakın.
İletişim
Entegrasyon süreciyle ilgili sorularınız 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 dahili olarak inceler. 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.