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 kılavuzda, geliştirici iş ortaklarının hem bu yeni yüzey alanını hem de mevcut Google yüzeylerini doldurmak için Engage SDK'sını kullanarak video içeriklerini entegre etmeleri için talimatlar bulunmaktadır.
Entegrasyon ayrıntısı
Terminoloji
Bu entegrasyon şu üç küme türünü içerir: Öneri, Devam ve Öne Çıkan.
Öneri kümeleri, belirli bir geliştirici iş ortağından izlenebilecek içerikler için kişiselleştirilmiş öneriler gösterir.
Önerileriniz aşağıdaki yapıyı alır:
Öneri Kümesi: Aynı geliştirici iş ortağından bir dizi öneri içeren kullanıcı arayüzü görünümü.
Varlık: Bir kümedeki tek bir öğeyi temsil eden bir nesne. Varlık bir film, TV dizisi, TV dizisi, canlı video ve daha fazlası olabilir. Desteklenen varlık türlerinin listesi için Varlık verileri sağlama bölümüne bakın.
Devam kümesi, tek bir kullanıcı arayüzü gruplandırmasında birden çok geliştirici iş ortağından tamamlanmamış videoları ve ilgili yeni yayınlanmış bölümleri gösterir. Her geliştirici iş ortağının Devamlılık kümesinde en fazla 10 varlık yayınlamasına izin verilir. Araştırmalar, kişiselleştirilmiş önerilerin kişiselleştirilmiş Devamlı içerik ile en iyi kullanıcı etkileşimini oluşturduğunu gösteriyor.
Öne Çıkan kümesi, tek bir kullanıcı arayüzü grubunda birden fazla geliştirici iş ortağından alınan varlıkları gösterir. Kullanıcı arayüzünün üst kısmına yakın bir yerde gösterilen tek bir Öne Çıkan küme bulunacaktır. Bu küme, tüm Öneri kümelerinin üzerinde bir öncelikli yerleşimle gösterilecektir. Her geliştirici iş ortağının Öne çıkanlar kümesinde en fazla 10 varlık yayınlamasına izin verilir.
Çalışma öncesi
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.4.0'
}
Daha fazla bilgi için Android 11'de paket görünürlüğü bölümüne bakın.
Ö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 maksimum varlık sınırları |
---|---|---|
Öneri Kümeleri | En fazla 5 | En fazla 50 |
Devam Kümesi | En fazla 1 | En fazla 10 |
Öne Çıkan Küme | En fazla 1 | En fazla 10 |
0. Adım: Mevcut Media Home SDK entegrasyonundan taşıma
Mevcut entegrasyondan veri modellerini eşleme
Mevcut bir Media Home entegrasyonundan geçiş yapıyorsanız aşağıdaki tabloda mevcut SDK'lardaki veri modellerinin yeni Engage SDK ile nasıl eşleneceği özetlenmiştir:
MediaHomeVideoContract entegrasyon eşdeğeri | Engage SDK entegrasyonu eşdeğeri |
---|---|
com.google.android.mediahome.video.PreviewChannel |
com.google.android.engage.common.datamodel.RecommendationCluster |
com.google.android.mediahome.video.PreviewChannel.Builder |
com.google.android.engage.common.datamodel.RecommendationCluster.Builder |
com.google.android.mediahome.video.PreviewChannelHelper |
com.google.android.engage.video.service.AppEngageVideoClient |
com.google.android.mediahome.video.PreviewProgram |
Ayrı sınıflara bölünmüş: EventVideo , LiveStreamingVideo , Movie , TvEpisode , TvSeason , TvShow , VideoClipEntity |
com.google.android.mediahome.video.PreviewProgram.Builder |
Ayrı sınıflarda derleyicilere ayrılmıştır: EventVideo , LiveStreamingVideo , Movie , TvEpisode , TvSeason , TvShow , VideoClipEntity |
com.google.android.mediahome.video.VideoContract |
Artık ihtiyacım kalmadı. |
com.google.android.mediahome.video.WatchNextProgram |
Ayrı sınıflardaki özelliklere bölünür: EventVideoEntity , LiveStreamingVideoEntity , MovieEntity , TvEpisodeEntity , TvSeasonEntity , TvShowEntity , VideoClipEntity |
com.google.android.mediahome.video.WatchNextProgram.Builder |
Ayrı sınıflardaki özelliklere bölünür: EventVideoEntity , LiveStreamingVideoEntity , MovieEntity , TvEpisodeEntity , TvSeasonEntity , TvShowEntity , VideoClipEntity |
Media Home SDK ve Engage SDK'sında küme yayınlama
Media Home SDK'sı ile kümeler ve varlıklar ayrı API'ler üzerinden yayınlanıyordu:
// 1. Fetch existing channels
List<PreviewChannel> channels = PreviewChannelHelper.getAllChannels();
// 2. If there are no channels, publish new channels
long channelId = PreviewChannelHelper.publishChannel(builder.build());
// 3. If there are existing channels, decide whether to update channel contents
PreviewChannelHelper.updatePreviewChannel(channelId, builder.build());
// 4. Delete all programs in the channel
PreviewChannelHelper.deleteAllPreviewProgramsByChannelId(channelId);
// 5. publish new programs in the channel
PreviewChannelHelper.publishPreviewProgram(builder.build());
Engage SDK'sı ile küme ve varlık yayınlama tek bir API çağrısında birleştirilir. Bir kümeye ait olan tüm varlıklar o kümeyle birlikte yayınlanır:
Kotlin
RecommendationCluster.Builder() .addEntity(MOVIE_ENTITY) .addEntity(MOVIE_ENTITY) .addEntity(MOVIE_ENTITY) .setTitle("Top Picks For You") .build()
Java
new RecommendationCluster.Builder() .addEntity(MOVIE_ENTITY) .addEntity(MOVIE_ENTITY) .addEntity(MOVIE_ENTITY) .setTitle("Top Picks For You") .build();
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. İzleme kategorisi için aşağıdaki varlıkları destekliyoruz:
Aşağıdaki tabloda, her bir türün özellikleri ve gereksinimleri özetlenmiştir.
MovieEntity
Özellik | Şartlar | Notlar |
---|---|---|
Ad | Zorunlu | |
Poster resimleri | Zorunlu | En az bir resim gereklidir ve bir en boy oranı sağlanmalıdır. (Yatay resim tercih edilir ancak farklı senaryolar için hem dikey hem de yatay resimlerin iletilmesi önerilir.)
Yardım için Resim Özellikleri bölümüne bakın. |
Oynatma URI'si | Zorunlu |
Filmi oynatmaya başlamak için sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Bilgi sayfası URI'sı | İsteğe bağlı |
Filmle ilgili ayrıntıları gösteren sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Yayın tarihi | Zorunlu | Dönem milisaniye cinsinden. |
Kullanılabilirlik | Zorunlu | AVAILABLE: İçerik, başka bir işlem yapmanıza gerek kalmadan kullanıcı tarafından kullanılabilir. FREE_WITH_SUBSCRIPTION: İçerik, kullanıcı bir abonelik satın aldıktan sonra kullanılabilir. PAID_CONTENT: İçerik için kullanıcının satın alması veya kiralaması gerekir. SATIN ALINDI: İçerik kullanıcı tarafından satın alındı veya kiralandı. |
Teklif fiyatı | İsteğe bağlı | Serbest metin |
Süre | Zorunlu | Milisaniye cinsinden. |
Tür | Zorunlu | Serbest metin |
İçerik derecelendirmeleri | Zorunlu | Serbest metin, lütfen endüstri standardına uyun. (Örnek) |
Sonraki türü izle | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalı ve aşağıdaki dört türden biri olmalıdır: DEVAM: Kullanıcı bu içeriğin 1 dakikadan uzun bir bölümünü zaten izledi. YENİ: Kullanıcı, bazı bölümlerden mevcut tüm bölümleri izledi, ancak yeni bir bölüm yayınlandı ve tam olarak bir tane izlenmemiş bölüm var. Bu özellik TV programları, bir dizideki kayıtlı futbol maçları ve benzerleri için kullanılabilir. SONRAKİ: Kullanıcı bazı bölümlerden bir veya daha fazla tam bölüm izlemiştir, ancak birden fazla bölüm kalmış veya son bölümün "YENİ" olmadığı ve kullanıcı bölümlü içeriği izlemeye başlamadan önce yayınlanmış tam bir bölüm kalmıştır. İZLEME LİSTESİ: Kullanıcı, izlemek istediği bir sonraki videoyu manuel olarak seçmek için izleme listesine film, etkinlik veya dizi eklemeyi açıkça seçmiştir. |
Son etkileşim zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalıdır. Dönem milisaniye cinsinden. |
Son oynatma konumu zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken ve WatchNextType değeri CONTINUE olduğunda sağlanmalıdır. Dönem milisaniye cinsinden. |
TvShowEntity
Özellik | Şartlar | Notlar |
---|---|---|
Ad | Zorunlu | |
Poster resimleri | Zorunlu | En az bir resim gereklidir ve bir en boy oranı sağlanmalıdır. (Yatay resim tercih edilir ancak farklı senaryolar için hem dikey hem de yatay resimlerin iletilmesi önerilir.)
Yardım için Resim Özellikleri bölümüne bakın. |
Bilgi sayfası URI'sı | Zorunlu |
TV programının ayrıntılarını gösteren, sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Oynatma URI'si | İsteğe bağlı |
TV programını oynatmaya başlamak için sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
İlk bölüm yayın tarihi | Zorunlu | Dönem milisaniye cinsinden. |
Son bölümün yayınlanma tarihi | İsteğe bağlı | Dönem milisaniye cinsinden. |
Kullanılabilirlik | Zorunlu | AVAILABLE: İçerik, başka bir işlem yapmanıza gerek kalmadan kullanıcı tarafından kullanılabilir. FREE_WITH_SUBSCRIPTION: İçerik, kullanıcı bir abonelik satın aldıktan sonra kullanılabilir. PAID_CONTENT: İçerik için kullanıcının satın alması veya kiralaması gerekir. SATIN ALINDI: İçerik kullanıcı tarafından satın alındı veya kiralandı. |
Teklif fiyatı | İsteğe bağlı | Serbest metin |
Sezon sayısı | Zorunlu | Pozitif tam sayı |
Tür | Zorunlu | Serbest metin |
İçerik derecelendirmeleri | Zorunlu | Serbest metin, lütfen endüstri standardına uyun. (Örnek) |
Sonraki türü izle | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalı ve aşağıdaki dört türden biri olmalıdır: DEVAM: Kullanıcı bu içeriğin 1 dakikadan uzun bir bölümünü zaten izledi. YENİ: Kullanıcı, bazı bölümlerden mevcut tüm bölümleri izledi, ancak yeni bir bölüm yayınlandı ve tam olarak bir tane izlenmemiş bölüm var. Bu özellik TV programları, bir dizideki kayıtlı futbol maçları ve benzerleri için kullanılabilir. SONRAKİ: Kullanıcı bazı bölümlerden bir veya daha fazla tam bölüm izlemiştir, ancak birden fazla bölüm kalmış veya son bölümün "YENİ" olmadığı ve kullanıcı bölümlü içeriği izlemeye başlamadan önce yayınlanmış tam bir bölüm kalmıştır. İZLEME LİSTESİ: Kullanıcı, izlemek istediği bir sonraki videoyu manuel olarak seçmek için izleme listesine film, etkinlik veya dizi eklemeyi açıkça seçmiştir. |
Son etkileşim zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalıdır. Dönem milisaniye cinsinden. |
Son oynatma konumu zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken ve WatchNextType değeri CONTINUE olduğunda sağlanmalıdır. Dönem milisaniye cinsinden. |
TvSeasonEntity
Özellik | Şartlar | Notlar |
---|---|---|
Ad | Zorunlu | |
Poster resimleri | Zorunlu | En az bir resim gereklidir ve bir en boy oranı sağlanmalıdır. (Yatay resim tercih edilir ancak farklı senaryolar için hem dikey hem de yatay resimlerin iletilmesi önerilir.)
Yardım için Resim Özellikleri bölümüne bakın. |
Bilgi sayfası URI'sı | Zorunlu |
TV programı sezonunun ayrıntılarını gösteren sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Oynatma URI'si | İsteğe bağlı |
TV programı sezonunu oynatmaya başlamak için provider uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Sezon numarasını görüntüle |
İsteğe bağlı v1.3.1 sürümünde kullanılabilir |
Dize |
İlk bölüm yayın tarihi | Zorunlu | Dönem milisaniye cinsinden. |
Son bölümün yayınlanma tarihi | İsteğe bağlı | Dönem milisaniye cinsinden. |
Kullanılabilirlik | Zorunlu | AVAILABLE: İçerik, başka bir işlem yapmanıza gerek kalmadan kullanıcı tarafından kullanılabilir. FREE_WITH_SUBSCRIPTION: İçerik, kullanıcı bir abonelik satın aldıktan sonra kullanılabilir. PAID_CONTENT: İçerik için kullanıcının satın alması veya kiralaması gerekir. SATIN ALINDI: İçerik kullanıcı tarafından satın alındı veya kiralandı. |
Teklif fiyatı | İsteğe bağlı | Serbest metin |
Bölüm sayısı | Zorunlu | Pozitif tam sayı |
Tür | Zorunlu | Serbest metin |
İçerik derecelendirmeleri | Zorunlu | Serbest metin, lütfen endüstri standardına uyun. (Örnek) |
Sonraki türü izle | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalı ve aşağıdaki dört türden biri olmalıdır: DEVAM: Kullanıcı bu içeriğin 1 dakikadan uzun bir bölümünü zaten izledi. YENİ: Kullanıcı, bazı bölümlerden mevcut tüm bölümleri izledi, ancak yeni bir bölüm yayınlandı ve tam olarak bir tane izlenmemiş bölüm var. Bu özellik TV programları, bir dizideki kayıtlı futbol maçları ve benzerleri için kullanılabilir. SONRAKİ: Kullanıcı bazı bölümlerden bir veya daha fazla tam bölüm izlemiştir, ancak birden fazla bölüm kalmış veya son bölümün "YENİ" olmadığı ve kullanıcı bölümlü içeriği izlemeye başlamadan önce yayınlanmış tam bir bölüm kalmıştır. İZLEME LİSTESİ: Kullanıcı, izlemek istediği bir sonraki videoyu manuel olarak seçmek için izleme listesine film, etkinlik veya dizi eklemeyi açıkça seçmiştir. |
Son etkileşim zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalıdır. Dönem milisaniye cinsinden. |
Son oynatma konumu zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken ve WatchNextType değeri CONTINUE olduğunda sağlanmalıdır. Dönem milisaniye cinsinden. |
TvEpisodeEntity
Özellik | Şartlar | Notlar |
---|---|---|
Ad | Zorunlu | |
Poster resimleri | Zorunlu | En az bir resim gereklidir ve bir en boy oranı sağlanmalıdır. (Yatay resim tercih edilir ancak farklı senaryolar için hem dikey hem de yatay resimlerin iletilmesi önerilir.)
Yardım için Resim Özellikleri bölümüne bakın. |
Oynatma URI'si | Zorunlu |
Bölümü oynatmaya başlamak için sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Bilgi sayfası URI'sı | İsteğe bağlı |
TV programı bölümü ile ilgili ayrıntıları göstermek için sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Bölüm numarasını göster |
İsteğe bağlı v1.3.1 sürümünde kullanılabilir |
Dize |
Yayınlanma tarihi | Zorunlu | Dönem milisaniye cinsinden. |
Kullanılabilirlik | Zorunlu | AVAILABLE: İçerik, başka bir işlem yapmanıza gerek kalmadan kullanıcı tarafından kullanılabilir. FREE_WITH_SUBSCRIPTION: İçerik, kullanıcı bir abonelik satın aldıktan sonra kullanılabilir. PAID_CONTENT: İçerik için kullanıcının satın alması veya kiralaması gerekir. SATIN ALINDI: İçerik kullanıcı tarafından satın alındı veya kiralandı. |
Teklif fiyatı | İsteğe bağlı | Serbest metin |
Süre | Zorunlu | Milisaniye cinsinden pozitif bir değer olmalıdır. |
Tür | Zorunlu | Serbest metin |
İçerik derecelendirmeleri | Zorunlu | Serbest metin, lütfen endüstri standardına uyun. (Örnek) |
Sonraki türü izle | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalı ve aşağıdaki dört türden biri olmalıdır: DEVAM: Kullanıcı bu içeriğin 1 dakikadan uzun bir bölümünü zaten izledi. YENİ: Kullanıcı, bazı bölümlerden mevcut tüm bölümleri izledi, ancak yeni bir bölüm yayınlandı ve tam olarak bir tane izlenmemiş bölüm var. Bu özellik TV programları, bir dizideki kayıtlı futbol maçları ve benzerleri için kullanılabilir. SONRAKİ: Kullanıcı bazı bölümlerden bir veya daha fazla tam bölüm izlemiştir, ancak birden fazla bölüm kalmış veya son bölümün "YENİ" olmadığı ve kullanıcı bölümlü içeriği izlemeye başlamadan önce yayınlanmış tam bir bölüm kalmıştır. İZLEME LİSTESİ: Kullanıcı, izlemek istediği bir sonraki videoyu manuel olarak seçmek için izleme listesine film, etkinlik veya dizi eklemeyi açıkça seçmiştir. |
Son etkileşim zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalıdır. Dönem milisaniye cinsinden. |
Son oynatma konumu zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken ve WatchNextType değeri CONTINUE olduğunda sağlanmalıdır. Dönem milisaniye cinsinden. |
LiveStreamingVideoEntity
Özellik | Şartlar | Notlar |
---|---|---|
Ad | Zorunlu | |
Poster resimleri | Zorunlu | En az bir resim gereklidir ve bir en boy oranı sağlanmalıdır. (Yatay resim tercih edilir ancak farklı senaryolar için hem dikey hem de yatay resimlerin iletilmesi önerilir.)
Yardım için Resim Özellikleri bölümüne bakın. |
Oynatma URI'si | Zorunlu |
Videoyu oynatmaya başlamak için sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Yayıncı | Zorunlu | Serbest metin |
Başlangıç zamanı | İsteğe bağlı | Dönem milisaniye cinsinden. |
Bitiş zamanı | İsteğe bağlı | Dönem milisaniye cinsinden. |
İzlenme sayısı | İsteğe bağlı | Serbest metin, yerelleştirilmelidir. |
Sonraki türü izle | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalı ve aşağıdaki dört türden biri olmalıdır: DEVAM: Kullanıcı bu içeriğin 1 dakikadan uzun bir bölümünü zaten izledi. YENİ: Kullanıcı, bazı bölümlerden mevcut tüm bölümleri izledi, ancak yeni bir bölüm yayınlandı ve tam olarak bir tane izlenmemiş bölüm var. Bu özellik TV programları, bir dizideki kayıtlı futbol maçları ve benzerleri için kullanılabilir. SONRAKİ: Kullanıcı bazı bölümlerden bir veya daha fazla tam bölüm izlemiştir, ancak birden fazla bölüm kalmış veya son bölümün "YENİ" olmadığı ve kullanıcı bölümlü içeriği izlemeye başlamadan önce yayınlanmış tam bir bölüm kalmıştır. İZLEME LİSTESİ: Kullanıcı, izlemek istediği bir sonraki videoyu manuel olarak seçmek için izleme listesine film, etkinlik veya dizi eklemeyi açıkça seçmiştir. |
Son etkileşim zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalıdır. Dönem milisaniye cinsinden. |
Son oynatma konumu zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken ve WatchNextType değeri CONTINUE olduğunda sağlanmalıdır. Dönem milisaniye cinsinden. |
VideoClipEntity
VideoClipEntity
nesnesi, TikTok veya YouTube gibi sosyal medyadan gelen bir video varlığını temsil eder.
Özellik | Şartlar | Notlar |
---|---|---|
Ad | Zorunlu | |
Poster resimleri | Zorunlu | En az bir resim gereklidir ve bir en boy oranı sağlanmalıdır. (Yatay resim tercih edilir ancak farklı senaryolar için hem dikey hem de yatay resimlerin iletilmesi önerilir.)
Yardım için Resim Özellikleri bölümüne bakın. |
Oynatma URI'si | Zorunlu |
Videoyu oynatmaya başlamak için sağlayıcı uygulamasının derin bağlantısı. Not: İlişkilendirme için derin bağlantıları kullanabilirsiniz. Bu SSS bölümünü inceleyin |
Oluşturma zamanı | Zorunlu | Dönem milisaniye cinsinden. |
Süre | Zorunlu | Milisaniye cinsinden pozitif bir değer olmalıdır. |
Kurucu | Zorunlu | Serbest metin |
Oluşturan görseli | İsteğe bağlı | İçerik üretici avatarının resmi |
İzlenme sayısı | İsteğe bağlı | Serbest metin, yerelleştirilmelidir. |
Sonraki türü izle | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalı ve aşağıdaki dört türden biri olmalıdır: DEVAM: Kullanıcı bu içeriğin 1 dakikadan uzun bir bölümünü zaten izledi. YENİ: Kullanıcı, bazı bölümlerden mevcut tüm bölümleri izledi, ancak yeni bir bölüm yayınlandı ve tam olarak bir tane izlenmemiş bölüm var. Bu özellik TV programları, bir dizideki kayıtlı futbol maçları ve benzerleri için kullanılabilir. SONRAKİ: Kullanıcı bazı bölümlerden bir veya daha fazla tam bölüm izlemiştir, ancak birden fazla bölüm kalmış veya son bölümün "YENİ" olmadığı ve kullanıcı bölümlü içeriği izlemeye başlamadan önce yayınlanmış tam bir bölüm kalmıştır. İZLEME LİSTESİ: Kullanıcı, izlemek istediği bir sonraki videoyu manuel olarak seçmek için izleme listesine film, etkinlik veya dizi eklemeyi açıkça seçmiştir. |
Son etkileşim zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken sağlanmalıdır. Dönem milisaniye cinsinden. |
Son oynatma konumu zamanı | Koşula bağlı olarak gerekli | Öğe, Devam kümesindeyken ve WatchNextType değeri CONTINUE olduğunda sağlanmalıdır. Dönem milisaniye cinsinden. |
Resim özellikleri
Aşağıdaki bölümde resim öğeleri için gerekli özellikler listelenmiştir:
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.
Örnek
Kotlin
var movie = MovieEntity.Builder() .setName("Avengers") .addPosterImage(Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(960) .setImageWidthInPixel(408) .build()) .setPlayBackUri(Uri.parse("http://tv.com/playback/1")) .setReleaseDateEpochMillis(1633032895L) .setAvailability(ContentAvailability.AVAILABILITY_AVAILABLE) .setDurationMillis(12345678L) .addGenre("action") .addContentRating("R") .setWatchNextType(WatchNextType.TYPE_NEW) .setLastEngagementTimeMillis(1664568895L) .build()
Java
MovieEntity movie = new MovieEntity.Builder() .setName("Avengers") .addPosterImage( new Image.Builder() .setImageUri(Uri.parse("http://www.x.com/image.png")) .setImageHeightInPixel(960) .setImageWidthInPixel(408) .build()) .setPlayBackUri(Uri.parse("http://tv.com/playback/1")) .setReleaseDateEpochMillis(1633032895L) .setAvailability(ContentAvailability.AVAILABILITY_AVAILABLE) .setDurationMillis(12345678L) .addGenre("action") .addContentRating("R") .setWatchNextType(WatchNextType.TYPE_NEW) .setLastEngagementTimeMillis(1664568895L) .build();
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ı sepetine yeni bir ürün eklediğinde).
AppEngagePublishClient
, kümeleri yayınlamaktan sorumludur. İstemcide aşağıdaki API'ler kullanılabilir:
isServiceAvailable
publishRecommendationClusters
publishFeaturedCluster
publishContinuationCluster
publishUserAccountManagementRequest
updatePublishStatus
deleteRecommendationsClusters
deleteFeaturedCluster
deleteContinuationCluster
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. } });
publishRecommendationClusters
Bu API, RecommendationCluster
nesnelerinin listesini yayınlamak için kullanılır.
Kotlin
client.publishRecommendationClusters( PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build() ) .build() )
Java
client.publishRecommendationClusters( new PublishRecommendationClustersRequest.Builder() .addRecommendationCluster( new RecommendationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .setTitle("Top Picks For You") .build()) .build());
Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
RecommendationCluster
verileri kaldırılır. - İstekteki veriler ayrıştırılır ve güncellenmiş Öneri Kümesinde depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishFeaturedCluster
Bu API, FeaturedCluster
nesnelerinin listesini yayınlamak için kullanılır.
Kotlin
client.publishFeaturedCluster( PublishFeaturedClusterRequest.Builder() .setFeaturedCluster( FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishFeaturedCluster( new PublishFeaturedClustersRequest.Builder() .addFeaturedCluster( new FeaturedCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
FeaturedCluster
verileri kaldırılır. - İstekten elde edilen veriler ayrıştırılır ve güncellenmiş Öne Çıkan Küme'de depolanır.
Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
publishContinuationCluster
Bu API bir ContinuationCluster
nesnesini yayınlamak için kullanılır.
Kotlin
client.publishContinuationCluster( PublishContinuationClusterRequest.Builder() .setContinuationCluster( ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build())
Java
client.publishContinuationCluster( new PublishContinuationClusterRequest.Builder() .setContinuationCluster( new ContinuationCluster.Builder() .addEntity(entity1) .addEntity(entity2) .build()) .build());
Hizmet, isteği aldığında tek işlem içinde aşağıdaki işlemler gerçekleştirilir:
- Geliştirici iş ortağından alınan mevcut
ContinuationCluster
verileri kaldırılır. - İstekten elde edilen veriler ayrıştırılır ve güncellenen Devam Kümesi'nde 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ı |
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.
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.
deleteFeaturedCluster
Bu API, Öne Çıkan Kümenin içeriğini silmek için kullanılır.
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Hizmet, isteği aldığında mevcut verileri Öne Çıkan Küme'den kaldırır. Hata olması durumunda isteğin tamamı reddedilir ve mevcut durum korunur.
deleteContinuationCluster
Bu API, Devam Kümesi 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'nden 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.
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.
Kotlin
client.deleteClusters( DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .build())
Java
client.deleteClusters( new DeleteClustersRequest.Builder() .addClusterType(ClusterType.TYPE_CONTINUATION) .addClusterType(ClusterType.TYPE_FEATURED) .addClusterType(ClusterType.TYPE_RECOMMENDATION) .build());
Hizmet isteği aldığında, 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.
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, 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()
kullanarakBroadcastReceiver
sınıfının bir örneğini dinamik olarak kaydedin. Bu, hâlâ bellekte bulunan uygulamalardan iletişim kurulmasını sağlar.
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)); }
- 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>
<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 amaçlar hizmet tarafından gönderilir:
com.google.android.engage.action.PUBLISH_RECOMMENDATION
Bu amacı alırken birpublishRecommendationClusters
çağrısı başlatmanız önerilir.com.google.android.engage.action.PUBLISH_FEATURED
Bu niyeti alırken birpublishFeaturedCluster
araması başlatmanız önerilir.com.google.android.engage.action.PUBLISH_CONTINUATION
Bu amacı alırken birpublishContinuationCluster
ç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 engagement-developers@google.com ile iletişime geçin.
Sonraki adımlar
Bu entegrasyonu tamamladıktan sonra uygulamanız gereken adımlar şunlardır:
- engagement-developers@google.com 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 Öneri, Öne Çıkan ve Devam kümeleriniz yayınlanabilir ve kullanıcılar tarafından görülebilir.