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

Yeni mobil uygulama yüklemeleri genellikle uygulama yükleme reklamlarından kaynaklanır. Reklam harcamalarından elde edilen gelirinizi en üst düzeye çıkarmak için, aynı uygulamanın yüklü olduğu cihazlara uygulama yükleme reklamı göstermemeniz önerilir. Bu öneride, bu uygulamaya "uygulama yükleme reklamı filtreleme" denir.

Bu teklifte, Android'deki Protected Audience'ın bağlama dayalı reklam filtrelemeyi (özellikle uygulama yükleme reklamı filtrelemeyi) gizliliği koruyan bir şekilde nasıl desteklediği açıklanmaktadır. Programa katılmak için cihazdaki uygulamanın uygulama yükleme reklamı filtrelemesini açık bir şekilde etkinleştirmesi gerekir. Reklam seçimi sırasında reklam adayları, reklam teknolojisinin bildiği cihaza yüklenen uygulamalar listesine göre filtrelenir.

Yüklü uygulamaların listesi yalnızca reklam seçim akışında görünür ve belirli bir reklamın cihazda bir uygulamanın varlığına göre filtrelenmesi gerektiğini belirtmek için alıcı tarafı platformu kullanır.

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

1. adım: Uygulamayı uygulama yükleme reklamı filtrelemesi için kaydedin

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

2. Adım: Uygulama yükleme reklamlarını filtreleme isteğinde bulunun

Bir reklam teklif vermek için değerlendirilirken alıcılar, reklamı uygulamanın yükleme durumuna göre filtrelenecek şekilde işaretlemeyi seçebilir. Bu işlem, uygulamanın paket adı reklamın meta verilerine ekleyerek yapılır. Uygulama yükleme reklamı filtreleme isteği, Protected Audience açık artırma sürecine beslenen reklam verilerinin bir parçasıdır. Bu reklam verileri, içeriğe dayalı veya yeniden pazarlama reklamı olmasına bağlı olarak farklı şekilde oluşturulur.

  • Uygulama yükleme reklamı filtrelemenin ana kullanım alanı olan bağlama dayalı reklam kullanım alanında, filtreleme bilgileri, alıcıların Protected Audience dışındaki bir bağlama dayalı teklife yanıt verirken satıcılara verebileceği reklam verilerinin bir parçası olarak dahil edilir. Protected Audience, diğer reklama özgü meta veriler gibi filtreleme bilgilerinin bağlamsal yanıtın bir parçası olarak döndürülmesini bekler.
  • Protected Audience, yeniden pazarlama kullanım alanında filtreleme bilgilerinin özel kitleye dahil edilmesini bekler. Bu dahil etme işleminin gerçekleşmesi için 2 fırsat vardır: Kitleye katılırken ve kitle güncelleme sürecinin bir parçası olarak yeni kitle verileri getirilirken. 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ı, reklam isteği sırasında filtreleme bilgileriyle birlikte birden fazla reklamı satıcıya geri gönderebilir. Böylece, yüklü uygulamaların reklamları filtrelenebilir. Satış tarafının, filtreleme bilgilerini adData alanındaki selectAds işlev yapılandırmasının bir parçası olarak 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 işlenir. Protected Audience, mesajda belirtilen uygulama reklam teknolojisi alıcılarının belirli uygulama yükleme listesinde yer alan uygulamayla eşleşirse reklamı filtreler. İki olası sonuç vardır:

  • Uygulama bu listede bulunmuyorsa yüklü ve açılmış değildir.
  • 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 yayınlamak için kullandığı reklam listesinden hariç tutulur.

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

Uygulama yükleme reklam filtrelemesiyle 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 birkaç noktayı belirtmek önemlidir.

  • Bir selectAd açık artırması çalıştırıldığında alıcı, ContextualAd nesnelerinin bir listesini iletme seçeneğine sahiptir. Bu nesneler; reklam alıcının eTLD+1'ini, reklam için teklifi, reklamın raporlama mantığını işaret eden bir URL'yi, asıl reklam içeriği URL'sini ve alıcıya ait bir doğrulama imzasını içerir (daha fazla bilgi için bağlamsal reklam imzalama bölümüne bakın).AdData 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ğlama dayalı ve yeniden pazarlama reklamları, AdData.adFilters.appInstallFilters.packageNames içinde belirtilen paket adları grubu kullanılarak filtrelenir. Ardından, tüm yeniden pazarlama reklamları için teklif değerleri belirlenir 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 reklamı 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 verilerine dahil edilen 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} };
}

Bağlamsal reklam imzalama

  • Uygulama yükleme filtrelemesi içeren bağlamsal reklamlar alıcı tarafından imzalanmalıdır. Platform, reklamları sağlayan reklam teknolojisini ve reklamlara uygulanacak reklam teknolojisi uygulama yükleme filtrelerini doğrulamak için bu imzayı kullanır. Bu, kötü amaçlı bir reklam teknolojisinin, başka bir reklam teknolojisinin uygulama yükleme filtreleme kaydından yararlanmak için başka bir 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 alır. En iyi uygulama olarak, anahtarların en geç 6 ayda bir sık sık güncellenmesini öneririz.

  • Özel Korumalı Alan, kayıt sürecinde reklam teknolojilerinin sağladığı uç noktanın kullanılabilirliğini onaylamasını ister. Mevcut ve yeni kayıtlı reklam teknolojilerinin yapması gereken işlemler hakkında daha fazla bilgi için Kayıt talimatları başlıklı makaleyi inceleyin.

  • Uygulamayla ilgili daha ayrıntılı talimatları içeren bir Geliştirici Kılavuzu yakın zamanda yayınlanacaktır.