Engage SDK Social: Üçüncü taraf teknik entegrasyon talimatları

Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriğinin tüketilmesi ve keşfedilmesi için yeni ve etkileyici bir deneyim sağlayan bir cihaz yüzeyi geliştirmektedir. Bu tam ekran deneyimi, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda gösterme fırsatı sunar.

Bu dokümanda, geliştirici iş ortaklarının bu yeni yüzey alanını doldurmak için Engage SDK'sını kullanarak sosyal içeriklerini entegre etmelerine yönelik talimatlar bulunmaktadır.

Entegrasyon ayrıntısı

Aşağıdaki bölümde entegrasyon ayrıntıları yer almaktadır.

Terminoloji

Öneri kümeleri, bağımsız bir geliştirici iş ortağından kişiselleştirilmiş öneriler gösterir.

Önerileriniz aşağıdaki yapıyı alır:

Öneri Kümesi: Aynı geliştirici iş ortağından bir grup öneri içeren kullanıcı arayüzü görünümü.

Her Öneri Kümesi aşağıdaki iki varlık türünden birinden oluşur :

• DikeyMedyaÖğesi
• SosyalPostEntity

PortreMediaEntity, yayın için 1 dikey resim içermelidir. Profil ve Etkileşimle ilgili meta veriler isteğe bağlıdır.

• Gönderi

  • Dikey modda resim ve Zaman Damgası veya
  • Dikey modda resim + metin içeriği ve Zaman Damgası

• Profil

  • Avatar, Ad veya Herkese Açık Kullanıcı Adı, Ek resim

• Etkileşim

  • Yalnızca sayı ve etiket ya da
  • Sayı ve görsel (simge)

SocialPostEntity; profil, yayın ve etkileşimle ilgili meta verileri içerir.

• Profil

  • Avatar, Ad veya Herkese Açık Kullanıcı Adı, ek metin, ek resim

• Gönderi

  • Metin ve Zaman Damgası veya
  • Rich media (resim veya zengin URL) ve Zaman Damgası ya da
  • Metin ve zengin medya (resim veya zengin URL) ile Zaman Damgası

• Etkileşimler

  • Yalnızca sayı ve etiket ya da
  • Sayı ve görsel (simge)

Çalışma öncesi

Minimum API düzeyi: 19

com.google.android.play:engage kitaplığını uygulamanıza ekleyin:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.4.0'
}

Özet

Tasarım, bağlı bir hizmetin uygulanmasına dayanır.

Bir istemcinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:

Küme türü	Küme sınırları	Bir kümedeki minimum varlık sınırları	Bir kümedeki maksimum varlık sınırları
Öneri Kümeleri	En fazla 5	En az 5 (PortraitMediaEntity veya SocialPostEntity)	En fazla 25 (PortraitMediaEntity veya SocialPostEntity)

1. adım: Varlık verileri sağlayın

SDK, her bir öğe türünü temsil edecek farklı varlıklar tanımlamıştır. SDK, Sosyal kategorisi için aşağıdaki varlıkları destekler:

1. PortraitMediaEntity
2. SocialPostEntity

Aşağıdaki grafiklerde, her tür için kullanılabilir özellikler ve gereksinimler özetlenmiştir.

PortraitMediaEntity

