Mobil Cihazlar için Topics API'ye genel bakış

Geri bildirim gönderin

Topics API hakkında

Mobil reklamcılıkta, reklamverenler bir ürün veya hizmetle alakalı üç önemli adım var. Örneğin bir kullanıcı, yemek pişirmekle ilgili reklamlar, onlar için yemek pişirmeyle ilgili reklamlardan daha alakalı olmayan reklamlar gösterebilir.

İçeriğe dayalı reklamcılık, yalnızca Görüntülenen (ve reklamı yapılan) mevcut içerik. Faydalarından biri Topics API, kullanıcı için faydalı ancak belki de daha alakalı reklamlar göstermek için içeriğe dayalı reklamcılık yoluyla kolayca para kazanamaz harcayabileceğinden çok daha fazla para kazanıyor. Bu da, bazı önemli bilgiler sağlıyor.

Topics API, verileri temel alarak cihaz üzerindeki genel ilgi sinyallerine kullanıcının uygulama kullanımı. Konu adı verilen bu sinyaller, izleme gerektirmeden sürekli ve diğer birinci taraf sinyallerine destek ve uygulamayı kapsar.

Topics API, aşağıdaki özelliklere sahip üçüncü taraf reklam SDK'larını destekleyecek şekilde tasarlanmıştır: genelde birden fazla uygulamada çalışır. Bu desteğin amacı şu şekildedir: SDK'ların normalde alacağı uygulamalar arası ilgi alanlarından bazılarını ortaya çıkarıyor. gözlemleyin. Bağımsız uygulama geliştiriciler daha fazla bilgi edinmeyi beklememelidir bilgi edinmiş olursunuz.

Temel kavramlar

• Konu, bu kullanıcının okuyabileceği bir konudur ve Topics sınıflandırması gerekir.
• Konu, bir çağrı tarafından gözlemlendiğinde ( uygulaması) çağrı yapan kişi, yaşanan değişimleri ele alacağız.
• Dönem, konu hesaplaması dönemidir (ör. bir hafta).

İşleyiş şekli

Topics API, bu teklifle arayanlara Kullanıcının uygulama kullanımına dayalı genel ilgi alanı reklamcılık konuları. Bu konular, abonelikle ilgili bağlamsal bilgilerin desteklenmesi için kullanılabilir. reklam göstermek isteyen bir uygulamadır ve uygun bir en iyisidir.

Aşağıdakileri gösteren kod örnekleri için Topics API geliştirici kılavuzuna bakın: İlgi alanına dayalı reklamcılık için konu getirme özelliğinin nasıl ayarlanacağı. Not: API'ler henüz kesinleşmedi.

Konular, önceden tanımlanmış bir açık kaynak sınıflandırmasından seçilir.

Platform, konuları tahmin etmek için bir sınıflandırıcı modeli kullanır. Konular API uygulaması ve sınıflandırıcı kullanımı, Android'in bir parçası olacaktır. ve zamanla daha iyi hale gelecektir.

Açıklama olması amacıyla, aşağıdaki kod örneğinde konuları belirleyin. Burada kullanılan API'ler nihai değildir.

// Initialize the Topics API.
…
topicsFuture = AdvertisingTopicsClient.getTopics();

// Retrieve Topics and use them in Ad request.
Futures.addCallback(
    topicsFuture,
    new FutureCallback<AdvertisingTopicsInfo>() {
        @Override
        public void onSuccess(@Nullable AdvertisingTopicsInfo topicsInfo) {
            // Sanitize Topics result.
            ...
            // Initialize ad request with Topics obtained.
            AdRequest adRequest = AdRequest.initialize(topicsInfo);
        }

        @Override
        public void onFailure(Throwable t) {
            // Handle error.
            ...
        }
});

Sınıflandırıcı modelinin nasıl çalıştığını daha iyi anlamak için Android Topics Sınıflandırıcısı'nı kullanarak farklı uygulama verilerinin sistemde nasıl tepki verdiğini görebilirsiniz. Colab'e gidin.

