Dopasowywanie plików cookie

Dopasowywanie plików cookie to funkcja, która umożliwia dopasowanie pliku cookie (np. identyfikatora użytkownika, który przeglądał Twoją witrynę) do odpowiedniego identyfikatora użytkownika Google licytującego, a także tworzenie list użytkowników, które ułatwiają podejmowanie lepszych decyzji dotyczących określania stawek. W tym przewodniku omawiamy pojęcia stosowane w dopasowywaniu plików cookie, a także różne procesy dopasowywania plików cookie, a także ich warianty w określonych przypadkach użycia.

Pojęcia

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

W kontekście reklamy cyfrowej Google identyfikuje użytkowników korzystających z plików cookie należących do domeny doubleclick.net, a licytujący uczestniczący w określaniu stawek w czasie rzeczywistym mogą mieć własną domenę, w której określają grupę użytkowników, którzy chcą wyświetlać reklamy. Dopasowywanie plików cookie umożliwia licytującemu dopasowanie swoich plików cookie do plików cookie Google, aby określić, czy wyświetlenie przesłane w żądaniu stawki jest powiązane z jednym z docelowanych użytkowników. W żądaniu stawki otrzyma albo własne dane pliku cookie, albo identyfikator użytkownika Google powiązany z licytującym, który jest zaszyfrowaną formą pliku cookie doubleclick.net.

Usługa dopasowywania plików cookie opisana w tym przewodniku ułatwia tworzenie i utrzymywanie powiązania między plikiem cookie licytującego a identyfikatorem User ID Google, a także umożliwia wypełnianie list użytkowników.

Tabele odpowiedników

Za pomocą tabeli zgodności możesz zmapować identyfikator lub inne dane z jednej domeny do innej. Użytkownicy mogą korzystać z usługi dopasowywania plików cookie, aby wypełniać własne tabele odpowiedników przez mapowanie pliku cookie danego użytkownika na jego identyfikator użytkownika Google lub wypełnianie tabeli odpowiedników hostowanych przez Google. Tabele odpowiedników są niezbędne, by aplikacja licytującego mogła uzyskać dostęp do danych z plików cookie użytkownika, któremu zostało wyświetlone wyświetlenie.

Tabele odpowiedników hostowane przez Google

Aby ułatwić konserwację, skrócić czas oczekiwania i zapewnić dostęp do danych dopasowania użytkownikom w określonych regionach, zalecamy zezwolenie Google na hostowanie tabeli dopasowania. Dzięki temu możesz określić bezpieczny w internecie ciąg zakodowany w standardzie base64 (nazywany dalej hostowanymi danymi dopasowania), który zostanie zmapowany na identyfikator użytkownika Google danego użytkownika. Po ustaleniu dopasowania można go wykorzystać na te sposoby:

  • Określanie stawek w czasie rzeczywistym: w kolejnych żądaniach stawek dotyczących wyświetleń powiązanych z użytkownikiem Google, Google wyśle Ci hostowane dane dopasowania dopasowane do identyfikatora użytkownika Google. W implementacji OpenRTB Google parametrBidRequest.user.buyeruid będzie zawierać ciąg tekstowy obsługiwany w internecie i zakodowany w base64. Jeśli punkt końcowy ustalania stawek jest skonfigurowany do używania wycofanego protokołu RTB Google, w polu BidRequest.hosted_match_data zobaczysz tę wartość w postaci zdekodowanych bajtów.

  • Listy użytkowników: listy użytkowników mogą być wypełniane za pomocą identyfikatorów użytkowników Google lub hostowanych danych dopasowania.

  • Kierowanie wstępne: możesz skonfigurować kierowanie wstępne tak, aby otrzymywać tylko pytania o stawkę zawierające hostowane dane dopasowywania. Możesz go użyć, aby wyeliminować mniej trafne wyświetlenia dla użytkowników spoza Twojej przestrzeni 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ą procesów dopasowywania plików cookie opisanych poniżej lub za pomocą usługi przesyłania zbiorczego.

Pierwsze kroki

