Ograniczenie liczby wyświetleń w ramach Protected Audience API

Ograniczenie liczby wyświetleń to praktyka reklamowa, która ogranicza liczbę reklam z określonej kategorii wyświetlanych użytkownikowi w określonym przedziale czasu. Ograniczenie liczby wyświetleń zapewnia większą wygodę użytkowników, ponieważ sprawia, że reklamy są interesujące i nie nużą. Pomaga też reklamodawcom zarządzać wydatkami na reklamę.

W tej propozycji przedstawiamy, jak za pomocą interfejsu Protected Audience na Androidzie można stosować funkcję ograniczenia liczby wyświetleń w sposób dokładny i zapewniający ochronę prywatności.

Protected Audience stosuje ograniczenie liczby wyświetleń, łącząc 2 funkcje: przechowywanie na urządzeniu liczników zdarzeń związanych z reklamami oraz możliwość filtrowania reklam według wstępnie zdefiniowanego zbioru strategii filtrowania. Ograniczenie liczby wyświetleń umożliwia reklamodawcom określenie progu licznika na podstawie sumy wartości histogramu w określonym przedziale czasu.

Liczniki są unikalne dla każdej kombinacji profilu urządzenia, technologii reklamowej i klucza licznika. Każda reklama powinna zawierać zestaw kluczy licznika, które będą używane w przypadku zarejestrowania wyświetlenia lub wyświetlenia reklamy. W przypadku każdego klucza Protected Audience przechowuje zestaw liczników, a każdy z nich zlicza wszystkie zdarzenia związane z reklamą, które występują w określonym przedziale czasu. Liczniki na urządzeniu są zwiększane, gdy wystąpi wyświetlenie lub odsłona, a ich dane są przechowywane na urządzeniu. Dokładny czas przechowywania zostanie określony później.

Logika filtrowania reklam w procesie wyboru reklam w przypadku chronionych list odbiorców ma dostęp do liczników, reklam remarketingowych i reklam kontekstowych, dzięki czemu limitowanie liczby wyświetleń na użytkownika w przypadku chronionych list odbiorców może działać z uwzględnieniem wszystkich tych typów żądań reklamy.

Uwaga: filtrowanie reklam jest dostępne tylko w Piaskownicy prywatności na urządzeniach z Androidem. Implementacja Protected Audience w Chrome nie zawiera mechanizmu filtrowania reklam kierowanych kontekstowo, które nie są objęte Protected Audience. Ta propozycja obejmuje tylko obsługę po stronie kupującego. Jeśli będzie taka potrzeba, wprowadzimy obsługę po stronie sprzedawcy w późniejszym terminie.

Limit wyświetleń na użytkownika obowiązujący w przypadku chronionej listy odbiorców obsługuje wiele wymagań, w tym:

• Filtrowanie w czasie rzeczywistym z minimalnym opóźnieniem po stronie serwera podczas aktualizowania liczników na urządzeniu.
• Elastyczna hierarchia kluczy, w tym pojedyncze reklamy, kampanie lub inne grupy.
• Zgodność z innymi metodami ograniczania liczby wyświetleń, bez zależności od identyfikatora AdID.
• Działa w aplikacjach na danym profilu użytkownika urządzenia.
• dokładne i kompletne liczniki;
• Obsługa niestandardowych definicji zdarzeń reklamowych, np. obejrzeń lub wyświetleń.
• Jedna funkcja do remarketingu i reklam kontekstowych.

Aby skonfigurować ograniczenie liczby wyświetleń:

Krok 1. Dodaj do reklam informacje o ograniczeniu liczby wyświetleń

Reklamy kontekstowe i reklamy remarketingowe wskazują odpowiednie liczniki histogramu do zaktualizowania w przypadku wyświetlenia lub wyświetlenia za pomocą pola ad_counter_keys, które zawiera listę dowolnych liczb całkowitych. Pole nie jest uwzględniane w polu metadata, które nie jest analizowane przez Protected Audience.

Ten przykład pokazuje format danych pola adsData w AdSelectionConfig. W przypadku remarketingu format listy reklam dla danej listy odbiorców niestandardowych jest zgodny z treścią pola ads, jak w tym przykładzie:

'adsData': [
  {
    "buyer": "ads.example.com",
    "ads": [
      {
        'render_url': 'exampleUrl',
        'metadata': {...},   /* metadata are opaque to Protected Audience are
                                required to be in valid JSON format */
        'ad_counter_keys': [1234, 5678]
      }]
  }]
}

Krok 2. Zarejestruj wyświetlenie lub wyświetlenie w ramach CPM

