Dopasowywanie plików cookie

Dopasowywanie plików cookie to funkcja, która umożliwia dopasowanie Twojego pliku cookie (np. identyfikatora użytkownika, który przeglądał Twoją witrynę) do odpowiedniego identyfikatora użytkownika Google powiązanego z licytującym. Dzięki temu możesz tworzyć listy użytkowników, które pomagają podejmować lepsze decyzje dotyczące określania stawek. W tym przewodniku opisujemy pojęcia używane w przypadku dopasowywania plików cookie, różne procesy dopasowywania plików cookie oraz ich odmiany w określonych przypadkach użycia.

Pojęcia

Właściciele domen zwykle określają zawartość plików cookie dla użytkowników, którzy przeglądają ich witrynę. Pliki te służą do identyfikowania użytkowników w danej domenie. Nawet jeśli właściciele 2 domen zgodziliby się na wymianę tych danych, model zabezpieczeń przeglądarek internetowych uniemożliwia odczytanie pliku cookie ustawionego przez inną domenę.

W kontekście reklamy cyfrowej Google identyfikuje użytkowników za pomocą plików cookie należących do domeny doubleclick.net, a licytujący uczestniczący w licytacji w czasie rzeczywistym mogą mieć własną domenę, w której identyfikują pewną grupę użytkowników, którym chcą wyświetlać reklamy. Dopasowywanie plików cookie umożliwia licytującemu dopasowywanie swoich plików cookie do plików cookie Google, dzięki czemu może on określić, czy wyświetlenie przesłane w pytaniu o stawkę jest powiązane z jednym z użytkowników, do których kierowane są reklamy. Licytujący otrzyma własne dane plików cookie lub identyfikator użytkownika Google specyficzny dla licytującego, który jest zaszyfrowaną formą pliku cookie doubleclick.netw pytaniu o stawkę.

Opisana w tym przewodniku usługa dopasowywania plików cookie ułatwia tworzenie i utrzymywanie powiązania między plikiem cookie oferenta a identyfikatorem użytkownika Google, a także umożliwia wypełnianie list użytkowników.

Tabele odpowiedników

Tabela dopasowań może służyć do mapowania identyfikatora lub innych danych z jednej domeny na inną. Licytujący mogą używać usługi dopasowywania plików cookie do wypełniania własnych tabel odpowiedników przez mapowanie plików cookie dla danego użytkownika na identyfikator użytkownika Google lub do wypełniania tabeli odpowiedników hostowanej przez Google. Tabele dopasowań są niezbędne, aby aplikacja licytującego mogła uzyskać dostęp do danych plików cookie użytkownika, któremu wyświetla się reklama.

Tabele odpowiedników hostowane przez Google

Aby ułatwić konserwację, poprawić opóźnienie i zapewnić użytkownikom w niektórych regionach dostęp do danych o dopasowaniu, zalecamy zezwolenie Google na hostowanie tabeli dopasowania. Umożliwia to określenie ciągu zakodowanego w bezpiecznym formacie Base64, który będzie mapowany na identyfikator użytkownika Google w przypadku danego użytkownika. Po ustaleniu dopasowania można go używać w ten sposób:

  • Określanie stawek w czasie rzeczywistym: w kolejnych prośbach o stawki za wyświetlenia powiązane z użytkownikiem Google będzie przesyłać Ci hostowane dane dopasowania, które zostały dopasowane do identyfikatora użytkownika Google. Google określi BidRequest.user.buyeruid jako ciąg tekstowy zakodowany w formacie base64, który jest bezpieczny dla sieci.

  • Listy użytkowników: listy użytkowników można wypełniać identyfikatorami użytkowników Google lub hostowanymi danymi o dopasowaniu.

  • Kierowanie wstępne: możesz skonfigurować kierowanie wstępne tak, aby otrzymywać tylko pytania o stawkę zawierające dane dopasowania hostowane przez Ciebie. Możesz go używać 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 Real-Time Bidding API. Po utworzeniu możesz wypełnić te listy za pomocą tych procesów dopasowywania plików cookie lub za pomocą usługi przesyłania zbiorczego.

Pierwsze kroki

Aby rozpocząć korzystanie 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 pomóc Ci skonfigurować te elementy:

  • Identyfikator sieci dopasowywania plików cookie (NID): identyfikator ciągu, który w unikalny sposób wskazuje konto licytującego na potrzeby dopasowywania plików cookie i innych powiązanych działań.
  • 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. W tym adresie URL reklamodawcy mogą umieszczać makra, aby kontrolować kolejność parametrów przekazywanych do niego w ramach przepływów pracy dopasowywania plików cookie.
  • Tag dopasowania: tag, który musisz umieścić w przeglądarce użytkownika w przypadku przepływu pracy dopasowywania plików cookie zainicjowanego przez licytującego. Może być wyświetlana obok reklam lub umieszczana w usługach internetowych poza reklamami.
  • URL raportu dotyczącego dopasowania plików cookie (opcjonalny): w jednokierunkowym przepływie pracy dopasowywania plików cookie jest to opcjonalny adres URL, który można podać, aby określić punkt końcowy do otrzymywania informacji o błędach, jeśli wystąpi niepowodzenie dopasowania za pomocą przekierowania HTTP 302. Domyślnie odpowiedzi będą wysyłane na ten adres URL tylko wtedy, gdy wystąpi błąd w operacji dopasowywania plików cookie, ale reklamodawcy mogą zażądać, aby przekierowanie było zawsze wysyłane.
  • URL wspomaganego dopasowania plików cookie: w przypadku giełd, które wdrażają przepływ pracy wspomaganego dopasowania plików cookie, jest to podstawowy URL punktu końcowego, który ma odpowiadać na przychodzące żądania.
  • Limit wspomaganego dopasowywania plików cookie: w przypadku platform wymiany, które wdrażają przepływ pracy wspomaganego dopasowywania plików cookie, jest to maksymalna liczba żądań, jaką może otrzymywać co sekundę adres URL dopasowywania plików cookie. Ma to zapobiec przeciążeniu serwerów giełdy przez żądania CMA.