Aby rozpocząć korzystanie z dopasowywania plików cookie, skontaktuj się z technicznym menedżerem konta, który może włączyć określone przepływy pracy i pomóc Ci skonfigurować te opcje:

  • Identyfikator sieci dopasowania plików cookie (NID): ciąg znaków, 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 będzie akceptować i obsługiwać przychodzące żądania w ramach przepływów pracy związanych z dopasowywaniem plików cookie. Uczestnicy aukcji mogą umieszczać w tym adresie URL makra, aby kontrolować kolejność parametrów przekazywanych w ramach procesów dopasowywania plików cookie.
  • Tag dopasowania: tag, który musisz umieścić w przeglądarce użytkownika w ramach procesu dopasowywania plików cookie inicjowanego przez oferentów. Może ona być wyświetlana obok reklam lub w usługach internetowych poza reklamami.
  • URL raportu dotyczącego dopasowania plików cookie (opcjonalnie): 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 dopasowanie plików cookie się nie powiedzie za pomocą przekierowania HTTP 302. Domyślnie odpowiedzi będą wysyłane pod tym adresem URL tylko wtedy, gdy wystąpi błąd w operacji dopasowywania plików cookie, ale licytanci mogą poprosić o zawsze wysyłanie przekierowania.
  • URL wspomaganego dopasowania plików cookie: w przypadku giełd, które implementują przepływ pracy wspomaganego dopasowania plików cookie, jest to podstawowy URL punktu końcowego, który odpowiada na przychodzące żądania.
  • Limit pomocy przy dopasowywaniu plików cookie: w przypadku giełd stosujących proces pomocy przy dopasowaniu plików cookie jest to maksymalna liczba żądań, które ich adres URL dopasowywania plików cookie może otrzymać co sekundę. Ma to na celu zapobieganie przeciążaniu serwerów giełdy żądaniami CMA.

W przypadku dowolnego obsługiwanego przepływu pracy dopasowywania plików cookie parametry adresu URL dopasowywania plików cookie oferenta są zwykle dołączane w niegwarantowanej kolejności. Licytujący, których integracja wymaga spójnej kolejności parametrów, mogą umieszczać makra w adresie URL dopasowywania plików cookie, aby zagwarantować miejsce docelowe.

Obsługiwane makra

Uczestnicy aukcji mogą opcjonalnie skonfigurować adres URL dopasowywania plików cookie, 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:

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

Uczestnik aukcji ma zintegrowane dopasowywanie plików cookie z punktami końcowymi hostowanymi pod adresem https://user.bidder.com.cookies. Ich implementacja wymaga wstępnie zdefiniowanych parametrów oferentów oraz parametrów dopasowania Pixela w tej kolejności: google_push, google_gid, google_cvergoogle_error. Uczestnik aukcji może to osiągnąć, ustawiając w przypadku adresu URL dopasowania plików cookie:

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 do tego licytującego żądanie dopasowania, będzie ono wyglądać mniej więcej tak:

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 dopasowywania plików cookie obsługuje obecnie 3 przepływy pracy zależnie od przypadków użycia opisanych poniżej.

Dwukierunkowe dopasowywanie plików cookie to proces inicjowany przez licytującego, w którym użytkownik umieszcza w przeglądarce użytkownika tag dopasowania, który kieruje go do Google. Ten przepływ umożliwia zarówno Google, jak i licytującemu wypełnianie tabel odpowiedników. Poniżej znajdziesz prosty przykład tego procesu.

Krok 1. Umieść tag dopasowywania

Aby rozpocząć ten proces, licytujący musi umieścić tag dopasowania w taki sposób, aby renderował się 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" />

W tagu dopasowania możesz uwzględnić dodatkowe parametry, aby spełnić 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 dopasowania

Tag dopasowywania spowoduje, że usługa dopasowywania plików cookie Google otrzyma żądanie z przeglądarki użytkownika, która wygeneruje przekierowanie HTTP 302do adresu URL usługi dopasowywania plików cookie licytanta. Przekierowanie będzie zawierać parametry zapytania określające identyfikator użytkownika Google i jego numer wersji w adresie URL. Uczestnik aukcji otrzyma też plik cookie uwzględniony w nagłówkach żądania. W praktyce w przypadku adresu URL dopasowania plików cookie określonego jako https://ad.network.com/pixel adres URL przekierowania dla tagu prostego dopasowania 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 niewypełniony ciąg znaków zakodowany w standardzie base64, który jest bezpieczny dla sieci. W przypadku licytujących, którzy zdecydują się hostować tabelę dopasowania, zalecamy przechowywanie dokładnego ciągu znaków zwróconego przez usługę dopasowywania plików cookie. W kolejnych żądaniach stawek będą one odpowiadać wartościom określonym za pomocą parametru BidRequest.user.id w OpenRTB lub parametru BidRequest.google_user_id w wycofanym protokole Google RTB.

Wersja określona w nawiasach kwadratowych (google_cver) wskazuje numer wersji identyfikatora użytkownika Google. Identyfikator użytkownika Google danego użytkownika zmienia się rzadko, a potem się zwiększa.

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

Krok 3. Uczestnik aukcji przetwarza przekierowanie i reaguje na nie pikselem

Uczestnik aukcji otrzymuje przekierowanie do adresu URL dopasowywania plików cookie, który zawiera parametry określone przez niego w pierwszym kroku oraz parametry podane przez Google w drugim kroku. Oprócz tego otrzymają też plik cookie w nagłówkach HTTP. Jeśli operacja się powiedzie, licytujący, który hostuje własną tabelę dopasowania, może dopasować swój plik cookie do identyfikatora użytkownika Google podanego w odpowiedzi. Uczestnikom aukcji zalecamy przechowywanie dokładnego ciągu zwróconego przez usługę dopasowywania plików cookie.

