Ograniczenie liczby wyświetleń w ramach Protected Audience API

Ograniczenie liczby wyświetleń to praktyka, która ogranicza liczbę reklam kategorii reklam wyświetlanych użytkownikowi w danym okresie. Częstotliwość poprawia wrażenia użytkowników, bo reklamy są aktualne i i ułatwia reklamodawcom zarządzanie wydatkami na reklamę.

Ta oferta przedstawia, jak można wykorzystać Protected Audience API na Androida do: implementować funkcję ograniczania liczby wyświetleń w celu dokładnego sposób.

Funkcja Protected Audience API wprowadza ograniczenie liczby wyświetleń, łącząc 2 funkcje: przechowywanie na urządzeniu liczników zdarzeń związanych z reklamami oraz filtrowanie reklam według wstępnie zdefiniowanego zestawu strategii filtrowania. Ograniczenie liczby wyświetleń umożliwia reklamodawcom określenie wartości progowej licznika na sumie histogramu dla danego okresu.

Liczniki są unikalne dla każdej kombinacji profilu urządzenia, technologii reklamowej i licznika . Każda reklama powinna zawierać zestaw kluczy licznika, które mogą być używane w przypadku wyświetlenia lub wyświetlenia reklamy. W przypadku każdego klucza Protected Audience przechowuje i z nich zlicza, przy czym każdy z nich zlicza wszystkie w określonym przedziale czasu. Liczniki na urządzeniu są zwiększane, gdy wyświetlenie lub obejrzenie reklamy, a dane z licznika zostaną zachowane na urządzeniu. dokładny czas trwałości zostanie zdefiniowany później.

Logika filtrowania reklam w procesie wyboru reklam w ramach Protected Audience API obejmuje dostęp do liczników zdarzeń, reklam remarketingowych i reklam kontekstowych, Ograniczenie liczby odbiorców pozwala wyświetlać reklamy każdego typu żądań.

Uwaga: filtrowanie reklam jest dostępne tylko w Piaskownicy prywatności na urządzeniach z Androidem. Funkcja Protected Audience API w Chrome nie implementuje obecnie mechanizmu filtrowania kierowanych kontekstowo reklam bez ochrony odbiorców. Ten oferta obejmuje tylko pomoc po stronie kupującego. Jeśli jest popyt, dodamy pomocy w późniejszym terminie.

Ograniczenie liczby wyświetleń w ramach Protected Audience API obsługuje wiele wymagań, w tym:

  • Filtrowanie w czasie rzeczywistym z minimalnym opóźnieniem po stronie serwera, gdy liczniki zdarzeń na urządzeniu są aktualizowane.
  • Elastyczna hierarchia kluczy, w tym poszczególne reklamy, kampanie i inne grupowania.
  • Zgodność z innymi metodami ograniczania liczby wyświetleń bez zależności od AdID.
  • Działa w różnych aplikacjach na danym profilu użytkownika urządzenia.
  • Dokładne i kompletne liczniki.
  • Obsługa niestandardowych definicji zdarzeń reklamowych, takich jak obejrzenia lub wyświetlenia.
  • Jedna funkcja zarówno do remarketingu, jak i reklam kontekstowych.

Aby ustawić ograniczenie liczby wyświetleń:

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

Reklamy kontekstowe i remarketingowe wskazują odpowiednie liczniki histogramów, które należy zaktualizować dla obejrzenia lub wyświetlenia korzystającego z pola ad_counter_keys, które zawiera listę dowolnej liczby całkowitej. Pole nie znajduje się w sekcji metadata, które nie jest analizowane przez Protected Audience API.

Poniżej znajduje się przykład formatu danych dla pola adsData w AdSelectionConfig W przypadku remarketingu jest to format listy reklam danej reklamy niestandardowa lista odbiorców jest zgodna z zawartością pola ads pokazanego w następujący przykład:

'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

Techniki reklamowe mogą wywoływać metodę updateAdCounterHistogram w celu rejestracji. zdarzeń używanych do ograniczania liczby wyświetleń. Metodą może być wywoływana wielokrotnie dla tego samego zdarzenia dla kluczy określonych w zwycięskiej reklamie. eventType

void updateAdCounterHistogram(@EventType eventType, long adSelectionId)

Dane wejściowe:

  • eventType: wskazuje, czy zdarzenie jest liczone jako wyświetlenie, wyświetlenie, kliknięcie czy wygraną w procesie wyboru reklamy.
  • adSelectionId: wartości identyfikatora w obiekcie AdSelectionOutcome, które są zwróconych przez tyle połączeń: selectAds.
.

Wywołanie updateAdCounterHistogram aktualizuje histogram dla zestawu kluczy zdefiniowane jako część reklam remarketingowych pobranych przez CustomAudience lub reklamy kontekstowe uwzględnione w parametrze AdSelectionConfig dla argumentu selectAds

Jeśli założysz, że reklama z kroku 1 wygrywa AdSelection z parametrem Wartość id parametru 9999, wywołanie do updateAdCounterHistogram(FrequencyCapFilters.AD_EVENT_TYPE_VIEW, adSelectionId: 999) zwiększa liczniki trzech następujących wartości głównych Klucze:

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

Nazwa technologii reklamowej pochodzi z pola kupującego – może pochodzić z reklam kontekstowych lub za pomocą niestandardowych odbiorców, w zależności od tego, skąd pochodzą zwycięskie reklamy.

