Filtrowanie reklam promujących instalacje aplikacji na potrzeby Protected Audience API

Nowe instalacje aplikacji mobilnych są zwykle generowane przez reklamy promujące instalacje aplikacji. Aby zmaksymalizować zwrot z nakładów na reklamę, nie warto wyświetlać reklamy zachęcającej do zainstalowania aplikacji na urządzeniach, na których jest ona już zainstalowana. W tej propozycji nazywamy tę praktykę „filtrowaniem reklam promujących instalacje aplikacji”.

W tej propozycji opisujemy, jak Protected Audience API na Androidzie obsługuje filtrowanie reklam kontekstowych, w szczególności reklam promujących instalacje aplikacji, z zachowaniem prywatności. Aby wziąć udział w tym procesie, aplikacja na urządzeniu musi wyraźnie zgodzić się na filtrowanie reklam promujących instalacje aplikacji. Podczas wybierania reklam kandydaci są odfiltrowywani na podstawie listy aplikacji zainstalowanych na urządzeniu, które są znane technologii reklamowej.

Lista zainstalowanych aplikacji jest widoczna tylko w procesie wyboru reklamy i zależy od platformy po stronie kupującego, która sygnalizuje, że dana reklama powinna być filtrowana na podstawie obecności aplikacji na urządzeniu.

Aby skonfigurować filtrowanie reklam promujących instalację aplikacji:

Krok 1. Zarejestruj aplikację na potrzeby filtrowania reklam promujących instalację aplikacji

Aby włączyć filtrowanie reklam zachęcających do instalacji aplikacji, deweloper aplikacji wywołuje w aplikacji lub w pakiecie SDK technologii reklamowych interfejs API rejestracji aplikacjiregisterForAdFiltering z listą adresów eTLD+1 kupujących technologię reklamową. Dzięki temu kupujący na liście (i tylko oni) mogą filtrować reklamy na podstawie stanu instalacji aplikacji, bezpośrednio lub za pomocą pakietu SDK technologii reklamowej. Rejestracja daje deweloperowi aplikacji pełną kontrolę nad tym, czy jego aplikacja ma uczestniczyć w filtrowaniu reklam promujących instalację aplikacji. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

Krok 2. Poproś o odfiltrowanie reklam promujących instalację aplikacji

Gdy reklama jest brana pod uwagę w procesie ustalania stawek, kupujący mogą oznaczyć ją do odfiltrowania na podstawie stanu instalacji aplikacji. W tym celu w metadanych reklamy podaj nazwę pakietu aplikacji. Żądanie filtrowania reklam zachęcających do instalacji aplikacji jest częścią danych reklamowych przekazywanych do procesu aukcji Protected Audience. Te dane reklamowe są tworzone w różny sposób w zależności od tego, czy jest to reklama kontekstowa czy reklama remarketingowa.

  • W przypadku reklam kontekstowych, które są głównym zastosowaniem filtrowania reklam zachęcających do instalacji aplikacji, informacje o filtrowaniu są uwzględniane w danych reklam, które kupujący mogą przekazywać sprzedawcom w odpowiedzi na kontekstową stawkę poza Protected Audience. Protected Audience oczekuje, że informacje o filtrowaniu będą zwracane w ramach odpowiedzi kontekstowej, podobnie jak inne metadane dotyczące reklamy.
  • W przypadku remarketingu interfejs Protected Audience oczekuje, że informacje o filtrowaniu będą uwzględnione na liście niestandardowych odbiorców. Może to nastąpić w 2 sytuacjach: podczas dołączania do listy odbiorców i podczas pobierania nowych danych o odbiorcach w ramach procesu aktualizacji listy odbiorców. Żądanie odfiltrowania reklam zachęcających do instalacji aplikacji powinno wyglądać w obiekcie JSON AdData tak:json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

Krok 3. Filtruj reklamy zachęcające do instalacji aplikacji podczas wyboru reklam

Podczas żądania reklamy kupujący może przekazać sprzedawcy wiele reklam wraz z informacjami o filtrowaniu, aby można było odfiltrować reklamy zainstalowanych aplikacji. Platforma sprzedająca musi przekazywać informacje o filtrowaniu w ramach konfiguracji funkcji selectAds w polu adData. Android oczekuje formatu wiadomości podobnego do tego.

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);