Firmy technologiczne zajmujące się reklamami mogą wywoływać metodę updateAdCounterHistogram, aby rejestrować wystąpienia zdarzeń, które są używane do ograniczenia liczby wyświetleń. Metoda może być wielokrotnie wywoływana w ramach tego samego zdarzenia w przypadku kluczy określonych w wygrywającej reklamie.eventType

void updateAdCounterHistogram(@EventType eventType, long adSelectionId)

Wejścia:

• eventType: określa, czy zdarzenie jest liczone jako wyświetlenie, wyświetlenie, kliknięcie czy wygrana w procesie wyboru reklamy.
• adSelectionId: wartości identyfikatorów w obiekcie AdSelectionOutcome zwracane przez wywołania selectAds.

Wywołanie updateAdCounterHistogram aktualizuje histogram dla zbioru kluczy zdefiniowanych w ramach reklam remarketingowych pobieranych przez CustomAudience lub reklam kontekstowych uwzględnionych w parametrze AdSelectionConfig w selectAds.

Jeśli założysz, że reklama z etapu 1 jest zwycięską reklamą w kampanii AdSelection o wartości id 9999, wywołanie funkcji updateAdCounterHistogram(FrequencyCapFilters.AD_EVENT_TYPE_VIEW, adSelectionId: 999) zwiększa liczniki dla tych 3 głównych kluczy:

• {'ads.example.com', 1234, VIEW}
• {'ads.example.com', 5678, VIEW}

Nazwa technologii reklamowej jest pobierana z pola kupującego, z reklam kontekstowych lub z list odbiorców niestandardowych, w zależności od tego, skąd pochodzą reklamy zwycięskie.

Protected Audience na Androida automatycznie zwiększa wszystkie liczniki wymienione wcześniej w przypadku typu zdarzenia FrequencyCapFilters.AD_EVENT_TYPE_WIN dla reklam zwracanych przez wywołanie interfejsu API selectAds. Pod względem funkcjonalnym jest to równoznaczne z dodaniem argumentu prev_wins do argumentu browser_signals w funkcji generateBid w ramach implementacji Protected Audience w Chrome.

Krok 3. Wdróż filtrowanie według limitu wyświetleń za pomocą filtrów

Aby zapewnić optymalną wydajność, funkcja filtrowania limitu częstotliwości jest wykonywana w ramach AdServices. Protected Audience rozpoznaje, czy wiadomość musi zostać odfiltrowana, na podstawie pola filtrów w obiekcie AdsData. Lista filtrów jest podana w parametry frequency_cap. Wartości klucza, event_type i interval_in_seconds służą do pobierania histogramu zdarzeń, które są używane do filtrowania i Protected Audience.

Informacje do filtrowania można określić w przypadku reklam remarketingowych dostarczanych przez listę odbiorców niestandardowych oraz w przypadku reklam kontekstowych w ramach obiektu AdSelectionConfig.

W przypadku reklam kontekstowych z filtrami limitu wyświetleń reklamy są przekazywane za pomocą pola ads w obiekcie AdSelectionConfig. Reklamy są odfiltrowywane, a w wyniku wywołania metody selectAds zwracana jest reklama z najwyższą stawką.

W przypadku reklam remarketingowych z filtrami limitu wyświetleń reklamy są filtrowane przed wywołaniem funkcji JavaScript generateBid() dostarczonej przez kupującego.

Ten przykład pokazuje wiadomość z filtrowaniem według limitu wyświetleń:

