Google, kullanıcıların uygulamalarını sektörlere göre düzenleyen ve kişiselleştirilmiş uygulama içeriği tüketimi ve keşfi için yeni bir sürükleyici deneyim sunan cihaz üzerinde bir yüzey oluşturuyor. Bu tam ekran deneyimi, geliştirici iş ortaklarına en iyi zengin içeriklerini uygulamalarının dışında özel bir kanalda sergileme fırsatı sunar.
Bu doküman, 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 içerir.
Entegrasyon ayrıntısı
Aşağıdaki bölümde entegrasyon ayrıntıları yer alır.
Terminoloji
Öneri kümeleri, geliştirici iş ortaklarından kişiselleştirilmiş öneriler gösterir.
Önerileriniz aşağıdaki yapıya sahiptir:
Öneri Kümesi: Aynı geliştirici iş ortağından bir öneri grubu içeren kullanıcı arayüzü görünümü.
Her öneri kümesi aşağıdaki iki öğe türünden birinden oluşur :
- PortraitMediaEntity
- SocialPostEntity
PortraitMediaEntity, gönderi 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şimler
- Yalnızca sayma ve etiketleme veya
- 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ı veya
- Metin ve zengin medya (resim veya zengin URL) ve zaman damgası veya
- Video önizlemesi (küçük resim ve süre) ve zaman damgası
Etkileşimler
- Yalnızca sayma ve etiketleme veya
- Sayı ve görsel (simge)
Ö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, bağlantılı bir hizmet uygulamasına dayanır.
Bir istemcinin yayınlayabileceği veriler, farklı küme türleri için aşağıdaki sınırlara tabidir:
Küme türü | Küme sınırları | Bir kümedeki minimum öğe sınırları | Bir kümedeki maksimum öğe sınırları |
---|---|---|---|
Öneri Kümeleri | En fazla 7 | En az 1 (PortraitMediaEntity veya
SocialPostEntity ) |
En fazla 50 (PortraitMediaEntity veya
SocialPostEntity ) |
1. adım: Öğe verilerini sağlayın
SDK, her öğe türünü temsil etmek için farklı öğeler tanımlamıştır. SDK, Sosyal kategorisi için aşağıdaki öğeleri destekler:
PortraitMediaEntity
SocialPostEntity
Aşağıdaki grafiklerde, her tür için kullanılabilen özellikler ve koşullar özetlenmiştir.
PortraitMediaEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
Gönderiyle ilgili meta veriler (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ünde, uygulamada daha fazla resim bulunduğuna dair görsel bir gösterge bulunabilir. Yayın videoysa sağlayıcı, videonun resim olarak gösterilecek 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 maksimum 140 karakter) |
Zaman damgası | İsteğe bağlı | Gönderinin yayınlandığı zaman. | Milisaniye cinsinden Unix sıfır zaman damgası |
Video içeriğidir. | İsteğe bağlı | Gönderi video mu? | boole |
Video süresi | İsteğe bağlı | Videonun milisaniye cinsinden süresi. | Uzun |
Profille ilgili meta veriler (isteğe bağlı) | |||
Ad | Zorunlu | Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Demir", "@TeamPixel") | Dize(önerilen maksimum 25 karakter) |
Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Kare resim (1:1) |
Yardım için Resim Özellikleri bölümüne bakın. |
Ek resim | İsteğe bağlı |
Profil rozeti. Örneğin, doğrulanmış rozet Kare resim (1:1) |
Yardım için Resim Özellikleri bölümüne bakın. |
Etkileşimle ilgili meta veriler (isteğe bağlı) | |||
Sayı | İsteğe bağlı |
Etkileşim sayısını belirtin (ör. "3, 7 milyon"). Not: Hem Count hem de Count Value sağlanırsa Count kullanılır. |
Dize Önerilen metin boyutu: Sayı + etiket için en fazla 20 karakter |
Sayı Değeri | İsteğe bağlı | Etkileşim sayısı (değer). Not: Uygulamanız büyük bir sayının farklı ekran boyutları için nasıl optimize edileceğiyle ilgili mantığı işlemiyorsa Sayı yerine Sayı Değeri değerini sağlayın. Hem Sayı hem de Sayı Değeri sağlanırsa Sayı kullanılır. |
Uzun |
Etiket | İsteğe bağlı | Etkileşim etiketinin ne için olduğunu belirtin. Örneğin: "Beğeniler". | Dize Önerilen metin boyutu: Sayı + etiket için en fazla 20 karakter |
Görsel | İsteğe bağlı |
Etkileşimin neyle ilgili olduğunu belirtin. Örneğin: Beğenme simgesini, emojiyi gösteren resim. 1'den fazla resim sağlanabilir ancak bunların hepsi tüm form faktörlerinde gösterilmeyebilir. Not: 1:1 kare resim olmalıdır. |
Yardım için Resim Özellikleri bölümüne bakın. |
DisplayTimeWindow (İsteğe bağlı) - Bir içeriğin yüzeyde gösterileceği bir zaman aralığı belirleme | |||
Başlangıç zaman damgası | İsteğe bağlı |
İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası. Ayarlanmazsa içerik yüzeyde gösterilmeye uygundur. |
Milisaniye cinsinden Unix sıfır zaman damgası |
Bitiş zaman damgası | İsteğe bağlı |
İçeriğin artık platformda gösterilmeyeceği zaman damgası. Ayarlanmazsa içerik yüzeyde gösterilmeye uygundur. |
Milisaniye cinsinden Unix sıfır zaman damgası |
SocialPostEntity
Özellik | Şartlar | Açıklama | Biçim |
---|---|---|---|
İşlem URI'si | Zorunlu |
Sağlayıcı uygulamasındaki öğeye derin bağlantı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS'ye bakın |
URI |
Gönderiyle ilgili meta veriler (Zorunlu) TextContent, Image veya WebContent öğelerinden en az biri gereklidir. |
|||
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ünde, uygulamada daha fazla resim bulunduğuna dair görsel bir gösterge bulunabilir. Yayın videoysa sağlayıcı, videonun resim olarak gösterilecek 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 maksimum 140 karakter) |
Video İçeriği (İsteğe Bağlı) | |||
Süre | Zorunlu | Videonun milisaniye cinsinden süresi. | Uzun |
Resim | Zorunlu | Video içeriğinin önizleme resmi. | Yardım için Resim Özellikleri bölümüne bakın. |
Bağlantı Önizlemesi (İsteğe Bağlı) | |||
Bağlantı Önizlemesi - Başlık | Zorunlu | Web sayfası içeriğinin başlığını belirten metin | Dize |
Bağlantı Önizlemesi - Ana Makine Adı | Zorunlu | Web sayfasının sahibini belirten metin (ör. "INSIDER") | Dize |
Bağlantı Önizlemesi - Resim | İsteğe bağlı | Web içeriği için hero resim | Yardım için Resim Özellikleri bölümüne bakın. |
Zaman damgası | İsteğe bağlı | Gönderinin yayınlandığı zaman. | Milisaniye cinsinden Unix sıfır zaman damgası |
Profille ilgili meta veriler (isteğe bağlı) | |||
Ad | Zorunlu | Profil adı veya kimliği ya da herkese açık kullanıcı adı (ör. "Can Demir", "@TeamPixel"). | Dize(önerilen maksimum 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, "@Ali-Demir", "5 milyon takipçi", "Beğenebileceğiniz içerikler", "Trendler", "5 yeni yayın" |
Dize(önerilen maksimum 40 karakter) |
Avatar | Zorunlu |
Kullanıcının profil resmi veya avatar resmi. Kare resim (1:1) |
Yardım için Resim Özellikleri bölümüne bakın. |
Ek resim | İsteğe bağlı |
Profil rozeti (ör. doğrulanmış rozet) Kare resim (1:1) |
Yardım için Resim Özellikleri bölümüne bakın. |
Etkileşimle ilgili meta veriler (İsteğe bağlı) | |||
Sayı | Zorunlu | Etkileşim sayısını belirtin (ör. "3, 7 milyon"). | Dize (sayı + etiket kombinasyonu için önerilen maksimum 20 karakter) |
Etiket |
İsteğe bağlı Bu ayar sağlanmazsa Görsel sağlanmalıdır. |
Etkileşimin neyle ilgili olduğunu belirtin. Örneğin: "Beğeniler". | Dize (sayı + etiket kombinasyonu için önerilen maksimum 20 karakter) |
Görsel |
İsteğe bağlı Bu değer sağlanmazsa Label sağlanmalıdır. |
Etkileşimin neyle ilgili olduğunu belirtin. Örneğin: Beğenme simgesini ve emojiyi gösteren resim. 1'den fazla resim sağlayabilirsiniz ancak bunların hepsi tüm form faktörlerinde gösterilmeyebilir. Kare resim (1:1) |
Yardım için Resim Özellikleri bölümüne bakın. |
DisplayTimeWindow (İsteğe bağlı) - Bir içeriğin yüzeyde gösterileceği bir zaman aralığı belirleme | |||
Başlangıç zaman damgası | İsteğe bağlı |
İçeriğin yüzeyde gösterilmesi gereken epoch zaman damgası. Ayarlanmazsa içerik yüzeyde gösterilmeye uygundur. |
Milisaniye cinsinden Unix sıfır zaman damgası |
Bitiş zaman damgası | İsteğe bağlı |
İçeriğin artık platformda gösterilmeyeceği zaman damgası. Ayarlanmazsa içerik yüzeyde gösterilmeye uygundur. |
Milisaniye cinsinden Unix sıfır zaman damgası |
Resim özellikleri
Google'ın 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 şekilde gösterilmesi için şeffaf arka plan kullanın.
2. adım: Küme verilerini sağlayın
İçerik yayınlama işinin arka planda (örneğin, WorkManager kullanılarak) yürütülmesi ve düzenli olarak veya etkinlik bazında (örneğin, kullanıcı uygulamayı her açtığında ya da yeni bir hesabı takip ettiğinde) planlanması önerilir.
AppEngageSocialClient
, sosyal kümeleri yayınlamaktan sorumludur.
İstemcide kümeleri yayınlamak için aşağıdaki API'ler vardır:
isServiceAvailable
publishRecommendationClusters
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteUserManagementCluster
deleteClusters
isServiceAvailable
Bu API, hizmetin entegrasyon için kullanılıp kullanılamayacağını ve içeriğin cihazda sunulup sunulamayacağını kontrol etmek için kullanılır.
Kotlin
client.isServiceAvailable.addOnCompleteListener { task -> if (task.isSuccessful) { // Handle IPC call success if(task.result) { // Service is available on the device, proceed with content // publish calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } }
Java
client.isServiceAvailable().addOnCompleteListener(task - > { if (task.isSuccessful()) { // Handle success if(task.getResult()) { // Service is available on the device, proceed with content // publish calls. } else { // Service is not available, no further action is needed. } } else { // The IPC call itself fails, proceed with error handling logic here, // such as retry. } });
publishRecommendationClusters
Bu API, bir RecommendationCluster
nesnesi listesi yayınlamak için kullanılır.
RecommendationCluster
nesneleri aşağıdaki özelliklere sahip olabilir:
Özellik | Şartlar | Açıklama |
---|---|---|
SocialPostEntity veya PortraitMediaEntity listesi | Zorunlu | Bu öneri kümesi için önerileri oluşturan öğelerin listesi. Tek bir kümedeki öğeler aynı türde olmalıdır. |
Başlık | Zorunlu | Öneri kümesinin başlığı (örneğin, Arkadaşlarınızın son paylaşımları). Önerilen metin boyutu: 25 karakterden kısa (Çok uzun metinlerde üç nokta gösterilebilir) |
Alt başlık | İsteğe bağlı | Öneri kümesinin alt başlığı. |
İşlem Uri | İ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'ye bakı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 bir işlemde aşağıdaki işlemler gerçekleşir:
- Mevcut tüm öneri kümesi verileri kaldırılır.
- İstekten gelen 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 sunabilmesi) 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 | Zorunlu | İşleme derin bağlantı (ör. uygulamada oturum açma sayfasına yönlendirme) |
Resim | İsteğe bağlı: Sağlanmazsa Başlık sağlanmalıdır |
Kartta gösterilen resim 1264x712 çözünürlüğe sahip 16x9 en boy oranına sahip resimler |
Başlık | İsteğe bağlı: Sağlanmazsa resim sağlanmalıdır | Karttaki başlık |
İşlem metni | İsteğe bağlı | CTA'da Gösterilen Metin (ör. Oturum aç) |
Alt başlık | İsteğe bağlı | Kartta isteğe bağlı altyazı |
Kotlin
var SIGN_IN_CARD_ENTITY = SignInCardEntity.Builder() .addPosterImage( Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build() client.publishUserAccountManagementRequest( PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY = new SignInCardEntity.Builder() .addPosterImage( new Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(500) .setImageWidthInPixel(500) .build()) .setActionText("Sign In") .setActionUri(Uri.parse("http://xx.com/signin")) .build(); client.publishUserAccountManagementRequest( new PublishUserAccountManagementRequest.Builder() .setSignInCardEntity(SIGN_IN_CARD_ENTITY) .build());
Hizmet isteği aldığında tek bir işlemde aşağıdaki işlemler gerçekleşir:
- Geliştirici iş ortağının mevcut
UserAccountManagementCluster
verileri kaldırılır. - İstekten gelen veriler ayrıştırılır ve güncellenen UserAccountManagementCluster kümesinde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
updatePublishStatus
Dahili bir işletme nedeniyle kümelerin hiçbiri yayınlanmıyorsa updatePublishStatus API'sini kullanarak yayınlama durumunu güncellemenizi önemle tavsiye ederiz. Bu önemlidir, çünkü :
- İçerik yayınlandığında bile (STATUS == PUBLISHED) tüm senaryolarda durumu sağlamak, entegrasyonunuzun durumunu ve diğer metriklerini iletmek için bu açık durumu kullanan kontrol panellerini doldurmak açısından çok önemlidir.
- Hiçbir içerik yayınlanmamışsa ancak entegrasyon durumu bozulmamışsa (STATUS == NOT_PUBLISHED) Google, uygulama sağlığı kontrol panellerinde uyarı tetiklemekten kaçınabilir. Sağlayıcı açısından beklenen bir durum nedeniyle içeriğin yayınlanmadığını onaylar.
- Geliştiricilerin verilerin ne zaman yayınlandığı ve ne zaman yayınlanmadığı hakkında analizler sunmasına yardımcı olur.
- Google, kullanıcının uygulama içeriğini görmesini veya bu engeli aşmasını sağlamak için uygulamada belirli işlemleri yapmasına teşvik etmek amacıyla durum kodlarını kullanabilir.
Uygun yayınlama durumu 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, kullanıcının giriş yapmaması nedeniyle yayınlanmıyorsa Google, oturum açma kartını yayınlamanızı önerir. Sağlayıcılar herhangi bir nedenle oturum açma kartını yayınlayamıyorsa NOT_PUBLISHED_REQUIRES_SIGN_IN durum koduyla updatePublishStatus API'sini çağırmanızı öneririz.
Kotlin
client.updatePublishStatus( PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build())
Java
client.updatePublishStatus( new PublishStatusRequest.Builder() .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN) .build());
deleteRecommendationClusters
Bu API, öneri kümelerinin içeriğini silmek için kullanılır.
Kotlin
client.deleteRecommendationClusters()
Java
client.deleteRecommendationClusters();
Hizmet, isteği aldığında mevcut verileri öneri kümelerinden kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteUserManagementCluster
Bu API, UserAccountManagement kümesinin içeriğini silmek için kullanılır.
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
Hizmet, isteği aldığında mevcut verileri UserAccountManagement kümesinden kaldırır. Hata durumunda istek tamamen 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_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ümelerdeki mevcut verileri kaldırır. İstemciler bir veya daha fazla küme türünü iletmeyi seçebilir. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
Hata işleme
Yayınlama API'lerinden 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 yapabilirsiniz.
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, hata kodu olarak nedeni dahil edilerek AppEngageException
olarak döndürülür.
Hata kodu | Hata adı | Not |
---|---|---|
1 |
SERVICE_NOT_FOUND |
Hizmet, belirtilen cihazda kullanılamıyor. |
2 |
SERVICE_NOT_AVAILABLE |
Hizmet, belirli bir cihazda kullanılabilir ancak arama sırasında kullanılamaz (örneğin, açıkça devre dışı bırakılmıştır). |
3 |
SERVICE_CALL_EXECUTION_FAILURE |
Görev yürütme, mesaj dizileriyle ilgili sorunlar nedeniyle başarısız oldu. Bu durumda, işlem yeniden denenebilir. |
4 |
SERVICE_CALL_PERMISSION_DENIED |
Arayan kullanıcının servis araması yapmasına izin verilmiyor. |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
İstek geçersiz veriler içeriyor (örneğin, izin verilenden daha fazla sayıda küme). |
6 |
SERVICE_CALL_INTERNAL |
Hizmet tarafında bir hata var. |
7 |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Servis çağrısı çok sık yapılıyor. |
3. Adım: Yayın intent'lerini işleme
Bir iş aracılığıyla içerik yayınlama API çağrıları yapmanın yanı sıra, içerik yayınlama isteğini almak için bir BroadcastReceiver
oluşturmanız da gerekir.
Yayın niyetinin amacı, temel olarak uygulamayı yeniden etkinleştirmek ve veri senkronizasyonunu zorlamaktır. Yayın niyetleri çok sık gönderilecek şekilde tasarlanmamıştır. Yalnızca Engage Hizmeti içeriğin güncel olmayabileceğini (ör. 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 deneyimi yaşayabileceğinden emin olabilirsiniz.
BroadcastReceiver
aşağıdaki iki şekilde ayarlanmalıdır:
Context.registerReceiver()
sınıfının bir örneğiniContext.registerReceiver()
kullanarak dinamik olarak kaydedin.BroadcastReceiver
Bu sayede, bellekte hâlâ etkin olan uygulamalardan iletişim kurulabilir.
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));
}
AndroidManifest.xml
dosyanızda<receiver>
etiketiyle uygulamayı statik olarak beyan edin. Bu, uygulamanın çalışmadığında yayın intent'leri almasına ve 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 intent'ler gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATION
Bu amacı aldığınızdapublishRecommendationClusters
çağrısı başlatmanız önerilir.
Entegrasyon iş akışı
Entegrasyonunuz tamamlandıktan sonra doğrulamayla ilgili adım adım açıklamalı bir kılavuz için Engage geliştirici entegrasyon iş akışı başlıklı makaleyi inceleyin.
SSS
SSS için Engage SDK Sık Sorulan Sorular başlıklı makaleyi inceleyin.
İletişim
Entegrasyon işlemi sırasında sorularınız olursa engage-developers@google.com adresiyle iletişime geçebilirsiniz. Ekibimiz en kısa sürede yanıt verecektir.
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonra uygulayacağınız adımlar şunlardır:
- engage-developers@google.com adresine e-posta gönderin ve Google tarafından test edilmeye hazır entegre APK'nızı ekleyin.
- Google, entegrasyonun beklendiği gibi çalıştığından emin olmak için bir doğrulama ve şirket içi inceleme gerçekleştirir. Değişiklik yapılması gerekirse Google gerekli tüm bilgileri sizinle paylaşır.
- Test tamamlandığında ve herhangi bir değişiklik gerekmediğinde Google, güncellenmiş ve entegre APK'yı Play Store'da yayınlamaya başlayabileceğinizi bildirmek için sizinle iletişime geçer.
- Google, güncellenmiş APK'nızın Play Store'da yayınlandığını onayladıktan sonra Öneri kümeniz yayınlanır ve kullanıcılara gösterilir.