Özellik	Şartlar	Açıklama	Biçim
İşlem URI'si	Zorunlu	Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin	URI
İlgili meta verileri yayınlayın (Zorunlu)
Resimler	Zorunlu	Resimler dikey en boy oranında olmalıdır. Birden fazla resim sağlandığında kullanıcı arayüzünde yalnızca 1 resim gösterilebilir. Ancak kullanıcı arayüzü, uygulamada daha fazla görüntü olduğuna dair görsel göstergeler sunabilir. Gönderi bir video ise sağlayıcı, resim olarak gösterilecek videonun küçük resmini sağlamalıdır.	Yardım için Resim Özellikleri bölümüne bakın.
Metin içeriği	İsteğe bağlı	Bir yayının, güncellemenin vb. ana metni.	Dize (önerilen maks. 140 karakter)
Zaman damgası	İsteğe bağlı	Yayının yayınlandığı zaman.	Milisaniye cinsinden dönem zaman damgası
Profille ilgili meta veriler (İsteğe bağlı)
Ad	Zorunlu	Profil adı, kimliği veya herkese açık kullanıcı adı (ör. "Can Doğru", "@TeamPixel")	Dize(önerilen maks. 25 karakter)
Avatar	Zorunlu	Kullanıcının profil resmi veya avatar resmi. Kare 1:1 resim	Yardım için Resim Özellikleri bölümüne bakın.
Ek Resim	İsteğe bağlı	Profil rozeti. Örneğin, doğrulanmış rozeti Kare 1:1 resim	Yardım için Resim Özellikleri bölümüne bakın.
Etkileşimlerle ilgili meta veriler (İsteğe bağlı)
Sayı	Zorunlu	Etkileşim sayısını belirtin (örneğin, "3,7 M").	Dize (sayı ve etiketin toplamı için önerilen maks. 20 karakter)
Şirket	İsteğe bağlı Belirtilmezse Görsel sağlanmalıdır.	Etkileşimin ne için olduğunu belirtin. Örneğin, "Beğeniler".	Dize (sayı ve etiketin toplamı için önerilen maks. 20 karakter)
Görsel	İsteğe bağlı Sağlanmazsa Etiket sağlanmalıdır.	Etkileşimin ne için olduğunu belirtin. Örneğin, Beğeniler simgesinin, Emojilerin gösterildiği resim. 1'den fazla resim sağlanabilir ancak tüm form faktörlerinde tüm resimler gösterilmeyebilir. Kare 1:1 resim	Yardım için Resim Özellikleri bölümüne bakın.
DisplayTimeWindow (İsteğe Bağlı): İçeriğin yüzeyde gösterileceği zaman aralığını belirleyin
Başlangıç Zaman Damgası	İsteğe bağlı	İçeriğin yüzeyde gösterilmesi gereken dönemin zaman damgası. Politika ayarlanmazsa içerikler yüzeyde gösterilebilir.	Milisaniye cinsinden dönem zaman damgası
Bitiş Zaman Damgası	İsteğe bağlı	İçeriğin artık yüzeyde gösterilmediği dönemin zaman damgası. Politika ayarlanmazsa içerikler yüzeyde gösterilebilir.	Milisaniye cinsinden dönem zaman damgası

SocialPostEntity

Özellik	Şartlar	Açıklama	Biçim
İşlem URI'si	Zorunlu	Sağlayıcı uygulamasındaki varlığın Derin Bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin	URI
İlgili meta verileri yayınlayın (Zorunlu) En az bir TextContent, Image veya WebContent zorunludur
Resimler	İsteğe bağlı	Resimler dikey en boy oranında olmalıdır. Birden fazla resim sağlandığında kullanıcı arayüzünde yalnızca 1 resim gösterilebilir. Ancak kullanıcı arayüzü, uygulamada daha fazla görüntü olduğuna dair görsel göstergeler sunabilir. Gönderi bir video ise sağlayıcı, resim olarak gösterilecek videonun küçük resmini sağlamalıdır.	Yardım için Resim Özellikleri bölümüne bakın.
Metin içeriği	İsteğe bağlı	Bir yayının, güncellemenin vb. ana metni.	Dize (önerilen maks. 140 karakter)
Bağlantı Önizleme (İsteğe bağlı)
Bağlantı Önizleme - Başlık	Zorunlu	Web sayfası içeriğinin başlığını belirten metin	Dize
Bağlantı Önizleme - Ana makine adı	Zorunlu	Web sayfası sahibini belirten metin, ör. "INSIDER"	Dize
Bağlantı Önizleme - Resim	İsteğe bağlı	Web içeriği için lokomotif resim	Yardım için Resim Özellikleri bölümüne bakın.
Zaman damgası	İsteğe bağlı	Yayının yayınlandığı zaman.	Milisaniye cinsinden dönem zaman damgası
Profille ilgili meta veriler (İsteğe bağlı)
Ad	Zorunlu	Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Doğru", "@TeamPixel").	Dize(önerilen maks. 25 karakter)
Ek Metin	İsteğe bağlı	Profil kimliği, herkese açık kullanıcı adı veya ek meta veri olarak kullanılabilir Örneğin, "@Burçin Bilgili", "5 milyon takipçi", "Beğenebilirsiniz", "Trendler","5 yeni yayın"	Dize(önerilen maks. 40 karakter)
Avatar	Zorunlu	Kullanıcının profil resmi veya avatar resmi. Kare 1:1 resim	Yardım için Resim Özellikleri bölümüne bakın.
Ek Resim	İsteğe bağlı	Profil rozeti (ör. onaylı rozeti) Kare 1:1 resim	Yardım için Resim Özellikleri bölümüne bakın.
Etkileşimlerle ilgili meta veriler (İsteğe bağlı)
Sayı	Zorunlu	Etkileşim sayısını belirtin (örneğin, "3,7 M").	Dize (sayı ve etiketin toplamı için önerilen maks. 20 karakter)
Şirket	İsteğe bağlı Belirtilmezse Görsel sağlanmalıdır.	Etkileşimin ne için olduğunu belirtin. Örneğin, "Beğeniler".	Dize (sayı ve etiketin toplamı için önerilen maks. 20 karakter)
Görsel	İsteğe bağlı Sağlanmazsa Etiket sağlanmalıdır.	Etkileşimin ne için olduğunu belirtin. Örneğin, Beğeniler simgesi, Emojiler'in gösterildiği resim . 1'den fazla resim sağlanabilir ancak tüm form faktörlerinde tüm resimler gösterilmeyebilir. Kare 1:1 resim	Yardım için Resim Özellikleri bölümüne bakın.
DisplayTimeWindow (İsteğe Bağlı): İçeriğin yüzeyde gösterileceği zaman aralığını belirleyin
Başlangıç Zaman Damgası	İsteğe bağlı	İçeriğin yüzeyde gösterilmesi gereken dönemin zaman damgası. Politika ayarlanmazsa içerikler yüzeyde gösterilebilir.	Milisaniye cinsinden dönem zaman damgası
Bitiş Zaman Damgası	İsteğe bağlı	İçeriğin artık yüzeyde gösterilmediği dönemin zaman damgası. Politika ayarlanmazsa içerikler yüzeyde gösterilebilir.	Milisaniye cinsinden dönem zaman damgası