W przypadku dowolnego z obsługiwanych przepływów pracy dopasowywania plików cookie do adresu URL dopasowywania plików cookie reklamodawcy zwykle dołączane są parametry w niegwarantowanej kolejności. Oferenci, których integracje wymagają spójnej kolejności parametrów, mogą umieszczać makra w adresie URL dopasowywania plików cookie, aby wskazywać ich położenie.

Obsługiwane makra

Licytujący mogą opcjonalnie skonfigurować adres URL dopasowywania plików cookie tak, aby zawierał co najmniej 1 makro w formie %%GOOGLE_<PARAM_NAME>%% lub %%GOOGLE_<PARAM_NAME>_PAIR%%. Obsługiwane makra i ich rozwinięte wartości to:

Makro Rozwinięta wartość
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

W przypadku integracji z dopasowywaniem plików cookie oferent ma punkt końcowy hostowany pod adresem https://user.bidder.com/cookies, a jego implementacja wymaga wstępnie zdefiniowanych przez oferenta parametrów oprócz parametrów dopasowywania pikseli w tej kolejności: google_push, google_gid, google_cvergoogle_error. Licytujący może to zrobić, ustawiając URL dopasowania 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 wyśle później do tego licytującego żądanie dopasowania, zostanie ono rozwinięte do postaci podobnej do tej:

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 dopasowywania plików cookie Google obsługuje te 3 procesy.

Dwukierunkowe dopasowywanie plików cookie to proces inicjowany przez licytującego, w ramach którego umieszcza on w przeglądarce użytkownika tag dopasowania, który kieruje ją do Google. Ten proces umożliwia zarówno Google, jak i reklamodawcy wypełnianie tabel dopasowań. Poniżej znajdziesz przykład takiego przepływu pracy.

Krok 1. Umieść tag dopasowania

Aby rozpocząć ten proces, oferent musi umieścić tag dopasowania w taki sposób, aby był renderowany w przeglądarce użytkownika. Tag dopasowania, który zwraca do reklamodawcy 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" />

W tagu dopasowania możesz uwzględnić dodatkowe parametry, aby realizować różne przypadki użycia. Więcej informacji o tych parametrach znajdziesz w artykule Parametry adresu URL tagu dopasowania.

Krok 2. Google odpowiada przekierowaniem zawierającym dane o dopasowaniu

Tag dopasowania spowoduje, że usługa dopasowywania plików cookie Google otrzyma z przeglądarki użytkownika żądanie, które wygeneruje HTTP 302przekierowanie do adresu URL dopasowywania plików cookie reklamodawcy. Przekierowanie będzie zawierać parametry zapytania określające identyfikator użytkownika Google i jego numer wersji w adresie URL, a w nagłówkach żądania reklamodawca otrzyma też swój plik cookie. W praktyce w przypadku adresu URL dopasowania plików cookie określonego jako https://ad.network.com/pixel adres URL przekierowania dla poprzedniego tagu dopasowania może wyglądać tak:

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

Identyfikator użytkownika Google przekazywany za pomocą parametru google_gid to ciąg znaków zakodowany w standardzie base64, który jest bezpieczny w internecie i nie zawiera dopełnienia. Licytującym, którzy zdecydują się hostować tabelę dopasowań, zalecamy przechowywanie dokładnego ciągu znaków zwracanego przez usługę dopasowywania plików cookie. W kolejnych pytaniach o stawkę będzie to odpowiadać wartościom określonym za pomocą parametru BidRequest.user.id.

Wersja określona w google_cver to numer wersji identyfikatora użytkownika Google. Identyfikator użytkownika Google dla danego użytkownika rzadko się zmienia, a gdy to nastąpi, zostanie zwiększony.

Jeśli podczas przetwarzania żądania dopasowania wystąpi błąd, zamiast tego zostanie określony parametr google_error.

Krok 3. Wykonawca reklamy przetwarza przekierowanie i odpowiada za pomocą piksela

Wysyłamy do niego przekierowanie do adresu URL dopasowywania plików cookie, które zawiera parametry określone przez niego w pierwszym kroku oraz parametry podane przez Google w drugim kroku. Otrzymają też plik cookie w nagłówkach HTTP. Jeśli operacja się powiedzie, reklamodawca hostujący własną tabelę dopasowań może dopasować swój plik cookie do identyfikatora użytkownika Google zawartego w odpowiedzi. Zalecamy, aby reklamodawcy przechowywali dokładny ciąg tekstowy zwrócony przez usługę dopasowywania plików cookie.

Jeśli operacja się nie powiedzie, w przekierowaniu pojawi się parametr google_error. Jest to wartość liczbowa odpowiadająca różnym stanom błędu, które identyfikują konkretny błąd, który wystąpił. Więcej informacji o możliwych wartościach błędów znajdziesz w opisie parametru adresu URL google_error. Jeśli pojawi się błąd, możesz ponownie spróbować dopasować użytkownika, umieszczając nowy tag dopasowywania.

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

Ten przepływ pracy ilustruje poniższy diagram, na którym żądania i odpowiedzi są reprezentowane przez strzałkę, a towarzyszące im elementy danych są wymienione w nawiasach.

