Dopasowywanie plików cookie

Dopasowywanie plików cookie to funkcja, która umożliwia dopasowanie pliku cookie (np. identyfikatora użytkownika przeglądającego Twoją witrynę) do odpowiedniego identyfikatora użytkownika Google konkretnego licytującego i tworzenie list użytkowników, które ułatwiają podejmowanie trafniejszych decyzji dotyczących określania stawek. W tym przewodniku omawiamy pojęcia związane z dopasowywaniem plików cookie i różne procesy dopasowywania plików cookie oraz wszelkie ich odmiany w określonych przypadkach użycia.

Pojęcia

Właściciele domen zwykle ustawiają zawartość plików cookie dla użytkowników przeglądających ich witryny, które służą do identyfikowania użytkowników w danej domenie. Nawet jeśli dwóch właścicieli domen zgodzi się na wymianę tych danych, model zabezpieczeń przeglądarek internetowych ogranicza możliwość odczytu pliku cookie umieszczonego przez inną domenę.

W kontekście reklamy internetowej Google identyfikuje użytkowników za pomocą plików cookie z domeny doubleclick.net, a licytujący uczestniczący w określaniu stawek w czasie rzeczywistym mogą mieć własną domenę, w której identyfikują grupę użytkowników, którym chcą wyświetlać reklamy. Dopasowywanie plików cookie umożliwia licytującemu dopasowanie swoich plików cookie do plików Google, dzięki czemu może on określić, czy wyświetlenie wysłane w pytaniu o stawkę jest powiązane z jednym z użytkowników objętych kierowaniem. Otrzyma on w pytaniu o stawkę albo własne dane plików cookie, albo identyfikator użytkownika Google (osobny licytującego), który jest zaszyfrowany.doubleclick.net

Opisana w tym przewodniku usługa dopasowywania plików cookie ułatwia tworzenie i utrzymywanie powiązania między plikiem cookie licytującego a identyfikatorem użytkownika Google oraz uzupełnianie list użytkowników.

Tabele odpowiedników

Tabela odpowiedników może służyć do mapowania identyfikatora lub innych danych z jednej domeny na drugą. Licytujący mogą korzystać z usługi dopasowywania plików cookie, aby wypełniać własne tabele odpowiedników, mapując plik cookie danego użytkownika na jego identyfikator użytkownika Google lub wypełniając tabelę odpowiedników hostowaną przez Google. Tabele odpowiedników są niezbędne, aby aplikacja licytującego mogła uzyskać dostęp do danych z plików cookie użytkownika, który wyświetlił wyświetlenie.

Tabele odpowiedników hostowane przez Google

Aby ułatwić konserwację, skrócić czas oczekiwania oraz uzyskać dostęp do danych dopasowywania w przypadku użytkowników w określonych regionach, zalecamy zezwolenie na hostowanie Twojej tabeli odpowiedników przez Google. Dzięki temu możesz określić bezpieczny w internecie ciąg zakodowany w standardzie base64 (nazywany dalej hostowanymi danymi dopasowania), który będzie zmapowany na identyfikator użytkownika Google dotyczący danego użytkownika. Po znalezieniu dopasowania można go użyć w następujący sposób:

  • Określanie stawek w czasie rzeczywistym: w kolejnych pytaniach o stawkę za wyświetlenia powiązane z użytkownikiem Google wyśle Ci hostowane dane dopasowania dopasowane do jego identyfikatora użytkownika Google. Jeśli punkt końcowy określania stawek jest skonfigurowany do używania protokołu RTB Google, otrzymasz tę wartość jako zdekodowane bajty w polu BidRequest.hosted_match_data. W Google implementacji OpenRTB BidRequest.user.buyeruid zwraca te dane w postaci bezpiecznego dla internetu ciągu zakodowanego w standardzie base64.

  • Listy użytkowników: listy użytkowników mogą być wypełniane identyfikatorami użytkowników Google lub hostowanymi danymi dopasowania.

  • Kierowanie wstępne: możesz skonfigurować kierowanie wstępne tak, aby otrzymywać tylko pytania o stawkę zawierające hostowane dane dopasowania. Może to służyć do eliminowania mniej trafnych wyświetleń w przypadku użytkowników spoza Twojej przestrzeni plików cookie.

Listy użytkowników

Listy użytkowników można tworzyć i nimi zarządzać za pomocą interfejsu API określania stawek w czasie rzeczywistym. Po utworzeniu tych list możesz je uzupełnić, korzystając z procedur dopasowywania plików cookie opisanych poniżej lub korzystając z usługi przesyłania zbiorczego.

Pierwsze kroki

Aby zacząć korzystać z dopasowywania plików cookie, musisz skontaktować się z technicznym menedżerem konta, który może włączyć określone przepływy pracy i skonfigurować te elementy:

  • Identyfikator sieci dopasowywania plików cookie (NID): identyfikator ciągu znaków jednoznacznie identyfikujący konto licytującego na potrzeby dopasowywania plików cookie i innych powiązanych operacji.
  • URL dopasowywania plików cookie: podstawowy adres URL punktu końcowego, który akceptuje i obsługuje przychodzące żądania w ramach przepływów pracy dopasowywania plików cookie. Licytujący mogą umieszczać w tym adresie URL makra, aby kontrolować kolejność parametrów przekazywanych do niego w procesach dopasowywania plików cookie.
  • Tag dopasowania: tag, który musisz umieścić w przeglądarce użytkownika, aby umożliwić proces dopasowywania plików cookie inicjowany przez licytującego. Treści te mogą być wyświetlane obok reklam lub umieszczane w usługach internetowych poza reklamami.
  • URL raportu o dopasowaniu plików cookie (opcjonalnie): w jednokierunkowym procesie dopasowywania plików cookie jest to opcjonalny adres URL, który można podać, aby określić punkt końcowy, który będzie otrzymywał szczegóły błędów, jeśli dopasowanie plików cookie nie powiedzie się poprzez przekierowanie HTTP 302. Domyślnie odpowiedzi będą wysyłane na ten adres URL tylko wtedy, gdy podczas operacji dopasowywania plików cookie wystąpił błąd, ale licytujący może poprosić, żeby przekierowanie było zawsze wysyłane.
  • URL wspomagania dopasowania plików cookie: w przypadku giełd wdrażających proces pomocy przy dopasowaniu plików cookie jest to podstawowy adres URL punktu końcowego, który ma odpowiadać na żądania przychodzące.
  • Limit wspomagania dopasowania plików cookie: w przypadku giełd implementujących proces pomocy w dopasowaniu plików cookie jest to maksymalna liczba żądań, które ich adres URL dopasowywania plików cookie może otrzymać w ciągu sekundy. Dzięki temu żądania CMA nie powodują przeciążenia serwerów giełdy żądaniami.

