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 inwestycji w nakłady na reklamę, nie zalecamy instalowania aplikacji na urządzeniach, na których jest już zainstalowana ta sama aplikacja. W tej propozycji nazywamy tę praktykę „filtrowaniem reklam promujących instalacje aplikacji”.

Ta propozycja wyjaśnia, jak Protected Audience na Androida obsługuje filtrowanie kontekstowe reklam, a w szczególności filtrowanie reklam promujących instalacje aplikacji, w sposób zapewniający ochronę prywatności. Aby wziąć udział w programie, aplikacja na urządzeniu musi wyraźnie wyrazić zgodę na filtrowanie reklam promujących instalacje aplikacji. Podczas wyboru reklamy kandydaci są odfiltrowywani na podstawie listy aplikacji zainstalowanych na urządzeniu znanej technologii reklamowej.

Lista zainstalowanych aplikacji jest widoczna tylko w ramach procesu wyboru reklamy i polega na platformie po stronie kupującego, która sygnalizuje, że dana reklama powinna zostać odfiltrowana na podstawie istnienia aplikacji na urządzeniu.

Aby skonfigurować filtrowanie reklam promujących instalację aplikacji, wykonaj następujące czynności:

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

Aby włączyć filtrowanie reklam w instalacji aplikacji, deweloper aplikacji wywołuje registerForAdFiltering interfejs API rejestracji aplikacji z aplikacji lub pakietu SDK firmy zajmującej się technologią reklamową, podając listę 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 brać udział w filtrowaniu reklam w instalacjach aplikacji. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

Krok 2. Poproś o odfiltrowywanie reklam instalacji aplikacji

Gdy reklama jest uwzględniana w określaniu stawek, kupujący mogą oznaczyć ją jako odfiltrowaną na podstawie stanu instalacji aplikacji. Można to zrobić, dodając nazwę pakietu aplikacji w metadanych reklamy. Żądanie filtrowania reklam promujących instalacje aplikacji jest częścią danych reklam przesyłanych do procesu aukcji z Protected Audience API. Dane te są tworzone w różny sposób w zależności od tego, czy są to reklamy kontekstowe czy reklamy remarketingowe.

  • W przypadku reklam kontekstowych, które są głównym zastosowaniem filtrowania reklam z zainstalowaniem aplikacji, informacje o filtrowaniu są uwzględniane w ramach danych reklam, które kupujący mogą przekazywać sprzedawcom w odpowiedzi na stawkę kontekstową poza grupą odbiorców chronionych. Protected Audience wymaga, aby informacje o filtrowaniu były zwracane w ramach odpowiedzi kontekstowej, tak jak inne metadane reklamy.
  • W przypadku remarketingu Protected Audience API oczekuje, że informacje o filtrowaniu będą uwzględnione w listach niestandardowych odbiorców. Są 2 możliwości: podczas dołączania do listy odbiorców oraz podczas pobierania nowych danych o odbiorcach w ramach procesu aktualizowania list odbiorców. Żądanie filtrowania reklam z propozycją instalacji aplikacji powinno wyglądać w obiektywie JSON obiektu AdData w ten sposób: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

Krok 3. Podczas wybierania reklam wykluczaj reklamy instalacji aplikacji

W trakcie żądania reklamy kupujący może przekazać sprzedawcy wiele reklam z informacjami filtrującymi, co pozwala odfiltrować reklamy zainstalowanych aplikacji. Strona sprzedaży musi przekazywać informacje o filtrowaniu w ramach konfiguracji funkcji selectAds w polu adData. Android oczekuje formatu wiadomości podobnego do tego poniżej.

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 above
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

Filtrowanie jest przetwarzane w interfejsie API selectAds. Protected Audience odfiltrowuje reklamę, jeśli aplikacja określona w wiadomości jest zgodna z aplikacją na liście instalacji aplikacji określonych przez kupujących w technologii reklamowej. Możliwe są 2 wyniki:

  • Aplikacji nie znaleziono na tej liście, co oznacza, że nie jest ona zainstalowana ani otwarta.
  • Aplikacja znajduje się na tej liście, co oznacza, że jest zainstalowana i otwarta. Jeśli Protected Audience API wykryje, że aplikacja już istnieje, reklama zostanie wykluczona z listy reklam, na których aukcja uruchamia scoreAds.

Uwagi dotyczące reklam kontekstowych

Dzięki filtrowaniu reklam z zachętą do instalacji aplikacji interfejsy Protected Audience API zaczynają obsługiwać filtrowanie reklam kontekstowych. W przypadku aukcji, która jest mieszanką reklam kontekstowych i remarketingowych lub składa się wyłącznie z reklam kontekstowych, należy podać kilka ważnych informacji.

  • Po uruchomieniu aukcji selectAd kupujący może przesłać listę obiektów ContextualAd. Te obiekty zawierają eTLD+1 kupującego reklamę, stawkę za reklamę, adres URL wskazujący na 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 sekcji 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 dla wszystkich reklam remarketingowych, a zarówno reklamy remarketingowe, jak i reklamy kontekstowe są oceniane za pomocą 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 aplikacja spowoduje uruchomienie raportowania wyświetleń, Protected Audience pobierze i wykonuje funkcję JS o nazwie reportWin() z adresu URL raportowania zawartego w danych reklamy kontekstowej. Jest to podobne do raportowania reklam remarketingowych, które wygrywają 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 weryfikacji technologii reklamowej, która dostarczyła reklamy, i filtrów instalacji aplikacji związanych z technologią reklamową, które mają być zastosowane do tych reklam. Robimy to, aby uniemożliwić złośliwym usługom reklamowym korzystanie z tożsamości innej usługi reklamowej w celu korzystania z rejestracji filtrowania instalacji aplikacji innej usługi reklamowej.

  • Piaskownica prywatności pobiera te klucze z punktu końcowego technologii reklamowych podanego podczas rejestracji. Zgodnie ze sprawdzoną metodą klucze należy aktualizować często, ale nie częściej niż co 6 miesięcy.

  • Piaskownica prywatności będzie wymagać od firm z branży technologii reklamowych potwierdzenia dostępności punktu końcowego udostępnionego przez tę firmę podczas procesu rejestracji. Więcej informacji o działaniach wymaganych przez obecnych i nowo zarejestrowanych dostawców technologii reklamowych znajdziesz w instrukcjach rejestracji.

  • W najbliższej przyszłości opublikujemy przewodnik dla programistów ze szczegółowymi instrukcjami implementacji.