Jeśli operacja się nie powiedzie, licytujący otrzyma parametr google_error w przekierowaniu. Jest to wartość liczbowa odpowiadająca różnym stanom błędu, które identyfikują konkretny 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ć tego użytkownika, umieszczając nowy tag dopasowania.

Licytujący musi zawsze wyświetlić w odpowiedzi obraz niewidocznego piksela 1 x 1 lub zwrócić odpowiedź HTTP 204 Brak treści.

Ten proces jest zilustrowany na diagramie poniżej, na którym żądania i odpowiedzi są oznaczone strzałkami, a elementy danych, które im towarzyszą, 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 Wskazuje usłudze dopasowywania plików cookie Google, że powinna przeprowadzić dopasowywanie plików cookie. Wartość tego parametru jest ignorowana i może zostać pominięty.
google_sc Ten parametr został wycofany. Ustawia plik cookie Google dla użytkownika, jeśli go nie ma. Wartość tego parametru jest ignorowana i może zostać pominięty. Jeśli nie ma pliku cookie, pominięcie tego parametru powoduje błąd.
google_no_sc Ten parametr został wycofany. Oznacza to, że usługa Google dopasowywania plików cookie nie powinna ustawiać pliku cookie dla użytkownika, jeśli taki plik nie jest dostępny. Wartość tego parametru jest ignorowana i może zostać pominięty.
google_hm

Dane, które licytujący chce przechowywać w hostowanej przez Google tabeli dopasowania.

Wartość to ciąg znaków zakodowany w formacie base64 (opcjonalnie z wypełnieniem). Dane nieprzetworzone nie mogą mieć więcej niż 40 bajtów. Na przykład: Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Zakodowany ciąg znaków w adresie URL, który licytujący może podać, jeśli chce, aby Google przekierowywało HTTP 302 do zakodowanego adresu URL tego tagu dopasowania. Dzięki temu Google może być umieszczane na początku łańcucha wywołań partnerów. Jeśli podasz tu wartość bez google_hm lub google_cm, wystąpi błąd.
google_ula Ciąg znaków służący do dodawania 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, wskazująca, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL można powtórzyć, by dodać użytkownika do większej liczby list.

gdpr Wskazuje, że żądanie podlega ograniczeniom wynikającym z RODO dotyczącym użycia danych. Więcej informacji znajdziesz w  wymaganiach dotyczących zgody użytkowników z UE poniżej lub w sekcji Wpływ na zgodność z zasadami dopasowywania plików cookie dokumentacji TCF w wersji 2.0 opracowanej przez IAB dla autoryzowanych kupujących.

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 sekcjach Wymagania dotyczące zgody użytkownika z UE poniżej lub w sekcji Jak będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody? w dokumentacji dotyczącej przejrzystości i uzyskiwania zgody na przetwarzanie danych w Authorized Buyers w wersji 2.0.
process_consent Wskazuje, że licytujący uzyskał od użytkownika końcowego zgodę 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 w żądaniu dostępne są inne parametry zgody (gdpr_consent), ten parametr jest ignorowany.

Przykład: process_consent=T

Oprócz powyższych parametrów oferenci mogą podać własne, które zostaną dołączone jako parametry do adresu URL przekierowania. Pamiętaj, że parametry zdefiniowane przez licytującego z prefiksem google_ będą ignorowane, ponieważ są zarezerwowane przez Google do wykorzystania w przyszłości. Kolejność parametrów nie jest gwarantowana. 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

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

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

Wartość liczby całkowitej wskazująca ogólny błąd żądania. Otrzymanie kodu oznacza, że nie przeprowadzono żadnych operacji 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 pomocą tego pliku.
  • 2: nie określono żadnych prawidłowych operacji. Na przykład otrzymano żądanie bez operacji.
  • 3: użytkownik nie ma pliku cookie Google. Google nie ustawia pliku cookie za pomocą usługi dopasowywania plików cookie.
  • 4: Podano sprzeczne operacje. Nie możesz podać w tym samym żądaniu flag google_pushgoogle_cm, ponieważ mają one sprzeczne przeznaczenie.
  • 5: nieprawidłowy parametr google_push został przekazany w ramach przekierowania do serwera Google jako część dwukierunkowego żądania dopasowania pikseli. Przekierowanie musi mieć ustawienie google_push na tę samą wartość, która została Ci przekazana w pierwszym żądaniu piksela.
  • 6: w tagu dopasowania podano nieprawidłowy identyfikator NID.
  • 7: wykryto nieprawidłowy plik cookie.
  • 8: nieużywany. Nie znaleziono pliku cookie.
  • 9: nie znaleziono pliku cookie, podjęto próbę ustawienia pliku cookie testowego.
  • 10: parametr google_redir został użyty bez określenia google_hm lub był używany razem z parametrem google_cm.
  • 15: prośba pochodzi z regionu, w którym Google wymaga, aby tabela dopasowania była hostowana przez Google. W związku z tym ta odpowiedź nie zawiera identyfikatora użytkownika Google. Obecnie jest ona włączona tylko w przypadku niewielkiego odsetka ruchu, ale planujemy wdrożenie jej w czerwcu 2020 r.