W każdym z obsługiwanych procesów dopasowywania plików cookie adres URL dopasowywania plików cookie licytującego ma zwykle dołączone parametry w kolejności niegwarantowanej. Licytujący z integracjami, które wymagają spójnej kolejności parametrów, mogą umieszczać makra w adresach URL dopasowywania plików cookie, aby zagwarantować ich miejsce docelowe.

Obsługiwane makra

Licytujący mogą opcjonalnie skonfigurować adres URL dopasowywania plików cookie, aby uwzględnić 1 lub więcej makr w postaci %%GOOGLE_<PARAM_NAME>%% lub %%GOOGLE_<PARAM_NAME>_PAIR%%. Obsługiwane makra i ich rozwinięte wartości to:

Makro Wartość rozwinięta
GOOGLE_GID GOOGLE_USER_ID
GOOGLE_GID_PAIR &google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_PAIR &cver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR ERROR_ID
GOOGLE_ERROR_PAIR &google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_PAIR &google_push=PIXEL_MATCH_DATA
GOOGLE_ALL_PARAMS google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID

Przykład makra

Licytujący ma integrację dopasowywania plików cookie z punktem końcowym hostowanym w https://user.bidder.com.cookies. Jego implementacja wymaga gotowych parametrów zdefiniowanych przez licytującego oprócz parametrów Pixel Matching w tej kolejności: google_push, google_gid, google_cver i google_error. Licytujący może to zrobić, ustawiając adres URL dopasowywania plików cookie na:

https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%

Gdy Google później wyśle do tego licytującego żądanie dopasowania, zostanie ono rozwinięte do takiego licytującego:

https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3

Usługa Google do dopasowywania plików cookie obsługuje obecnie 3 przepływy pracy dla różnych przypadków użycia opisanych poniżej.

Dwukierunkowe dopasowywanie plików cookie odnosi się do przepływu pracy inicjowanego przez licytującego, w którym w przeglądarce użytkownika jest umieszczany tag dopasowania przekierowujący go do Google. Ten przepływ pracy umożliwia Google i licytującemu wypełnianie tabel odpowiedników. Poniżej przedstawiamy prosty przykład tego procesu.

Krok 1. Umieść tag dopasowywania

Aby zainicjować ten proces, licytujący musi umieścić tag dopasowania w taki sposób, aby był renderowany w przeglądarce użytkownika. Prosty tag dopasowania, który zwraca licytującemu tylko identyfikator użytkownika Google, może mieć taką strukturę:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />

Tag dopasowania zawiera dodatkowe parametry, które spełniają różne warunki. Więcej informacji o tych parametrach znajdziesz w artykule Dopasuj parametry adresu URL tagu.

Krok 2. Google odpowiada za pomocą przekierowania z danymi dopasowania

Tag dopasowania sprawi, że usługa Google do dopasowywania plików cookie otrzyma z przeglądarki użytkownika żądanie, które spowoduje przekierowanie HTTP 302 do adresu URL dopasowywania plików cookie licytującego. Przekierowanie będzie uwzględniać parametry zapytania określające identyfikator użytkownika Google i numer jego wersji w adresie URL. Licytujący otrzyma też plik cookie umieszczony w nagłówkach żądania. W praktyce w przypadku adresu URL dopasowywania plików cookie określonego jako https://ad.network.com/pixel przekierowanie prostego tagu dopasowania, tak jak pokazano powyżej, może wyglądać tak:

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

Identyfikator użytkownika Google przekazywany przez parametr google_gid to bezpieczny w internecie ciąg zakodowany w formacie base64. Licytujący, którzy chcą hostować tabelę odpowiedników, powinni zapisać dokładny ciąg znaków zwrócony przez usługę dopasowywania plików cookie. W kolejnych pytaniach o stawkę będzie ona odpowiadać wartościom określonym przez BidRequest.google_user_id w protokole RTB Google lub BidRequest.user.id w implementacji OpenRTB Google.

Wersja podana w polu google_cver to numeryczny numer wersji identyfikatora użytkownika Google. Identyfikator użytkownika Google danego użytkownika rzadko się zmienia, a po jego upływie wartość ta będzie zwiększana.

Jeśli podczas przetwarzania żądania dopasowania Google napotka błąd, zamiast niego zostanie określony parametr google_error.

Krok 3. Proces licytującego przekierowuje ruch i odpowiada przy użyciu piksela

Licytujący otrzymuje przekierowanie na adres URL dopasowywania plików cookie zawierający parametry określone w pierwszym kroku i parametry podane przez Google w drugim kroku. Ponadto otrzymają pliki cookie w nagłówkach HTTP. Jeśli operacja się udała, licytujący hostujący własną tabelę odpowiedników może dopasować plik cookie do identyfikatora użytkownika Google zawartego w odpowiedzi. Zaleca się, aby licytujący zapisali dokładny ciąg znaków zwrócony przez usługę dopasowywania plików cookie.

Jeśli operacja się nie powiedzie, licytujący otrzyma parametr google_error. Jest to wartość liczbowa odpowiadająca różnym stanom błędu, który identyfikuje konkretny napotkany błąd. Więcej informacji o możliwych wartościach błędów znajdziesz tutaj. Jeśli pojawi się błąd, możesz spróbować ponownie dopasować dane tego użytkownika, umieszczając nowy tag dopasowania.

Licytujący musi zawsze odpowiedzieć, wyświetlając niewidoczny piksel 1 x 1 lub zamiast tego zwracać odpowiedź HTTP 204 Brak treści.

