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 wyświetlaj reklamy z prośbą o zainstalowanie 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 na Androidzie umożliwia filtrowanie reklam kontekstowych, w tym reklam promujących instalacje aplikacji, przy zachowaniu 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 reklamy docelowe są odfiltrowywane na podstawie listy aplikacji zainstalowanych na urządzeniu, znanej przez technologię reklamową.

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 obecności aplikacji na urządzeniu.

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

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

Aby włączyć filtrowanie reklam w aplikacji, deweloper aplikacji wywołuje registerForAdFiltering interfejs API rejestracji aplikacji z aplikacji lub pakietu SDK firmy dostarczającej technologie reklamowe, podając listę domen eTLD+1 kupujących reklamy. Dzięki temu kupujący na liście, a 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 odfiltrowanie reklam instalacji aplikacji

Gdy reklama jest brana pod uwagę w celu określenia stawki, kupujący może oznaczyć ją jako wykluczoną na podstawie stanu instalacji aplikacji. Aby to zrobić, dodaj nazwę pakietu aplikacji w metadanych reklamy. Żądanie filtrowania reklam w aplikacji jest częścią danych reklam przekazywanych do procesu aukcji Protected Audience. 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 zadaniem instalowania aplikacji, informacje o filtrowaniu są uwzględniane w ramach danych reklam, które kupujący mogą przekazywać sprzedawcom w odpowiedzi na stawkę kontekstową poza Protected Audience. Protected Audience wymaga, aby informacje o filtrowaniu były zwracane w ramach odpowiedzi kontekstowej, tak jak inne metadane reklamy.
  • W przypadku remarketingu Protected Audience wymaga, aby informacje o filtrowaniu były uwzględniane na liście niestandardowych odbiorców. Dane te mogą zostać uwzględnione w 2 sposobach: podczas dołączania listy odbiorców i pobierania nowych danych o listach odbiorców w ramach procesu aktualizacji listy odbiorców. Żądanie filtrowania reklam z propozycją instalacji aplikacji powinno wyglądać w obiektywie AdData JSON w ten sposób: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

Krok 3. Podczas wybierania reklam odfiltruj reklamy instalacji aplikacji

Podczas żądania reklamy kupujący może przekazać sprzedawcy wiele reklam z informacjami o filtrowaniu, aby można było 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.

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 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 technologii reklamowych. Możliwe są 2 wyniki:

  • Aplikacji nie znaleziono na tej liście, co oznacza, że nie jest ona zainstalowana ani otwarta.
  • Aplikacja jest na tej liście, co oznacza, że jest zainstalowana i otwarta. Jeśli Protected Audience wykryje, że aplikacja już istnieje, reklama zostanie wykluczona z listy reklam, których używa aukcja do wyświetlania 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.

  • Podczas przeprowadzania aukcji selectAd kupujący może przekazać listę obiektów ContextualAd. Te obiekty zawierają eTLD+1 kupującego reklamę, stawkę za reklamę, URL wskazujący na logikę raportowania reklamy oraz AdData zawierający rzeczywisty 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 w kontekście

  • Reklamy kontekstowe, które obejmują filtrowanie instalacji aplikacji, muszą być podpisane przez kupującego. Platforma używa tego podpisu do weryfikacji technologii reklamowych, które dostarczyły reklamy, oraz do określenia, które filtry instalacji aplikacji reklamowych mają być stosowane do 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 pobierze te klucze z usług reklamowych podanych podczas rejestracji. Zgodnie ze sprawdzoną metodą klucze należy często aktualizować, ale nie rzadziej niż co 6 miesięcy.

  • Piaskownica prywatności będzie wymagać od dostawców technologii reklamowych potwierdzenia dostępności punktu końcowego udostępnionego przez nich w ramach procesu rejestracji. Więcej informacji o działaniach wymaganych od obecnych i nowych zarejestrowanych usług reklamowych znajdziesz w instrukcjach rejestracji.

  • W najbliższej przyszłości opublikujemy Przewodnik dla programistów zawierający bardziej szczegółowe instrukcje implementacji.