Korunan kitle için uygulama yükleme reklamları filtreleme

Yeni mobil uygulama yüklemeleri genellikle uygulama yükleme reklamları tarafından sağlanır. Reklam harcamalarından elde edilen gelir hedefini en üst düzeye çıkarmak için, aynı uygulamanın zaten yüklü olduğu cihazlarda uygulama yükleme reklamı göstermemek iyi bir fikirdir. Bu teklifte, bu uygulamaya "uygulama yükleme reklamlarını filtreleme" adını veriyoruz.

Bu teklifte, Android'de Protected Audience'ın bağlamsal reklam filtrelemeyi, özellikle de uygulama yükleme reklamı filtrelemeyi gizliliği koruyacak şekilde nasıl desteklediği açıklanmaktadır. Katılmak için cihazdaki uygulamanın uygulama yükleme reklamı filtrelemeyi açıkça etkinleştirmesi gerekir. Reklam seçimi sırasında, reklam teknolojisi tarafından bilinen ve cihaza yüklenen uygulamaların listesine göre reklam adayları filtrelenir.

Yüklü uygulamaların listesi yalnızca reklam seçimi akışında görünür ve belirli bir reklamın cihazdaki bir uygulamanın varlığına göre filtrelenmesi gerektiğini belirtmek için satın alma tarafı platformuna bağlıdır.

Uygulama yükleme reklamı filtrelemeyi ayarlamak için aşağıdaki adımları uygulayın:

1. adım: Uygulamayı, uygulama yükleme reklamları filtreleme için kaydedin

Uygulama yükleme reklamları filtrelemeyi etkinleştirmek için uygulama geliştirici, reklam teknolojisi alıcısının eTLD+1'lerinin listesini içeren bir reklam teknolojisi SDK'sı veya uygulamasından registerForAdFiltering uygulama kaydı API'sini çağırır. Bu, listedeki alıcıların (ve yalnızca bu alıcıların) reklamları uygulamanın yükleme durumuna göre doğrudan veya reklam teknolojilerinin SDK'sını kullanarak filtrelemesine olanak tanır. Kaydolma, uygulama geliştiriciye uygulamasının uygulama yükleme reklamı filtrelemeye katılıp katılmaması konusunda tam kontrol sağlar. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

2. adım: Uygulama yükleme reklamlarının filtrelenmesini isteyin

Bir reklam teklif için değerlendirilirken alıcılar, reklamı bir uygulamanın yükleme durumuna göre filtrelenecek şekilde işaretleyebilir. Bu işlem, uygulamanın paket adını reklamın meta verilerine ekleyerek yapılır. Uygulama yükleme reklamları filtreleme isteği, Protected Audience açık artırma sürecine aktarılan reklam verilerinin bir parçasıdır. Bu reklam verileri, bağlamsal reklam mı yoksa yeniden pazarlama reklamı mı olduğuna bağlı olarak farklı şekilde oluşturulur.

  • Uygulama yükleme reklamlarının filtrelenmesiyle ilgili temel kullanım alanı olan bağlamsal reklam kullanım alanında, filtreleme bilgileri, Protected Audience'ın dışında bağlamsal bir teklife yanıt verirken alıcıların satıcılara verebileceği reklam verilerinin bir parçası olarak eklenir. Protected Audience, filtreleme bilgilerinin diğer reklama özgü meta veriler gibi bağlamsal yanıtın bir parçası olarak döndürülmesini bekler.
  • Yeniden pazarlama kullanım alanında Protected Audience, filtreleme bilgilerinin özel kitleye dahil edilmesini bekler. Bu dahil etme işleminin gerçekleşmesi için 2 fırsat vardır: kitleye katılma ve kitleyi güncelleme sürecinin bir parçası olarak yeni kitle verilerini getirme. Uygulama yükleme reklamlarını filtreleme isteği, AdData JSON nesnesinde aşağıdaki gibi görünmelidir: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

3. adım: Reklam seçimi sırasında uygulama yükleme reklamlarını filtreleyin

Alıcı, bir reklam isteği sırasında satıcıya filtreleme bilgileriyle birlikte birden fazla reklam iletebilir. Böylece, yüklü uygulamaların reklamları filtrelenebilir. Satış tarafının, filtreleme bilgilerini selectAds işlev yapılandırmasının bir parçası olarak adData alanında iletmesi gerekir. Android, buna benzer bir mesaj biçimi bekler.