Ten przepływ pracy ilustruje poniższy schemat. Żądania i odpowiedzi są oznaczone strzałką, a towarzyszące im elementy danych – w nawiasach.

Dopasuj parametry adresu URL tagu

Parametr Opis
google_nid Identyfikator sieci (NID) na koncie licytującego. Ten identyfikator możesz pobrać za pomocą zasobu Licytujący.
google_cm Informuje usługę Google do dopasowywania plików cookie, że powinna przeprowadzać dopasowywanie plików cookie. Wartość tego parametru jest ignorowana i można ją pominąć.
google_sc Ten parametr został wycofany. Konfiguruje plik cookie Google dla użytkownika, jeśli plik cookie nie jest dostępny. Wartość tego parametru jest ignorowana i można ją pominąć. Jeśli nie ma pliku cookie, jego pominięcie spowoduje błąd.
google_no_sc Ten parametr został wycofany. Informuje to usługę Google do dopasowywania plików cookie, że nie powinna tworzyć plików cookie dla użytkownika, jeśli nie ma takiego pliku. Wartość tego parametru jest ignorowana i można ją pominąć.
google_hm

Dane, które licytujący chce zapisać w tabeli odpowiedników na serwerze Google.

Wartość jest ciągiem zakodowanym w internecie w formacie base64 (opcjonalne dopełnienie). Nieprzetworzone dane mogą mieć maksymalnie 40 bajtów. Na przykład: Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Ciąg zakodowany w adresie URL, który licytujący może określić, aby wskazać Google, że ma wysłać przekierowanie HTTP 302 na zakodowany adres URL w przypadku tego tagu dopasowania. Dzięki temu możemy umieścić Google na początku w łańcuchowym wywołaniu partnerów. Jeśli podasz błąd bez właściwości google_hm lub za pomocą google_cm, wystąpi błąd.
google_ula Ciąg tekstowy używany w celu dodania użytkownika do istniejącej listy użytkowników. Oczekiwany format wartości to userlistid[,timestamp]:
  • userlistid: pojedynczy numeryczny identyfikator listy użytkowników.
  • timestamp: opcjonalna sygnatura czasowa w formacie POSIX, wskazuje, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL może być powtarzany w celu dodania użytkownika do większej liczby list.
gdpr Wskazuje, że żądanie podlega ograniczeniom RODO dotyczącym użycia danych. Więcej informacji znajdziesz poniżej w sekcji Wymagania dotyczące zgody użytkownika z UE lub w artykule o wpływie na kwalifikowanie się do dopasowywania plików cookie w dokumentacji Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 w Authorized Buyers.

Przykład: gdpr=1
gdpr_consent ciąg tekstowy dotyczący przejrzystości i zgody, który reprezentuje zgodę użytkownika. Więcej informacji znajdziesz w sekcji Wymagania dotyczące zgody użytkownika z UE poniżej lub w sekcji W jaki sposób będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody? w dokumentacji Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 w Authorized Buyers.
process_consent Wskazuje, że licytujący uzyskał zgodę użytkownika na wykorzystanie danych zgodnie z polityką Google w zakresie zgody użytkownika z UE.

Jeśli żądanie nie podlega polityce w zakresie zgody użytkownika z UE lub jeśli zawiera ono inne parametry dotyczące zgody użytkownika (gdpr_consent), ten parametr jest ignorowany.

Przykład: process_consent=T

Oprócz powyższych parametrów licytujący mogą określić własne, które zostaną dołączone jako parametry do przekierowania. Pamiętaj, że parametry zdefiniowane przez licytujących o nazwach z prefiksem google_ będą ignorowane, ponieważ są zarezerwowane przez Google na potrzeby przyszłego rozwoju i zachowanie kolejności parametrów nie jest gwarantowane. Tag dopasowania zawierający parametry zdefiniowane przez licytującego może wyglądać tak:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />

Parametry adresu URL przekierowania

Przekierowanie jest tworzone na podstawie podstawowego adresu URL dopasowywania plików cookie skonfigurowanego na koncie licytującego, w tym parametru google_ i parametrów zdefiniowanych przez licytującego, w zależności od parametrów określonych w tagu dopasowania. Zdefiniowano te parametry odpowiedzi google_:

Parametr Opis
google_gid Identyfikator użytkownika Google. Ustaw, jeśli w żądaniu określono google_cm i żądanie zostało zrealizowane.
google_cver Wersja pliku cookie. Ustaw, jeśli w żądaniu określono google_cm i żądanie zostało zrealizowane.
google_error

Wartość całkowita wskazująca ogólny błąd żądania. Po otrzymaniu tego komunikatu oznacza to, że nie zostały wykonane żadne operacje i nie zostaną ustawione żadne inne parametry odpowiedzi google_. Obsługiwane wartości błędów:

  • 1: użytkownik ma plik cookie Google, ale zrezygnował ze śledzenia za jego pomocą.
  • 2: nie określono prawidłowych operacji, na przykład otrzymano żądanie no-op.
  • 3: użytkownik nie ma pliku cookie Google. Google nie będzie umieszczać pliku cookie za pomocą usługi dopasowywania plików cookie.
  • 4: podano operacje kolidujące. W tym samym żądaniu nie możesz określić jednocześnie flag google_push i google_cm, ponieważ mają one sprzeczne cele.
  • 5: w przekierowaniu na serwer Google został przekazany nieprawidłowy parametr google_push w ramach dwukierunkowego żądania dopasowania pikseli. Przekierowanie musi ustawić google_push na taką samą wartość, jaka została Ci przesłana w pierwszym żądaniu piksela.
  • 6: w tagu dopasowania podano nieprawidłowy identyfikator NID.
  • 7: wykryto nieprawidłowy plik cookie.
  • 8: wycofano. Nie znaleziono pliku cookie.
  • 9: nie znaleziono pliku cookie. Podejmowana jest próba ustawienia testowego pliku cookie.
  • 10: parametr google_redir został użyty bez określenia google_hm lub był używany razem z parametrem google_cm.
  • 15: żądanie pochodzi z regionu, w którym Google wymaga, aby tabela odpowiedników była hostowana przez Google. Dlatego ta odpowiedź nie zawiera identyfikatora użytkownika Google. Obecnie ta funkcja jest włączona w przypadku niewielkiego odsetka ruchu, ale planujemy ją w pełni włączyć w czerwcu 2020 r.
