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

Nowe instalacje aplikacji mobilnej są zwykle spowodowane reklamami promującymi instalacje aplikacji. Aby zmaksymalizować zwrot z inwestycji w reklamę, nie wyświetlaj reklam promujących instalację aplikacji na urządzeniach, na których już ją masz. W tej ofercie określamy ją jako „filtrowanie reklam promujących instalacje aplikacji”.

Omawiamy tu, w jaki sposób Protected Audience na Androidzie obsługuje filtrowanie reklam kontekstowych, w szczególności reklam promujących instalacje aplikacji, w sposób zapewniający ochronę prywatności. Aby korzystać z tej funkcji, aplikacja na urządzeniu musi wyraźnie zezwolić na filtrowanie reklam promujących instalacje aplikacji. Podczas wyboru reklamy kandydujące reklamy są odfiltrowywane na podstawie listy aplikacji zainstalowanych na urządzeniu znanej danej technologii.

Lista zainstalowanych aplikacji jest widoczna tylko w ramach procesu wyboru reklamy i zależy od platformy kupującego, aby zasygnalizować, że dana reklama powinna zostać odfiltrowana na podstawie obecności aplikacji na urządzeniu.

Aby skonfigurować filtrowanie reklam promujących instalacje aplikacji:

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

Aby zezwolić na filtrowanie reklam promujących instalacje aplikacji, deweloper wywołuje z aplikacji interfejs API rejestracji aplikacji registerForAdFiltering lub pakiet SDK technologii reklamowych z listą adresów eTLD + 1 od kupujących technologie reklamowe. Dzięki temu kupujący z listy i tylko ci mogą filtrować reklamy według stanu instalacji aplikacji – bezpośrednio lub za pomocą pakietu SDK technologii reklamowej. Rejestracja daje deweloperowi aplikacji pełną kontrolę nad tym, czy aplikacja powinna korzystać z filtrowania reklam promujących instalacje aplikacji.java void registerForAdFiltering(List<AdTechIdentifier> buyers);

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

Gdy reklama jest rozważana pod kątem ustalania stawek, kupujący mogą oznaczyć ją jako odfiltrowaną na podstawie stanu instalacji aplikacji. Polega to na dodaniu nazwy pakietu aplikacji w metadanych reklamy. Żądanie filtrowania reklam promujących instalacje aplikacji jest częścią danych reklam przekazywanych na potrzeby aukcji Protected Audience API. Dane te 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 jest głównym przypadkiem użycia filtrowania reklam promujących instalacje aplikacji, informacje o filtrowaniu są uwzględniane w danych o reklamach, które kupujący mogą przekazywać sprzedawcom, gdy odpowiadają na pytania o stawkę kontekstową poza funkcją Protected Audience. Protected Audience wymaga, aby informacje dotyczące filtrowania były zwracane jako część odpowiedzi kontekstowej, tak jak w przypadku innych metadanych związanych z reklamą.
  • W przypadku remarketingu funkcja Protected Audience wymaga, aby lista niestandardowa zawierała informacje o filtrowaniu. Są 2 możliwości: przy dołączeniu do grupy odbiorców i podczas pobierania nowych danych o odbiorcach w ramach procesu aktualizacji list odbiorców. Żądanie odfiltrowania reklam promujących instalacje aplikacji w obiekcie JSON AdData powinno wyglądać tak: json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }

Krok 3. Odfiltruj reklamy promujące instalacje aplikacji podczas wyboru reklamy

W żądaniu reklamy kupujący może przekazać z powrotem sprzedawcy wiele reklam z informacjami odfiltrowującymi, które pozwalają odfiltrować reklamy zainstalowanych aplikacji. Strona sprzedaży musi przekazywać informacje dotyczące filtrowania w ramach konfiguracji funkcji selectAds w polu adData. Android wymaga 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. Moduł Protected Audience odfiltrowuje reklamę, jeśli aplikacja określona w komunikacie odpowiada aplikacji na liście instalacji aplikacji określonej dla kupujących technologie reklamowe. Możliwe są 2 wyniki:

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

Co wziąć pod uwagę w przypadku reklam kontekstowych

Od filtrowania reklam promujących instalacje aplikacji interfejsy Protected Audience API zaczynają obsługiwać filtrowanie reklam kontekstowych. Kilka ważnych kwestii należy określić w sytuacjach, gdy aukcja obejmuje kombinację reklam kontekstowych i reklam remarketingowych albo składa się wyłącznie z reklam kontekstowych.

  • Po przeprowadzeniu aukcji selectAd kupujący może przekazać listę obiektów ContextualAd. Obiekty te zawierają identyfikator eTLD + 1 kupującego, stawkę za reklamę, adres URL wskazujący logikę raportowania reklamy oraz obiekt AdData zawierający faktyczny adres URL treści reklamy oraz 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 aukcji reklamy kontekstowe i remarketingowe są odfiltrowywane na podstawie zestawu nazw pakietów określonych w parametrze AdData.adFilters.appInstallFilters.packageNames. Następnie dla reklam remarketingowych ustalane są wartości stawek, a ocena reklam remarketingowych i kontekstowych odbywa się za pomocą funkcji scoreAds. Wygrywa reklama z najwyższym wynikiem. Ten proces działa nawet wtedy, gdy nie masz reklam remarketingowych.

  • Jeśli reklama kontekstowa wygra aukcję, a aplikacja uruchomi raportowanie wyświetleń, funkcja Protected Audience pobiera i wykona funkcję JavaScript o nazwie reportWin() z adresu URL raportowania zawartego w danych reklam kontekstowych. Przypomina to sposób raportowania reklamy remarketingowej, która wygrała aukcję.

    Przykładowa funkcja raportowania 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 uwzględniające filtrowanie instalacji aplikacji muszą być podpisane przez kupującego. Platforma korzysta z tego podpisu, aby weryfikować technologię reklamową, która dostarczyła reklamy, i określać filtry promujące instalacje aplikacji. Ma to na celu uniemożliwienie złośliwej technologii reklamowej wykorzystanie tożsamości innej technologii w celu uzyskania korzyści z rejestracji filtrowania instalacji aplikacji tego typu.

  • Piaskownica prywatności będzie pobierać te klucze z punktu końcowego technologii reklamowych udostępnionego podczas rejestracji. Zgodnie ze sprawdzoną metodą zalecamy częste aktualizowanie kluczy, ale nie później niż co 6 miesięcy.

  • Piaskownica prywatności poprosi technologie reklamowe o potwierdzenie dostępności punktu końcowego dostarczonego technologii reklamowych. Więcej informacji o działaniach wymaganych przez obecnych i nowo zarejestrowanych technologii reklamowych znajdziesz w instrukcjach rejestracji.

  • Niedługo udostępnimy przewodnik dla programistów ze szczegółowymi instrukcjami.