Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriği tüketimi ile keşfi için yeni bir etkileyici deneyim sağlayan cihaz üzerinde bir yüzey oluşturuyor. Bu tam ekran deneyimi, geliştirici iş ortaklarına uygulamalarının dışında özel bir kanalda en iyi zengin içeriklerini sergileme fırsatı sunar.Bu kılavuzda, geliştirici iş ortaklarının Engage SDK'yı kullanarak bu yeni yüzey alanını doldurmak için flört içeriklerini entegre etme talimatları yer almaktadır.
Entegrasyon ayrıntıları
Terminoloji
Bu entegrasyon aşağıdaki üç küme türünü içerir: Öneri, Öne Çıkan ve Devam.
Öneri kümeleri, tek bir geliştirici iş ortağından kişiselleştirilmiş flört önerileri gösterir. Bu öneriler kullanıcıya göre kişiselleştirilebilir.
- Öneri kümesi
ArticleEntity,PersonEntityveyaEventEntityöğelerinden oluşabilir ancak farklı öğe türlerinin karışımından oluşamaz.
Önerileriniz aşağıdaki yapıya sahiptir:
Öneri Kümesi: Aynı geliştirici iş ortağının önerilerinden oluşan bir grubu içeren kullanıcı arayüzü görünümü.
Varlık: Bir kümedeki tek bir öğeyi temsil eden nesne. Bu entegrasyon, Öneri Kümesi kullanılarak gösterilecek bazı öğeler sunar:
ArticleEntity: ArticleEntity, arkadaşlıkla ilgili metin tabanlı içerik önerisini temsil eder. ArticleEntity öğesi, geliştiricilerin kullanıcılara bilgi aktarmak için daha fazla meta veriyle çeşitli metin ve resim içerikleri sağlamasına olanak tanır.
Şekil 1: Öneriler kümesinde tek bir ArticleEntity gösteren kullanıcı arayüzü. PersonEntity: PersonEntity, bir kişiyi temsil eder. Öneriler, flört etme ihtimali olan kişileri öne çıkarmak için kullanılabilir.
Şekil 2: Öneriler kümesinde tek bir PersonEntity gösteren kullanıcı arayüzü. EventEntity: EventEntity, gelecekte gerçekleşecek bir etkinliği temsil eder. Etkinlik başlangıç saati, kullanıcılara iletilmesi gereken kritik bir bilgidir.
Şekil 3: Öneriler kümesinde tek bir EventEntity'nin gösterildiği 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ının kısa süre önce etkileşimde bulunduğu içerikleri gösterir. Her geliştirici iş ortağı, Devam Kümesi'nde en fazla 10 öğe yayınlayabilir.
Devam niteliğindeki içeriğiniz aşağıdaki yapıda olabilir:
ArticleEntity: ArticleEntity, arkadaşlıkla ilgili metin tabanlı içerik önerisini temsil eder. Bu öğe, kullanıcının kaldığı yerden devam etmek istediği bitmemiş haber makalelerini veya diğer içerikleri temsil etmek için kullanılabilir.
6.şekil Devam kümesinde tek bir ArticleEntity'yi gösteren kullanıcı arayüzü. EventReservationEntity: EventReservationEntity, bir etkinliğin rezervasyonunu temsil eder ve kullanıcıların yaklaşan veya devam eden flört ve buluşma etkinliği rezervasyonlarını takip etmesine yardımcı olur.
Şekil 8. Devamlılık kümesinde tek bir EventReservationEntity gösteren kullanıcı arayüzü.
Öne Çıkanlar kümesi, birçok geliştirici iş ortağının seçilen öne çıkan uygulamasını tek bir kullanıcı arayüzü gruplandırmasında gösteren bir kullanıcı arayüzü görünümüdür.
GenericFeaturedEntityTek bir Öne Çıkan kümesi vardır. Bu küme, kullanıcı arayüzünün üst kısmına yakın bir yerde gösterilir ve tüm Öneri kümelerinin üzerinde öncelikli bir yerleşime sahiptir. Her geliştirici iş ortağı, Öne Çıkanlar'da desteklenen bir türün tek bir öğesini yayınlayabilir. Öne Çıkanlar kümesinde ise birden fazla uygulama geliştiricinin birçok öğesi (farklı türlerde olabilir) yer alır.GenericFeaturedEntity: GenericFeaturedEntity, Recommendation item'dan farklıdır. Featured item, geliştiricilerin tek bir üst düzey içeriği için kullanılmalı ve kullanıcıların ilgisini çekecek ve alakalı olacak en önemli tek içeriği temsil etmelidir.
Şekil 12: Bir GenericFeaturedEntity listesi içeren Öne Çıkan Küme'yi gösteren kullanıcı arayüzü
Ön çalışma
Minimum API düzeyi: 19
Uygulamanıza com.google.android.engage:engage-core kitaplığını ekleyin:
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.5.2'
}
Özet
Tasarım, bağlı hizmetin uygulanmasına dayanır.
Bir istemcinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:
| Küme türü | Küme sınırları | Bir kümedeki minimum öğe sınırları | Bir kümedeki maksimum öğe sınırları |
|---|---|---|---|
| Öneri kümeleri | En fazla 5 | En az 5 | En fazla 25 (ArticleEntity, PersonEntity veya
EventEntity) |
| Devamlılık 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: Tüzel kişi verilerini sağlayın
SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. Arkadaşlık kategorisinde aşağıdaki öğeler desteklenir:
GenericFeaturedEntityArticleEntityPersonEntityEventEntityEventReservationEntity
Aşağıdaki grafiklerde, her tür için kullanılabilir özellikler ve şartlar özetlenmiştir.
GenericFeaturedEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: Derin bağlantıları ilişkilendirme için kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan bırakın. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Başlık | İsteğe bağlı | Varlığın başlığı. | Serbest metin Önerilen metin boyutu: 50 karakter |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırlık metin olan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir. Resmin/videonun üstünde özel kullanıcı deneyimi uygulaması (ör. resmin üstünde rozet yer paylaşımı)
|
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Sıralamaların Listesi Rehberlik için İçerik Kategorisi bölümüne bakın. |
ArticleEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: Derin bağlantıları ilişkilendirme için kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Serbest metin Önerilen metin boyutu: En fazla 50 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Resim eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Kaynak - Başlık | İsteğe bağlı | Yazarın, kuruluşun veya muhabirin adı | Serbest metin Önerilen metin boyutu: 25 karakterden az |
| Kaynak - Resim | İsteğe bağlı | Kaynakla ilgili bir resim (ör. yazar, kuruluş, muhabir) | Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırlık metin olan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı | Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir. Resmin/videonun üstünde özel kullanıcı deneyimi uygulaması (ör. resmin üstünde rozet yer paylaşımı)
|
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| İçerik Yayınlama Zamanı | İsteğe bağlı | Bu, içeriğin uygulamada yayınlandığı / güncellendiği zamana ait milisaniye cinsinden epoch zaman damgasıdır. | Milisaniye cinsinden dönem zaman damgası |
| Son Etkileşim Zamanı | Koşula bağlı olarak zorunlu | Kullanıcının bu öğeyle en son etkileşime girdiği zamana ait milisaniye cinsinden dönem zaman damgası. Not: Bu alan, bu öğe devamlılık kümesinin bir parçasıysa zorunludur. |
Milisaniye cinsinden dönem zaman damgası |
| İlerleme yüzdesi | Koşula bağlı olarak zorunlu | Kullanıcının bugüne kadar tükettiği tam içeriğin yüzdesi. Not: Bu alan, bu öğe devamlılık kümesinin bir parçasıysa zorunludur. |
0 ile 100 arasında (0 ve 100 dahil) bir int değeri. |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Sıralamaların Listesi Rehberlik için İçerik Kategorisi bölümüne bakın. |
PersonEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: Derin bağlantıları ilişkilendirme için kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Profil - Ad | Zorunlu | Profil adı, kimliği veya herkese açık kullanıcı adı (ör. "John Doe", "@TeamPixel" vb.) | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metin. | Serbest metin Önerilen metin boyutu: En fazla 15 karakter |
| Profil - Ek Resim | İsteğe bağlı | Doğrulama rozeti gibi küçük bir resim. | Yardım için Resim Özellikleri bölümüne bakın. |
| Başlık resmi | İsteğe bağlı |
Üstbilgi resmini gösterir. Profil resminden farklı olmalıdır. Bu özellik, kişinin çalışmalarını öne çıkarmaya yardımcı olacak ek bir resim varsa kullanılabilir. Not: 16:9 en-boy oranına sahip bir resim olmalıdır. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Popülerlik - Sayı | İsteğe bağlı |
Takipçi sayısını veya popülerlik değerini belirtin. Örneğin: "3, 7 M". Not: Hem Sayı hem de Sayı Değeri sağlanırsa Sayı kullanılır. |
Dize Önerilen metin boyutu: Sayı + etiket birleşimi için en fazla 20 karakter |
| Popülerlik - Sayı Değeri | İsteğe bağlı | Takipçi sayısı veya popülerlik değeri. Not: Uygulamanız, çok sayıda öğenin farklı ekran boyutları için nasıl optimize edileceğiyle ilgili mantığı işlemek istemiyorsa Count Value (Sayı Değeri) sağlayın. Hem Sayı hem de Sayı Değeri sağlanırsa kullanıcılara Sayı gösterilir. |
Uzun |
| Popülerlik - Etiket | İsteğe bağlı | Popülerlik etiketinin ne olduğunu belirtin. Örneğin, "Beğeniler". | Dize Önerilen metin boyutu: Sayı + etiket birleşimi için en fazla 20 karakter |
| Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin amacını belirtin. Örneğin, beğenme simgesi ve emoji gösteren resim. Birden fazla resim sağlayabilirsiniz ancak tüm form faktörlerinde tüm resimler gösterilmeyebilir. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Puan - Maksimum değer | Zorunlu | Derecelendirme ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Geçerli değer | Zorunlu | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Varlığın puan sayısı. Not: Uygulamanızın, bunun kullanıcılara nasıl gösterileceğini kontrol etmek istemesi durumunda bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kesilmemesi için 1M gibi kısaltmalar kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Varlığın puan sayısı. Not: Gösterim kısaltma mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı'yı kullanırız. |
Uzun |
| Konum - Ülke | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği ülke. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği şehir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | İsteğe bağlı | Kullanıcıya, kişinin bulunduğu veya hizmet verdiği adres gösterilir. | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği açık adres (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği eyalet (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği yerin posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırlık metin olan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
EventEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: Derin bağlantıları ilişkilendirme için kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen zamanın epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa her ikisi de mi olacağını belirten bir alan. |
Enum: VIRTUAL, IN_PERSON veya HYBRID |
| Poster resimleri | Zorunlu | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Resim eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Konum - Ülke | Koşula bağlı olarak zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Koşula bağlı olarak zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | Koşula bağlı olarak zorunlu | Etkinliğin yapılacağı ve kullanıcıya gösterilmesi gereken adres veya mekan adı. Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Etkinliğin düzenlendiği yerin sokak adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Etkinliğin düzenlendiği eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Etkinliğin düzenlendiği konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönemin zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırlık metin olan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinliğin biletinin/kartının mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Etkinlik için biletin/kartın orijinal fiyatı. | Serbest metin |
| Fiyat açıklama metni | İsteğe bağlı | Varsa promosyon, etkinlik veya üye indirimini öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
EventReservationEntity
| Özellik | Şartlar | Açıklama | Biçim |
|---|---|---|---|
| İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı oluşturun. Not: Derin bağlantıları ilişkilendirme için kullanabilirsiniz. Bu SSS'ye bakın |
URI |
| Başlık | Zorunlu | Varlığın başlığı. | Dize Önerilen metin boyutu: En fazla 50 karakter |
| Başlangıç zamanı | Zorunlu |
Etkinliğin başlaması beklenen zamanın epoch zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
| Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa her ikisi de mi olacağını belirten bir alan. |
Enum: VIRTUAL, IN_PERSON veya HYBRID |
| Konum - Ülke | Koşula bağlı olarak zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Şehir | Koşula bağlı olarak zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Adresi Göster | Koşula bağlı olarak zorunlu | Etkinliğin yapılacağı ve kullanıcıya gösterilmesi gereken adres veya mekan adı. Not: Bu, YÜZ YÜZE veya HİBRİT etkinlikler için gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Açık Adres | İsteğe bağlı | Etkinliğin düzenlendiği yerin sokak adresi (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Eyalet | İsteğe bağlı | Etkinliğin düzenlendiği eyalet veya il (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Posta kodu | İsteğe bağlı | Etkinliğin düzenlendiği konumun posta kodu (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: en fazla 20 karakter |
| Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur. Not: Resim eklemeniz önemle tavsiye edilir. Rozet sağlanıyorsa resmin hem üst hem de alt kısmında 24 dp'lik güvenli alan olduğundan emin olun. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönemin zaman damgası. Not: Bu değer milisaniye cinsinden gösterilir. |
Milisaniye cinsinden dönem zaman damgası |
| Servis Sağlayıcı - Adı | İsteğe bağlı |
Servis sağlayıcının adı. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Serbest metin. Örneğin, etkinliği düzenleyenin/turun adı |
| Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Servis sağlayıcı için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Açıklama | İsteğe bağlı | Varlığı açıklayan tek bir metin paragrafı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Önerilen metin boyutu: 180 karakter |
| Altyazı listesi | İsteğe bağlı | Her biri tek satırlık metin olan en fazla 3 altyazı. Not: Kullanıcıya açıklama veya alt başlık listesi gösterilir, ikisi birden gösterilmez. |
Serbest metin Her altyazı için önerilen metin boyutu: en fazla 50 karakter |
| Rozetler | İsteğe bağlı |
Her rozet, serbest metin (en fazla 15 karakter) veya küçük bir resimdir. |
|
| Rozet - Metin | İsteğe bağlı | Rozetin başlığı Not: Rozet için metin veya resim gereklidir. |
Serbest metin Önerilen metin boyutu: en fazla 15 karakter |
| Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi uygulaması (ör. resim/video küçük resminde rozet yer paylaşımı olarak). Not: Rozet için metin veya resim gereklidir. |
Yardım için Resim Özellikleri bölümüne bakın. |
| Rezervasyon kimliği | İsteğe bağlı | Etkinlik rezervasyonunun rezervasyon kimliği. | Serbest metin |
| Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinliğin biletinin/kartının mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa bu özellik de sağlanmalıdır. |
Serbest metin |
| Fiyat - StrikethroughPrice | İsteğe bağlı | Etkinlik için biletin/kartın orijinal fiyatı. | Serbest metin |
| Fiyat açıklama metni | İsteğe bağlı | Varsa promosyon, etkinlik veya üye indirimini öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
| Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Puanın mevcut değeri de sağlanıyorsa bu özellik sağlanmalıdır. |
Sayı >= 0,0 |
| Derecelendirme - Geçerli değer | İsteğe bağlı | Puan ölçeğinin mevcut değeri. Derecelendirmenin maksimum değeri de sağlanıyorsa belirtilmelidir. |
Sayı >= 0,0 |
| Puan - Sayı | İsteğe bağlı | Etkinliğin derecelendirme sayısı. Not: Uygulamanızın, bunun kullanıcılara nasıl gösterileceğini kontrol etmek istemesi durumunda bu alanı sağlayın. Kullanıcıya gösterilebilecek kısa dizeyi sağlayın. Örneğin, sayı 1.000.000 ise daha küçük ekran boyutlarında kesilmemesi için 1M gibi kısaltmalar kullanabilirsiniz. |
Dize |
| Derecelendirme - Sayı Değeri | İsteğe bağlı | Etkinliğin derecelendirme sayısı. Not: Gösterim kısaltma mantığını kendiniz yönetmek istemiyorsanız bu alanı sağlayın. Hem Sayı hem de Sayı Değeri varsa kullanıcılara göstermek için Sayı'yı kullanırız. |
Uzun |
| İçerik Kategorileri | İsteğe bağlı | Öğedeki içeriğin kategorisini açıklayın. | Uygun Enum'ların Listesi
Rehberlik için İçerik Kategorisi bölümüne bakın. |
Resim özellikleri
Resim öğeleri için gerekli özellikler bu tabloda listelenmiştir:
| En boy oranı | Minimum piksel sayısı | Önerilen piksel sayısı |
|---|---|---|
Kare (1x1) Tercih edilen |
300x300 | 1200x1200 |
| Yatay (1,91x1) | 600x314 | 1200x628 |
| Dikey (4x5) | 480x600 | 960x1200 |
Google'ın erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir.
Dosya biçimleri
PNG, JPG, statik GIF, WebP
Maksimum dosya boyutu
5.120 KB
Ek öneriler
- Resim güvenli alanı: Önemli içeriklerinizi yatay ve dikey yönde ortalanmış olarak resmin% 80'ini kaplayacak şekilde yerleştirin.
- Resmin koyu ve açık tema ayarlarında düzgün şekilde gösterilebilmesi için şeffaf bir arka plan kullanın.
İçerik Kategorisi
İçerik kategorisi, uygulamaların birden fazla kategoriye ait içerik yayınlamasına olanak tanır. Bu işlem, içeriği önceden tanımlanmış kategorilerden bazılarıyla eşler. Bu kategoriler şunlardır:
TYPE_EDUCATIONTYPE_SPORTSTYPE_MOVIES_AND_TV_SHOWSTYPE_BOOKSTYPE_AUDIOBOOKSTYPE_MUSICTYPE_DIGITAL_GAMESTYPE_TRAVEL_AND_LOCALTYPE_HOME_AND_AUTOTYPE_BUSINESSTYPE_NEWSTYPE_FOOD_AND_DRINKTYPE_SHOPPINGTYPE_HEALTH_AND_FITENESSTYPE_MEDICALTYPE_PARENTINGTYPE_DATING
Google'ın erişebilmesi için resimlerin herkese açık CDN'lerde barındırılması gerekir.
İçerik kategorilerini kullanma yönergeleri
- ArticleEntity ve GenericFeaturedEntity gibi bazı öğeler, içerik kategorilerinin herhangi birini kullanabilir. EventEntity, EventReservationEntity, PersonEntity gibi diğer öğeler için bu kategorilerin yalnızca bir alt kümesi uygundur. Listeyi doldurmadan önce bir öğe türü için uygun olan kategorilerin listesini kontrol edin.
Bazı içerik kategorileri için genel öğeler ve ContentCategory kombinasyonu yerine belirli öğe türünü kullanın:
- TYPE_MOVIES_AND_TV_SHOWS: Genel öğeleri kullanmadan önce İzleme entegrasyonu kılavuzundaki öğeleri inceleyin.
- TYPE_BOOKS: Genel öğeleri kullanmadan önce EbookEntity'yi inceleyin.
- TYPE_AUDIOBOOKS: Genel öğeleri kullanmadan önce AudiobookEntity'yi inceleyin.
- TYPE_SHOPPING - Check out ShoppingEntity before using the generic entities.
- TYPE_FOOD_AND_DRINK: Genel öğeleri kullanmadan önce Yemek entegrasyonu kılavuzundaki öğeleri inceleyin.
ContentCategory alanı isteğe bağlıdır ve içerik, daha önce bahsedilen kategorilerden herhangi birine ait değilse boş bırakılmalıdır.
Birden fazla içerik kategorisi sağlanması durumunda, bunları içerikle alaka düzeyine göre sıralayın. En alakalı içerik kategorisi listede ilk sırada yer almalıdır.
2. adım: Küme verilerini sağlama
İçerik yayınlama işinin arka planda (örneğin, WorkManager kullanılarak) yürütülmesi ve düzenli olarak veya etkinlik bazında (örneğin, kullanıcı uygulamayı her açtığında ya da sepete bir öğe eklediğinde) planlanması önerilir.
AppEngagePublishClient, kümelerin yayınlanmasından sorumludur.
İstemcide kümeleri yayınlamak için aşağıdaki API'ler kullanılabilir:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishContinuationClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteContinuationClusterdeleteUserManagementClusterdeleteClusters
isServiceAvailable
Bu API, hizmetin entegrasyona uygun olup olmadığını ve içeriğin cihazda sunulup sunulamayacağını kontrol etmek için kullanılır.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task ->
if (task.isSuccessful) {
// Handle IPC call success
if(task.result) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
Java
client.isServiceAvailable().addOnCompleteListener(task - > {
if (task.isSuccessful()) {
// Handle success
if(task.getResult()) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
publishRecommendationClusters
Bu API, RecommendationCluster nesnelerinin listesini yayınlamak için kullanılır.
Kotlin
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build()
)
.build()
)
Java
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
new RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build())
.build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağından alınan mevcut
RecommendationClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen RecommendationCluster'da depolanır.
Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishFeaturedCluster
Bu API, FeaturedCluster nesnelerinin listesini yayınlamak için kullanılır.
Kotlin
client.publishFeaturedCluster(
PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
Java
client.publishFeaturedCluster(
new PublishFeaturedClustersRequest.Builder()
.addFeaturedCluster(
new FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağından alınan mevcut
FeaturedClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen Öne Çıkan Küme'de saklanır.
Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishContinuationCluster
Bu API, ContinuationCluster nesnesini yayınlamak için kullanılır.
Kotlin
client.publishContinuationCluster(
PublishContinuationClusterRequest.Builder()
.setContinuationCluster(
ContinuationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
Java
client.publishContinuationCluster(
new PublishContinuationClusterRequest.Builder()
.setContinuationCluster(
new ContinuationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağından alınan mevcut
ContinuationClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen Continuation Cluster'da depolanır.
Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishUserAccountManagementRequest
Bu API, oturum açma kartı yayınlamak için kullanılır . Oturum açma işlemi, kullanıcıları uygulamanın oturum açma sayfasına yönlendirir. Böylece uygulama, içerik yayınlayabilir (veya daha kişiselleştirilmiş içerikler sunabilir).
Aşağıdaki meta veriler, oturum açma kartının bir parçasıdır:
| Özellik | Şartlar | Açıklama |
|---|---|---|
| İşlem URI'si | Zorunlu | İşleme derin bağlantı (ör. uygulama oturum açma sayfasına yönlendirir) |
| Resim | İsteğe bağlıdır. Sağlanmazsa başlık sağlanmalıdır. |
Kartta Gösterilen Resim 1264x712 çözünürlüğünde 16:9 en boy oranına sahip resimler |
| Başlık | İsteğe bağlıdır. Sağlanmazsa resim sağlanmalıdır. | Kart üzerindeki başlık |
| İşlem Metni | İsteğe bağlı | CTA'da Gösterilen Metin (ör. Oturum açın) |
| Alt başlık | İsteğe bağlı | Kartta İsteğe Bağlı Altyazı |
Kotlin
var SIGN_IN_CARD_ENTITY =
SignInCardEntity.Builder()
.addPosterImage(
Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build()
client.publishUserAccountManagementRequest(
PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY =
new SignInCardEntity.Builder()
.addPosterImage(
new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build();
client.publishUserAccountManagementRequest(
new PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağından alınan mevcut
UserAccountManagementClusterverileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen UserAccountManagementCluster kümesinde depolanır.
Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
updatePublishStatus
Herhangi bir dahili ticari nedenden dolayı kümelerin hiçbiri yayınlanmazsa updatePublishStatus API'yi kullanarak yayın durumunu güncellemenizi şiddetle tavsiye ederiz. Bu önemlidir, çünkü :
- İçerik yayınlanmış olsa bile (STATUS == PUBLISHED) tüm senaryolarda durumu sağlamak, entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu açık durumu kullanan kontrol panellerini doldurmak açısından kritik öneme sahiptir.
- İçerik yayınlanmamış ancak entegrasyon durumu bozulmamışsa (STATUS == NOT_PUBLISHED), Google, uygulama sağlığı kontrol panellerinde uyarı tetiklemeyi önleyebilir. İçeriğin, sağlayıcının bakış açısıyla beklenen bir durum nedeniyle yayınlanmadığını onaylar.
- Geliştiricilerin, verilerin ne zaman yayınlandığına dair bilgi vermesine yardımcı olur.
- Google, kullanıcıyı uygulama içeriğini görebilmesi veya sorunu aşabilmesi için uygulamada belirli işlemleri yapmaya yönlendirmek amacıyla durum kodlarını kullanabilir.
Uygun yayınlama durumu kodlarının listesi :
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
İçerik, oturum açmamış bir kullanıcı nedeniyle yayınlanmıyorsa Google, oturum açma kartının yayınlanmasını önerir. Herhangi bir nedenle sağlayıcılar Oturum Açma Kartı'nı yayınlayamıyorsa updatePublishStatus API'sinin NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla çağrılması önerilir.
Kotlin
client.updatePublishStatus(
PublishStatusRequest.Builder()
.setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
.build())
Java
client.updatePublishStatus(
new PublishStatusRequest.Builder()
.setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
.build());
deleteRecommendationClusters
Bu API, Öneri Grupları'nın içeriğini silmek için kullanılır.
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
Hizmet isteği aldığında mevcut verileri Öneri Kümeleri'nden kaldırır. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteFeaturedCluster
Bu API, Öne Çıkan Küme'nin içeriğini silmek için kullanılır.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Hizmet isteği aldığında mevcut verileri Öne Çıkan Küme'den kaldırır. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteContinuationCluster
Bu API, Devam Kümesi'nin içeriğini silmek için kullanılır.
Kotlin
client.deleteContinuationCluster()
Java
client.deleteContinuationCluster();
Hizmet, isteği aldığında mevcut verileri devamlılık kümesinden kaldırır. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteUserManagementCluster
Bu API, UserAccountManagement kümesinin içeriğini silmek için kullanılır.
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
Hizmet isteği aldığında mevcut verileri UserAccountManagement kümesinden kaldırır. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteClusters
Bu API, belirli bir küme türünün içeriğini silmek için kullanılır.
Kotlin
client.deleteClusters(
DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_CONTINUATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.build())
Java
client.deleteClusters(
new DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_CONTINUATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.build());
Hizmet isteği aldığında mevcut verileri, belirtilen küme türleriyle eşleşen tüm kümelerden kaldırır. İstemciler bir veya daha fazla küme türü iletmeyi seçebilir. Hata durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
Hata işleme
Başarılı bir görevi kurtarmak ve yeniden göndermek için takip işlemi yapılabilmesi amacıyla yayınlama API'lerinden gelen görev sonucunu dinlemeniz önemle tavsiye edilir.
Kotlin
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(..)
.build())
.addOnCompleteListener { task ->
if (task.isSuccessful) {
// do something
} else {
val exception = task.exception
if (exception is AppEngageException) {
@AppEngageErrorCode val errorCode = exception.errorCode
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
}
Java
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(...)
.build())
.addOnCompleteListener(
task -> {
if (task.isSuccessful()) {
// do something
} else {
Exception exception = task.getException();
if (exception instanceof AppEngageException) {
@AppEngageErrorCode
int errorCode = ((AppEngageException) exception).getErrorCode();
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
});
Hata, nedenini içeren bir AppEngageException olarak döndürülür.
| Hata kodu | Not |
|---|---|
SERVICE_NOT_FOUND |
Hizmet, belirtilen cihazda kullanılamıyor. |
SERVICE_NOT_AVAILABLE |
Hizmet, söz konusu cihazda kullanılabilir ancak arama sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır). |
SERVICE_CALL_EXECUTION_FAILURE |
İş parçacığı sorunları nedeniyle görev yürütme başarısız oldu. Bu durumda, işlem yeniden denenebilir. |
SERVICE_CALL_PERMISSION_DENIED |
Arayan kullanıcının hizmet çağrısı yapmasına izin verilmiyor. |
SERVICE_CALL_INVALID_ARGUMENT |
İstek geçersiz veriler içeriyor (örneğin, izin verilen küme sayısından daha fazla küme). |
SERVICE_CALL_INTERNAL |
Hizmet tarafında bir hata var. |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Hizmet çağrısı çok sık yapılıyor. |
3. adım: Yayın amaçlarını işleme
İçerik yayınlama API çağrılarını bir iş aracılığıyla yapmanın yanı sıra, içerik yayınlama isteğini almak için BroadcastReceiver ayarlamanız da gerekir.
Yayın niyetlerinin temel amacı, uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın amaçları çok sık gönderilmek üzere tasarlanmamıştır. Bu özellik yalnızca Engage Hizmeti, içeriğin eski olabileceğini (örneğin, bir hafta önce yayınlanmış) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süredir çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimi yaşayabileceğine dair daha fazla güven duyulur.
BroadcastReceiver aşağıdaki iki şekilde ayarlanmalıdır:
BroadcastReceiversınıfının bir örneğiniContext.registerReceiver()kullanarak dinamik olarak kaydedin. Bu, bellekte hâlâ etkin olan uygulamalardan iletişime izin verir.
Kotlin
class AppEngageBroadcastReceiver : BroadcastReceiver(){
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}
fun registerBroadcastReceivers(context: Context){
var context = context
context = context.applicationContext
// Register Recommendation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Featured Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Continuation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(Intents.ACTION_PUBLISH_CONTINUATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
}
Java
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continuation cluster publish when PUBLISH_CONTINUATION broadcast is
// received
}
public static void registerBroadcastReceivers(Context context) {
context = context.getApplicationContext();
// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Continuation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_CONTINUATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
}
<receiver>etiketiyle bir uygulamayıAndroidManifest.xmldosyanızda statik olarak bildirin. Bu, uygulamanın çalışmadığı zamanlarda yayın amaçlarını almasına ve içeriği yayınlamasına olanak tanır.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_CONTINUATION" />
</intent-filter>
</receiver>
</application>
Hizmet tarafından aşağıdaki amaçlar gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONBu amaç alındığındapublishRecommendationClustersaraması başlatılması önerilir.com.google.android.engage.action.PUBLISH_FEATUREDBu amaç alındığındapublishFeaturedClustergörüşmesi başlatılması önerilir.com.google.android.engage.action.PUBLISH_CONTINUATIONBu amaç alındığındapublishContinuationClustergörüşmesi başlatılması önerilir.
Entegrasyon iş akışı
Entegrasyonunuz tamamlandıktan sonra doğrulama ile ilgili adım adım kılavuz için Geliştirici entegrasyonu iş akışını kullanma başlıklı makaleyi inceleyin.
SSS
SSS için Engage SDK ile ilgili sık sorulan sorular bölümüne bakın.
İletişim
Entegrasyon işlemi sırasında herhangi bir sorunuz olursa engage-developers@google.com ile iletişime geçin.
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonraki adımlarınız şunlardır:
engage-developers@google.comadresine e-posta gönderin ve Google tarafından test edilmeye hazır olan entegre APK'nızı ekleyin.- Google, entegrasyonun beklendiği gibi çalıştığından emin olmak için doğrulama yapar ve şirket içinde inceleme gerçekleştirir. Değişiklik yapılması gerekiyorsa Google, gerekli ayrıntıları paylaşmak için sizinle iletişime geçer.
- Test tamamlandığında ve herhangi bir değişiklik yapılması gerekmediğinde Google, güncellenmiş ve entegre edilmiş APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
- Google, güncellenen APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneri, Öne Çıkanlar ve Devam kümeleriniz yayınlanabilir ve kullanıcılara gösterilebilir.