google_hm

Wyświetla się tylko wtedy, gdy próba zapisu w tabeli odpowiedników na serwerze Google nie powiedzie się. W takim przypadku wartością jest jeden z tych kodów stanu:

  • 1 – zabroniony: klient nie ma jeszcze uprawnień do zapisywania hostowanych wpisów w tabeli odpowiedników.
  • 2 – błąd dekodowania: nie udało się zdekodować wartości parametru.
  • 3 – ładunek zbyt długi: wartość parametru zdekodowana do ilości danych przekraczających 24 bajty.
  • 4 – błąd wewnętrzny: podczas zapisywania danych wystąpił błąd wewnętrzny.
  • 5 – Ograniczone: ten zapis nie został przetworzony z powodu ograniczenia.
google_ula

Stan operacji dodawania listy użytkowników, powtarzany, jeśli w żądaniu określono wiele elementów google_ula. Format to:
userlistid,status code

Np. google_ula=1234567890,0

Operacja google_ula może zwracać dowolny z tych kodów stanu:

  • 0 – brak błędów. Użytkownik został dodany do listy użytkowników.
  • 2 – odmowa dostępu. Nie masz uprawnień do dodawania użytkowników do danej listy użytkowników.
  • 5 – nieprawidłowy identyfikator listy użytkowników. Podany identyfikator listy użytkowników jest nieprawidłowy.
  • 6 – identyfikator zamkniętego atrybutu. Podany identyfikator listy użytkowników jest zamknięty.
  • 10 – błąd wewnętrzny. Usługa dopasowywania plików cookie napotkała błąd wewnętrzny. Możesz spróbować ponownie dopasować użytkownika.

W poniższych scenariuszach opisano, jak dopasowywanie plików cookie może wyglądać w przypadku typowego użytkownika przeglądającego stronę internetową.

Scenariusz 1. Użytkownik usuwa pliki cookie i przegląda witrynę

Janina czyści pamięć podręczną ze wszystkich plików cookie. Następnie odwiedzają stronę główną ExampleNews.com.

Jak to działa:

  1. ExampleNews.com renderuje i wywołuje reklamy z Google (Ad Manager).
  2. Jako że jednostka reklamowa kwalifikuje się do alokacji dynamicznej, Google wysyła pytania o stawkę do FinestDSP i innych licytujących za pomocą usługi określania stawek w czasie rzeczywistym.
  3. Aplikacja licytującego na platformie FinestDSP otrzymuje i przetwarza pytanie o stawkę oraz wysyła odpowiedź na stawkę.
  4. Google otrzymuje od licytujących odpowiedzi na stawki, w tym odpowiedź FinestDSP, która określa reklamę z tagiem dopasowania (pikselem).
  5. Aukcję wygrywa FinestDSP. Google wyświetla reklamę FinestDSP i dopasowuje tag do Janiny.
  6. Tag dopasowania wywołuje usługę Google Cookie Match, określając parametry google_nid i google_cm.
  7. Usługa dopasowywania plików cookie odczytuje plik cookie Janiny i wysyła jej przeglądarce przekierowanie do adresu URL dopasowywania plików cookie na platformie FinestDSP, używając zestawu parametrów google_user_id i google_cver.
  8. Przeglądarka Janiny wczytuje przekierowanie do adresu URL dopasowania plików cookie platformy FinestDSP.
  9. Punkt końcowy dopasowywania plików cookie FinestDSP przetwarza żądanie przekierowania, które zawiera parametry adresu URL ustawione przez Google i ich plik cookie dla Anny w nagłówkach HTTP. FinestDSP może teraz zapisywać mapowanie pliku cookie na element google_user_id w tabeli odpowiedników.
  10. FinestDSP odpowiada na przekierowanie niewidocznym pikselem 1 x 1.
Scenariusz 2. Użytkownik z istniejącym mapowaniem

Tydzień po scenariuszu 1 Janka ponownie odwiedza witrynę ExampleNews.com. Teraz, gdy Janina ma na komputerze zarówno pliki cookie licytującego, jak i plików cookie Ad Managera, zobaczmy, jak działa dopasowywanie.

  1. Strona internetowa się renderuje, przez co Google (Ad Manager) wysyła żądanie reklam, które zostaną wyrenderowane na stronie.
  2. Podczas aukcji reklam Google wysyła pytanie o stawkę do odpowiednich licytujących, w tym do FinestDSP.
  3. Platforma FinestDSP otrzymuje pytanie o stawkę, w tym sygnały takie jak google_user_id.
  4. FinestDSP wyszukuje w tabeli odpowiedników google_user_id i znajduje plik cookie powiązany z Anną, który został utworzony tydzień wcześniej (w scenariuszu 1).
  5. Na podstawie informacji powiązanych z plikiem cookie strategia ustalania stawek FinestDSP ustala stawkę za wyświetlenie i wygrywa aukcję.
  6. Janina może zobaczyć reklamę dopasowaną do jej zainteresowań na podstawie informacji posiadanych przez firmę FinestDSP.

Jednokierunkowe dopasowywanie plików cookie jest podobne do przepływu pracy dwukierunkowego, z tą różnicą, że zostało zmienione w taki sposób, że tylko Google hostuje i wypełnia tabelę odpowiedników. Można z niej korzystać w sytuacjach, gdy licytujący nie może hostować identyfikatorów użytkowników Google we własnej tabeli odpowiedników. Aby skorzystać z tego procesu, licytujący muszą zezwolić Google na hostowanie tabeli odpowiedników i nie mogą już określać pola google_cm w żądaniach wysyłanych do usługi dopasowywania plików cookie Google, co oznacza, że nie otrzymają parametru google_gid umożliwiającego wypełnienie własnej tabeli odpowiedników. Gdy Google ustali dopasowanie dla użytkownika, licytujący mogą dodać ich do list użytkowników, korzystając z własnych plików cookie. Podobnie pytania o stawkę w przypadku tych użytkowników nie uwzględniają identyfikatora User-ID Google, ale zawierają hostowane dane dopasowania. Poniżej znajdziesz podsumowanie prostego przykładu zmienionego przepływu pracy.