Resim özellikleri

Google'ın bu görüntülere erişebilmesi için görüntülerin herkese açık CDN'lerde barındırılması gerekir.

Dosya biçimleri

PNG, JPG, statik GIF, WebP

Maksimum dosya boyutu

5.120 KB

Ek öneriler

• Resim güvenli alanı: Önemli içeriklerinizi yatay ve dikey yönde ortalanmış olarak resmin% 80'ini kaplayacak şekilde yerleştirin.
• Resmin Koyu ve Açık tema ayarlarında düzgün bir şekilde görüntülenebilmesi için şeffaf bir arka plan kullanın.

2. Adım: Küme verilerini sağlayın

İçerik yayınlama işinin arka planda yürütülmesi (örneğin, WorkManager kullanılarak) ve düzenli olarak ya da etkinlik temelli olarak planlanması önerilir (örneğin, kullanıcı uygulamayı her açtığında veya kullanıcı yeni bir hesabı takip ettiğinde)

AppEngageSocialClient, sosyal kümeleri yayınlamaktan sorumludur.

Kümeleri istemcide yayınlamak için aşağıdaki API'ler mevcuttur:

• isServiceAvailable
• publishRecommendationClusters
• publishUserAccountManagementRequest
• updatePublishStatus
• deleteRecommendationsClusters
• deleteUserManagementCluster
• deleteClusters

isServiceAvailable

Bu API, hizmetin entegrasyon için uygun olup olmadığını ve içeriğin cihazda sunulup sunulmadığını kontrol etmek için kullanılır.

Kotlin

client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content
          // publish calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}

Java

client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content
          // publish calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

Not: Hizmetin daha sonraki bir noktada kullanılabilir olup olmadığını kontrol etmek için düzenli bir iş çalıştırmanızı önemle tavsiye ederiz. Hizmetin kullanılabilirliği; Android sürümü yükseltmeleri, uygulama yükseltmeleri, yüklemeleri ve kaldırmaları nedeniyle değişebilir. Belirli bir zaman aralığında düzenli iş denetimleri gerçekleştirerek veriler, hizmet kullanıma sunulduğunda yayınlanabilir.

publishRecommendationClusters

Bu API, RecommendationCluster nesnelerini bir liste yayınlamak için kullanılır.

RecommendationCluster nesnesi aşağıdaki özelliklere sahip olabilir:

Özellik	Şartlar	Açıklama
SocialPostEntity veya PortraitMediaEntity listesi	Zorunlu	Bu Öneri Kümesi için önerileri oluşturan varlıkların listesi. Tek bir kümedeki varlıklar aynı türde olmalıdır.
Başlık	Zorunlu	Öneri Kümesi başlığı (örneğin, Arkadaşlarınızdan en yeniler). Önerilen metin boyutu: 25 karakterden kısa (Çok uzun olan metinlerde üç nokta gösterilebilir)
İşlem URI'sı	İsteğe bağlı	Kullanıcıların önerilerin tam listesini görebileceği iş ortağı uygulamasındaki sayfanın derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin

Önemli: Yayın API'leri upsert API'lerdir ve mevcut içeriğin yerini alır. Yayınlama API'leri kendiliğinden bunu yaptığından, içeriği değiştirmek için delete ve publish API'lerini daha sonra çağırmayın.

Kotlin