Protected Audience na Androida automatycznie zwiększa wartość wszystkich liczników wymienionych powyżej dla typu zdarzenia FrequencyCapFilters.AD_EVENT_TYPE_WIN dla reklam zwracanych przez wywołanie interfejsu API selectAds. Jest to odpowiednik funkcji dodanie argumentu prev_wins do funkcji browser_signals w generateBid w Implementacja z Protected Audience API 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 w AdServices Funkcja Protected Audience API określa, czy wiadomość musi być filtrowana według odczytuje pole filtrów w obiekcie AdsData. Lista filtrów to określono w funkcji frequency_cap. Wartości klucza, event_type i interval_in_seconds służy do pobierania histogramu użytych zdarzeń do filtrowania i udostępniania w ramach Protected Audience API.

Informacje filtrowania mogą być określone dla reklam remarketingowych dostarczane przez niestandardowy odbiorców i reklam kontekstowych w ramach obiektu AdSelectionConfig.

W przypadku reklam kontekstowych z filtrami limitu wyświetleń na użytkownika reklamy są przekazywane za pomocą reklam w obiekcie AdSelectionConfig. zostały odfiltrowane, a reklama z tagiem w wyniku wywołania funkcji selectAds zwracana jest najwyższa stawka.

W przypadku reklam remarketingowych z filtrami limitu wyświetleń reklamy są filtrowane przed jest wywoływana funkcja JavaScript generateBid() udostępniona przez kupującego.

Poniższy przykład przedstawia komunikat 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. Utwórz raport na temat zwycięskich reklam

Po zakończeniu procesu wyboru reklamy wyświetla się komunikat AdSelectionOutcome. obiekt zawierający renderUri i adSelectionId, liczbowy identyfikator połączenia selectAds. Tego identyfikatora można użyć do wywołania interfejsu API reportImpression która obecnie obsługuje raportowanie na poziomie zdarzenia. W wersji beta 1 ta metoda obsługuje w raportach dotyczących reklam remarketingowych i zostanie rozszerzona o obsługę raportów dotyczących reklam kontekstowych w przyszłej wersji. W przypadku reklam kontekstowych kupujący musi: wskazują, gdzie można pobrać funkcję reportWin podczas reportImpression wywołania przy użyciu dodatkowego pola o nazwie reportingJS w reklamie jak widać w przykładzie powyżej.

Sprawdzone metody wyboru kandydatów do reklam

w ramach Protected Audience API przenosimy egzekwowanie ograniczenia liczby wyświetleń z serwera na urządzenia. Zwycięskie stawki są zgłaszane przez Piaskownicę prywatności, deweloperzy nie będą wiedzieć, dlaczego reklama nie została wyświetlona. Reklamy mogą nie być wyświetlane z powodu: utraconą stawkę lub z powodu ograniczenia liczby wyświetleń. Brak pełnego wglądu w przyczyny dlaczego niektóre reklamy nie wygrywają, systemy określania stawek wymagają dodatkowych działań, wyświetlane są optymalne reklamy. Te sprawdzone metody pomogą zapewnić optymalne wyświetlanie reklam w ramach Protected Audience API.

Wyślij wystarczającą liczbę reklam remarketingowych

Reklamy remarketingowe nie mogą być optymalizowane pod kątem poszczególnych użytkowników. Jeśli użytkownik zobaczy znaczną niestandardowych odbiorców, a limity reklam są niskie, wszystkie zostały odfiltrowane. Reklamy remarketingowe są odświeżane okresowo, co zapewnia wystarczającą ilość zasobów reklamowych muszą przejść przez ograniczenie liczby wyświetleń, aby reklamy remarketingowe . Trzeba to zrównoważyć ograniczeniami rozmiaru reklam, można określić podczas wywołania joinCustomAudience oraz podczas codzienną aktualizację odbiorców. Kupujący muszą wziąć pod uwagę, że może wystąpić wzrost czas oczekiwania w fazie określania stawek. 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 szacowaniu po stronie serwera deweloper może oszacować, kiedy ograniczenie liczby wyświetleń może być aktywne. Szacunki te mogą wskazywać, że reklama ma prawdopodobnie osiągnie limit wyświetleń na użytkownika, więc powinien być wysyłany z większą lub zostać całkowicie wyeliminowane.

Wysyłanie wielu kandydatów do reklam w odpowiedzi kontekstowej

Wiele propozycji reklam wraz z odpowiedzią kontekstową należy wysłać przed aukcja z Protected Audience API. Dzięki temu w przypadku odfiltrowania kilku reklam inne reklamy są nadal wyświetlane. Kandydaci mogą być traktowani priorytetowo, dzięki czemu niektóre reklamy są udostępniane.

Ponieważ realizacja jest ograniczona czasowo, kandydatury należy wybierać według prawdopodobieństwo wygrania aukcji i uniknięcia odfiltrowania.

Ograniczenia

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

  1. Ograniczenie liczby wyświetleń w ramach Protected Audience API działa na profilu użytkownika urządzenia bez wspólnych liczników na innych urządzeniach i w innych profilach. Dowolne liczby reklam wyświetlanych z innych urządzeń trzeba włączyć ręcznie, w razie potrzeby.
  2. Liczniki urządzeń są przechowywane na urządzeniu i mają na nim dostęp. Liczniki po stronie serwera którymi trzeba zarządzać oddzielnie.
  3. Podczas przetwarzania na urządzeniu ograniczenia liczby wyświetleń i powiązanego z nim filtrowania reklam platformy technologiczne nie mają bezpośredniej kontroli nad tymi operacjami. Aby ominąć do osiągnięcia limitu wyświetleń na użytkownika, platformy technologii reklamowych 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.
. .