Google, cihaz üzerinde kullanıcıların cihazlarını ve sektörlere göre uygulamalar Ayrıca kişiselleştirilmiş uygulama içeriği tüketimi için yeni ve etkileyici bir deneyim sunar. keşfedeceğiz. Bu tam ekran deneyimi, geliştirici iş ortaklarına En iyi zengin içeriklerini YouTube dışındaki özel bir kanalda sergileme fırsatı Bu kılavuz, geliştirici iş ortaklarının entegre etmek için Engage SDK'sını kullanarak arkadaş bulma içeriklerini entegre edip bir yüzey.
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ş arkadaşlık önerileri gösterir Google Analytics 4'te e-posta alırsınız. Bu öneriler kullanıcıya göre kişiselleştirilmiştir.
- Öneri kümesi;
ArticleEntity
,PersonEntity
, veyaEventEntity
(farklı öğe türlerinin bir karışımı değil).
Ö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: flört ile ilgili metne dayalı içerik. ArticleEntity öğesi geliştiricilerin çeşitli metin ve resim içeriği sağlamasına olanak tanır bir araya getirerek bilgileri kullanıcılara daha ayrıntılı bir şekilde anlatır.
PersonEntity: PersonEntity bir kişiyi temsil eder. İlgili içeriği oluşturmak için kullanılan sosyalleşmek için flörtte birisini öne çıkarmak potansiyel müşterilerdir.
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.
- Öneri kümesi;
Devam kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden çok geliştirici iş ortağı ile çalışır. Her bir geliştirici iş ortağı Devamında en fazla 10 varlık yayınlamasına izin verilir kümesidir.
Devam içeriğiniz aşağıdaki yapıyı alabilir:
MakaleEntity: ArticleEntity, şuna yönelik bir öneriyi temsil eder: flört ile ilgili metne dayalı içerik. Bu varlık, tamamlanmamış haber makalelerini veya kullanıcının göreceği diğer içeriği temsil etme kaldığı yerden tüketmeye devam etmek olabilir.
EventReservationEntity: EventReservationEntity temsil eder ve kullanıcıların yaklaşan ya da devam eden etkinlikleri izlemelerine yardımcı olur. buluşma ve buluşma etkinliği rezervasyonları.
Ö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 , 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 ç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 Arkadaşlık kategorisi için şu varlıklar:
GenericFeaturedEntity
ArticleEntity
PersonEntity
EventEntity
EventReservationEntity
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 özel kullanıcı deneyimi kullanımı (ör. rozet olarak) resmin üzerinde yer paylaşımı
|
|
Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
İçeriğin Yayınlanma Zamanı | İsteğe bağlı | İçeriğin kullanıldığı zaman, milisaniye cinsinden, dönem zaman damgasıdır. Uygulamada yayınlanmış / güncellenmiş. | Milisaniye cinsinden Epoch zaman damgası |
Son Etkileşim Zamanı | Koşula Bağlı Olarak Zorunlu | Kullanıcının etkileşimde bulunduğu milisaniye cinsinden dönem zaman damgası bu öğe için istekli olabilir. Not: Bu alan, söz konusu tüzel kişiliğin ve devamı kümesidir. |
Milisaniye cinsinden Epoch zaman damgası |
İlerleme Yüzdesi | Koşula Bağlı Olarak Zorunlu | Bugüne kadar kullanıcı tarafından tüketilen tam içeriğin yüzdesi. Not: Bu alan, söz konusu tüzel kişiliğin ve devamı kümesidir. |
0~100 dahil olmak üzere bu değerler arasında bir tam sayı değeri. |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Sıralama Listesi İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
PersonEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantılar kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
Profil - Ad | Zorunlu | Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Doğru", "@TeamPixel" vb.) | Dize Önerilen metin boyutu: Maksimum 50 karakter |
Profil - Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri'ne bakın. |
Profil - Ek Metin | İsteğe bağlı | Profil herkese açık kullanıcı adı gibi serbest metinler olmalıdır. | Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
Profil - Ek Resim | İsteğe bağlı | Doğrulanmış rozet gibi küçük bir resim. | Yardım için Resim Özellikleri'ne bakın. |
Başlık resmi | İsteğe bağlı |
Üstbilgi resmini temsil eder. Profil resminden farklı olmalıdır. Bu özellik, bazı insanlar var. Not: Resim en boy oranı 16:9 olmalıdır. Rozet sağlanırsa Resmin hem üstünde hem de altında 24 d/sn güvenli alan sağlanmalıdır |
Yardım için Resim Özellikleri'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 Adet kullanılacak |
Dize Önerilen metin boyutu: Sayı + etiket için maksimum 20 karakter birleşik |
Popülerlik - Sayı Değeri | İsteğe bağlı | Takipçi sayısı veya popülerlik değeri. Not: Uygulamanız bunu istemiyorsa Sayı Değeri sağlayın büyük bir sayının optimize edilmesi için ne kadar farklı ekran boyutlarına sahip. Hem Sayı hem de Sayı Değeri sağlanırsa Sayı, kullanıcılara gösterilir. |
Uzun |
Popülerlik - Etiket | İsteğe bağlı | Popülerlik etiketinin ne olduğunu belirtin. Örneğin - "Beğenilenler". | Dize Önerilen metin boyutu: Sayı + etiket için maksimum 20 karakter birleşik |
Popülerlik - Görsel | İsteğe bağlı |
Etkileşimin ne için olduğunu belirtin. Örneğin - Gösterilen resim Beğenme simgesi, emoji. 1'den fazla resim eklenebilir ancak bunların tümü, tüm resimlerde gösterilmeyebilir olabilir. Not: Kare 1:1 resim olmalıdır. |
Yardım için Resim Özellikleri'ne bakın. |
Puan - Maksimum değer | Zorunlu | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
Puan - Geçerli değer | Zorunlu | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
Puan - Sayı | İsteğe bağlı | Varlık için puan sayısıdır. Not: Uygulamanız aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa ve öz bir dize girin. büyük bir kısmıdır. Örneğin, sayı 1.000.000 varsa, 1 milyon gibi kısaltmalar kullanabilirsiniz. daha küçük ekran boyutlarında kısaltılır. |
Dize |
Puan - Sayı Değeri | İsteğe bağlı | Varlık için puan sayısıdır. Not: İşlem yapmak istemiyorsanız bu alanı sağlayın. ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri kullanıcılara göstermek için Sayı'yı kullanacağız. |
Uzun |
Konum - Ülke | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği ülke. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Şehir | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği şehir. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Görünen Adres | İsteğe bağlı | Kullanıcının bulunduğu veya reklam sunduğu adres, temsil eder. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Açık Adres | İsteğe bağlı | Söz konusu kişinin bulunduğu açık adres (varsa) veya yardımcı olur. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Eyalet | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği eyalet (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Posta kodu | İsteğe bağlı | Kişinin bulunduğu veya hizmet verdiği posta kodu (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Mahalle | İsteğe bağlı | Söz konusu kişinin bulunduğu veya hizmet verdiği mahalle (varsa). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamaların Listesi
İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
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. |
EventReservationEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'sı | Zorunlu |
Sağlayıcı uygulamasındaki varlığa derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın 'nı inceleyin. |
URI |
Başlık | Zorunlu | Varlığın başlığıdır. | Dize Önerilen metin boyutu: Maksimum 50 karakter |
Başlangıç zamanı | Zorunlu |
Etkinliğin başlamasının beklendiği zamanın zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Epoch zaman damgası |
Etkinlik modu | Zorunlu | Etkinliğin sanal mı, yüz yüze mi yoksa yüz yüze mi olacağını belirten bir alan her ikisini de seçebilirsiniz. |
Enum: VIRTUAL, IN_PERSON veya HYBRID |
Konum - Ülke | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştiği ülke. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Şehir | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştiği şehir. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Görünen Adres | Koşula Bağlı Olarak Zorunlu | Etkinliğin gerçekleştirileceği yerin adı ve kullanıcıya gösterilecektir. Not: Bu, IN_PERSON veya KARMA |
Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Açık Adres | İsteğe bağlı | Etkinliğin yapıldığı konumun açık adresi (varsa) budur. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Eyalet | İsteğe bağlı | Etkinliğin gerçekleştiği eyalet veya il (geçerliyse) barındırılır. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Posta kodu | İsteğe bağlı | Etkinliğin gerçekleştiği konumun posta kodu (varsa) barındırılır. | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Konum - Mahalle | İsteğe bağlı | Etkinliğin düzenlendiği mahalle (geçerliyse). | Serbest metin Önerilen metin boyutu: Maksimum ~20 karakter |
Poster resimleri | İsteğe bağlı | Birden fazla resim sağlandığında yalnızca 1 resim gösterilir. Önerilen en boy oranı 16:9'dur Not: Resim kesinlikle önerilir. Rozet Hem üst hem de alt kısımda 24 dps'lik güvenli bir alan resim |
Yardım için Resim Özellikleri'ne bakın. |
Bitiş zamanı | İsteğe bağlı |
Etkinliğin sona ermesinin beklendiği dönem zaman damgası. Not: Bu değer, milisaniye cinsinden gösterilir. |
Milisaniye cinsinden Epoch zaman damgası |
Servis Sağlayıcı - Ad | İsteğe bağlı |
Servis sağlayıcının adı. Not: Hizmet için metin veya resim gereklidir sağlar. |
Serbest metin. Örneğin, etkinliği düzenleyenin/turun adı |
Servis Sağlayıcı - Resim | İsteğe bağlı |
Servis sağlayıcının logosu/resmi. Not: Hizmet için metin veya resim gereklidir sağlar. |
Yardım için Resim Özellikleri'ne bakın. |
Açıklama | İsteğe bağlı | Tüzel kişiyi açıklayan tek bir paragraflık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Önerilen metin boyutu: 180 karakter |
Altyazı listesi | İsteğe bağlı | En fazla 3 altyazı ve her altyazıda tek satırlık metin. Not: Açıklama veya altyazı listesi kullanıcıya gösterilir. |
Serbest metin Her altyazı için önerilen metin boyutu: maks. 50 karakter |
Rozetler | İsteğe bağlı |
Her rozet, serbest metin (maks. 15 karakter) veya küçük resimdir. |
|
Rozet - Metin | İsteğe bağlı | Rozet başlığı Not: Rozet için metin veya resim gereklidir |
Serbest metin Önerilen metin boyutu: Maksimum 15 karakter |
Rozet - Resim | İsteğe bağlı | Küçük resim Özel kullanıcı deneyimi değerlendirmesi (ör. resimde/videoda rozet yer paylaşımı) küçük resim. Not: Rozet için metin veya resim gereklidir |
Yardım için Resim Özellikleri'ne bakın. |
Rezervasyon Kimliği | İsteğe bağlı | Etkinlik rezervasyonunun rezervasyon kimliği. | Serbest metin |
Fiyat - CurrentPrice | Koşula bağlı olarak gerekli |
Etkinlik biletinin/kartın mevcut fiyatı. Üstü çizili fiyat sağlanıyorsa sağlanmalıdır. |
Serbest metin |
Fiyat - StrikethroughPrice | İsteğe bağlı | Etkinlik biletinin/kartın orijinal fiyatı. | Serbest metin |
Fiyat Açıklama Metni | İsteğe bağlı | Promosyon, etkinlik veya üye indirimi varsa bunları öne çıkarmak için fiyat açıklama metni. | Serbest metin Önerilen metin boyutu: 45 karakterden kısa (Metin çok uzun) üç nokta simgesi olabilir) |
Puan - Maksimum değer | İsteğe bağlı | Derecelendirme ölçeğinin maksimum değeri. Geçerli puan değeri de şu durumlarda sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
Puan - Geçerli değer | İsteğe bağlı | Derecelendirme ölçeğinin mevcut değeri. Maksimum puan değeri de şu ise sağlanmalıdır: sağlar. |
Sayı >= 0,0 |
Puan - Sayı | İsteğe bağlı | Etkinlik için verilen puan sayısı. Not: Uygulamanız aşağıdaki gibiyse bu alanı sağlayın: ve bunun kullanıcılara nasıl görüntüleneceğini denetleyin. Kısa ve öz bir dize girin. büyük bir kısmıdır. Örneğin, sayı 1.000.000 varsa, 1 milyon gibi kısaltmalar kullanabilirsiniz. daha küçük ekran boyutlarında kısaltılır. |
Dize |
Puan - Sayı Değeri | İsteğe bağlı | Etkinlik için verilen puan sayısı. Not: İşlem yapmak istemiyorsanız bu alanı sağlayın. ekran kısaltma mantığını kendiniz çözebilir. Hem Sayım hem de Sayım Değeri kullanıcılara göstermek için Sayı'yı kullanacağız. |
Uzun |
İçerik Kategorileri | İsteğe bağlı | Varlıktaki içeriğin kategorisini açıklayın. | Uygun Sıralamaların Listesi
İçerik Kategorisi bölümüne bakın. inceleyebilirsiniz. |
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, EventEntity, EventReservationEntity, PersonEntity, yalnızca bir alt kümesi uygun olduğunu gördük. Aşağıdakiler için uygun kategorilerin listesini inceleyin: bir varlık türünü belirtmelisiniz.
Bazı içerik kategorileri için bir kombinasyon yerine belirli bir öğe türünü kullanın. ve ContentCategory (İçerik Kategorisi) arasında şunlar bulunur:
- TYPE_MovieS_AND_TV_SHOWS - Şunlara göz atın: anlamına gelir.
- TYPE_BOOKS - Şuna göz atın: EbookEntity anlamına gelir.
- TYPE_AUDIOBOOKS - Ödeme Şundan önce AudiobookEntity: emin olmanız gerekir.
- TYPE_SHOPPING - Ödeme Şu tarihten önce ShoppingEntity: emin olmanız gerekir.
- TYPE_FOOD_AND_DRINK - Şuradaki varlıkları incele: Gıda Entegrasyonu Kılavuzu anlamına gelir.
ContentCategory alanı isteğe bağlıdır ve içerik daha önce belirtilen kategorilerden hiçbirine ait değildir.
Birden fazla içerik kategorisi sağlanmışsa bunları sırasıyla sağlayın. en alakalı içerik kategorisine yerleştirilen içerikle alaka düzeyi ilk sırada yer alıyor.
2. Adım: Küme verilerini sağlayın
İçerik yayınlama işinin arka planda yürütülmesi önerilir (örneğin, WorkManager kullanarak) düzenlenecek ve düzenli olarak veya etkinlik temelli olarak (örneğin, Kullanıcı uygulamayı açtığında veya kullanıcı sepetine yeni bir ürün eklediğinde).
AppEngagePublishClient
, kümeleri yayınlamaktan sorumludur.
İstemcide küme yayınlamak için aşağıdaki API'lerden yararlanabilirsiniz:
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.