Topics API: Entegrasyon kılavuzu

Android için Topics API, uygulamalar arası tanımlayıcılara bağlı kalmadan ilgi alanına dayalı reklamcılığı destekleyecek şekilde tasarlanmıştır.

Reklamverenler, kullanıcıların ilgi alanlarıyla alakalı reklamlar sunmayı amaçlar. Örneğin, bir kullanıcı yemek pişirmeyle ilgili bilgilerle ilgileniyorsa, ilgi alanlarıyla alakalı olmayan reklamlardansa yemek pişirmeyle ilgili reklamların kendisi için daha alakalı olduğunu bulabilir.

İlgi alanına dayalı reklamcılık (IBA), reklamların kullanıcının ilgi alanlarına göre seçildiği bir kişiselleştirilmiş reklamcılık biçimidir. Android'deki Özel Korumalı Alan sayesinde bu ilgi alanları, kullanıcının etkileşimde bulunduğu uygulamalardan türetilir. Bu, yalnızca görüntülenen mevcut içerikten elde edilen ilgi alanlarına dayanan içeriğe dayalı reklamcılıktan farklıdır. IBA, uygulamaların içeriğe dayalı reklamlardan daha alakalı ve ilgi çekici reklamlar göstermesini sağlar.

İlgi alanına dayalı reklamcılık genellikle uygulamalar, satıcılar ve alıcılar arasındaki iletişimi içerir. Bu kılavuz, hem alıcı hem de satıcı olarak çalışan ağlar ve reklam teknolojileri dahil olmak üzere bu tarafların tamamına yöneliktir.

Topics API, bir kullanıcının uygulama kullanımına dayanarak cihaz üzerindeki genel ilgi sinyallerine dair çıkarımda bulunur. Konular adı verilen bu sinyaller, uygulamalarda bireysel kullanıcıları izlemeye gerek kalmadan IBA'yı desteklemek amacıyla reklamverenlerle paylaşılır.

Topics API ile ilgi alanına dayalı reklamcılığı uygularken dikkat edilmesi gereken önemli hususlar vardır:

  • Kullanıcının ilgi alanı çıkarımı cihazda işlenir: Kullanıcının, cihazında tam olarak hangi uygulamaların yüklü olduğuna dair bilgileri cihazdan dışarı çıkmaz ve gizlilik korunur. Bu model, şu anda yaygın olarak kullanılan, kullanıcının uygulamalar arası verilerinin cihaz dışında, reklam teknolojisi sunucularında gönderilmesi ve işlenmesini sağlayan modelden farklıdır. Reklam seçimi için kişiselleştirme ve optimizasyon modellerinde Topics API tarafından sağlanan sinyallerin kullanılması gibi belirli işleme türleri, reklam teknolojisi sunucularında kalmaya devam eder.

  • Alıcılar ve reklamverenler satış tarafına bağımlıdır: Konu almak için satış tarafı uygulamaların ve SDK'ların, en az 1 dönemde Topics API'nin gözlemcisi olarak ayak izi oluşturması gerekir.

Terminoloji

  • Reklamveren: Reklam envanteri satın alma yoluyla kullanıcılarla etkileşime giren bir şirket
  • Yayıncı: İçerikleriyle birlikte kullanılabilen reklam envanteri satan bir şirket.
  • Alıcı (veya alıcı tarafı): Reklamverenlerin reklam envanteri satın almasını kolaylaştıran bir reklam teknolojisi şirketi
  • Satıcı (veya satış tarafı): Yayıncıların reklam envanteri satmasına yardımcı olan bir reklam teknolojisi şirketi
  • : Hem alıcı hem de satıcı olarak görev yapan bir reklam teknolojisi şirketi
  • Sahipli ve yönetilen: Yayıncı, satıcı ve alıcı rolünü üstlenen şirket

Goller

IBA işletmeniz için önemliyse uygulamanızın iş gerekçeleri bağlamında çalışan Topics API'nin bir sürümüne sahip olmanızı isteriz. Böylece geri bildirimlerinizi alabilir ve API'yi şekillendirmenize olanak tanıyabiliriz. Beta sürümü kullanıma sunulduğunda konu alabilmeniz için tasarımların ve geliştirmenin engelini kaldırabildiğinizden emin olmak istiyoruz.

Şu anda, Android Geliştirici Önizlemesi'nde Özel Korumalı Alan için entegrasyon planlamasının hedefleri aşağıdakileri yapabilmenizi içermektedir:

Tüm reklam teknolojileri için

  • Konular sınıflandırmasını inceleyin ve dahil edilen konularla ilgili geri bildirim verin.
  • Cihaz üzerinde sınıflandırıcıdan hangi konu verilerinin döndürüldüğünü görmek için Topics API örnek uygulamalarıyla denemeler yapın.
  • Topics API'yi çağırmaya başlamak için uygulama ve SDK akışlarını güncelleyin.
  • Reklam isteklerinde konu göndermeye başlamak için protokolleri güncelleyin.
  • Özel Korumalı Alan'a reklam teknolojinizi kaydettirin.

Satış tarafı reklam teknolojileri için

  • Topics API ayak izi oluşturmak için gözlemci olun. Topics API yeni bir sinyaldir. Bu nedenle, Topics API'yi çağırmaya başlamak için SDK'nızı güncellemeniz gerekir. Konuları tutarlı bir şekilde almak için uygulamaların her dönem başına API'yi en az bir kez çağırması gerekir. Reklam isteklerinizle birlikte gönderilecek maksimum sayıda konu (3 konu) elde etmek için en fazla 4 dönem gerekir.
  • Reklam isteklerinize Topics API bilgilerini ekleyin. Her reklam isteği için Topics API verilerinizi alıcı tarafı iş ortaklarıyla paylaşmaya başlayın. Topics API, belirli bir ziyaretçi için uygun bir reklam bulmaya yardımcı olmak için diğer sinyalleri (içeriğe dayalı sinyaller gibi) desteklemeyi planlamaktadır.
  • Alıcı tarafı iş ortaklarınızla konuları paylaşmaya yönelik bir protokol üzerinde ortak çalışın. Topics API, Topics API verilerinin nasıl paylaşılacağı konusunda anlaşmak için her SDK'nın aşağı akış iş ortaklarıyla çalışmasını gerektirir.

Alıcı tarafı reklam teknolojileri için

  • Konuları gözlemleme ve ayak izi oluşturma planlarını doğrulamak için satış tarafı iş ortaklarıyla bağlantı kurun. Konuları almak için satış tarafı sağlayıcıların, Topics API'yi dönem başına en az bir kez çağırması gerekir.
  • Satış tarafı iş ortaklarınızdan konu almak için bir protokol üzerinde ortak çalışın. Konular, reklam isteğinin bir parçası olarak satış tarafı iş ortakları tarafından paylaşılacak yeni bir sinyaldir. Alıcı tarafı tüketiciler, konuların nasıl paylaşılacağı konusunda yukarı akış iş ortaklarıyla çalıştıklarından emin olmalıdır.
  • Konuları teklif verme ve optimizasyon modellerine ekleme. Topics API'nin, ziyaretçi için uygun bir reklam bulmaya yardımcı olmak için bağlamsal gibi diğer sinyalleri desteklemesi beklenmektedir.

Ön koşullar ve kurulum

Uygulama geliştiriciler, satıcılar ve alıcılar Topics API'yi kullanmak için aşağıdaki adımları uygulamalıdır.

API hakkında bilgi edinmek

  1. Topics API ve özellikleri hakkında bilgi edinmek için tasarım teklifini okuyarak başlayın.
  2. İhtiyacınız olan kodu ve API çağrılarını kullanım alanlarınıza nasıl dahil edeceğinizi öğrenmek için geliştirici kılavuzunu okuyun.
  3. Sınıflandırmayı inceleyin ve listede hangi konuların yer aldığı hakkında geri bildirim sağlayın.
  4. Tasarım teklifi veya belgeler için geri bildirim gönderin.
  5. Topics API hakkında güncellemeler almak için kaydolun. Bu, gelecekteki sürümlerde kullanıma sunulacak yeni özelliklerden haberdar olmanıza yardımcı olur.

Örnek uygulamayı kurup test edin

  1. Android Studio'da Android SDK'sında Özel Korumalı Alan'ı kurmak için bu sayfadaki talimatları uygulayın.
  2. Cihazdaki konuları nasıl alabileceğinizi öğrenmek için örnek uygulamanın Java veya Kotlin sürümündeki kodu çatallayıp çalıştırın.
  3. Test sırasında, cihaz üzerindeki sınıflandırıcıdan hangi konuların döndürüleceğini değiştirmek için ad ve açıklamayla ilgili uygulama bilgileriyle denemeler yapın.
  4. Client API ve cihaz üzerinde sınıflandırmaların işleyiş şeklini anladıktan sonra, kendi entegrasyonunuza yön vermek için örnek olarak örnek uygulamayı kullanın.

İpucu: Uygulamanız için döndürülen konu verilerinin ne kadar faydalı olduğunu dikkatlice inceleyin. Sınıflandırmanın veya sınıflandırmanın iyileştirilebileceğini düşündüğünüz yolları belirtin ve sınıflandırmayı iyileştirme önerileriniz varsa geri bildirim gönderin.