Aby zainicjować ten proces, licytujący musi umieścić tag dopasowania, który będzie renderowany w przeglądarce użytkownika. W przeciwieństwie do procedury w przypadku użytkowników spoza stanu USA, w których obowiązują ograniczenia dotyczące prywatności, tag dopasowania musi kierować przeglądarkę użytkownika na adres URL dopasowania plików cookie. Na przykład adres URL dopasowywania plików cookie skonfigurowany jako https://ad.network.com/pixel wygląda tak:

<img src="https://ad.network.com/pixel" />

Podczas wczytywania strony w przeglądarce użytkownika wysyła żądanie piksela z adresu URL dopasowywania plików cookie licytującego. Żądanie będzie zawierać ich plik cookie w nagłówku HTTP, który należy wyodrębnić na potrzeby następnego kroku.

Punkt końcowy dopasowywania plików cookie licytującego musi przekierowywać do usługi Google do dopasowywania plików cookie. Obejmuje to parametr google_hm uzupełniany danymi z plików cookie zakodowanych w internecie w standardzie base64. Może ono wyglądać tak:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

Google otrzyma przekierowanie zawierające określone przez Ciebie parametry oprócz pliku cookie Google w nagłówkach HTTP.

Krok 4. Google wyświetla piksel po wystąpieniu błędu lub przekierowaniu błędu, jeśli podano adres URL raportu

Jeśli operacja dopasowywania plików cookie się powiedzie – lub na koncie licytującego nie określono adresu URL raportu o dopasowywaniu plików cookie – Google domyślnie wyświetli przezroczysty piksel 1 x 1, a proces ten zakończy się tutaj. Wyświetlenia w przypadku tego użytkownika w kolejnych pytaniach o stawkę będą obejmować hostowane w BidRequest.hosted_match_data dane dopasowania licytującego lub BidRequest.user.buyeruid na potrzeby implementacji OpenRTB. Licytujący mogą też wypełniać listy użytkowników, korzystając z określonych przez siebie hostowanych danych dopasowania.

W przeciwnym razie, jeśli wystąpi błąd, Google wyśle przekierowanie na adres URL raportu o dopasowywaniu plików cookie licytującego z przyczyną błędu podaną w parametrze google_error. Jeśli adres URL raportu o dopasowywaniu plików cookie licytującego miał postać https://ad.network.com/report, przekierowanie wygląda tak:

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

Przeglądarka użytkownika przekieruje Cię na adres URL raportu o dopasowywaniu plików cookie licytującego, z uwzględnieniem przyczyny błędu (jeśli wystąpiło) podanej przez Google w parametrze google_error. Więcej informacji o interpretowaniu kodu błędu znajdziesz w opisie parametru.

Krok 6. Licytujący wyświetla przezroczysty piksel 1 x 1

Licytujący musi odpowiedzieć, wyświetlając w przeglądarce użytkownika przezroczysty piksel 1 x 1.

Domyślny przepływ pracy w przypadku użytkowników ze stanów w USA, w których obowiązują ograniczenia dotyczące prywatności, zilustrowano na diagramie poniżej. Żądania i odpowiedzi są oznaczone strzałką, a towarzyszące im elementy danych – w nawiasach.

Parametr Opis
google_nid Identyfikator sieci (NID) na koncie licytującego. Ten identyfikator możesz pobrać za pomocą zasobu Licytujący.
google_sc Ten parametr został wycofany. Konfiguruje plik cookie Google dla użytkownika, jeśli plik cookie nie jest dostępny. Wartość tego parametru jest ignorowana i można ją pominąć. Jeśli nie ma pliku cookie, jego pominięcie spowoduje błąd.
google_no_sc Ten parametr został wycofany. Informuje to usługę Google do dopasowywania plików cookie, że nie powinna tworzyć plików cookie dla użytkownika, jeśli nie ma takiego pliku. Wartość tego parametru jest ignorowana i można ją pominąć.
google_hm

Zawiera dane, które licytujący chce zapisać w tabeli odpowiedników hostowanej przez Google.
google_redir Zakodowany adres URL, pod którym Google ma wysłać przekierowanie HTTP 302. Podany adres URL będzie otrzymywać przekierowania z parametrem google_error zarówno w przypadku błędów, jak i udanych operacji.
google_ula Ciąg tekstowy używany w celu dodania użytkownika do istniejącej listy użytkowników. Oczekiwany format wartości to userlistid[,timestamp]:
  • userlistid: pojedynczy numeryczny identyfikator listy użytkowników.
  • timestamp: opcjonalna sygnatura czasowa w formacie POSIX, wskazuje, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL może być powtarzany w celu dodania użytkownika do większej liczby list.
gdpr Wskazuje, że żądanie podlega ograniczeniom RODO dotyczącym użycia danych. Więcej informacji znajdziesz poniżej w sekcji Wymagania dotyczące zgody użytkownika z UE lub w artykule o wpływie na kwalifikowanie się do dopasowywania plików cookie w dokumentacji Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 w Authorized Buyers.

Przykład: gdpr=1
gdpr_consent ciąg tekstowy dotyczący przejrzystości i zgody, który reprezentuje zgodę użytkownika. Więcej informacji znajdziesz w sekcji Wymagania dotyczące zgody użytkownika z UE poniżej lub w sekcji W jaki sposób będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody? w dokumentacji Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w wersji 2.0 w Authorized Buyers.
process_consent Wskazuje, że licytujący uzyskał zgodę użytkownika na wykorzystanie danych zgodnie z polityką Google w zakresie zgody użytkownika z UE.

Jeśli żądanie nie podlega polityce w zakresie zgody użytkownika z UE lub jeśli zawiera ono inne parametry dotyczące zgody użytkownika (gdpr_consent), ten parametr jest ignorowany.

Przykład: process_consent=T
Parametr Opis
google_error