Topics API'lerine erişim elde etme

Reklam teknolojisi platformlarının Topics API'ye erişmek için kaydolması gerekir. Bunun için bkz. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolun.

Ayrıntılar

• Her dönemden (ör. haftada bir kez) kullanıcının en önemli 5 konusu hesaplanır cihaz üzerindeki bilgileri kullanarak.

  • Topics API çağrıldığında platform, bir konunun API'yi çağıran uygulamaya atanmış olmalıdır. Hiç atanmamışsa aşağıdaki gibi bir konu seçilecek ve seçilen konu bu uygulamaya atanır.
    • %95 olasılıkla, ilgili dönem için hesaplanan en önemli 5 konuyu ele aldık.
    • %5 olasılık ile, sınıflandırmadan rastgele bir konu seçilir.
    • Arayan, aşağıdakileri yapmadan konuları almak istediğini belirtebilir: Parametreyi kullanarak getTopics öğesini çağırarak durumu değiştirme shouldRecordObservation = false. Bu nedenle, konular geri döndü, ancak çağrı haftalık döneme dahil edilmeyecek veya anket oturumu için gözlemlenen konuların listesini de arayan
  • Her uygulamanın çeşitli konulardan biri olmasının nedeni, uygulamaların farklı konular almasına neden olur. Bu da uygulamaların kullanabilirsiniz.
    • Örneğin A uygulaması, kullanıcı için T1 konusunu görebilirken B uygulaması 2. konuya bakın. Bu da iki uygulamanın da bu bilginin aynı kullanıcıyla ilişkili olduğunu belirler.

• Topics API, geçmiş 3 konunun her biri için 1 tane olmak üzere en fazla 3 konunun yer aldığı bir liste döndürür dönemler.

  • En fazla 3 konu sağladığınızda, sık kullanılmayan uygulamalar yeterli olacaktır alakalı reklamlar bulmak için farklı konular, ancak sık kullanılan uygulamalar, Haftada 1 yeni konu.
  • Döndürülen konu bilgileri, girişe, sınıflandırma sürümüne ve sınıflandırıcı modeli ile sürümünü değil.
  • Yalnızca kullanıcıyı gözlemleyen arayanlar konuyla ilişkilendirilmiş bir uygulama kullanır. önceliklendirme, ilgili e-posta,
  • Döndürülen tüm konular kullanıcının ilgi alanlarını temsil eder ve şunları yapabilirsiniz: reklamınızda reklam kişiselleştirme için bu konuların herhangi birini veya tümünü seçin isteğinde bulunabilirsiniz.