client.publishRecommendationClusters(
            PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Latest from your friends")
                        .build())
                .build())

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Latest from your friends")
                        .build())
                .build());

Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:

• Mevcut tüm Öneri Kümesi verileri kaldırılır.
• İstekten elde edilen veriler ayrıştırılır ve yeni Öneri Kümelerinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

publishUserAccountManagementRequest

Bu API, Oturum Açma kartı yayınlamak için kullanılır . Oturum açma işlemi, uygulamanın içerik yayınlayabilmesi (veya daha kişiselleştirilmiş içerik sağlayabilmesi) için kullanıcıları uygulamanın oturum açma sayfasına yönlendirir

Aşağıdaki meta veriler Oturum Açma Kartının bir parçasıdır -

Özellik	Şartlar	Açıklama
İşlem URI'sı	Zorunlu	İşlem için derin bağlantı (ör. uygulamada oturum açma sayfasına yönlendirir)
Resim	İsteğe bağlı - Sağlanmamışsa başlık sağlanmalıdır	Kartta Gösterilen Resim 1264x712 çözünürlüklü 16x9 en boy oranına sahip resimler
Başlık	İsteğe bağlı - Sağlanmazsa Resim sağlanmalıdır	Kartın Başlığı
İşlem Metni	İsteğe bağlı	CTA'da gösterilen metin (ör. oturum açma)
Alt başlık	İsteğe bağlı	Kartta İsteğe Bağlı Altyazı

Önemli: Yayın API'leri upsert API'lerdir ve mevcut içeriğin yerini alır. Yayınlama API'leri kendiliğinden bunu yaptığından, içeriği değiştirmek için delete ve publish API'lerini daha sonra çağırmayın.

Kotlin

var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Java

SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:

• Geliştirici iş ortağından alınan mevcut UserAccountManagementCluster verileri kaldırılır.
• İstekteki veriler ayrıştırılır ve güncellenmiş UserAccountManagementCluster Kümesinde depolanır.

Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

updatePublishStatus

İşle ilgili herhangi bir nedenle kümelerin hiçbiri yayınlanmazsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle öneririz. Bu önemlidir, çünkü :

• İçerik yayınlandığında bile tüm senaryolarda durumun sağlanması (DURUM == YAYINLANDI), entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu uygunsuz durumu kullanan kontrol panellerinin doldurulması için kritik önem taşır.
• Hiçbir içerik yayınlanmadıysa ancak entegrasyon durumu bozuk değilse (STATUS == NOT_PUBLISHED) Google, uygulama durumu kontrol panellerinde uyarı tetiklemekten kaçınabilir. Bu işlem, sağlayıcının açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
• Geliştiricilerin, verilerin ne zaman yayınlanıp yayınlanmadığına dair analizler sağlamasına yardımcı olur.
• Google, durum kodlarını kullanıcının uygulama içeriğini görebilmesi veya aşması için uygulamada belirli işlemleri yapmasını yönlendirmek amacıyla kullanabilir.

Uygun yayınlama durum kodlarının listesi şu şekildedir :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

Kullanıcı giriş yapmadığı için içerik yayınlanmazsa Google, Oturum Açma Kartının yayınlanmasını önerir. Sağlayıcılar Oturum Açma Kartını herhangi bir nedenle yayınlayamazsa updatePublishStatus API'sinin NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla çağrılmasını öneririz

Kotlin

client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())

Java

client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

Bu API, Öneri Kümelerinin içeriğini silmek için kullanılır.

Önemli: Silme API'leri yalnızca yayınlanacak içerik olmadığında çağrılmalıdır. publish API'leri kendiliğinden bunu yaptığından, içeriği değiştirmek için delete and publish API'lerini daha sonra çağırmayın. Silme API'lerini kullanmadan önce engagement-developers@ ile iletişime geçin.

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

Hizmet, isteği aldığında mevcut verileri Öneri Kümelerinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteUserManagementCluster

Bu API, UserAccountManagement Cluster'ın içeriğini silmek için kullanılır.

Önemli: Silme API'leri yalnızca yayınlanacak içerik olmadığında çağrılmalıdır. publish API'leri kendiliğinden bunu yaptığından, içeriği değiştirmek için delete and publish API'lerini daha sonra çağırmayın. Silme API'lerini kullanmadan önce engagement-developers@ ile iletişime geçin.

Kotlin

client.deleteUserManagementCluster()

Java

client.deleteUserManagementCluster();

Hizmet, isteği aldığında mevcut verileri UserAccountManagement Cluster'dan kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

deleteClusters

Bu API, belirli bir küme türünün içeriğini silmek için kullanılır.