Wartość całkowita wskazująca ogólny błąd żądania. Po otrzymaniu tego komunikatu oznacza to, że nie zostały wykonane żadne operacje i nie zostaną ustawione żadne inne parametry odpowiedzi google_. Obsługiwane wartości błędów:

  • 1: użytkownik ma plik cookie Google, ale zrezygnował ze śledzenia za jego pomocą.
  • 2: nie określono prawidłowych operacji, na przykład otrzymano żądanie no-op.
  • 3: użytkownik nie ma pliku cookie Google. Google nie będzie umieszczać pliku cookie za pomocą usługi dopasowywania plików cookie.
  • 4: podano operacje kolidujące. W tym samym żądaniu nie możesz określić jednocześnie flag google_push i google_cm, ponieważ mają one sprzeczne cele.
  • 5: w przekierowaniu na serwer Google został przekazany nieprawidłowy parametr google_push w ramach dwukierunkowego żądania dopasowania pikseli. Przekierowanie musi ustawić google_push na taką samą wartość, jaka została Ci przesłana w pierwszym żądaniu piksela.
  • 6: w tagu dopasowania podano nieprawidłowy identyfikator NID.
  • 7: wykryto nieprawidłowy plik cookie.
  • 8: wycofano. Nie znaleziono pliku cookie.
  • 9: nie znaleziono pliku cookie. Podejmowana jest próba ustawienia testowego pliku cookie.
  • 10: parametr google_redir został użyty bez określenia google_hm lub był używany razem z parametrem google_cm.
  • 15: żądanie pochodzi z regionu, w którym Google wymaga, aby tabela odpowiedników była hostowana przez Google. Dlatego ta odpowiedź nie zawiera identyfikatora użytkownika Google. Obecnie ta funkcja jest włączona w przypadku niewielkiego odsetka ruchu, ale planujemy ją w pełni włączyć w czerwcu 2020 r.

Inicjowane przez Google: dwukierunkowe dopasowywanie pikseli

Dwukierunkowe dopasowywanie pikseli to proces dostępny w ramach usługi Google dopasowywania plików cookie, w ramach którego Google próbuje dopasować identyfikator użytkownika Google do algorytmicznie wybranego licytującego innego niż zwycięzca aukcji z określaniem stawek w czasie rzeczywistym. Po umieszczeniu reklamy Google umieści tag dopasowania, który przekieruje przeglądarkę użytkownika do wczytania przezroczystego piksela z adresu URL dopasowywania plików cookie wybranego licytującego. Dzięki temu zarówno Google, jak i licytujący będą mogli wypełnić tabelę odpowiedników dotyczącą danego użytkownika. Poniżej znajduje się prosty przykład tego procesu.

Krok 1. Google umieszcza tag dopasowania

Gdy strona wydawcy uczestniczącego w programie wczytuje się w przeglądarce użytkownika, a boks reklamowy na tej stronie zostanie wypełniony przez Google, może zostać umieszczony tag dopasowania, który wyśle żądanie piksela od licytującego wybranego przez algorytm. Umieszczony przez Google tag dopasowywania plików cookie łączy adres URL dopasowywania plików cookie licytującego z dodatkowymi parametrami, których licytujący może używać do wypełniania tabeli odpowiedników. Adres URL dopasowywania plików cookie określony jako https://ad.network.com/pixel ma taką strukturę:

<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />

Licytujący, którzy otrzymują żądania dopasowywania pikseli, muszą w odpowiedzi przekazać przekierowanie do usługi Google do dopasowywania plików cookie. Ma ona taką strukturę:

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

Powyższy adres URL przekierowania jest podobny do adresu URL używanego w tagu dopasowania w ramach przepływu pracy dopasowywania plików cookie zainicjowanego przez licytujący. W dopasowywaniu Pixela parametr google_cm jest zastępowany parametrem google_push, a jego wartość musi być równa wartości podanej przez Google w żądaniu. Podobnie jak w przypadku przepływu pracy inicjowanego przez licytującego, na potrzeby dodatkowych przypadków użycia można określić dodatkowe parametry.

Krok 3. Google przetwarza przekierowanie i odpowiada za pomocą piksela

Google rejestruje, że dla użytkownika utworzono dopasowanie, i obsługuje wszelkie dodatkowe operacje żądane za pomocą parametrów zapytania. Na koniec Google wysyła przezroczysty piksel 1 x 1.

Schemat procesu dopasowywania Pixela

Ten przepływ pracy ilustruje poniższy schemat. Żądania i odpowiedzi są oznaczone strzałką, a towarzyszące im elementy danych – w nawiasach.

Parametry żądania tagu dopasowania Google

Parametr Opis
google_gid Identyfikator użytkownika Google. W przypadku użytkowników spoza stanu USA, w którym obowiązują ograniczenia dotyczące prywatności, ta informacja będzie zawsze podana w tagu dopasowania Google.
google_cver Wersja pliku cookie. Ta wartość będzie zawsze określona w tagu dopasowania Google.
google_push Wskazuje, że to żądanie inicjuje proces dopasowywania pikseli. Wartość musi być zwracana za pomocą odpowiedniego parametru w odpowiedzi przekierowania licytującego.

Parametry przekierowania Pixel Matching licytującego

Parametr Opis
google_nid Identyfikator sieci (NID) na koncie licytującego. Ten identyfikator możesz pobrać za pomocą zasobu Licytujący.
google_push Wskazuje, że to przekierowanie kończy proces dopasowywania pikseli. Należy tutaj podać wartość odpowiedniego tagu dopasowania Google.
google_hm

Zawiera dane, które licytujący chce zapisać w tabeli odpowiedników hostowanej przez Google.
google_ula Ciąg tekstowy używany w celu dodania użytkownika do istniejącej listy użytkowników. Oczekiwany format wartości to userlistid[,timestamp]:
  • userlistid: pojedynczy numeryczny identyfikator listy użytkowników.
  • timestamp: opcjonalna sygnatura czasowa w formacie POSIX, wskazuje, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL może być powtarzany w celu dodania użytkownika do większej liczby list.

Inicjowane przez Google: jednokierunkowe dopasowywanie pikseli

Jednokierunkowe dopasowywanie pikseli różni się od procesu dwukierunkowego tym, że tag dopasowania Google nie zawiera parametru określającego identyfikator użytkownika Google, ale nadal będzie wypełniać tabelę odpowiedników na serwerze Google. Można z niej korzystać w sytuacjach, gdy licytujący nie może hostować identyfikatorów użytkowników Google we własnej tabeli odpowiedników. Prosty przykład zmienionego przepływu pracy znajdziesz w krokach poniżej.