google_hm

Pojawia się tylko wtedy, gdy próba zapisu w tabeli dopasowania hostowanej przez Google zakończy się niepowodzeniem. W takim przypadku jego wartością jest jeden z następujących kodów stanu:

  • 1 – Zabronione: klient nie został jeszcze dodany do białej listy, aby mógł zapisywać rekordy w gospodarowanej tabeli zgodności.
  • 2 – błąd dekodowania: nie udało się zdekodować wartości parametru.
  • 3 – za długa ładunek: wartość parametru odkodowana na ponad 24 bajty danych.
  • 4 – błąd wewnętrzny: wystąpił błąd wewnętrzny podczas zapisywania danych.
  • 5 – Ograniczony: ten zapis nie został przetworzony z powodu ograniczania.
google_ula

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

Np. google_ula=1234567890,0

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

  • 0 – brak błędów. Użytkownik został dodany do listy użytkowników.
  • 2 – brak uprawnień. 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 atrybutu zamkniętego. 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 opisujemy, jak może wyglądać dopasowywanie plików cookie w przypadku typowego użytkownika przeglądającego stronę internetową.

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

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

Jak to działa:

  1. ExampleNews.com renderuje i wywołuje reklamy z Google (Ad Manager).
  2. Jednostka reklamowa kwalifikuje się do alokacji dynamicznej, więc Google wysyła żądania stawek do FinestDSP i innych licytujących za pomocą usługi określania stawek w czasie rzeczywistym.
  3. Aplikacja licytanta w ramach platformy DSP FinestDSP odbiera i przetwarza pytanie o stawkę, a następnie wysyła odpowiedź na pytanie o stawkę.
  4. Google otrzymuje odpowiedzi na stawki od licytujących, w tym od FinestDSP, która określa reklamę z tagiem dopasowania (pikselem).
  5. FinestDSP wygrywa aukcję. Google wyświetla tag reklamy i tag dopasowywania FinestDSP Jane.
  6. Tag dopasowywania wywołuje usługę Google Cookie Match Service, która określa parametry google_nid i google_cm.
  7. Usługa dopasowywania plików cookie odczytuje plik cookie Google użytkownika i wyśle do jego przeglądarki 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 FinestDSP.
  9. Punkt końcowy dopasowywania plików cookie FinestDSP przetwarza żądanie przekierowania, które zawiera parametry URL ustawione przez Google oraz plik cookie Jane w nagłówkach HTTP. FinestDSP może teraz zapisać mapowanie swojego pliku cookie na google_gid w tabeli odpowiedników.
  10. FinestDSP odpowiada na przekierowanie za pomocą niewidocznego piksela 1 x 1.
Scenariusz 2. Użytkownik z dotychczasowym mapowaniem

Tydzień po scenariuszu 1 Jane ponownie odwiedza witrynę ExampleNews.com. Teraz, gdy na komputerze Jane są zarówno pliki cookie licytującego, jak i Ad Managera, wyjaśniamy, jak działa dopasowywanie.

  1. Strona internetowa jest renderowana, co powoduje, że Google (Ad Manager) wysyła żądania reklam, które będą renderowane na stronie.
  2. Podczas aukcji reklam Google wysyła pytanie o stawkę do odpowiednich systemów licytujących, w tym do FinestDSP.
  3. FinestDSP otrzymuje pytanie o stawkę, w tym sygnały takie jak google_gid.
  4. FinestDSP wyszukuje w swojej tabeli dopasowania wartość google_gid i znajduje plik cookie powiązany z Janą, który został utworzony tydzień wcześniej (w sytuacji 1).
  5. Na podstawie informacji powiązanych z ciasteczkiem algorytm ustalania stawek w usłudze FinestDSP ustala stawkę za wyświetlenie i wygrywa aukcję.
  6. Joanna może zobaczyć reklamę dostosowaną do jej zainteresowań na podstawie informacji, które posiada FinestDSP.

Jednokierunkowe dopasowywanie plików cookie jest podobne do dwukierunkowego przepływu pracy, ale z tą różnicą, że tylko Google hostuje i wypełnia tabelę dopasowań. Można go używać w przypadkach, gdy licytujący nie ma uprawnień do hostowania identyfikatorów użytkowników Google w własnej tabeli dopasowania. Aby korzystać z tego procesu, konkurenci muszą zezwolić Google na hostowanie tabeli dopasowania, nie mogą już określać wartości google_cm w żądaniach do usługi dopasowywania plików cookie Google i w konsekwencji nie będą otrzymywać wartości google_gid do wypełniania własnej tabeli dopasowania. Gdy Google ustali dopasowanie użytkownika, oferenci mogą dodać go do list użytkowników, korzystając z własnych danych plików cookie. Podobnie pytania o stawkę dotyczące tych użytkowników będą wykluczać identyfikator użytkownika Google, ale będą zawierać dane dopasowania hostowanego. Poniżej znajdziesz prosty przykład zaktualizowanego procesu.

