Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriğinin tüketilmesi ve keşfedilmesi için yeni ve etkileyici bir deneyim sağlayan bir cihaz yüzeyi geliştirmektedir. Bu tam ekran deneyimi, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışındaki özel bir kanalda gösterme fırsatı sunar.Bu rehber, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak arkadaşlık içeriklerini entegre etmeleri için talimatlar içerir.
Entegrasyon ayrıntısı
Terminoloji
Bu entegrasyon şu üç küme türünü içerir: Öneri, Öne Çıkan ve Devam.
Öneri kümeleri, tek bir geliştirici iş ortağından kişiselleştirilmiş arkadaş bulma önerilerini gösterir. Bu öneriler kullanıcıya göre kişiselleştirilebilir.
- Öneri kümesi
ArticleEntity
,PersonEntity
veyaEventEntity
içerebilir ancak farklı öğe türlerinin bir karışımından oluşamaz.
Önerileriniz aşağıdaki yapıyı alır:
Öneri Kümesi: Aynı geliştirici iş ortağından bir dizi öneri içeren kullanıcı arayüzü görünümü.
Varlık: Bir kümedeki tek bir öğeyi temsil eden bir nesne. Bu entegrasyon, Öneri Kümesi kullanılarak ortaya çıkacak bazı varlıklar sunar:
ArticleEntity: ArticleEntity, arkadaşlık ile ilgili metin tabanlı içerik önerisini temsil eder. ArticleEntity öğesi, geliştiricilerin bilgileri kullanıcılara anlatmak için daha fazla meta veriye sahip çeşitli metin ve resim içeriği sağlamasına olanak tanır.
Şekil 1: Öneriler kümesindeki tek bir ArticleEntity öğesini gösteren kullanıcı arayüzü. PersonEntity: PersonEntity, bir kişiyi temsil eder. Flört adaylarından birini öne çıkarmanız önerilir.
Şekil 2: Recommendations kümesindeki tek bir PersonEntity'yi gösteren kullanıcı arayüzü. EventEntity: EventEntity, gelecekte olacak bir etkinliği temsil eder. Etkinlik başlangıç zamanı, kullanıcılara aktarılması gereken kritik bir bilgidir.
Şekil 3: Öneriler kümesi içindeki tek bir EventEntity'yi gösteren kullanıcı arayüzü.
- Öneri kümesi
Devam kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden fazla geliştirici iş ortağının kullanıcıları tarafından yakın zamanda etkileşimde bulunulan içeriği gösterir. Her geliştirici iş ortağının Devam kümesinde en fazla 10 varlık yayınlamasına izin verilecek.
Devam içeriğiniz şu yapıyı alabilir:
ArticleEntity: ArticleEntity, arkadaşlık ile ilgili metin tabanlı içerik önerisini temsil eder. Bu varlık, tamamlanmamış haber makalelerini veya kullanıcının kaldığı yerden tüketmeye devam etmek istediği diğer içerikleri göstermek için kullanılabilir.
Şekil 6. Bir Devamlılık kümesi içindeki tek bir ArticleEntity öğesini gösteren kullanıcı arayüzü. EventReservationEntity: EventReservationEntity, bir etkinlik için yapılan rezervasyonu temsil eder ve kullanıcıların yaklaşan veya devam eden arkadaşlık ve buluşma etkinliği rezervasyonlarını izlemesine yardımcı olur.
Şekil 8. Bir Devamlılık kümesi içindeki tek bir EventReservationEntity'yi gösteren kullanıcı arayüzü.
Öne Çıkanlar kümesi, tek bir kullanıcı arayüzü gruplandırmasında birçok geliştirici iş ortağının seçilen hero
GenericFeaturedEntity
'sini gösteren bir kullanıcı arayüzü görünümüdür. Kullanıcı arayüzünün üst kısmına yakın bir yerde gösterilen tek bir Öne Çıkan küme vardır. Bu küme, tüm Öneri kümelerinin üzerinde bir öncelik yerleşimine sahiptir. Her geliştirici iş ortağının Öne Çıkanlar kümesindeki birden fazla uygulama geliştiricisinden gelen birçok varlıkla (muhtemelen farklı türlerde) desteklenen türde tek bir varlık yayınlamasına izin verilir.GenericFeaturedEntity: GenericFeatureEntity, Öneri öğesinden farklıdır. Öne çıkarılan öğenin geliştiricilerden tek bir üstteki içerik için kullanılması ve kullanıcıların ilgi çekici ve alakalı olacak en önemli içeriği temsil etmesi gerekir.
Şekil 12: SpecificationCluster ile İçeriğinizin bir listesini gösteren kullanıcı arayüzü
Çalışma öncesi
Minimum API düzeyi: 19
com.google.android.play:engage
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.4.1'
}
Özet
Tasarım, bağlı bir hizmetin uygulanmasına dayanır.
Bir istemcinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:
Küme türü | Küme sınırları | Bir kümedeki minimum varlık sınırları | Bir kümedeki maksimum varlık sınırları |
---|---|---|---|
Öneri Kümeleri | En fazla 5 | En az 5 | En fazla 25 (ArticleEntity , PersonEntity veya
EventEntity ) |
Devam Kümesi | En fazla 1 | En az 1 | En fazla 10 (ArticleEntity veya
EventReservationEntity ) |
Öne Çıkan Küme | En fazla 1 | En az 1 | En fazla 10 (GenericFeaturedEntity ) |
1. adım: Varlık verileri sağlayın
SDK, her bir öğe türünü temsil edecek farklı varlıklar tanımlamıştır. Arkadaşlık kategorisi için aşağıdaki varlıkları destekliyoruz:
GenericFeaturedEntity
ArticleEntity
PersonEntity
EventEntity
EventReservationEntity
Aşağıdaki grafiklerde, her tür için kullanılabilir özellikler ve gereksinimler özetlenmiştir.
GenericFeaturedEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'yi inceleyin |
URI |
Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 görsel gösterilir. Önerilen en boy oranı 16:9'dur Not: Rozet verilmişse lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
Başlık | İsteğe bağlı | Varlığın başlığı. | Serbest metin Önerilen metin boyutu: 50 karakter |
Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her alt başlık 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 (ör. resmin üzerine 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: maks. 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Sıralama Listesi Yardım için İçerik Kategorisi bölümüne bakın. |
ArticleEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'yi inceleyin |
URI |
Başlık | Zorunlu | Varlığın başlığı. | Serbest metin Önerilen metin boyutu: Maksimum 50 karakter |
Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 görsel gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
Kaynak - Başlık | İsteğe bağlı | Yazarın, kuruluşun veya bildirenin adı | Serbest metin Önerilen metin boyutu: 25 karakterin altında |
Kaynak - Resim | İsteğe bağlı | Yazar, kuruluş, muhabir gibi kaynağın resmi | Yardım için Resim Özellikleri bölümüne bakın. |
Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her alt başlık 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 (ör. resmin üzerine 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: maks. 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
İçeriğin Yayınlanma Zamanı | İsteğe bağlı | İçeriğin uygulamada yayınlandığı / güncellendiği zamanı gösteren milisaniye cinsinden sıfır zaman damgasıdır. | Milisaniye cinsinden dönem zaman damgası |
Son Etkileşim Zamanı | Koşula Bağlı Olarak Gerekli | Kullanıcının bu varlıkla en son etkileşim kurduğunda oluşan milisaniye cinsinden sıfır zaman damgası. Not: Bu varlık, devam kümesinin parçasıysa bu alan gereklidir. |
Milisaniye cinsinden dönem zaman damgası |
İlerleme Yüzdesi | Koşula Bağlı Olarak Gerekli | Bugüne kadar kullanıcı tarafından tüketilen tüm içeriğin yüzdesi. Not: Bu varlık, devam kümesinin parçasıysa bu alan gereklidir. |
0 ile 100 arasında (0 ve 100 dahil) bir tam sayı değeri. |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Sıralama Listesi Yardım için İçerik Kategorisi bölümüne bakın. |
PersonEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'yi inceleyin |
URI |
Profil - Ad | Zorunlu | Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Doğru", "@TeamPixel" vb.) | Dize Önerilen metin boyutu: Maksimum 50 karakter |
Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metinler. | Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
Profil - Ek Resim | İsteğe bağlı | Doğrulanmış rozet gibi küçük bir resim. | Yardım için Resim Özellikleri bölümüne bakın. |
Başlık resmi | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 görsel gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
Popülerlik - Sayı | İsteğe bağlı |
Başlık resmini temsil eder. Profil resminden farklı olmalıdır. Bu, kişiyi çalışması gibi öne çıkarmaya yardımcı olacak ek bir resim varsa kullanılabilir. Not: Resim 16:9 olmalıdır. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun |
Dize Önerilen metin boyutu: Sayı ve etiket toplamı için maksimum 20 karakter |
Popülerlik - Sayı Değeri | İsteğe bağlı | Takipçi sayısı veya popülerlik değeri. Not: Uygulamanız, büyük bir sayının farklı ekran boyutları için nasıl optimize edilmesi gerektiğiyle ilgili mantığı işlemek istemiyorsa Sayı Değeri sağlayın. Hem Sayım hem de Sayma Değeri sağlanırsa Sayım 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ı ve etiket toplamı için maksimum 20 karakter |
Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin ne için olduğunu belirtin. Örneğin, Beğeniler simgesinin, Emojilerin gösterildiği resim. 1'den fazla resim sağlanabilir ancak tüm form faktörlerinde tüm resimler gösterilmeyebilir. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
Puan - Maksimum değer | Zorunlu | Kullanıcı oyu ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanırsa sağlanmalıdır. |
Sayı >= 0,0 |
Puan - Geçerli değer | Zorunlu | Kullanıcı oyu ölçeğinin mevcut değeri. Maksimum puan değeri de sağlanırsa sağlanmalıdır. |
Sayı >= 0,0 |
Puan - Sayı | İsteğe bağlı | Varlığa ilişkin puan sayısı. Not: Uygulamanız kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Lütfen kullanıcıya gösterilebilecek kısa ve öz dizeyi girin. Örneğin sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1.0 gibi kısaltmalar kullanabilirsiniz. |
Dize |
Puan - Sayı Değeri | İsteğe bağlı | Varlığa ilişkin puan sayısı. Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız |
Uzun |
Konum - Ülke | İsteğe bağlı | Kişinin bulunduğu veya hizmet sunduğu ülke. | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Şehir | İsteğe bağlı | Kişinin bulunduğu veya hizmet sunduğu şehir. | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Görünen Adres | İsteğe bağlı | Kişinin bulunduğu veya hizmet sunduğu adres kullanıcıya gösterilir. | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Açık Adres | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği yerin açık adresi (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Eyalet | İsteğe bağlı | Kişinin bulunduğu veya hizmet sunduğu eyalet (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Posta kodu | İsteğe bağlı | Kişinin bulunduğu veya servisi yaptığı yerin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum: Mahalle | İsteğe bağlı | Kişinin bulunduğu veya hizmet sunduğu mahalle (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 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: maks. 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her alt başlık için önerilen metin boyutu: maks. 50 karakter |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamalar Listesi
Yardım için İçerik Kategorisi bölümüne bakın. |
EventEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'yi inceleyin |
URI |
Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
Başlangıç zamanı | Zorunlu |
Etkinliğin başlamasının beklendiği dönem zaman damgası. Not: Bu, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa her ikisini de mi olacağını belirten bir alan. |
Sıralama: VIRTUAL, IN_PERSON veya HYBRID |
Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 görsel gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
Konum - Ülke | Koşula Bağlı Olarak Gerekli | Etkinliğin gerçekleştiği ülke. Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir |
Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Şehir | Koşula Bağlı Olarak Gerekli | Etkinliğin gerçekleştiği şehir. Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir |
Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Görünen Adres | Koşula Bağlı Olarak Gerekli | Etkinliğin gerçekleşeceği ve kullanıcıya gösterilmesi gereken adres veya mekan adı. Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir |
Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Açık Adres | İsteğe bağlı | Etkinliğin düzenlendiği konumun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Eyalet | İsteğe bağlı | Etkinliğin düzenlendiği eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Posta kodu | İsteğe bağlı | Etkinliğin barındırıldığı konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum: Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönem zaman damgası. Not: Bu, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her alt başlık 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ı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: maks. 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat varsa sağlanmalıdır. |
Serbest metin |
Fiyat - Üstü çizili fiyat | İsteğe bağlı | Etkinlik biletinin/kartın orijinal fiyatı. | Serbest metin |
Fiyat Açıklama Metni | İsteğe bağlı | Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun olan metinlerde üç nokta gösterilebilir) |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamalar Listesi
Yardım için İçerik Kategorisi bölümüne bakın. |
EventReservationEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'yi inceleyin |
URI |
Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
Başlangıç zamanı | Zorunlu |
Etkinliğin başlamasının beklendiği dönem zaman damgası. Not: Bu, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa her ikisini de mi olacağını belirten bir alan. |
Sıralama: VIRTUAL, IN_PERSON veya HYBRID |
Konum - Ülke | Koşula Bağlı Olarak Gerekli | Etkinliğin gerçekleştiği ülke. Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir |
Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Şehir | Koşula Bağlı Olarak Gerekli | Etkinliğin gerçekleştiği şehir. Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir |
Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Görünen Adres | Koşula Bağlı Olarak Gerekli | Etkinliğin gerçekleşeceği ve kullanıcıya gösterilmesi gereken adres veya mekan adı. Not: Bu bilgi, IN_PERSON veya HYBRID türündeki etkinlikler için gereklidir |
Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Açık Adres | İsteğe bağlı | Etkinliğin düzenlendiği konumun açık adresi (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Eyalet | İsteğe bağlı | Etkinliğin düzenlendiği eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum - Posta kodu | İsteğe bağlı | Etkinliğin barındırıldığı konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Konum: Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: maks. ~20 karakter |
Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 görsel gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kullanmanız önemle tavsiye edilir. Rozet sağlandıysa lütfen resmin üst ve alt kısmında 24 dps'lik güvenli bir alan bulunduğundan emin olun |
Yardım için Resim Özellikleri bölümüne bakın. |
Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönem zaman damgası. Not: Bu, 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. Ör. Etkinliği düzenleyenin/turun adı |
Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | Her altyazının tek bir satırı olacak şekilde en fazla 3 altyazı. Not: Kullanıcıya açıklama veya altyazı listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her alt başlık 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ı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: maks. 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirme (ör. resmin/video küçük resminin üzerinde rozet yer paylaşımı). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
Rezervasyon Kimliği | İsteğe bağlı | Etkinlik rezervasyonunun rezervasyon kimliği. | Serbest metin |
Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat varsa sağlanmalıdır. |
Serbest metin |
Fiyat - Üstü çizili fiyat | İsteğe bağlı | Etkinlik biletinin/kartın orijinal fiyatı. | Serbest metin |
Fiyat Açıklama Metni | İsteğe bağlı | Varsa promosyonu, etkinliği veya üye indirimini öne çıkaran fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun olan metinlerde üç nokta gösterilebilir) |
Puan - Maksimum değer | İsteğe bağlı | Kullanıcı oyu ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanırsa sağlanmalıdır. |
Sayı >= 0,0 |
Puan - Geçerli değer | İsteğe bağlı | Kullanıcı oyu ölçeğinin mevcut değeri. Maksimum puan değeri de sağlanırsa sağlanmalıdır. |
Sayı >= 0,0 |
Puan - Sayı | İsteğe bağlı | Etkinliğe ilişkin kullanıcı oylarının sayısı. Not: Uygulamanız kullanıcılara nasıl gösterileceğini kontrol etmek istiyorsa bu alanı sağlayın. Lütfen kullanıcıya gösterilebilecek kısa ve öz dizeyi girin. Örneğin sayı 1.000.000 ise daha küçük ekran boyutlarında kısaltılmaması için 1.0 gibi kısaltmalar kullanabilirsiniz. |
Dize |
Puan - Sayı Değeri | İsteğe bağlı | Etkinliğe ilişkin kullanıcı oylarının sayısı. Not: Ekran kısaltma mantığını kendiniz işlemek istemiyorsanız bu alanı sağlayın. Hem Sayım hem de Sayım Değeri mevcutsa kullanıcılara göstermek için Sayı özelliğini kullanırız |
Uzun |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamalar Listesi
Yardım için İçerik Kategorisi bölümüne bakın. |
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 bu görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.
Dosya biçimleri
PNG, JPG, statik GIF, WebP
Maksimum dosya boyutu
5.120 KB
Ek öneriler
- Resim güvenli alanı: Önemli içeriklerinizi yatay ve dikey yönde ortalanmış olarak resmin% 80'ini kaplayacak şekilde yerleştirin.
- Resmin Koyu ve Açık tema ayarlarında düzgün bir şekilde görüntülenebilmesi için şeffaf bir arka plan kullanın.
İçerik Kategorisi
İçerik kategorisi, uygulamaların birden fazla kategoriye ait içerikleri yayınlamasına olanak tanır. Bu işlem, içeriği önceden tanımlanmış bazı kategorilerle eşler:
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 bu görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.
İçerik kategorilerini kullanma kuralları
- ArticleEntity ve GenericFeaturedEntity gibi bazı varlıklar, içerik kategorilerinden herhangi birini kullanmaya uygundur. EventEntity, EventReservationEntity ve PersonEntity gibi diğer varlıklar için bu kategorilerin yalnızca bir alt kümesi uygundur. Listeyi doldurmadan önce bir varlık türü için uygun kategorilerin listesini kontrol edin.
Genel varlıklar ve ContentCategory bir kombinasyonu yerine bazı içerik kategorileri için belirli öğe türünü kullanın:
- TYPE_MovieS_AND_TV_SHOWS - Genel varlıkları kullanmadan önce İzleme entegrasyon kılavuzundaki varlıklara göz atın.
- TYPE_BOOKS - Genel varlıkları kullanmadan önce EbookEntity öğesine göz atın.
- TYPE_AUDIOBOOKS - Genel varlıkları kullanmadan önce SeslibookEntity bölümüne göz atın.
- TYPE_SHOPPING - Genel varlıkları kullanmadan önce ShoppingEntity öğesine göz atın.
- TYPE_FOOD_AND_DRINK - Genel varlıkları kullanmadan önce Yiyecek Entegrasyonu kılavuzundaki varlıkları inceleyin.
İçerik Kategorisi alanı isteğe bağlıdır ve içerik daha önce bahsedilen kategorilerden birine ait değilse boş bırakılmalıdır.
Birden fazla içerik kategorisi sağlanmışsa bunları içerikle alaka düzeyine göre sıralayarak en alakalı içerik kategorisi listede ilk sırada gösterin.
2. Adım: Küme verilerini sağlayın
İçerik yayınlama işinin arka planda yürütülmesi (örneğin, WorkManager kullanılarak) ve düzenli olarak ya da etkinlik temelli olarak planlanması önerilir (örneğin, kullanıcı uygulamayı her açtığında veya kullanıcı sepetine bir ürün eklediğinde).
AppEngagePublishClient
, kümeleri yayınlamaktan sorumludur.
Kümeleri istemcide yayınlamak için aşağıdaki API'ler mevcuttur:
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
deleteUserManagementCluster
deleteClusters
isServiceAvailable
Bu API, hizmetin entegrasyon için uygun olup olmadığını ve içeriğin cihazda sunulup sunulmadığını kontrol etmek için kullanılır.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task -> if (task.isSuccessful) { // Handle IPC call success if(task.result) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } }
Java
client.isServiceAvailable().addOnCompleteListener(task - > { if (task.isSuccessful()) { // Handle success if(task.getResult()) { // Service is available on the device, proceed with content publish // calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } });
publishRecommendationClusters
Bu API, RecommendationCluster
nesnelerinin listesini yayınlamak için kullanılır.
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build() ) .build() )
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( new RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build()) .build());
Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
RecommendationCluster
verileri kaldırılır. - İstekteki veriler ayrıştırılır ve güncellenmiş Öneri Kümesinde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishFeaturedCluster
Bu API, FeaturedCluster
nesnelerinin listesini yayınlamak için kullanılır.
Kotlin
client.publishFeaturedCluster( PublishFeaturedClusterRequest.Builder() .setFeaturedCluster( FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishFeaturedCluster( new PublishFeaturedClustersRequest.Builder() .addFeaturedCluster( new FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
FeaturedCluster
verileri kaldırılır. - İstekten elde edilen veriler ayrıştırılır ve güncellenmiş Öne Çıkan Küme'de depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishContinuationCluster
Bu API bir 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 işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
ContinuationCluster
verileri kaldırılır. - İstekten elde edilen veriler ayrıştırılır ve güncellenen Devam Kümesi'nde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishUserAccountManagementRequest
Bu API, Oturum Açma kartı yayınlamak için kullanılır . Oturum açma işlemi, uygulamanın içerik yayınlayabilmesi (veya daha kişiselleştirilmiş içerik sağlayabilmesi) için kullanıcıları uygulamanın oturum açma sayfasına yönlendirir
Aşağıdaki meta veriler Oturum Açma Kartının bir parçasıdır -
Özellik | Şartlar | Açıklama |
---|---|---|
İşlem URI'sı | Zorunlu | İşlem için derin bağlantı (ör. uygulamada oturum açma sayfasına yönlendirir) |
Resim | İsteğe bağlı - Sağlanmamışsa başlık sağlanmalıdır |
Kartta Gösterilen Resim 1264x712 çözünürlüklü 16x9 en boy oranına sahip resimler |
Başlık | İsteğe bağlı - Sağlanmazsa Resim sağlanmalıdır | Kartın Başlığı |
İşlem Metni | İsteğe bağlı | CTA'da gösterilen metin (ör. oturum açma) |
Alt başlık | İsteğe bağlı | Kartta İsteğe Bağlı Altyazı |
Kotlin
var SIGN_IN_CARD_ENTITY = SignInCardEntity.Builder() .addPosterImage( Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build() client.publishUserAccountManagementRequest( PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY = new SignInCardEntity.Builder() .addPosterImage( new Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build(); client.publishUserAccountManagementRequest( new PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
UserAccountManagementCluster
verileri kaldırılır. - İstekteki veriler ayrıştırılır ve güncellenmiş UserAccountManagementCluster Kümesinde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
updatePublishStatus
İşle ilgili herhangi bir nedenle kümelerin hiçbiri yayınlanmazsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle öneririz. Bu önemlidir, çünkü :
- İçerik yayınlandığında bile tüm senaryolarda durumun sağlanması (DURUM == YAYINLANDI), entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu uygunsuz durumu kullanan kontrol panellerinin doldurulması için kritik önem taşır.
- Hiçbir içerik yayınlanmadıysa ancak entegrasyon durumu bozuk değilse (STATUS == NOT_PUBLISHED) Google, uygulama durumu kontrol panellerinde uyarı tetiklemekten kaçınabilir. Bu işlem, sağlayıcının açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
- Geliştiricilerin, verilerin ne zaman yayınlanıp yayınlanmadığına dair analizler sağlamasına yardımcı olur.
- Google, durum kodlarını kullanıcının uygulama içeriğini görüp aşması için uygulamada belirli işlemleri yapmasını teşvik etmek amacıyla kullanabilir.
Uygun yayınlama durum kodlarının listesi şu şekildedir :
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
İçerik, kullanıcı giriş yapmadığı için yayınlanmazsa Google, Oturum Açma Kartı'nın yayınlanmasını önerir. Sağlayıcılar Oturum Açma Kartını herhangi bir nedenle yayınlayamazsa updatePublishStatus API'sinin NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla çağrılmasını öneririz.
Kotlin
client.updatePublishStatus( PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build())
Java
client.updatePublishStatus( new PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build());
deleteRecommendationClusters
Bu API, Öneri Kümelerinin içeriğini silmek için kullanılır.
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
Hizmet, isteği aldığında mevcut verileri Öneri Kümelerinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteFeaturedCluster
Bu API, Öne Çıkan Kü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 olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteContinuationCluster
Bu API, Devam Kümesi içeriğini silmek için kullanılır.
Kotlin
client.deleteContinuationCluster()
Java
client.deleteContinuationCluster();
Hizmet, isteği aldığında mevcut verileri Devam Kümesi'nden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteUserManagementCluster
Bu API, UserAccountManagement Cluster'ın içeriğini silmek için kullanılır.
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
Hizmet, isteği aldığında mevcut verileri UserAccountManagement Cluster'dan kaldırır. 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ığında, belirtilen küme türleriyle eşleşen tüm kümelerden mevcut verileri kaldırır. Müşteriler bir veya daha fazla küme türünü geçirebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
Hata işleme
Yayınlama API'lerinden gelen görev sonucunu dinlemeniz önemle tavsiye edilir. Böylece başarılı bir görevi kurtarıp yeniden göndermek için takip işlemi gerçekleştirilebilir.
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, neden hata kodu olarak eklenmiş şekilde AppEngageException
biçiminde döndürülür.
Hata kodu | Not |
---|---|
SERVICE_NOT_FOUND |
Hizmet belirtilen cihazda kullanılamıyor. |
SERVICE_NOT_AVAILABLE |
Hizmet, belirtilen cihazda kullanılabilir ancak çağrı sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır). |
SERVICE_CALL_EXECUTION_FAILURE |
İleti dizisi sorunları nedeniyle görev yürütülemedi. Bu durumda, işlem yeniden denenebilir. |
SERVICE_CALL_PERMISSION_DENIED |
Arayanın servis araması yapma izni yok. |
SERVICE_CALL_INVALID_ARGUMENT |
İstek geçersiz veriler içeriyor (örneğin, izin verilen küme sayısından fazla). |
SERVICE_CALL_INTERNAL |
Hizmet tarafında bir hata var. |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Servis çağrısı çok sık yapılıyor. |
3. Adım: Yayın amaçlarını ele alın
Bir iş aracılığıyla publish Content API çağrıları yapmaya ek olarak, bir içerik yayınlama isteğini almak için BroadcastReceiver
kurulumu da gerekir.
Yayın amaçlarının amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın amaçları çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca İnternet Reklamcılığı Programı içeriğin eski olabileceğini (örneğin, bir haftalık) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süre çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimine sahip olabileceğine dair daha fazla güven duyulur.
BroadcastReceiver
aşağıdaki iki şekilde ayarlanmalıdır:
Context.registerReceiver()
kullanarakBroadcastReceiver
sınıfının bir örneğini dinamik olarak kaydedin. Bu, hâlâ bellekte bulunan uygulamalardan iletişim kurulmasını sağlar.
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)); }
- Statik olarak
AndroidManifest.xml
dosyanızda<receiver>
etiketiyle bir uygulama tanımlayın. Bu, uygulamanın çalışmadığında yayın amaçlarını almasına ve aynı zamanda uygulamanın içeriği yayınlamasına olanak tanır.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Aşağıdaki amaçlar hizmet tarafından gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATION
Bu niyeti alırken birpublishRecommendationClusters
çağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_FEATURED
Bu amacı alırken birpublishFeaturedCluster
çağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_CONTINUATION
Bu amacı alırken birpublishContinuationCluster
çağrısı başlatmanız önerilir.
Entegrasyon iş akışı
Entegrasyonun tamamlandıktan sonra doğrulanmasıyla ilgili adım adım açıklamalı bir kılavuz için Geliştirici entegrasyonu iş akışını etkileşim kurma başlıklı makaleyi inceleyin.
SSS
SSS için Engage SDK'sı ile İlgili Sık Sorulan Sorular bölümüne bakın.
İletişim
Entegrasyon işlemi sırasında herhangi bir sorunuz olursa lütfen engagement-developers@google.com ile iletişime geçin.
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonra uygulamanız gereken adımlar şunlardır:
- engagement-developers@google.com adresine e-posta gönderin ve Google tarafından test edilmeye hazır olan entegre APK'nızı ekleyin.
- Google, entegrasyonun beklendiği gibi çalıştığından emin olmak için bir doğrulama gerçekleştirir ve dahili incelemeler yapar. Değişiklik yapılması gerekirse Google gerekli bilgileri vermek için sizinle iletişime geçer.
- Test tamamlandığında ve herhangi bir değişiklik gerekmediğinde Google, güncellenmiş ve entegre APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
- Google, güncellenen APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneri, Öne Çıkan ve Devam kümeleriniz yayınlanabilir ve kullanıcılar tarafından görülebilir.