Krok 1. Google umieszcza tag dopasowania

Google umieszcza tag dopasowania w przypadku wybranego algorytmicznie licytującego. Tag dopasowania zawiera parametr google_push. Oto przykład:

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

Krok 2. Przeglądarka użytkownika wysyła żądanie piksela z adresu URL dopasowania kulinarnego licytującego

Przeglądarka użytkownika wysyła żądanie piksela z adresu URL dopasowywania plików cookie licytującego, w tym pliku cookie licytującego w nagłówkach HTTP.

Punkt końcowy dopasowywania plików cookie licytującego musi przekierowywać do usługi Google do dopasowywania plików cookie. Obejmuje to parametr google_hm uzupełniany danymi z plików cookie zakodowanych w internecie w standardzie base64. Może ono wyglądać tak:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

Google otrzyma przekierowanie zawierające określone przez Ciebie parametry oprócz pliku cookie Google w nagłówkach HTTP. Jeśli operacja się udała, wyświetlenia tego użytkownika w kolejnych pytaniach o stawkę będą zawierały dane hostowanego dopasowania licytującego w BidRequest.hosted_match_data w przypadku protokołu Google lub BidRequest.user.buyeruid w przypadku implementacji OpenRTB Google. Licytujący mogą też wypełniać listy użytkowników, korzystając z określonych przez nich hostowanych danych dopasowania.

Na koniec Google zwraca do przeglądarki użytkownika przezroczysty piksel 1 x 1.

Otwarte ustalanie stawek umożliwia giełdom korzystanie z procesów dopasowywania plików cookie zainicjowanych przez licytujących i zainicjowanych przez Google w celu dopasowywania identyfikatora User-ID Google do ich pliku cookie. Wspomaganie dopasowania plików cookie (CMA) to dodatkowa funkcja na potrzeby giełd, która umożliwia tworzenie tabel odpowiedników z własnymi licytującymi.

  1. Gdy umieszczasz reklamę, Google algorytmicznie wybiera uczestniczącą giełdę i umieszcza tag Asystenta dopasowania plików cookie o takiej strukturze:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

  2. Tag dopasowania CMA Google powoduje, że adres URL dopasowywania plików cookie giełdy otrzymuje żądanie piksela.

  3. Żądanie jest wysyłane do punktu końcowego dopasowywania plików cookie giełdy, gdzie jej własna usługa dopasowywania plików cookie odpowiada za dopasowanie identyfikatora użytkownika do jednego z licytujących. Na poniższym diagramie usługa dopasowywania plików cookie giełdy odpowiada na przeglądarkę użytkownika przekierowaniem do jednego z punktów końcowych licytującego.
  4. Licytujący otrzymuje żądanie wraz z parametrami określonymi przez giełdę, które pozwalają dopasować identyfikator użytkownika do jego pliku cookie.

Ograniczenia

Ograniczenie częstotliwości żądań w przypadku nowych dopasowań

Licytujący są odpowiedzialni za ograniczenie liczby wywołań usługi dopasowywania plików cookie w przypadku użytkowników, którzy dodali nowy wpis w tabeli odpowiedników hostowanej przez Google. Wpis w hostowanej tabeli odpowiedników może zostać uznany za wygasły po 14 dniach i po tym czasie można go odświeżyć.

Odpowiadanie na wszystkie żądania dopasowania pikseli

Licytujący, którzy korzystają z procesu dopasowywania Pixela, powinni odpowiadać na wszystkie przychodzące żądania Pixel Match, używając odpowiedzi z parametrem google_push. Dzięki temu Google może egzekwować zasady, monitorując wykorzystanie. Jeśli współczynnik odpowiedzi licytującego spadnie poniżej 90%, Google ograniczy liczbę żądań Pixel Match wysłanych na jego konto.

Używanie punktów końcowych HTTPS

Punkty końcowe używane we wszystkich przepływach pracy dopasowywania plików cookie muszą używać HTTPS.

Gdy odpowiadasz na żądanie Pixel Match wysłane przez HTTPS, musisz wykonać przekierowanie do usługi dopasowywania plików cookie przez HTTPS. Podobnie punkt końcowy wspomagania dopasowania plików cookie, który przekierowuje do licytujących, też musi używać protokołu HTTPS. Jeśli wysyłasz żądania do Google częściej niż raz na 2 minuty, liczba żądań dopasowania wysyłanych na Twoje konto będzie ograniczana.

Żądania dopasowywania plików cookie, które podlegają polityce Google w zakresie zgody użytkownika z UE, powinny zawierać zgodę użytkownika. Takie żądania muszą wskazywać, że zgoda została udzielona w jeden z tych sposobów:

Przykłady

Poniższe przykłady pokazują, jak korzystać z usługi dopasowywania plików cookie w celu realizacji określonych celów. Pamiętaj, że o ile nie wskazano inaczej, zakłada się, że działający użytkownik nie pochodzi ze stanu USA, w którym obowiązują ograniczenia dotyczące prywatności.

Wypełnianie tabeli odpowiedników hostowanej przez licytującego

Licytujący może skorzystać z procesu dopasowywania plików cookie, aby wypełnić własną tabelę odpowiedników, podając tylko parametry google_nid i google_cm w tagu dopasowania. Może to wyglądać tak:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />

Jeśli adres URL dopasowywania plików cookie licytującego ma wartość https://ad.network.com/pixel?id=1, a operacja dopasowywania plików cookie się powiedzie, przekierowanie wysłane przez Google w odpowiedzi na tag dopasowania licytującego może wyglądać tak:

https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

Jeśli operacja dopasowywania plików cookie nie powiedzie się, ponieważ użytkownik nie ma pliku cookie Google, odpowiedź będzie miała postać:

https://ad.network.com/pixel?id=1&google_error=3

Kod błędu zależy od jego przyczyny. Więcej informacji o możliwych kodach błędów związanych z dopasowywaniem plików cookie znajdziesz w artykule Parametry adresu URL przekierowania.