Önemli: Silme API'leri yalnızca yayınlanacak içerik olmadığında çağrılmalıdır. publish API'leri kendiliğinden bunu yaptığından, içeriği değiştirmek için delete and publish API'lerini daha sonra çağırmayın. Silme API'lerini kullanmadan önce engagement-developers@ ile iletişime geçin.

Kotlin

client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      ...
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                ...
                .build());

Hizmet isteği aldığında, belirtilen küme türleriyle eşleşen tüm kümelerden mevcut verileri kaldırır. Müşteriler bir veya daha fazla küme türünü geçirebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.

Hata işleme

Yayınlama API'lerinden gelen görev sonucunu dinlemeniz önemle tavsiye edilir. Böylece başarılı bir görevi kurtarıp yeniden göndermek için takip işlemi gerçekleştirilebilir.

client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

Hata, neden hata kodu olarak eklenmiş şekilde AppEngageException biçiminde döndürülür.

Hata kodu	Not
SERVICE_NOT_FOUND	Hizmet belirtilen cihazda kullanılamıyor.
SERVICE_NOT_AVAILABLE	Hizmet, belirtilen cihazda kullanılabilir ancak çağrı sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır).
SERVICE_CALL_EXECUTION_FAILURE	İleti dizisi sorunları nedeniyle görev yürütülemedi. Bu durumda, işlem yeniden denenebilir.
SERVICE_CALL_PERMISSION_DENIED	Arayanın servis araması yapma izni yok.
SERVICE_CALL_INVALID_ARGUMENT	İstek geçersiz veriler içeriyor (örneğin, izin verilen küme sayısından fazla).
SERVICE_CALL_INTERNAL	Hizmet tarafında bir hata var.
SERVICE_CALL_RESOURCE_EXHAUSTED	Servis çağrısı çok sık yapılıyor.

3. Adım: Yayın amaçlarını ele alın

Bir iş aracılığıyla publish Content API çağrıları yapmaya ek olarak, bir içerik yayınlama isteğini almak için BroadcastReceiver kurulumu da gerekir.

Yayın amaçlarının amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın amaçları çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca İnternet Reklamcılığı Programı içeriğin eski olabileceğini (örneğin, bir haftalık) belirlediğinde tetiklenir. Bu sayede, uygulama uzun süre çalıştırılmamış olsa bile kullanıcının yeni bir içerik deneyimine sahip olabileceğine dair daha fazla güven duyulur.

BroadcastReceiver aşağıdaki iki şekilde ayarlanmalıdır:

• Context.registerReceiver() kullanarak BroadcastReceiver sınıfının bir örneğini dinamik olarak kaydedin. Bu, hâlâ bellekte bulunan uygulamalardan iletişim kurulmasını sağlar.

class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION 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));

}

• Statik olarak AndroidManifest.xml dosyanızda <receiver> etiketiyle bir uygulama tanımlayın. Bu, uygulamanın çalışmadığında yayın amaçlarını almasına ve aynı zamanda uygulamanın içeriği yayınlamasına olanak tanır.

<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
   </receiver>
</application>

Hizmet tarafından aşağıdaki amaçlar gönderilir:

• com.google.android.engage.action.PUBLISH_RECOMMENDATION Bu amacı alırken bir publishRecommendationClusters çağrısı başlatmanız önerilir.

Entegrasyon iş akışı

Entegrasyonun tamamlandıktan sonra doğrulanmasıyla ilgili adım adım açıklamalı bir kılavuz için Geliştirici entegrasyonu iş akışını etkileşim kurma başlıklı makaleyi inceleyin.

SSS

SSS için Engage SDK'sı ile İlgili Sık Sorulan Sorular bölümüne bakın.

İletişim

Entegrasyon işlemi sırasında herhangi bir sorunuz olursa lütfen [e-mail] ile iletişime geçin. Ekibimiz mümkün olan en kısa sürede size yanıt verecektir.

Sonraki adımlar

Bu entegrasyonu tamamladıktan sonra uygulamanız gereken adımlar şunlardır:

• [e-mail] adresine e-posta gönderin ve Google tarafından test edilmeye hazır olan entegre APK'nızı ekleyin.
• Google, entegrasyonun beklendiği gibi çalıştığından emin olmak için bir doğrulama gerçekleştirir ve dahili incelemeler yapar. Değişiklik yapılması gerekirse Google gerekli bilgileri vermek için sizinle iletişime geçer.
• Test tamamlandığında ve herhangi bir değişiklik gerekmediğinde Google, güncellenen ve entegre APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
• Google, güncellenen APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneriniz, kümeler yayınlanır ve kullanıcılar tarafından görülebilir.