AdData myAdData = new AdData.Builder()
        .setRenderUri(Uri.parse("https://.."))
        .setMetadata("{...}")
        .setFilters(new AdFilters.Builder()
                .setAppInstalledFilter(new AppInstalledFilter.Builder()
                    .setPackageNames(ImmutableList.of("app1.package", "app2.package"))
                    .build())
                .build())
        .build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
    .setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
    .setDecisionLogicUri(Uri.parse("https://..."))
    ...
    .setContextualAds(ImmutableList.of(new ContextualAd.Builder()
                      .setBuyer(AdTechIdentifier.fromString("example.com"))
                      .setReportingUri("https://example.com/reporting")
                      .setBid(20)
                      // myAdData could be taken from the JSON defined earlier
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

Filtreleme işlemi selectAds API'sinde yapılır. Protected Audience, mesajda belirtilen uygulama, reklam teknolojisi satın alanların belirli uygulama yükleme listesindeki uygulamayla eşleşirse reklamı filtreler. İki olası sonuç vardır:

  • Uygulama bu listede bulunmuyorsa yüklenmemiş ve açılmamıştır.
  • Uygulama bu listede yer alıyorsa yüklenmiş ve açılmış demektir. Protected Audience, bir uygulamanın zaten mevcut olduğunu algılarsa reklam, açık artırmanın scoreAds üzerinde çalışmak için kullandığı reklam listesinden hariç tutulur.

İçeriğe dayalı reklamlar söz konusu olduğunda dikkat edilmesi gereken noktalar

Uygulama yükleme reklamı filtreleme özelliğiyle birlikte Protected Audience API'leri, bağlamsal reklam filtrelemeyi desteklemeye başlar. Açık artırmanın bağlamsal ve yeniden pazarlama reklamlarının bir karışımı olduğu veya tamamen yalnızca bağlamsal reklamlardan oluştuğu durumlarda belirtilmesi gereken birkaç önemli nokta vardır.

  • Bir selectAd açık artırması çalıştırıldığında alıcı, ContextualAd nesnelerinin listesini iletme seçeneğine sahiptir. Bu nesneler, reklam alıcısının eTLD+1'ini, reklam için verilen teklifi, reklamın raporlama mantığına işaret eden bir URL'yi ve gerçek reklam içeriği URL'sini içeren AdData ile alıcıya ait bir doğrulama imzasını içerir (daha fazla bilgi için bağlamsal reklam imzası bölümüne bakın). AdData biçiminin hem bağlama dayalı hem de yeniden pazarlama reklamlarında kullanıldığını unutmayın.
  • Açık artırma sürecinin başında, bağlamsal ve yeniden pazarlama reklamları, AdData.adFilters.appInstallFilters.packageNames içinde belirtilen paket adları kümesi kullanılarak filtrelenir. Ardından, yeniden pazarlama reklamları için teklif değerlerine karar verilir ve hem yeniden pazarlama hem de bağlamsal reklamlar, sağlanan scoreAds işlevi kullanılarak puanlanır. En yüksek puana sahip reklam kazanır. Bu işlemin, yeniden pazarlama reklamları olmasa bile çalıştığını unutmayın.

  • Bir bağlamsal reklam açık artırmayı kazanırsa ve gösterim raporlaması uygulama tarafından tetiklenirse Protected Audience, bağlamsal reklam verilerinde yer alan raporlama URL'sinden reportWin() adlı bir JS işlevini indirip yürütür. Bu, açık artırmayı kazanan bir yeniden pazarlama reklamı için raporlamanın yapılmasına benzer.

    Örnek JavaScript raporlama işlevi:

    function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer,
contextual_signals) {
let reporting_address = 'https://reporting.example.com';
return {'status': 0, 'results': {'reporting_uri':
     reporting_address + '?some_signal=' + per_buyer_signals.some_signal} };
}

İçeriğe dayalı reklam imzası

  • Uygulama yükleme filtreleme içeren bağlamsal reklamlar, alıcı tarafından imzalanmalıdır. Platform, reklamları sağlayan reklam teknolojisini ve reklamlara hangi reklam teknolojisi uygulama yükleme filtrelerinin uygulanacağını doğrulamak için bu imzayı kullanır. Bu işlem, kötü amaçlı bir reklam teknolojisinin, başka bir reklam teknolojisinin uygulama yükleme filtreleme kaydından yararlanmak için bu reklam teknolojisinin kimliğini kullanmasını önlemek amacıyla yapılır.

  • Özel Korumalı Alan, bu anahtarları kayıt sırasında sağlanan reklam teknolojisi uç noktasından getirir. En iyi uygulama olarak, anahtarların sık sık güncellenmesini, ancak en geç 6 ayda bir güncellenmesini öneririz.

  • Özel Korumalı Alan, kayıt işlemi sırasında reklam teknolojisi sağlayıcıların, sağlanan reklam teknolojisi uç noktasının kullanılabilirliğini onaylamasını ister. Mevcut ve yeni kayıtlı reklam teknolojisi sağlayıcılarının yapması gereken işlemler hakkında daha fazla bilgi için Kayıt talimatları başlıklı makaleyi inceleyin.

  • Uygulama için daha ayrıntılı talimatlar içeren bir Geliştirici Kılavuzu yakında yayınlanacaktır.