Parametry adresu URL tagu dopasowania

Parametr Opis
google_nid Identyfikator sieci (NID) konta licytującego. Ten identyfikator można pobrać za pomocą zasobu Bidders.
google_cm Informuje usługę dopasowywania plików cookie Google, że ma ona przeprowadzić dopasowywanie plików cookie. Wartość parametru jest ignorowana i może zostać pominięta.
google_sc Ten parametr został wycofany. Ustawia plik cookie Google dla użytkownika, jeśli nie jest on obecny. Wartość parametru jest ignorowana i może zostać pominięta. Jeśli nie podasz tego parametru, a nie ma żadnego pliku cookie, wystąpi błąd.
google_no_sc Ten parametr został wycofany. Informuje to usługę dopasowywania plików cookie Google, że nie powinna ona ustawiać pliku cookie dla użytkownika, jeśli nie jest on obecny. Wartość parametru jest ignorowana i może zostać pominięta.
google_hm

Dane, które reklamodawca chce przechowywać w tabeli dopasowań hostowanej przez Google.

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

google_redir Zakodowany ciąg znaków, który może określić licytujący, jeśli chce, aby Google wysyłało HTTP 302 przekierowanie do zakodowanego adresu URL w przypadku tego tagu dopasowania. Umożliwia to umieszczenie Google na początku połączonego wywołania partnerów. Jeśli ten parametr zostanie podany bez google_hm lub z google_cm, wystąpi błąd.
google_ula Ciąg znaków używany do dodawania użytkownika do istniejącej listy użytkowników. Wymagany format wartości to userlistid[,timestamp]:
  • userlistid: pojedynczy liczbowy identyfikator listy użytkowników.
  • timestamp: opcjonalna sygnatura czasowa w formacie POSIX, która wskazuje, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL może być powtarzany, aby dodać użytkownika do wielu list.

gdpr Wskazuje, że żądanie podlega ograniczeniom RODO dotyczącym użycia danych. Więcej informacji znajdziesz w sekcji Wymagania dotyczące zgody użytkowników z UE lub Wpływ na kwalifikowanie się do dopasowywania plików cookie dokumentacji Authorized Buyers dotyczącej zasad IAB TCF w wersji 2.0.

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żytkowników z UE lub Jak będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody? dokumentacji Authorized Buyers dotyczącej zasad TCF organizacji IAB w wersji 2.0.
process_consent Wskazuje, że oferent uzyskał zgodę użytkownika na wykorzystanie danych w sposób określony w  polityce Google w zakresie zgody użytkownika z UE.

Jeśli żądanie nie podlega polityce w zakresie zgody użytkownika z UE lub jeśli w żądaniu są dostępne inne parametry zgody (gdpr_consent), ten parametr jest ignorowany.

Przykład: process_consent=T

Oprócz wymienionych wcześniej parametrów oferenci mogą określać własne, które będą dołączane do adresu URL przekierowania. Pamiętaj, że zdefiniowane przez reklamodawcę parametry o nazwach z prefiksem google_ będą ignorowane, ponieważ są one zarezerwowane przez Google na potrzeby przyszłego rozwoju, a zachowanie kolejności parametrów nie jest gwarantowane. Tag dopasowania zawierający zdefiniowane przez reklamodawcę parametry 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

Adres URL przekierowania jest tworzony na podstawie podstawowego adresu URL dopasowywania plików cookie skonfigurowanego na koncie reklamodawcy, w tym parametrów google_ i parametrów zdefiniowanych przez reklamodawcę, w zależności od parametrów określonych w tagu dopasowywania. Zdefiniowane są te parametry odpowiedzi google_:

Parametr Opis
google_gid Identyfikator użytkownika Google. Ustaw wartość google_cm, jeśli w żądaniu podano ten parametr i żądanie zostało zrealizowane.
google_cver wersję pliku cookie, Ustaw wartość google_cm, jeśli w żądaniu podano ten parametr i żądanie zostało zrealizowane.
google_error

Wartość całkowita wskazująca ogólny błąd żądania. Gdy otrzymasz ten kod, oznacza to, że nie wykonano żadnych operacji i nie ustawiono żadnych innych parametrów odpowiedzi google_. Obsługiwane wartości błędu to:

  • 1: użytkownik ma plik cookie Google, ale zrezygnował ze śledzenia za jego pomocą.
  • 2: nie określono żadnych prawidłowych operacji, np. otrzymano żądanie bez operacji.
  • 3: Użytkownik nie ma pliku cookie Google. Google nie utworzy pliku cookie za pomocą usługi dopasowywania plików cookie.
  • 4: Określono sprzeczne operacje. W tym samym żądaniu nie można określić jednocześnie flag google_pushgoogle_cm, ponieważ mają one sprzeczne ze sobą cele.
  • 5: w ramach żądania dwukierunkowego dopasowania pikseli w przekierowaniu do serwera Google przekazano nieprawidłowy parametr google_push. Przekierowanie musi ustawić parametr google_push na tę samą wartość, która została przekazana w początkowym żądaniu piksela.
  • 6: w tagu dopasowania podano nieprawidłowy identyfikator NID.
  • 7: wykryto nieprawidłowy plik cookie.
  • 8: Wycofane. Nie znaleziono pliku cookie.
  • 9: nie znaleziono pliku cookie, podjęto próbę ustawienia testowego pliku cookie.
  • 10: parametr google_redir został użyty bez określenia parametru google_hm lub został użyty dodatkowo w stosunku do parametru google_cm.
  • 15: żądanie pochodzi z regionu, w którym Google wymaga, aby tabela dopasowań była hostowana przez Google. W związku z tym ta odpowiedź nie zawiera identyfikatora użytkownika Google.
