Ograniczenie liczby wyświetleń w ramach Protected Audience API

Ograniczenie liczby wyświetleń to działanie reklamowe, które polega na ograniczaniu liczby reklam z danej kategorii wyświetlanych użytkownikowi w danym okresie. Ograniczenie liczby wyświetleń polepsza wrażenia użytkowników, dzięki czemu reklamy są aktualne i ciekawe, a reklamodawcy mogą zarządzać wydatkami na reklamę.

Ta oferta przedstawia, w jaki sposób można wykorzystać Protected Audience na Androidzie do dokładnego i zachowania prywatności w ramach ograniczania liczby wyświetleń.

Protected Audience stosuje ograniczenie liczby wyświetleń, łącząc 2 funkcje: przechowywanie liczników zdarzeń na urządzeniu dla zdarzeń związanych z reklamą oraz możliwość filtrowania reklam zgodnie ze wstępnie zdefiniowanym zestawem strategii filtrowania. Ograniczenie liczby wyświetleń umożliwia reklamodawcom określenie wartości progowej licznika względem sumy wartości histogramu w danym okresie.

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. Dla każdego klucza Protected Audience przechowuje zestaw liczników, a każdy z nich zlicza wszystkie zdarzenia związane z reklamą, które wystąpiły w określonym przedziale czasu. Liczniki na urządzeniu zwiększają się po wyświetleniu lub wyświetleniu, a dane z licznika są zapisywane na urządzeniu. Dokładny czas przechowywania zostanie określony później.

Mechanizm filtrowania reklam w ramach procesu wyboru reklamy w ramach Protected Audience API ma dostęp do liczników, reklam remarketingowych i reklam kontekstowych, dzięki czemu funkcja ta może działać ze wszystkimi typami żądań reklamy.

Uwaga: na urządzeniach z Androidem filtrowanie reklam jest dostępne tylko w Piaskownicy prywatności. Implementacja Protected Audience API w Chrome nie obejmuje obecnie mechanizmu filtrowania kierowanych kontekstowo reklam bez tej funkcji. Ta oferta obejmuje tylko pomoc po stronie kupującego. Jeśli pojawi się popyt, dodamy je w późniejszym czasie.

Ograniczenie liczby wyświetleń w ramach Protected Audience API obsługuje szeroki zakres wymagań, m.in.:

  • Filtrowanie w czasie rzeczywistym z minimalnym opóźnieniem po stronie serwera podczas aktualizacji liczników na urządzeniu.
  • Elastyczna hierarchia kluczy, m.in. poszczególne reklamy, kampanie i dowolne inne grupy.
  • zgodność z innymi metodami ograniczania liczby wyświetleń, bez zależności od AdID.
  • Działa we wszystkich aplikacjach na danym profilu użytkownika urządzenia.
  • Dokładne i pełne liczniki.
  • Obsługa niestandardowych definicji zdarzeń reklamowych, np. obejrzeń czy wyświetleń.
  • Jedna funkcja zarówno dla reklam remarketingowych, jak i kontekstowych.

Aby skonfigurować ograniczenie liczby wyświetleń:

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

Reklamy kontekstowe i remarketingowe wskazują odpowiednie liczniki histogramu, które są aktualizowane w przypadku wyświetlenia lub obejrzenia, korzystając z pola ad_counter_keys, które zawiera listę dowolnej liczby całkowitej. To pole nie znajduje się w polu metadata, które nie jest analizowane przez Protected Audience.

Poniższy przykład przedstawia format danych w polu adsData w AdSelectionConfig. W przypadku remarketingu format listy reklam dla danej niestandardowej grupy odbiorców jest zgodny z treścią pola ads 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 obejrzenie lub wyświetlenie

Technologie reklamowe mogą wywoływać metodę updateAdCounterHistogram, aby rejestrować wystąpienia zdarzeń wykorzystywanych do ograniczania liczby wyświetleń. Metoda może być wywoływana wielokrotnie po tym samym zdarzeniu dla kluczy określonych w parametrze eventType zwycięskiej reklamy.

void updateAdCounterHistogram(@EventType eventType, long adSelectionId)

Wejścia:

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

Wywołanie updateAdCounterHistogram aktualizuje histogram zestawu kluczy określonych jako część reklam remarketingowych pobranych przez CustomAudience lub reklam kontekstowych uwzględnionych w parametrze AdSelectionConfig dla selectAds.

Jeśli założysz, że reklama w kroku 1 wygrywa z AdSelection z wartością id równą 9999, wywołanie metody updateAdCounterHistogram(FrequencyCapFilters.AD_EVENT_TYPE_VIEW, adSelectionId: 999) zwiększa liczbę liczników dla tych 3 kluczy podstawowych:

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

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

Protected Audience na Androida automatycznie zwiększa wartości wszystkich wymienionych powyżej liczników dla typu zdarzenia FrequencyCapFilters.AD_EVENT_TYPE_WIN w przypadku reklam zwracanych przez wywołanie interfejsu API selectAds. Jest to funkcjonalnie odpowiednik dodania argumentu prev_wins do funkcji browser_signals w generateBid w implementacji Protected Audience w Chrome.

Krok 3. Zaimplementuj filtrowanie limitu wyświetleń na użytkownika za pomocą filtrów

