Google, cihaz üzerinde kullanıcıların özelliklerini düzenleyen bir yüzey oluşturuyor. 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 deneyimi, geliştirici iş ortaklarına En iyi zengin içeriklerini YouTube dışındaki özel bir kanalda sergileme fırsatı en iyi yoludur. Bu kılavuz, geliştirici iş ortaklarının seyahatlerini ve bu alanı doldurmak için Engage SDK'sını kullanarak yeni bir yüzey alanı seçin.
Entegrasyon ayrıntıları
Terminoloji
Bu entegrasyon şu üç küme türünü içerir: Öneri, Öne Çıkanlar ve Devam.
Öneri kümeleri, kişiselleştirilmiş seyahat ve etkinlik önerileri Google Analytics 4'te e-posta alırsınız. Bu öneriler veya genelleştirilmiş (örneğin, trend öğeler) kullanılabilir. Tekliflerinizi otomatikleştirmek ve optimize etmek için Bunlar; makale, etkinlik, konaklama veya ilgi çekici yerler göstermek için öneriler.
- Öneri kümesi;
ArticleEntity
,EventEntity
,LodgingEntity
,PointOfInterestEntity
veyaStoreEntity
giriş, ancak farklı tüzel kişiliklerin bir karışımı olmamalıdır.
Önerileriniz aşağıdaki yapıya sahiptir:
Öneri Kümesi: Bir kullanıcı arayüzü görünümü aynı geliştirici iş ortağından gelen önerilerle ilgilidir.
Varlık: Kümedeki tek bir öğeyi temsil eden nesne. Bu entegrasyonu, Search Ads 360 API'sinde de yalnızca Öneri Kümesi:
MakaleEntity: ArticleEntity, şuna yönelik bir öneriyi temsil eder: seyahat ve seyahat ile ilgili metin tabanlı içerik etkinlikler. Şunlar için kullanılabilir: makale, blog yayını, pazarlama içeriği, haber snippet'i vb.
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.
LodgingEntity: LodgingEntity, bir konaklama yerini temsil eder. kısa ve uzun vadeli otel, daire, tatil evi olarak kiralama.
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.
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.
- Öneri kümesi;
Devam kümesi, şuradan gelen kullanıcıların yakın zamanda etkileşimde bulunduğu içerikleri gösterir: 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: ArticleEntity, içerik için bir öneriyi temsil eder Bunlar seyahat ve etkinlikler. Bu varlık, tamamlanmamış haber makaleleri veya kullanıcının görmek istediği diğer içerik kaldığı yerden tüketmeye devam edebilir. Ör.: Haber snippet'i, blog yayını bir seyahat hedefi veya etkinlikle ilgili snippet'ler
RestaurantReservationEntity: RestaurantReservationEntity temsil eder rezervasyonları yaptırmalarına yardımcı olur ve kullanıcıların yaklaşan devam eden restoran rezervasyonları.
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ı
LodgingReservationEntity: LodgingEntityReservation, bir konaklama rezervasyonları yapar ve kullanıcıların yaklaşan ya da devam eden otel veya kiralık yer rezervasyonları.
TransportationReservationEntity: TransportationReservationEntity herhangi bir ulaşım şekline yönelik ulaşım rezervasyonunu 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.
VehicleRentalEntity: Araç Kiralama Rezervasyonu Araç kiralama rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden araç kiralama rezervasyonları anlamına gelir.
Ö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.
Ö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 veya
PointOfInterestEntity ) |
Devam Kümesi | En fazla 1 | En az 1 | En çok 10 (ArticleEntity ,
RestaurantReservationEntity
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 Seyahat ve seyahat için aşağıdaki tüzel kişiler Etkinlik kategorisi:
GenericFeaturedEntity
ArticleEntity
EventEntity
LodgingEntity
StoreEntity
PointOfInterestEntity
RestaurantReservationEntity
EventReservationEntity
LodgingReservationEntity
TransportationReservationEntity
VehicleRentalReservationEntity
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ğ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. |
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 ö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. |
İç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 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. |
İç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ğ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. |
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 aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa, öz ve dize. Ö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) |
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, öz ve dize. Ö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 sağlamak için, sayfanın hem üst hem de alt kısmında 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 aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa, öz ve dize. Ö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ı | Önemli yer için 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 |
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. |
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ı | Etkinlikle ilgili kullanıcı oyu 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, öz ve dize. Ö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ı | Etkinlikle ilgili kullanıcı oyu 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ğlanırsa Resmin hem üstünde hem altında 24 d/sn |
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, öz ve dize. Ö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_EDUCATION
TYPE_SPORTS
TYPE_MOVIES_AND_TV_SHOWS
TYPE_BOOKS
TYPE_AUDIOBOOKS
TYPE_MUSIC
TYPE_DIGITAL_GAMES
TYPE_TRAVEL_AND_LOCAL
TYPE_HOME_AND_AUTO
TYPE_BUSINESS
TYPE_NEWS
TYPE_FOOD_AND_DRINK
TYPE_SHOPPING
TYPE_HEALTH_AND_FITENESS
TYPE_MEDICAL
TYPE_PARENTING
TYPE_DATING
Google'ın erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir. 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ırayla 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:
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters
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
RecommendationCluster
verileri 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
FeaturedCluster
verileri 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
ContinuationCluster
verileri 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
UserAccountManagementCluster
verileri: 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
bir içerik yayınlama isteğidir.
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:
BroadcastReceiver
sı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.xml
dosya 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
ÖnerilirpublishRecommendationClusters
araması başlatın.com.google.android.engage.action.PUBLISH_FEATURED
Önerilir. Bu niyeti alırkenpublishFeaturedCluster
araması başlatın.com.google.android.engage.action.PUBLISH_CONTINUATION
Önerilir. Bu niyeti alırkenpublishContinuationCluster
araması 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.