google_hm

Pojawia się tylko wtedy, gdy próba zapisu w tabeli dopasowań hostowanej przez Google się nie powiedzie. W takim przypadku jego wartość jest jednym z tych kodów stanu:

  • 1 – Zabronione: klient nie ma dostępu do zapisywania wpisów w tabeli dopasowań hostowanych.
  • 2 – błąd dekodowania: nie udało się odkodować wartości parametru.
  • 3 – Ładunek jest zbyt długi: wartość parametru po zdekodowaniu zajmuje więcej niż 40 bajtów danych.
  • 4 – Błąd wewnętrzny: podczas zapisywania danych wystąpił błąd wewnętrzny.
  • 5 – Ograniczony: ten zapis nie został przetworzony z powodu ograniczenia.
google_ula

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

Np. google_ula=1234567890,0

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

  • 0 – brak błędu. Użytkownik został dodany do listy użytkowników.
  • 2 – Odmowa dostępu. Nie masz uprawnień do dodawania użytkowników do tej listy.
  • 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.

Poniższe scenariusze opisują, jak może wyglądać dopasowywanie plików cookie w przypadku typowego użytkownika przeglądającego stronę internetową.

Scenariusz 1. Użytkownik czyści pliki cookie i przegląda witrynę

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

Jak to działa:

  1. Witryna ExampleNews.com renderuje reklamy i wywołuje reklamy z Google (Ad Managera).
  2. Ponieważ jednostka reklamowa kwalifikuje się do alokacji dynamicznej, Google wysyła żądania stawek do FinestDSP i innych licytujących za pomocą usługi określania stawek w czasie rzeczywistym.
  3. Aplikacja licytująca FinestDSP otrzymuje i przetwarza pytanie o stawkę oraz wysyła odpowiedź na pytanie o stawkę.
  4. Google otrzymuje odpowiedzi na stawki od oferentów, w tym odpowiedź FinestDSP, która określa reklamę z tagiem dopasowania (pikselem).
  5. Aukcję wygrywa FinestDSP. Google wyświetla Jane reklamę i tag dopasowania od FinestDSP.
  6. Tag dopasowywania wywołuje usługę dopasowywania plików cookie Google, określając parametry google_nidgoogle_cm.
  7. Usługa dopasowywania plików cookie odczytuje plik cookie Google Jane i wysyła do przeglądarki Jane przekierowanie do adresu URL dopasowywania plików cookie FinestDSP z ustawionymi parametrami google_gidgoogle_cver.
  8. Przeglądarka Jane 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 URL ustawione przez Google oraz plik cookie dotyczący Jane w nagłówkach HTTP. FinestDSP może teraz przechowywać w tabeli dopasowań mapowanie swojego pliku cookie na google_gid.
  10. FinestDSP odpowiada na przekierowanie niewidocznym pikselem o wymiarach 1x1.
Scenariusz 2. Użytkownik z istniejącym mapowaniem

Tydzień po scenariuszu 1 Jane ponownie odwiedza witrynę ExampleNews.com. Jane ma teraz na swoim urządzeniu zarówno pliki cookie podmiotu składającego oferty, jak i pliki cookie usługi Ad Manager. Oto jak działa dopasowywanie:

  1. Strona internetowa jest renderowana, co powoduje, że Google (Ad Manager) wysyła żądanie reklam, które będą wyświetlane na stronie.
  2. Podczas aukcji reklam Google wysyła pytanie o stawkę do odpowiednich systemów licytujących, w tym FinestDSP.
  3. FinestDSP otrzymuje pytanie o stawkę, w tym sygnały takie jak google_gid.
  4. FinestDSP wyszukuje w tabeli dopasowań google_gid i znajduje powiązany z Jane plik cookie utworzony tydzień wcześniej (w scenariuszu 1).
  5. Na podstawie informacji powiązanych z plikami cookie logika ustalania stawek FinestDSP składa ofertę za wyświetlenie i wygrywa aukcję.
  6. Jane może zobaczyć reklamę dopasowaną do jej zainteresowań na podstawie informacji, które posiada FinestDSP.

Dopasowywanie plików cookie w jednym kierunku jest podobne do przepływu pracy w dwóch kierunkach, z tą różnicą, że tylko Google hostuje i wypełnia tabelę dopasowań. Może być używany w przypadkach, gdy oferent nie może hostować identyfikatorów użytkowników Google w swojej tabeli dopasowań. Aby korzystać z tego procesu, reklamodawcy muszą zezwolić Google na hostowanie tabeli dopasowań, nie mogą już określać parametru google_cm w żądaniach do usługi dopasowywania plików cookie Google i w konsekwencji nie będą otrzymywać parametru google_gid do wypełniania własnej tabeli dopasowań. Gdy Google znajdzie dopasowanie użytkownika, reklamodawcy mogą dodać go do list użytkowników, korzystając z własnych danych z plików cookie. Podobnie pytania o stawkę dotyczące tych użytkowników nie będą zawierać identyfikatora użytkownika Google, ale będą zawierać dane dopasowania hostowanego. Przykład zmienionego przepływu pracy został podsumowany w tych krokach.

Krok 1. Umieść tag dopasowania kierowany na adres URL dopasowania plików cookie reklamodawcy