{
  'render_url': 'url',
  'metadata': {...},   /* metadata are opaque to Protected Audience and assumed
                        to be in valid JSON format */

  'ad_counter_keys': [1234, 5678],

  "filters": {
    "frequency_cap": {
      "view": [
        {
          "ad_counter_key": 1234
          "max_count": 10,
          "interval_in_seconds": 86400
        },
        {
          "ad_counter_key": 5678
          "max_count": 10,
          "interval_in_seconds": 86400
        },
      ],
      "win": [
        {
          "ad_counter_key": 1234
          "max_count": 5,
          "interval_in_seconds": 604800
        },
        {
          "ad_counter_key": 5678
          "max_count": 5,
          "interval_in_seconds": 345600
        },
      ]
    },

  // This field is only required in contextual ads and is used in
  // reportImpression calls to fetch the reportWin function.
  'reportingJS': "https://ads.example.com?reportWin.js"
}

Krok 4. Zgłoś zwycięskie reklamy

Po zakończeniu procesu wyboru reklamy zwraca obiekt AdSelectionOutcome zawierający renderUri i adSelectionId, czyli numeryczny identyfikator wywołania funkcji selectAds. Ten identyfikator może służyć do wywoływania interfejsu API reportImpression, który obsługuje raportowanie na poziomie zdarzenia. W wersji beta 1 ta metoda obsługuje raportowanie reklam remarketingowych. W późniejszej wersji zostanie rozszerzona o raportowanie reklam kontekstowych. W przypadku reklam kontekstowych kupujący musi wskazać, gdzie podczas wywołania funkcji reportWin można pobrać funkcję reportWin, używając w strukturze reklamy dodatkowego pola o nazwie reportingJS, jak pokazano w poprzednim przykładzie.reportImpression

Sprawdzone metody wybierania reklam docelowych

Zabezpieczenie Protected Audience przenosi wyegzekwowanie ograniczenia liczby wyświetleń z serwera na urządzenie. Chociaż wygrane stawki są raportowane w Piaskownicy prywatności, deweloperzy nie będą wiedzieć, dlaczego reklama się nie wyświetla. Reklamy mogą się nie wyświetlać z powodu przegranego przetargu lub ograniczenia liczby wyświetleń na użytkownika. Ponieważ nie mamy pełnej wiedzy o przyczynach, dla których niektóre reklamy nie wygrywają, systemy ustalania stawek wymagają dodatkowej pracy, aby wyświetlać optymalne reklamy. Te sprawdzone metody pomogą Ci zapewnić optymalne wyświetlanie reklam za pomocą Protected Audience.

Wysyłanie wystarczającej liczby reklam remarketingowych

Reklam remarketingowych nie można optymalizować pod kątem poszczególnych użytkowników. Jeśli użytkownik widzi znaczną liczbę reklam z listy odbiorców niestandardowych, a limity reklam są niskie, wszystkie reklamy mogą zostać odfiltrowane. Reklamy remarketingowe są okresowo odświeżane, dlatego aby zapewnić wyświetlanie reklam remarketingowych, należy uwzględnić w ograniczeniach liczby wyświetleń wystarczającą liczbę zasobów reklamowych. Należy to zrównoważyć z ograniczeniami dotyczącymi rozmiaru reklam, które można określić podczas wywołania funkcji joinCustomAudience i podczas codziennej aktualizacji listy odbiorców niestandardowych. Kupujący muszą wziąć pod uwagę, że w trakcie fazy licytacji może wystąpić zwiększenie opóźnienia. Aby zminimalizować wpływ tych problemów, filtrowanie limitu wyświetleń na użytkownika jest wykonywane przed wywołaniem funkcji generateBid.

Przechowywanie liczników kontekstowych na serwerze

Dzięki oszacowaniu po stronie serwera deweloper może uzyskać przybliżone informacje o tym, kiedy może być aktywne ograniczenie częstotliwości wyświetleń. Te oszacowania mogą wskazywać, że reklama osiągnęła prawdopodobny próg limitu wyświetleń, dlatego należy wysłać więcej kandydatów na reklamy lub całkowicie wyeliminować reklamę.

Wysyłanie wielu kandydatów na reklamy w ramach odpowiedzi kontekstowej

Przed aukcją Protected Audience należy wysłać kilka kandydatów na reklamę z odpowiedzią kontekstową. Dzięki temu, jeśli zostanie odfiltrowanych kilka reklam, inne będą się nadal wyświetlać. Reklamy docelowe można ustawić w kolejności priorytetów, tak aby niektóre reklamy były wyświetlane jako rezerwowe.

Ponieważ realizacja jest ograniczona czasowo, reklamy docelowe powinny być wybierane na podstawie prawdopodobieństwa wygrania aukcji i nieodfiltrowania.

Ograniczenia

Oto znane ograniczenia dotyczące ograniczenia liczby wyświetleń w Protected Audience:

1. Ograniczenie liczby wyświetleń w przypadku chronionych list odbiorców działa na poziomie profilu użytkownika na urządzeniu, bez udostępniania liczników na innych urządzeniach i profilach. W razie potrzeby należy ręcznie uwzględnić wszelkie wzrosty liczby wyświetleń reklam z innych urządzeń.
2. Liczniki urządzenia są przechowywane na urządzeniu i dostęp do nich jest uzyskiwany na urządzeniu. Liczniki po stronie serwera wymagają osobnego zarządzania.
3. Ograniczenie liczby wyświetleń i powiązane z nim filtrowanie reklam są przetwarzane na urządzeniu, więc platformy technologiczne nie mają bezpośredniej kontroli nad tymi operacjami. Aby obejść próg częstotliwości wyświetlania na urządzeniu, platformy technologiczne mogą wysyłać wiele reklam z różnymi filtrami.
4. Dostosowania stawek na podstawie zarejestrowanej częstotliwości nie są obsługiwane. Funkcje generateBid nie mogą wyświetlać liczników częstotliwości.