Aby rozpocząć ten proces, licytujący musi umieścić tag dopasowania w taki sposób, aby był renderowany w przeglądarce użytkownika. W odróżnieniu od procesu w przypadku użytkowników spoza stanu USA, w którym obowiązują ograniczenia związane z ochroną prywatności, tag dopasowania musi kierować przeglądarkę użytkownika na adres URL dopasowania plików cookie. Jeśli na przykład skonfigurujesz dopasowywanie plików cookie z adresem URLhttps://ad.network.com/pixel, będzie ono wyglądać tak:

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

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

Punkt końcowy dopasowywania plików cookie licytującego musi przekierowywać do usługi dopasowywania plików cookie Google, w tym do parametru google_hm wypełnionego danymi z plików cookie zaszyfrowanych w standardzie base64. 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. Google wyświetla piksel w przypadku udanego lub błędu przekierowania, jeśli został podany URL raportu

Jeśli operacja dopasowania pliku cookie zakończy się powodzeniem lub na koncie licytującego nie ma określonego adresu URL raportu dopasowywania plików cookie, Google wyświetli domyślnie przezroczysty piksel 1 x 1. Na tym kończy się ten proces. Wyświetlenia dla tego użytkownika w kolejnych pytaniach o stawkę będą zawierać dane dopasowywania hostowane przez oferenta w pliku BidRequest.user.buyeruid w przypadku OpenRTB lub BidRequest.hosted_match_data w przypadku przestarzałego protokołu Google RTB. Uczestnicy aukcji mogą też wypełniać listy użytkowników za pomocą hostowanych danych dopasowania.

W przeciwnym razie, jeśli wystąpi błąd, Google przekieruje licytanta na adres URL raportu o dopasowywaniu plików cookie z powodem błędu określonym w parametrze google_error. Gdyby adres URL raportu o dopasowaniu plików cookie licytującego miał wartość https://ad.network.com/report, adres URL przekierowania wyglądałby tak:

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

Przeglądarka użytkownika przekieruje użytkownika na adres URL raportu o dopasowaniu plików cookie licytującego, uwzględniając w nim przyczynę błędu (jeśli występuje) podaną przez Google w parametrze google_error. Więcej informacji o interpretowaniu kodu błędu znajdziesz w opisie parametru.

Krok 6. Usługa określania stawek wyświetla przezroczysty piksel o wymiarach 1 x 1

Uczestnik 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 w stanach USA z ograniczeniami dotyczącymi prywatności przedstawia diagram poniżej. Żądania i odpowiedzi są na nim oznaczone strzałkami, a towarzyszące im elementy danych – nawiasami.

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 go nie ma. Wartość parametru jest ignorowana i może zostać pominięta. Pominięcie tego parametru spowoduje błąd, jeśli nie ma pliku cookie.
google_no_sc Ten parametr został wycofany. Wskazuje to usłudze dopasowywania plików cookie Google, że nie powinna ustawiać pliku cookie dla użytkownika, jeśli nie ma go w przypadku danego użytkownika. Wartość parametru jest ignorowana i może zostać pominięta.
google_hm

Zawiera dane, które licytujący chce przechowywać w usługowej tabeli dopasowania hostowanej przez Google.

google_redir Zakodowany adres URL, do którego 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 znaków służący do dodawania 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, wskazująca, kiedy użytkownik został dodany do listy użytkowników.

Ten parametr adresu URL można powtórzyć, by dodać użytkownika do większej liczby list.