Aby rozpocząć ten proces, oferent musi umieścić tag dopasowania w taki sposób, aby był renderowany w przeglądarce użytkownika. W przeciwieństwie do procesu w przypadku użytkowników spoza stanów USA, w których obowiązują ograniczenia dotyczące prywatności, tag dopasowania musi kierować przeglądarkę użytkownika na adres URL dopasowywania plików cookie. Jeśli na przykład URL dopasowania plików cookie ma postaćhttps://ad.network.com/pixel, będzie wyglądać tak:

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

Podczas wczytywania w przeglądarce użytkownika wysyła żądanie piksela na adres URL dopasowywania plików cookie oferenta. To żądanie będzie zawierać ich plik cookie w nagłówku HTTP, który należy wyodrębnić w następnym kroku.

Punkt końcowy dopasowywania plików cookie reklamodawcy musi przekierowywać do usługi dopasowywania plików cookie Google, w tym do parametru google_hm wypełnionego danymi plików cookie zakodowanymi w formacie base64 obsługiwanym w internecie. Adres URL przekierowania może 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 oraz plik cookie Google w nagłówkach HTTP.

Krok 4. Jeśli podano adres URL raportu, Google wyświetla piksel w przypadku przekierowania po powodzeniu lub błędzie

Jeśli operacja dopasowywania plików cookie zakończy się powodzeniem lub jeśli na koncie reklamodawcy nie określono adresu URL raportu o dopasowywaniu plików cookie, Google domyślnie wyświetli przezroczysty piksel o wymiarach 1x1 i proces zakończy się w tym miejscu. Wyświetlenia dla tego użytkownika w kolejnych pytaniach o stawkę będą zawierać dane dopasowania hostowane przez licytującego w BidRequest.user.buyeruid. Reklamodawcy mogą też wypełniać listy użytkowników za pomocą określonych przez siebie hostowanych danych o dopasowaniu.

W przeciwnym razie, jeśli wystąpi błąd, Google wyśle przekierowanie na adres URL raportu o dopasowywaniu plików cookie reklamodawcy z przyczyną błędu określoną w parametrze google_error. Jeśli URL raportu dotyczącego dopasowania plików cookie reklamodawcy to https://ad.network.com/report, URL przekierowania będzie wyglądać tak:

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

Przeglądarka użytkownika przekieruje do adresu URL raportu o dopasowywaniu plików cookie reklamodawcy, w tym do przyczyny błędu (jeśli wystąpił), określonej przez Google w parametrze google_error. Więcej informacji o interpretowaniu kodu błędu znajdziesz w opisie parametru.

Krok 6. Wyświetlanie przez oferenta przezroczystego piksela o wymiarach 1x1

W odpowiedzi musi on wyświetlić w przeglądarce użytkownika przezroczysty piksel o wymiarach 1 x 1.

Domyślny proces dla użytkowników ze stanów USA, w których obowiązują ograniczenia dotyczące prywatności, przedstawia poniższy diagram. Strzałki reprezentują żądania i odpowiedzi, a elementy danych, które im towarzyszą, są wymienione w nawiasach.

Parametr Opis
google_nid Identyfikator sieci (NID) konta licytującego. Ten identyfikator można pobrać za pomocą zasobu Bidders.
google_sc Ten parametr został wycofany. Ustawia plik cookie Google dla użytkownika, jeśli nie jest on obecny. Wartość parametru jest ignorowana i może zostać pominięta. Jeśli nie podasz tego parametru, a nie ma żadnego pliku cookie, wystąpi błąd.
google_no_sc Ten parametr został wycofany. Informuje to usługę dopasowywania plików cookie Google, że nie powinna ona ustawiać pliku cookie dla użytkownika, jeśli nie jest on obecny. Wartość parametru jest ignorowana i może zostać pominięta.
google_hm

Zawiera dane, które reklamodawca chce przechowywać w tabeli dopasowań hostowanej przez Google.

google_redir Zakodowany adres URL, na który Google ma wysłać przekierowanie HTTP 302. Określony adres URL będzie otrzymywać przekierowania z parametrem google_error zarówno w przypadku błędów, jak i operacji zakończonych powodzeniem.
google_ula Ciąg znaków używany do dodawania użytkownika do istniejącej listy użytkowników. Wymagany format wartości to userlistid[,timestamp]:
  • userlistid: pojedynczy liczbowy identyfikator listy użytkowników.
  • timestamp: opcjonalna sygnatura czasowa w formacie POSIX, która wskazuje, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL może być powtarzany, aby dodać użytkownika do wielu list.

gdpr Wskazuje, że żądanie podlega ograniczeniom RODO dotyczącym użycia danych. Więcej informacji znajdziesz w sekcji Wymagania dotyczące zgody użytkowników z UE lub Wpływ na kwalifikowanie się do dopasowywania plików cookie dokumentacji Authorized Buyers dotyczącej zasad IAB TCF w wersji 2.0.

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żytkowników z UE lub Jak będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody? dokumentacji Authorized Buyers dotyczącej zasad TCF organizacji IAB w wersji 2.0.
process_consent Wskazuje, że oferent uzyskał zgodę użytkownika na wykorzystanie danych w sposób określony w  polityce Google w zakresie zgody użytkownika z UE.

