Engage SDK Arkadaşlık: Üçüncü taraf teknik entegrasyon talimatları

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, veya EventEntity (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.

        Şekil 1: Öneriler kümesinde tek bir ArticleEntity öğesinin gösterildiği kullanıcı arayüzü.
      • 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.

        Şekil 2: Kullanıcı arayüzünde tek bir PersonEntity (Kişi Varlığı) gösteriliyor Öneri kümesi.
      • 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.

        Şekil 3: Tek bir EventEntity gösteren kullanıcı arayüzü Öneriler kümesine dahil edilir.
  • 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.

      Şekil 6. Şurada tek bir Makale Varlığının gösterildiği kullanıcı arayüzü bir Devam kümesi oluşturuyor.
    • 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ı.

      Şekil 8. Tek bir tane gösteren kullanıcı arayüzü Bir Devam kümesi içindeki EventReservationEntity.
  • Ö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.

      Şekil 12: Kullanıcı arayüzünde Genel Öne ÇıkanEntity listesi

Ö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:

  1. GenericFeaturedEntity
  2. ArticleEntity
  3. PersonEntity
  4. EventEntity
  5. 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ı

  • "Canlı güncelleme"
  • Makale okuma süresi
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ı

  • Örneğin, "Canlı güncelleme"
  • Örneğin, Makale okuma süresi
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

  • TYPE_HEALTH_AND_FITENESS (Örnek - Yoga/fitness eğitmeni)
  • TYPE_HOME_AND_OTO (Örnek - Tesisatçı)
  • TYPE_SPORTS (Örnek - Oyuncu)
  • TÜR_TARİH VERME

İç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

  • TYPE_MovieS_AND_TV_SHOWS (Örnek - Sinema)
  • TYPE_DIGITAL_GAMES (Örnek - e-Spor)
  • TYPE_MUSIC (Örnek - Konser)
  • TYPE_TRAVEL_AND_LOCAL (Örnek - Tur, festival)
  • TYPE_HEALTH_AND_FITENESS (Örnek - Yoga dersi)
  • TYPE_EDUCATION (Örnek - Sınıf)
  • TYPE_SPORTS (Örnek - Futbol maçı)
  • TYPE_DAting (Örnek - buluşma)

İç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

  • TYPE_MovieS_AND_TV_SHOWS (Örnek - Sinema)
  • TYPE_DIGITAL_GAMES (Örnek - e-Spor)
  • TYPE_MUSIC (Örnek - Konser)
  • TYPE_TRAVEL_AND_LOCAL (Örnek - Tur, festival)
  • TYPE_HEALTH_AND_FITENESS (Örnek - Yoga dersi)
  • TYPE_EDUCATION (Örnek - Sınıf)
  • TYPE_SPORTS (Örnek - Futbol maçı)
  • TYPE_DAting (Örnek - buluşma)

İç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ı

  1. 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.
  2. 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.
  3. ContentCategory alanı isteğe bağlıdır ve içerik daha önce belirtilen kategorilerden hiçbirine ait değildir.

  4. 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ğini Context.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 Önerilir publishRecommendationClusters araması başlatın.
  • com.google.android.engage.action.PUBLISH_FEATURED Önerilir. Bu niyeti alırken publishFeaturedCluster araması başlatın.
  • com.google.android.engage.action.PUBLISH_CONTINUATION Önerilir. Bu niyeti alırken publishContinuationCluster 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.