gdpr Wskazuje, że żądanie podlega ograniczeniom wynikającym z RODO dotyczącym użycia danych. Więcej informacji znajdziesz poniżej w sekcji Wymagania w zakresie zgody użytkownika z UE lub w sekcji Wpływ na kwalifikację do dopasowywania plików cookie w dokumentacji dotyczącej przejrzystości i uzyskiwania zgody na przetwarzanie danych w Authorized Buyers 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 wymaganiach dotyczących zgody użytkowników w UE poniżej lub w sekcji Jak będzie przekazywany ciąg tekstowy dotyczący przejrzystości i zgody na przetwarzanie danych? dokumentacji Zasad TCF IAB w wersji 2.0 dla autoryzowanych kupujących.
process_consent Wskazuje, że licytujący uzyskał od użytkownika końcowego zgodę 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 w żądaniu dostępne są 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 zostanie odebrana, oznacza to, że nie wykonano żadnych operacji i nie ustawiono żadnych innych parametrów odpowiedzi google_. Obsługiwane wartości błędów:

  • 1: użytkownik ma plik cookie Google, ale zrezygnował ze śledzenia za pomocą tego pliku.
  • 2: nie określono żadnych prawidłowych operacji. Na przykład otrzymano żądanie bez operacji.
  • 3: użytkownik nie ma pliku cookie Google. Google nie ustawia pliku cookie za pomocą usługi dopasowywania plików cookie.
  • 4: Podano sprzeczne operacje. Nie możesz podać w tym samym żądaniu flag google_pushgoogle_cm, ponieważ mają one sprzeczne przeznaczenie.
  • 5: w ramach przekierowania na serwer Google w ramach dwukierunkowego żądania dopasowania pikseli przekazano nieprawidłowy parametr google_push. Przekierowanie musi ustawić parametr google_push na tę samą wartość, która została przekazana w pierwotnym żądaniu pikselu.
  • 6: w tagu dopasowania podano nieprawidłowy identyfikator NID.
  • 7: wykryto nieprawidłowy plik cookie.
  • 8: nieużywany. Nie znaleziono pliku cookie.
  • 9: nie znaleziono pliku cookie, podjęto próbę ustawienia pliku cookie testowego.
  • 10: parametr google_redir został użyty bez określenia google_hm lub był używany razem z parametrem google_cm.
  • 15: prośba pochodzi z regionu, w którym Google wymaga, aby tabela dopasowania była hostowana przez Google. W związku z tym ta odpowiedź nie zawiera identyfikatora użytkownika Google. Obecnie jest ona włączona tylko w przypadku niewielkiego odsetka ruchu, ale planujemy wdrożenie jej w czerwcu 2020 r.

Inicjowane przez Google: dwukierunkowe dopasowywanie pikseli

Dwukierunkowe dopasowywanie pikseli to proces w usłudze dopasowywania plików cookie Google, w którym Google próbuje dopasować identyfikator użytkownika Google do wybranego algorytmicznie licytanta innego niż zwycięzca aukcji z określaniem stawek w czasie rzeczywistym. Po umieszczeniu reklamy Google umieszcza w niej tag dopasowania, który wskazuje przeglądarce użytkownika wczytanie przezroczystego piksela z adresu URL dopasowywania plików cookie wybranego licytującego. Umożliwi to zarówno Google, jak i uczestnikom aukcji wypełnianie tabeli odpowiedników danym użytkownikiem. Poniżej znajdziesz prosty przykład tego procesu.

Krok 1. Google umieszcza tag dopasowania

Gdy w przeglądarce użytkownika wczytuje się strona wydawcy uczestniczącego w programie, a miejsce na reklamę na tej stronie jest wypełnione przez Google, może zostać umieszczony tag dopasowania, który prosi o piksel od 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 tabeli odpowiedników. W przypadku adresu URL dopasowania plików cookie określonego jako https://ad.network.com/pixel ma on następującą strukturę:

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

Licytujący otrzymujący żądania dopasowania pikseli muszą w odpowiedzi użyć przekierowania do usługi Google dopasowywania plików cookie, która ma taką strukturę:

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

Uwaga: powyższy adres URL przekierowania jest podobny do adresu URL użytego w tagu dopasowywania w ramach przepływu pracy dopasowywania plików cookie inicjowanego przez oferentów. 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 procesu inicjowanego przez licytującego, dodatkowe parametry można określić, aby spełniać dodatkowe przypadki użycia.

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

Google rejestruje, że dla danego użytkownika utworzono dopasowanie, i przetwarza wszystkie dodatkowe operacje żądane przez parametry zapytania. Na koniec Google odpowiada przezroczystym pikselem 1 x 1.

Schemat procesu dopasowywania pikseli