Jeśli żądanie nie podlega polityce w zakresie zgody użytkownika z UE lub jeśli w żądaniu są dostępne inne parametry zgody (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. Gdy otrzymasz ten kod, oznacza to, że nie wykonano żadnych operacji i nie ustawiono żadnych innych parametrów odpowiedzi google_. Obsługiwane wartości błędu to:

  • 1: użytkownik ma plik cookie Google, ale zrezygnował ze śledzenia za jego pomocą.
  • 2: nie określono żadnych prawidłowych operacji, np. otrzymano żądanie bez operacji.
  • 3: Użytkownik nie ma pliku cookie Google. Google nie utworzy pliku cookie za pomocą usługi dopasowywania plików cookie.
  • 4: Określono sprzeczne operacje. W tym samym żądaniu nie można określić jednocześnie flag google_pushgoogle_cm, ponieważ mają one sprzeczne ze sobą cele.
  • 5: w ramach żądania dwukierunkowego dopasowania pikseli w przekierowaniu do serwera Google przekazano nieprawidłowy parametr google_push. Przekierowanie musi ustawić parametr google_push na tę samą wartość, która została przekazana w początkowym żądaniu piksela.
  • 6: w tagu dopasowania podano nieprawidłowy identyfikator NID.
  • 7: wykryto nieprawidłowy plik cookie.
  • 8: Wycofane. Nie znaleziono pliku cookie.
  • 9: nie znaleziono pliku cookie, podjęto próbę ustawienia testowego pliku cookie.
  • 10: parametr google_redir został użyty bez określenia parametru google_hm lub został użyty dodatkowo w stosunku do parametru google_cm.
  • 15: żądanie pochodzi z regionu, w którym Google wymaga, aby tabela dopasowań była hostowana przez Google. W związku z tym ta odpowiedź nie zawiera identyfikatora użytkownika Google.

Inicjowane przez Google: dwukierunkowe dopasowywanie pikseli

Dwukierunkowe dopasowywanie pikseli to proces w ramach usługi dopasowywania plików cookie Google, w którym Google próbuje dopasować identyfikator użytkownika Google do wybranego algorytmicznie oferenta innego niż zwycięzca aukcji określania stawek w czasie rzeczywistym. Gdy reklama zostanie umieszczona, Google umieści tag dopasowania, który przekieruje przeglądarkę użytkownika do wczytania przezroczystego piksela z adresu URL dopasowywania plików cookie wybranego oferenta. Umożliwi to zarówno Google, jak i reklamodawcy wypełnianie tabeli odpowiedników danymi użytkownika. Poniżej znajdziesz przykład takiego przepływu pracy.

Krok 1. Google umieszcza tag dopasowania

Gdy strona wydawcy uczestniczącego w programie wczytuje się w przeglądarce użytkownika, a miejsce na reklamę na tej stronie jest wypełniane przez Google, może zostać umieszczony tag dopasowania, który wysyła żądanie piksela do wybranego algorytmicznie oferenta. Tag dopasowywania pikseli umieszczony przez Google łączy adres URL dopasowywania plików cookie oferenta z dodatkowymi parametrami, których oferent może używać do wypełniania swojej tabeli odpowiedników. Adres URL dopasowywania plików cookie określony jako https://ad.network.com/pixel ma następującą strukturę:

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

Podmioty składające oferty, które otrzymują żądania dopasowania pikseli, muszą odpowiedzieć przekierowaniem do usługi dopasowywania plików cookie Google o tej strukturze:

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

Pamiętaj, że powyższy adres URL przekierowania jest podobny do adresu URL używanego w tagu dopasowywania w przypadku przepływu pracy dopasowywania plików cookie inicjowanego przez reklamodawcę. W przypadku dopasowywania pikseli 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 można określić dodatkowe parametry, aby realizować dodatkowe przypadki użycia.

Krok 3. Google przetwarza przekierowanie i odsyła piksel

Google rejestruje utworzenie dopasowania dla użytkownika i obsługuje wszelkie dodatkowe operacje wymagane przez parametry zapytania. Na koniec Google odpowiada przezroczystym pikselem o wymiarach 1 x 1.

Diagram przepływu pracy dopasowywania pikseli

Ten przepływ pracy ilustruje poniższy diagram, na którym żądania i odpowiedzi są reprezentowane przez strzałkę, a towarzyszące im elementy danych są wymienione w nawiasach.

Parametry żądania tagu dopasowania Google

Parametr Opis
google_gid Identyfikator użytkownika Google. W przypadku użytkowników, którzy nie pochodzą ze stanu USA, w którym obowiązują ograniczenia dotyczące prywatności, ta wartość będzie zawsze określona w tagu dopasowania Google.
google_cver Wersja pliku cookie. Zawsze będzie to określone w tagu dopasowania Google.
google_push Wskazuje, że to żądanie inicjuje przepływ pracy związany z dopasowywaniem pikseli. Wartość musi być zwracana za pomocą odpowiedniego parametru w odpowiedzi przekierowania reklamodawcy.
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żytkowników z UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) lub w artykule **Jak będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody?** w [dokumentacji Authorized Buyers dotyczącej zasad TCF IAB w wersji 2.0](//support.google.com/authorizedbuyers/answer/9789378).

Parametry przekierowania dopasowywania pikseli przez reklamodawcę

Parametr Opis
google_nid Identyfikator sieci (NID) konta licytującego. Ten identyfikator można pobrać za pomocą zasobu Bidders.
google_push Wskazuje, że to przekierowanie kończy proces dopasowywania pikseli. Musisz tu podać wartość z odpowiedniego tagu dopasowania Google.
google_hm

Zawiera dane, które reklamodawca chce przechowywać w tabeli dopasowań hostowanej przez Google.

google_ula Ciąg znaków używany do dodawania użytkownika do istniejącej listy użytkowników. Wymagany format wartości to userlistid[,timestamp]:
  • userlistid: pojedynczy liczbowy identyfikator listy użytkowników.
  • timestamp: opcjonalna sygnatura czasowa w formacie POSIX, która wskazuje, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL może być powtarzany, aby dodać użytkownika do wielu list.

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żytkowników z UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) lub w artykule **Jak będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody?** w [dokumentacji Authorized Buyers dotyczącej zasad TCF IAB w wersji 2.0](//support.google.com/authorizedbuyers/answer/9789378).

Inicjowane przez Google: jednokierunkowe dopasowywanie pikseli

Jednokierunkowe dopasowywanie pikseli różni się od dwukierunkowego przepływu pracy tym, że tag dopasowywania Google nie zawiera parametru określającego identyfikator użytkownika Google, ale nadal będzie wypełniać tabelę dopasowywania hostowaną przez Google. Może to być przydatne w sytuacjach, gdy system licytujący nie może przechowywać identyfikatorów użytkowników Google w swojej tabeli dopasowań. Przykładowy zmieniony proces został podsumowany w tych krokach:

Krok 1. Google umieszcza tag dopasowania

Google umieszcza tag dopasowania w przypadku wybranego algorytmicznie oferenta. 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 do adresu URL dopasowania plików cookie reklamodawcy

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

Punkt końcowy dopasowywania plików cookie reklamodawcy musi przekierowywać do usługi dopasowywania plików cookie Google, w tym do parametru google_hm wypełnionego danymi plików cookie zakodowanymi w formacie base64 obsługiwanym w internecie. Adres URL przekierowania może 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 oraz plik cookie Google w nagłówkach HTTP. Jeśli operacja się powiedzie, w kolejnych żądaniach stawek dotyczących tego użytkownika wyświetlenia będą zawierać dane dopasowania hostowane przez reklamodawcę w BidRequest.user.buyeruid. Reklamodawcy mogą też wypełniać listy użytkowników za pomocą określonych przez siebie danych o dopasowaniu hostowanym.

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

Otwarte ustalanie stawek umożliwia giełdom korzystanie z procesów dopasowywania plików cookie inicjowanych przez licytującegoinicjowanych przez Google, aby dopasować identyfikator użytkownika Google do jego pliku cookie. Cookie Match Assist (CMA) to dodatkowa funkcja dla giełd, która umożliwia im tworzenie tabel dopasowań z własnymi oferentami.

  1. Podczas umieszczania reklamy algorytm Google wybiera uczestniczącą w programie giełdę i umieszcza tag Cookie Match Assist o tej strukturze:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
  2. Tag dopasowywania CMA Google powoduje, że adres URL dopasowywania plików cookie platformy wymiany otrzymuje żądanie piksela.

  3. Punkt końcowy dopasowywania plików cookie platformy wymiany otrzymuje żądanie, w którym jej własna usługa dopasowywania plików cookie jest odpowiedzialna za dopasowanie identyfikatora użytkownika do jednego z jej reklamodawców. Na poniższym diagramie usługa dopasowywania plików cookie platformy wymiany reklam odpowiada przeglądarce użytkownika przekierowaniem do jednego z punktów końcowych reklamodawcy.
  4. Licytujący otrzymuje żądanie wraz z parametrami określonymi przez giełdę, aby dopasować identyfikator użytkownika do jego pliku cookie.

Ograniczenia

Ograniczanie częstotliwości żądań nowych dopasowań

Reklamodawcy są odpowiedzialni za ograniczanie liczby wywołań usługi dopasowywania plików cookie w przypadku użytkowników, którzy mają nowy wpis w tabeli dopasowań hostowanej przez Google. Wpis w hostowanej tabeli odpowiedników może wygasnąć po 14 dniach, po czym można go odświeżyć.

Odpowiadanie na wszystkie prośby o dopasowanie pikseli

Licytujący korzystający z przepływu pracy dopasowywania pikseli powinni odpowiadać na wszystkie przychodzące żądania dopasowywania pikseli, przesyłając odpowiedź zawierającą parametr google_push. Dzięki temu Google może egzekwować zasady, monitorując wykorzystanie. Jeśli współczynnik odpowiedzi reklamodawcy jest mniejszy niż 90%, Google ograniczy liczbę żądań dopasowania pikseli wysyłanych na jego konto.

Używanie punktów końcowych HTTPS

Wymagane jest, aby punkty końcowe używane we wszystkich przepływach pracy dopasowywania plików cookie korzystały z protokołu HTTPS.

Gdy odpowiadasz na żądanie Pixel Match wysłane do Ciebie przez HTTPS, musisz przekierować je do usługi dopasowywania plików cookie przez HTTPS. Podobnie punkt końcowy Cookie Match Assist, który przekierowuje do oferentów, również musi używać protokołu HTTPS. Jeśli wysyłasz żądania do Google przez HTTP częściej niż raz na 2 minuty, liczba żądań dopasowania wysyłanych na Twoje konto zostanie ograniczona.

Żądania dopasowywania plików cookie, które podlegają polityce Google w zakresie zgody użytkownika z UE, powinny wskazywać zgodę użytkownika. W takich żądaniach należy wskazać, że zgoda została uzyskana w jeden z tych sposobów:

Przykłady

Poniższe przykłady pokazują, jak używać usługi dopasowywania plików cookie do osiągania konkretnych celów. Pamiętaj, że o ile nie podano inaczej, zakłada się, że użytkownik, którego dotyczy działanie, nie pochodzi ze stanu USA, w którym obowiązują ograniczenia dotyczące prywatności.

Wypełnianie hostowanej przez reklamodawcę tabeli odpowiedników

Licytujący może użyć przepływu pracy Dopasowywanie plików cookie, aby wypełnić własną tabelę odpowiedników, podając w tagu dopasowania tylko parametry google_nidgoogle_cm. 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 reklamodawcy jest ustawiony na https://ad.network.com/pixel?id=1, a operacja dopasowywania plików cookie zakończy się powodzeniem, przekierowanie wysłane przez Google w odpowiedzi na tag dopasowywania reklamodawcy 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 wyglądać tak:

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

Kod błędu zależy od przyczyny błędu. Więcej informacji o możliwych kodach błędów w przypadku przepływu pracy dopasowywania plików cookie znajdziesz w sekcji Parametry adresu URL przekierowania.

Dodawanie do listy pojedynczych użytkowników

Parametr google_ula można określić w tagu dopasowania reklamodawcy, aby dodać użytkownika do listy użytkowników o podanym identyfikatorze. Jeśli w tabeli dopasowań hostowanej przez Google lub przez dostawcę znajduje się nowy wpis dotyczący użytkownika, dostawca może umieścić tag dopasowania zawierający parametry google_nidgoogle_ula, aby dodać użytkownika do określonej listy bez inicjowania pełnego procesu dopasowywania plików cookie. Więcej informacji znajdziesz w sekcji ograniczenia dotyczące 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" />

W przypadku odpowiedzi świadczącej o powodzeniu, gdy adres URL dopasowywania plików cookie reklamodawcy 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. użytkownik 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 otrzymasz google_ula. W przeciwieństwie do parametru tagu dopasowania zastępuje on sygnaturę czasową kodem stanu, aby wskazać, czy operacja zakończyła się sukcesem. Jeśli na przykład żądanie nie powiodło się, ponieważ konto licytującego nie miało dostępu do określonej listy użytkowników, adres URL przekierowania będzie wyglądać tak:

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

Dodawanie do wielu list użytkowników

Wyświetlający reklamy mogą określić, że użytkownik powinien zostać dodany do wielu list użytkowników, uwzględniając w tagu dopasowania kilka parametrów google_ula. 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 dla każdej listy użytkowników jest podobnie raportowany za pomocą różnych parametrów google_ula w przekierowaniu:

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

W poprzednim przekierowaniu widzimy, że operacja powiodła się w przypadku listy użytkowników o identyfikatorze 45678, ale nie powiodła się w przypadku listy użytkowników o identyfikatorze 12345, ponieważ reklamodawca nie miał do niej dostępu.

Aby przeprowadzić dopasowanie plików cookie i dodać użytkownika do listy użytkowników w ramach jednego żądania, tag dopasowania reklamodawcy powinien zawierać parametry google_cmgoogle_ula:

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

Adres URL przekierowania określony przez Google będzie zawierać google_gid,google_cvergoogle_ula. Może to wyglądać tak:

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

Przechowywanie dopasowania w tabeli dopasowań hostowanej przez Google

Jeśli reklamodawca chce przechowywać dane z plików cookie w tabeli dopasowań hostowanej przez Google i nie zamierza przechowywać dopasowania do identyfikatora użytkownika Google we własnej tabeli dopasowań, jego tag dopasowania musi zawierać parametr google_hm, którego wartość musi być ciągiem tekstowym z bezpiecznym kodowaniem Base64. W przypadku użytkownika, którego niezakodowane dane z pliku cookie reklamodawcy to Cookie number 1!, zakodowana wartość to Q29va2llIG51bWJlciAxIQ==. Zostanie ona użyta w tagu dopasowania, np. w tym:

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

W przypadku prawidłowej odpowiedzi, gdy adres URL dopasowywania plików cookie reklamodawcy to https://cookie-monster.com/pixel, adres URL przekierowania Google będzie wyglądać tak:

https://cookie-monster.com/pixel

Parametr google_gid nie znajduje się w przekierowaniu, ponieważ tag dopasowania nie zawierał parametru google_cm, a parametr google_hm nie jest uwzględniany w odpowiedziach z informacją o powodzeniu. W przyszłych pytaniach o stawkę dotyczących wyświetleń u tego użytkownika uczestnik aukcji otrzyma hostowane dane o dopasowaniu w BidRequest.user.buyeruid.

Jeśli zamiast tego reklamodawca użył tagu dopasowania, w którym wartość parametru 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

Poprzedni adres URL przekierowania zawiera wartość google_hm, co sugeruje, że operacja nie powiodła się, ponieważ nie udało się odkodować wartości.2

Tabele dopasowań hostowane przez Google i platformę licytującą z listami użytkowników

Jeśli oferent hostuje własną listę użytkowników oprócz listy użytkowników hostowanej przez Google i chce, aby jeden tag dopasowania dopasowywał obie tabele i dodawał użytkownika do danej listy użytkowników, tag dopasowania musi zawierać parametry google_cm, google_hmgoogle_ula. Jeśli dane z pliku cookie reklamodawcy to Cookie number 1!, zakodowana wartość to Q29va2llIG51bWJlciAxIQ==, co spowoduje wygenerowanie tagu dopasowania podobnego do tego:

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

W przypadku odpowiedzi informującej o powodzeniu, w której adres URL dopasowywania plików cookie reklamodawcy 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 reklamodawca może dopasować identyfikator użytkownika Google podany w parametrze google_gid do danych z plików cookie w tabeli odpowiedników. Dodatkowo mogą one stwierdzić, że operacje na hostowanej przez Google tabeli dopasowań i liście użytkowników zakończyły się powodzeniem. W konsekwencji każde wstępne kierowanie skonfigurowane przez reklamodawcę tak, aby kierować reklamy na listę identyfikatorów użytkowników, spowoduje, że reklamodawca będzie otrzymywać pytania o stawkę dotyczące wyświetleń od tych użytkowników. Podobnie w tych pytaniach o stawkę licytujący otrzyma dane o dopasowaniu hostowanym w BidRequest.user.buyeruid.