Aby uzyskać optymalną skuteczność, funkcja filtrowania limitu wyświetleń na użytkownika jest wykonywana wewnątrz elementu AdServices. Protected Audience rozumie, odczytując pole filtrów w obiekcie AdsData. Listę filtrów można określić w polu frequency_cap. Wartości klucza event_type i interval_in_seconds służą do pobierania histogramu zdarzeń wykorzystywanych do filtrowania i ochrony odbiorców.

Informacje o filtrowaniu można podać na potrzeby reklam remarketingowych dostarczanych przez niestandardową grupę odbiorców oraz dla reklam kontekstowych w ramach obiektu AdSelectionConfig.

W przypadku reklam kontekstowych z filtrami limitu wyświetleń reklamy są przekazywane za pomocą pola reklam w obiekcie AdSelectionConfig. Reklamy są filtrowane i w wyniku wywołania 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() dostarczanej przez kupującego.

Ten przykład pokazuje wiadomość z filtrowaniem limitu wyświetleń na użytkownika:

{
  '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. Raport o zwycięskich reklamach

Po zakończeniu procesu wyboru reklamy zwraca obiekt AdSelectionOutcome zawierający renderUri i adSelectionId, czyli numeryczny identyfikator wywołania selectAds. Można go używać do wywoływania interfejsu API reportImpression, który obecnie obsługuje raportowanie na poziomie zdarzenia. W wersji beta 1 ta metoda obsługuje raportowanie reklam remarketingowych, a w kolejnej wersji zostanie dodana do funkcji raportowania reklam kontekstowych. W przypadku reklam kontekstowych kupujący musi wskazać, gdzie można pobrać funkcję reportWin podczas wywołania reportImpression, korzystając w strukturze reklamy z dodatkowego pola o nazwie reportingJS (jak w przykładzie powyżej).

Sprawdzone metody wyboru kandydatów reklamy

W ramach Protected Audience wymuszanie ograniczenia liczby wyświetleń jest przenoszone z serwera na urządzenie. Mimo że zwycięskie stawki są raportowane w Piaskownicy prywatności, deweloperzy nie wiedzą, dlaczego reklama się nie wyświetla. Reklamy mogą się nie wyświetlać z powodu utraty stawki lub ograniczenia liczby wyświetleń. Systemy ustalania stawek nie mają pełnego wglądu w przyczyny, dla których określone reklamy nie wygrywają, dlatego wymagają dodatkowych działań, aby zapewnić optymalne wyświetlanie reklam. Te sprawdzone metody pomogą Ci zoptymalizować wyświetlanie reklam w ramach Protected Audience API.

Wyślij wystarczającą liczbę reklam remarketingowych

Nie można optymalizować reklam remarketingowych pod kątem użytkownika. Jeśli użytkownik zobaczy dużą liczbę reklam z grupy niestandardowych odbiorców, a limity reklam będą niskie, możemy odfiltrować wszystkie reklamy. Reklamy remarketingowe są odświeżane okresowo, więc aby zapewnić ciągłość wyświetlania reklam, należy stosować ograniczenie liczby wyświetleń do odpowiedniej ilości 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 niestandardowych odbiorców. Kupujący muszą wziąć pod uwagę, że na etapie ustalania stawek może wystąpić wzrost opóźnienia. Aby zminimalizować wpływ tych problemów, filtrowanie limitu wyświetleń na użytkownika odbywa się przed wywołaniem funkcji generateBid.

Pozostaw liczniki kontekstowe na serwerze

Dzięki szacowaniu po stronie serwera deweloper może uzyskać przybliżone oszacowania, kiedy ograniczenie liczby wyświetleń może być aktywne. Oszacowania te mogą wskazywać, że reklama prawdopodobnie osiągnęła próg limitu wyświetleń na użytkownika i dlatego należy ją wysłać z większą liczbą kandydatów lub zostać całkowicie wyeliminowana.

Wysyłanie wielu kandydatów reklamy w odpowiedzi kontekstowej

Przed aukcją w ramach Protected Audience API musisz wysłać do wielu kandydatów reklamy z odpowiedzią kontekstową. Dzięki temu po odfiltrowaniu kilku reklam pozostałe reklamy nadal będą się wyświetlać. Kandydaci do reklam mogą mieć priorytet, dzięki czemu niektóre reklamy będą wyświetlane jako zapasowe.

Ponieważ realizacja jest ograniczona w czasie, kandydatów na reklamę należy wybierać na podstawie prawdopodobieństwa wygranej w aukcji.

Ograniczenia

Oto znane ograniczenia liczby wyświetleń w ramach Protected Audience API:

  1. Ograniczenie liczby wyświetleń w ramach Protected Audience API działa na poziomie profilu użytkownika urządzenia i nie ma wspólnych liczników na innych urządzeniach ani w innych profilach. W razie potrzeby przyrost liczby reklam wyświetlanych z innych urządzeń należy dodać ręcznie.
  2. Liczniki urządzeń są przechowywane i dostępne na urządzeniu. Licznikami po stronie serwera trzeba zarządzać oddzielnie.
  3. Ograniczenie liczby wyświetleń i powiązane z nim filtrowanie reklam są przetwarzane na urządzeniu, więc platformy technologii reklamowych nie mają bezpośredniej kontroli nad tymi operacjami. Aby ominąć wartość progową ograniczenia liczby wyświetleń na urządzeniu, platformy technologii reklamowych mogą wysyłać wiele reklam kandydujących 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.