Dodaj do listy pojedynczych użytkowników

Parametr google_ula można określić w tagu dopasowania licytującego, aby dodać użytkownika do listy użytkowników o podanym identyfikatorze. Jeśli tabela odpowiedników hostowana przez Google lub licytującego zawiera nowy wpis dotyczący użytkownika, licytujący może umieścić tag dopasowania z parametrami google_nid i google_ula, aby dodać użytkownika do określonej listy bez inicjowania pełnego procesu dopasowywania plików cookie. Więcej szczegółów znajdziesz w ograniczeniach wywoływania usługi dopasowywania plików cookie. Odpowiedni tag dopasowania może wyglądać tak:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />

Aby odpowiedź przebiegła pomyślnie, a adres URL dopasowywania plików cookie licytującego to https://ad.network.com/pixel, adres URL przekierowania Google będzie wyglądać tak:

https://ad.network.com/pixel?google_ula=12345,0

Jeśli wystąpi ogólny błąd, np. dla użytkownika nie ma pliku cookie Google – adres URL przekierowania będzie zawierał parametr google_error:

  • https://ad.network.com/pixel?google_error=3

Jeśli wystąpi błąd dotyczący dodawania użytkownika do listy, w przekierowaniu wyświetli się google_ula. W przeciwieństwie do odpowiedniego parametru tagu dopasowania powoduje to zastąpienie sygnatury czasowej kodem stanu, który wskazuje, czy operacja zakończyła się powodzeniem. Jeśli na przykład żądanie nie zostało zrealizowane, ponieważ konto licytującego nie miało dostępu do określonej listy użytkowników, przekierowanie miałoby postać:

https://ad.network.com/pixel?google_ula=12345,2

Dodaj do wielu list użytkowników

Licytujący mogą określić, że należy dodać użytkownika do wielu list użytkowników, uwzględniając wiele parametrów google_ula w tagu dopasowania. W praktyce może to wyglądać tak:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />

Stan operacji w przypadku każdej listy użytkowników jest raportowany w podobny sposób za pomocą różnych parametrów google_ula w przekierowaniu:

https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0

W powyższym przekierowaniu widać, że operacja zakończyła się powodzeniem w przypadku listy użytkowników o identyfikatorze 45678, ale nie powiodła się w przypadku listy o identyfikatorze 12345, ponieważ licytujący nie miał do niej dostępu.

Aby w jednym żądaniu można było dopasowywać pliki cookie i dodać użytkownika do listy użytkowników, tag dopasowania licytującego powinien zawierać te elementy: google_cm i google_ula:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />

Przekierowanie określone przez Google będzie miało postać google_gid, google_cver i google_ula. Może to wyglądać tak:

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

Zapisywanie dopasowania w tabeli odpowiedników na serwerze Google

Jeśli licytujący chce zapisać dane z plików cookie w tabeli odpowiedników hostowanej przez Google i nie chce zapisywać dopasowań z identyfikatorem użytkownika Google w własnej tabeli odpowiedników, tag dopasowania musi zawierać parametr google_hm, a jego wartość musi być ciągiem znaków zakodowanym w internecie w formacie base64. W przypadku użytkownika, w przypadku którego niezakodowane dane z plików cookie licytującego to Cookie number 1!, zakodowana wartość będzie miała postać Q29va2llIG51bWJlciAxIQ==, która zostanie użyta w tagu dopasowania takim jak:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

Aby odpowiedź przebiegła pomyślnie, a adres URL dopasowywania plików cookie licytującego to https://cookie-monster.com/pixel, adres URL przekierowania Google będzie wyglądać tak:

https://cookie-monster.com/pixel

W przekierowaniu nie ma parametru google_gid, ponieważ tag dopasowania nie zawiera parametru google_cm, a pole google_hm nie jest uwzględniane w udanych odpowiedziach. W przyszłych pytaniach o stawkę za wyświetlenia tego użytkownika licytujący będzie otrzymywać dane hostowanego dopasowania w BidRequest.hosted_match_data (w przypadku protokołu RTB Google lub BidRequest.user.buyeruid na potrzeby implementacji OpenRTB Google).

Jeśli licytujący zamiast tego użył tagu dopasowania, w którym wartość google_hm nie była zakodowana w formacie base64 (np. chocolate_chunk!), adres URL przekierowania może wyglądać tak:

https://cookie-monster.com/pixel?google_hm=2

Powyższe przekierowanie zawiera wartość google_hm w wysokości 2, co oznacza, że operacja się nie udała, ponieważ wartości nie udało się odkodować.

Tabele odpowiedników na serwerze licytującego i na serwerach Google z listami użytkowników

Jeśli licytujący oprócz listy użytkowników hostowanej przez Google hostuje własną listę użytkowników i chce, aby do obu tabel odpowiadał jeden tag dopasowania, oraz dodać użytkownika do danej listy użytkowników, jego tag dopasowania musi zawierać parametry google_cm, google_hm i google_ula. Jeśli dane plików cookie licytującego to Cookie number 1!, zakodowana wartość będzie wyglądać tak: Q29va2llIG51bWJlciAxIQ==, co da tag dopasowania taki jak:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />

Aby uzyskać odpowiedź, gdy URL dopasowania plików cookie licytującego to https://cookie-monster.com/pixel, adres URL przekierowania Google będzie wyglądać tak:

https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0

Po otrzymaniu przekierowania licytujący może dopasować identyfikator użytkownika Google określony w zasadzie google_gid do danych z plików cookie w tabeli odpowiedników. Mogą też ustalić, że operacje na serwerach Google dla tabeli odpowiedników i listy użytkowników zakończyły się powodzeniem. W efekcie każde kierowanie wstępne skonfigurowane pod kątem kierowania na listę użytkowników o określonym identyfikatorze będzie teraz powodować otrzymywanie od użytkownika pytań o stawkę za wyświetlenia. Podobnie w przypadku tych pytań o stawkę system licytujący otrzyma w BidRequest.hosted_match_data dane o hostowanym dopasowaniu (na potrzeby protokołu RTB Google lub BidRequest.user.buyeruid) na potrzeby implementacji OpenRTB Google.