• Topics API'yi çağıran uygulamaya bir konu atandıktan sonra platform, arayanın bu konuyu alıp alamayacağını belirler.

  • Yalnızca veya son 3 dönemde söz konusu konu, o konuyu alabilir.
  • Arayan kişi, söz konusu kullanıcı için geçmişte bir uygulamada API'yi çağırmadıysa takip ederseniz, o konu listeye dahil edilmez. kontrol edin.
  • Arayan kişi son 3 dönem içinde herhangi bir konu almadıysa Topics API boş bir liste döndürecek.

  Örneğin, kullanıcının cihazda yüklü 7 uygulaması olduğunu varsayalım: A, B, C, D, E, F ve G. Uygulamanın ve reklamın konu sınıflandırmasının bu uygulamalardaki teknoloji SDK'ları şunlardır:

  Uygulama	Konu sınıflandırma	Reklam teknolojisi SDK'sı
  A	K1, K5	ad-sdk1, ad-sdk2
  B	Ş2	reklam-sdk2
  C	Ş3, O6	ad-sdk3, ad-sdk4
  D	Ş1, K4	reklam-sdk1
  E	T5	ad-sdk4, ad-sdk5
  C	T6	ad-sdk2, ad-sdk3, ad-sdk4
  Y	T7	reklam-sdk2

  • 1. hafta sonu: Topics API, kullanıcının bu konu için en çok ilgi gösterdiği 5 konusunu oluşturur epoch'ta yer alır.

  En Popüler Konu	Konu hakkında bilgi edinebilen arayanlar
  Ş1	ad-sdk1, ad-sdk2
  Ş2	reklam-sdk2
  T3	ad-sdk3, ad-sdk4
  Ş4	reklam-sdk1
  T5	ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

  • 2. haftada, herhangi bir uygulamada arayan bir kullanıcı API'yi çağırırsa döndürülen konu liste yalnızca arayanın "Arayanlar" listesinde olduğu konuları içerir bilgi edinebilen bir uygulamadaki o konuya ait yaşandığı dönemdir.
  • Geçmiş penceresi, bu kullanıcıların erişebileceği konuların hesaplanmasına dahil edilir. her arayanın 3 dönem (veya 3 hafta) olduğunu varsayalım.
  • Yalnızca reklam aracılığıyla Topics API'yi çağıran uygulamalarla ilişkili konular SDK'lar kullanılır. Yani, uygulamada reklam SDK'sı yoksa yoksa Topics API'yi çağıran konular varsa o uygulamayla ilişkilendirilen konular Reklam SDK'larının erişebileceği konu havuzuna katkıda bulunur.
  • Uygulamalar ayrıca yeni manifesto ve XML öğelerini kullanarak, reklam SDK'larının API'yi seçin. Devre dışı bırakılan uygulamalarla ilişkili konular haftalık konu hesaplamasına katkıda bulunur. Bu doküman, ilgili uygulama ayrıntılarını içerecek şekilde güncellenir.

• Platformun 5 konu tahmin etmesine yetecek kadar uygulama kullanımı yoksa kalan konuları rastgele oluşturmak gibi seçenekleri değerlendirebilir.

Sınıflandırma

• Mevcut teklifte, ilk sınıflandırma birkaç yüz binlerce konu. İlk sınıflandırma teklifi, bu dokümanın gelecekteki bir güncellemesinde paylaşılacak.
• Bu sınıflandırma gerçek kişiler tarafından seçilir, böylece hassas konular sınıflandırmaktır.
• Bu sınıflandırma, Google Görüntülü Reklam Ağı'nda gösterilebilecek reklam kategorilerine mobil uygulamalar.
• Sınıflandırma herkese açıktır ve değişebilir. Bu sayfanın üst kısmındaki geri bildirim düğmesini kullanarak öneri gönderebilirsiniz.

Konu sınıflandırıcı

İlgi alanı konuları, şu verilere göre eğitilmiş bir sınıflandırıcı modelinden türetilir: herkese açık uygulama bilgileri (uygulama adı, açıklaması ve paket gibi) adı).

• Sınıflandırıcı modeli, bir testin konularını hesaplamak için çıkarım için belirli bir dönemden sonra, kullanılan sinyal grubu cihazda kalır. Bu grup sinyalleri, yüklenen veya son kullanılan uygulamaları içerebilir ve daha sonra diğer sinyalleri içerecek şekilde genişletildi.
• İlk modeller Google tarafından eğitilecektir. Burada eğitim verileri şunları içerir: Herkesin kullanımına açık uygulama bilgileri için gerçek kişiler tarafından seçilen etiketler. Model, uygulamaların, hangi konuları sınıflandırdığını görmek için ücretsiz olarak test etmesine olanak tanır. .
• İlk modeller, uygulamaların herkese açık bilgileri üzerine eğitilir .
• Bir uygulama birden fazla konu ile eşlenebilir, hiçbir konu olmayabilir veya kullanıcının konu geçmişine eklenmez. Bir uygulamanın Sınıflandırmada 1'den fazla konu var, bu uygulama için seçilen konu sayısı ilk 3'le sınırlı olacaktır.

Kullanıcı denetimleri