Filtrowanie jest przetwarzane w interfejsie selectAds API. Protected Audience odfiltrowuje reklamę, jeśli aplikacja określona w wiadomości pasuje do aplikacji na liście instalacji aplikacji określonej przez kupujących technologię reklamową. Możliwe są 2 rezultaty:

  • Aplikacji nie ma na tej liście, co oznacza, że nie jest zainstalowana ani otwarta.
  • Aplikacja znajduje się na tej liście, co oznacza, że jest zainstalowana i otwarta. Jeśli interfejs Protected Audience API wykryje, że aplikacja już istnieje, reklama zostanie wykluczona z listy reklam, których aukcja używa do działania scoreAds.

Co wziąć pod uwagę w przypadku reklam kontekstowych

Dzięki filtrowaniu reklam promujących instalację aplikacji interfejsy Protected Audience API zaczynają obsługiwać filtrowanie reklam kontekstowych. W sytuacjach, gdy aukcja obejmuje reklamy kontekstowe i remarketingowe lub składa się wyłącznie z reklam kontekstowych, należy określić kilka ważnych kwestii.

  • Gdy przeprowadzana jest selectAdaukcja, kupujący może przekazać listę ContextualAd obiektów. Te obiekty zawierają eTLD+1 kupującego reklamę, stawkę za reklamę, adres URL wskazujący logikę raportowania reklamy oraz AdData zawierający rzeczywisty adres URL treści reklamy i podpis weryfikacyjny należący do kupującego (więcej informacji znajdziesz w artykule Podpisywanie reklam kontekstowych). Pamiętaj, że format AdData jest używany zarówno w reklamach kontekstowych, jak i w reklamach remarketingowych.
  • Na początku procesu aukcji reklamy kontekstowe i remarketingowe są filtrowane za pomocą zestawu nazw pakietów określonych w AdData.adFilters.appInstallFilters.packageNames. Następnie określane są wartości stawek za reklamy remarketingowe, a reklamy remarketingowe i kontekstowe są oceniane za pomocą podanej funkcji scoreAds. Wygrywa reklama z najwyższym wynikiem. Pamiętaj, że ten proces działa nawet wtedy, gdy nie ma reklam remarketingowych.

  • Jeśli reklama kontekstowa wygra aukcję, a raportowanie wyświetleń zostanie wywołane przez aplikację, Protected Audience pobierze i wykona funkcję JS o nazwie reportWin() z adresu URL raportowania zawartego w danych reklamy kontekstowej. Jest to podobne do raportowania w przypadku reklamy remarketingowej, która wygrała aukcję.

    Przykładowa funkcja raportowania w JavaScript:

    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} };
}

Podpisywanie reklam kontekstowych

  • Reklamy kontekstowe, które obejmują filtrowanie instalacji aplikacji, muszą być podpisane przez kupującego. Platforma używa tego podpisu do weryfikowania technologii reklamowej, która dostarczyła reklamy, oraz filtrów instalacji aplikacji technologii reklamowej, które mają być stosowane w przypadku tych reklam. Ma to zapobiec wykorzystywaniu tożsamości innej platformy reklamowej przez złośliwą platformę reklamową w celu uzyskania korzyści z rejestracji filtrowania instalacji aplikacji przez tę platformę.

  • Piaskownica prywatności pobierze te klucze z punktu końcowego technologii reklamowej podanego podczas rejestracji. Zgodnie ze sprawdzonymi metodami klucze należy często aktualizować, ale nie rzadziej niż co 6 miesięcy.

  • W ramach Piaskownicy prywatności dostawcy technologii reklamowych będą proszeni o potwierdzenie dostępności punktu końcowego dostarczonego przez dostawcę technologii reklamowych podczas procesu rejestracji. Więcej informacji o działaniach, które muszą podjąć obecni i nowi dostawcy technologii reklamowych, znajdziesz w instrukcjach rejestracji.

  • Wkrótce opublikujemy przewodnik dla programistów z bardziej szczegółowymi instrukcjami wdrażania.