Ten przepływ pracy przedstawiono na diagramie poniżej. Żądania i odpowiedzi są oznaczone 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 spoza stanów USA, w których obowiązują ograniczenia dotyczące prywatności, zawsze będzie to określone 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 proces dopasowywania piksela. Wartość musi być zwracana za pomocą odpowiedniego parametru w odpowiedzi przekierowania oferenta.
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 w UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) poniżej lub w sekcji **Jak przekazywany jest ciąg tekstowy dotyczący przejrzystości i zgody?** w [dokumentacji Zasad IAB TCF w wersji 2.0 dla autoryzowanych kupujących](//support.google.com/authorizedbuyers/answer/9789378).

Parametry przekierowania w dopasowaniu pikseli licytującego

Parametr Opis
google_nid Identyfikator sieci (NID) konta licytującego. Ten identyfikator można pobrać z zasobu Licytujący.
google_push Wskazuje, że to przekierowanie kończy przetwarzanie danych w ramach procesu dopasowywania pikseli. Tutaj musisz podać wartość z odpowiedniego tagu dopasowania Google.
google_hm

Zawiera dane, które licytujący chce przechowywać w usługowej tabeli dopasowania hostowanej przez Google.

google_ula Ciąg znaków używany do 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, wskazująca, 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 w UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) poniżej lub w sekcji **Jak przekazywany jest ciąg tekstowy dotyczący przejrzystości i zgody?** w [dokumentacji Zasad IAB TCF w wersji 2.0 dla autoryzowanych kupujących](//support.google.com/authorizedbuyers/answer/9789378).

Inicjowane przez Google: jednokierunkowe dopasowywanie pikseli

Dopasowywanie pikseli w jednym kierunku różni się od procesu dwukierunkowego tym, że tag dopasowywania Google nie zawiera parametru określającego identyfikator użytkownika Google, ale nadal będzie wypełniać hostowaną przez Google tabelę odpowiedników. Można go używać w przypadkach, gdy system licytujący nie ma uprawnień do przechowywania identyfikatorów użytkowników Google w własnej tabeli dopasowania. Poniżej znajdziesz prosty przykład zaktualizowanego procesu.

Krok 1. Google umieszcza tag dopasowania

Google umieszcza tag dopasowania dla 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 dopasowywania gotowania licytującego

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

Punkt końcowy dopasowywania plików cookie licytującego musi przekierowywać do usługi dopasowywania plików cookie Google, w tym do parametru google_hm wypełnionego danymi plików cookie w formacie web-safe zakodowanym w formacie base64. 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ę uda, wyświetlenia w przypadku tego użytkownika w kolejnych pytaniach o stawkę będą zawierały hostowane dane dopasowania licytującego w polu BidRequest.user.buyeruid w przypadku OpenRTB lub BidRequest.hosted_match_data w przypadku wycofanego protokołu Google RTB. Licytujący mogą też wypełniać listy użytkowników, korzystając z określonych przez siebie hostowanych danych dopasowania.

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

Otwarte ustalanie stawek umożliwia giełdom wykorzystywanie procesów dopasowywania plików cookie zainicjowanych przez licytującego i zainicjowanych przez Google w celu dopasowywania identyfikatorów użytkowników Google do ich plików cookie. Cookie Match Assist (CMA) to dodatkowa funkcja dla giełd, która umożliwia im tworzenie tabel dopasowania z udziałem własnych licytujących.

  1. Podczas umieszczania reklamy Google wybiera algorytmicznie giełdę biorącą udział w programie i umieszcza tag pomocy w dopasowywaniu plików cookie o tej 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. Punkt końcowy dopasowywania plików cookie giełdy odbiera żądanie, a jej własna usługa dopasowywania plików cookie odpowiada za dopasowanie identyfikatora użytkownika do jednego z licytujących. Na diagramie poniżej usługa dopasowywania plików cookie giełdy odpowiada przeglądarce użytkownika przekierowaniem do jednego z punktów końcowych oferenta.
  4. Uczestnik aukcji otrzymuje żądanie wraz z parametrami określonymi przez giełdę, aby dopasować identyfikator użytkownika do jego pliku cookie.

Ograniczenia

Ograniczenie częstotliwości żądań dotyczących nowych dopasowań

Uczestnicy aukcji są odpowiedzialni za ograniczenie liczby wywołań usługi dopasowywania plików cookie w przypadku użytkowników, którzy mają nowy wpis w usługowej tabeli dopasowywania hostowanej przez Google. Wpis w tabeli odpowiedników hostowanych może zostać uznany za nieważny po 14 dniach. Po tym czasie można go odświeżyć.

Odpowiedzi na wszystkie żądania dopasowania piksela

Licytujący, którzy korzystają z procesu dopasowywania pikseli, powinni odpowiadać na wszystkie przychodzące żądania dopasowania pikseli za pomocą odpowiedzi zawierającej parametr google_push. Pozwala to Google egzekwować zasady, monitorując wykorzystanie. Jeśli współczynnik odpowiedzi licytanta spadnie poniżej 90%, Google ograniczy liczbę żądań dopasowania do Pixela wysył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ć protokołu HTTPS.

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

W przypadku żądań dopasowywania plików cookie, które podlegają polityce Google w zakresie zgody użytkownika z UE, należy wskazać zgodę użytkownika. Takie żądania muszą wskazywać, że użytkownik wyraził zgodę na przetwarzanie danych w jeden z tych sposobów:

Przykłady

Przykłady poniżej pokazują, jak używać usługi dopasowywania plików cookie do realizacji konkretnych celów. O ile nie zaznaczono inaczej, przyjmuje się, że użytkownik, którego dotyczy działanie, nie pochodzi ze stanu w USA, w którym obowiązują ograniczenia dotyczące prywatności.

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

Uczestnik aukcji może użyć przepływu pracy do dopasowywania 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 licytującego ma wartość https://ad.network.com/pixel?id=1, a dopasowywanie plików cookie zakończy się powodzeniem, przekierowanie wysył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 zakończy się niepowodzeniem, ponieważ użytkownik nie ma pliku cookie Google, odpowiedź będzie następująca:

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 w ramach 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 licytującego, aby dodać użytkownika do listy użytkowników o podanym identyfikatorze. Jeśli tabela dopasowania hostowana przez Google lub licytującego zawiera nowy wpis dotyczący użytkownika, licytujący może umieścić tag dopasowania, który zawiera parametry google_nidgoogle_ula, aby dodać użytkownika do określonej listy bez inicjowania pełnego procesu dopasowywania plików cookie. Więcej szczegółowych informacji znajdziesz w ograniczeniach dotyczących wywoływania usługi dopasowywania plików cookie. Odpowiadający 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 pomyślnej odpowiedzi, w której adres URL dopasowywania plików cookie oferenta to https://ad.network.com/pixel, adres URL przekierowania Google będzie miał postać:

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

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

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

Jeśli wystąpi błąd związany z dodaniem użytkownika do listy, w przekierowaniu pojawi się kod google_ula. W przeciwieństwie do odpowiadającego mu parametru tagu dopasowania zastępuje on sygnaturę czasową kodem stanu, aby wskazać, że operacja zakończyła się sukcesem. 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, adres URL przekierowania będzie wyglądał tak:

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

Dodawanie do wielu list użytkowników

Użytkownicy mogą określić, że użytkownik ma zostać dodany do wielu list użytkowników, podają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 w przypadku 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 przekierowaniu powyżej widzimy, że operacja została wykonana w przypadku listy użytkowników o identyfikatorze 45678, ale w przypadku listy użytkowników o identyfikatorze 12345 zakończyła się ona niepowodzeniem, ponieważ licytujący nie miał dostępu do tej listy.

Aby w jednym żądaniu wykonać dopasowanie pliku cookie i dodać użytkownika do listy użytkowników, tag dopasowania oferenta powinien zawierać te elementy: google_cmgoogle_ula:

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

Podany przez Google adres URL przekierowania zawiera atrybuty 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

Przechowywanie dopasowania w hostowanej przez Google tabeli odpowiedników

Jeśli licytujący chce przechowywać dane z plików cookie w utrzymywanej przez Google tabeli dopasowań i nie zamierza przechowywać w swojej własnej tabeli dopasowań dopasowań z identyfikatorem użytkownika Google, jego tag dopasowania musi zawierać parametr google_hm, którego wartość musi być bezpiecznym ciągiem znaków w formacie Base64. W przypadku użytkownika, którego niezakodowane dane z ciasteczka oferenta mają wartość Cookie number 1!, zakodowana wartość będzie wynosić Q29va2llIG51bWJlciAxIQ== i będzie używana w tagu dopasowania o takim kształcie:

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

Aby uzyskać skuteczną odpowiedź, w której adres URL dopasowywania plików cookie licytującego to https://cookie-monster.com/pixel, przekierowanie Google będzie wyglądać tak:

https://cookie-monster.com/pixel

Parametr google_gid nie występuje w przekierowaniu, ponieważ tag dopasowywania nie zawierał wartości google_cm, a wartość google_hm nie jest uwzględniana w odpowiedziach powodujących powodzenie. W przyszłych pytaniach o stawkę dotyczących wyświetleń tego użytkownika system licytujący otrzyma dane o zgodności hostowanej w ramach BidRequest.user.buyeruid w przypadku OpenRTB lub BidRequest.hosted_match_data w przypadku przestarzałego protokołu Google RTB.

Jeśli zamiast tego licytujący użył tagu dopasowania, w którym wartość google_hm nie został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 2, co sugeruje, że operacja się nie powiodła, ponieważ nie udało się odkodować wartości.

tabele dopasowywania hostowane przez oferentów i Google z listami użytkowników;

Jeśli licytujący hostuje własną listę użytkowników oprócz listy użytkowników hostowanej przez Google i chce, aby jeden tag dopasowania pasował do obu tabel i dodawał użytkownika do danej listy użytkowników, tag dopasowania musi zawierać parametry google_cm, google_hmgoogle_ula. Jeśli dane o pliku cookie oferenta to Cookie number 1!, zakodowana wartość będzie wynosić Q29va2llIG51bWJlciAxIQ==, co spowoduje utworzenie tagu dopasowania o takim kształcie:

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

Aby uzyskać skuteczną odpowiedź, w której adres URL dopasowywania plików cookie licytującego to https://cookie-monster.com/pixel, przekierowanie 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 polu google_gid do danych z plików cookie w tabeli odpowiedników. Mogą też sprawdzić, czy operacje związane z utrzymywaną przez Google tabelą dopasowania i listą użytkowników zakończyły się powodzeniem. W konsekwencji tego każdy rodzaj wstępnego kierowania, który jest skonfigurowany tak, aby kierować reklamy na określony identyfikator listy użytkowników, będzie teraz otrzymywać pytania o stawkę dotyczące wyświetleń od tego użytkownika. Podobnie w tych żądaniach stawek licytujący otrzyma hostowane dane dopasowania w formacie BidRequest.user.buyeruid w przypadku OpenRTB lub BidRequest.hosted_match_data w przypadku przestarzałego protokołu Google RTB.