• Tasarım, kullanıcıların bu öğeleri görüntüleme ve kaldırma alakalı konuları ele alacağız. Bunun uygulanması, Kullanıcı denetimi özelliği hâlâ devam eden bir çalışmadır ve dikkatinizi çekebilir.
• Kullanıcı, seçimine katkıda bulunan bir uygulamayı kaldırırsa tahmin edilen bir konu olursa bu konu son 3 dönem için döndürülen konuların listesidir. Böylece, kaldırma hakkında bilgi edin.

Son kullanıcı deneyiminin nasıl olacağına dair test sürecini kolaylaştırmak için, Topics'in ayarlar kullanıcı arayüzünü görüntülemek için uygulama içi bir niyet de fikir edinmenize yardımcı olabilir. Bu çağrıya ilişkin bir örneği aşağıda görebilirsiniz:

//Button that launches settings UI
private Button mSettingsAppButton;
private static final String RB_SETTING_APP_INTENT = "android.adservices.ui.SETTINGS";


//Does setup for button on screen that will launch settings UI to observe Topics
private void registerLaunchSettingsAppButton() {
    mSettingsAppButton.setOnClickListener(
        new View.OnClickListener() {

            @Override
            public void onClick(View view) {
                Context context = getApplicationContext();
                Intent activity2Intent = new Intent(RB_SETTING_APP_INTENT);
                activity2Intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(activity2Intent);
            }
        });
}

Bir reklam teknolojisi platformuna kaydolun

Topics API'ye erişmek için Google'ınkiler dahil tüm reklam teknolojisi platformlarının kayıt işlemini tamamlamalısınız.

Uygulama geliştiriciler, Topics API'lerine hangi reklam teknolojisi geliştiricilerinin erişebileceğini yönetmek için Uygulama manifestine, reklam teknolojisi geliştiricisinin kayıt kimliği dahildir.

Döndürülen konuların şifrelenmesi

Topics API'yi çağıran kayıtlı reklam teknolojisi platformlarının da şunları sağlaması gerekir: böylece döndürülen konuların yalnızca arayan

Özel Korumalı Alan, bu anahtarları reklam teknolojisi tarafından sağlanan uç noktadan getirir. Biz en iyi uygulama olarak, anahtarların sık sık güncellenmesini ve daha sonra her 6 ayda bir daha.

Özel Korumalı Alan, reklam teknisyenlerinden uç noktanın kullanılabilirliğini onaylamasını ister kayıt süreci sırasında reklam teknolojisi tarafından sağlanır. Ayrıntılı bilgi için daha fazla bilgi edinmek için Geliştirici Kılavuzu.

Şifreleme ayrıntıları

Şifrelemenin kullanıma sunulmasıyla birlikte, "GetTopics()" çağrıları oluşturmak için "EncryptedTopic" listesini içeren yanıt nesneler'i tıklayın. Bu sonuçların şifresi çözüldüğünde önceki Topic nesnesiyle aynı JSON biçimine sahip bir nesne oluşturur.

Topics API, HPKE'nin (Karma Ortak Anahtar) tek seferlik uygulamasını destekler Şifreleme). Kayıtlı arayanın, kayıt sırasında sağlanan herkese açık şifreleme URL'si uç noktası. Bu anahtarlar Base64 olarak kodlanması beklenir.

EncryptedTopic nesnesinin 3 alanı vardır. Döndürülen konular listesi ortak anahtara karşılık gelen özel anahtar kullanılarak alınır.

Geliştirme amacıyla, işlemini tekrarlar. Bu işlem, API'yi test ortak anahtarını şifrelemeyi deneyin. Şifrelenmiş konuların şifresini çözmek için ilgili özel anahtara karşılık gelir.

Sizin için önerilenler

• Not: JavaScript kapalıyken bağlantı metni gösterilir
• Sürüm notları
• Android geliştirici kılavuzunda Protected Audience API
• Topics API geliştirici kılavuzu

ziyaret edin.