Dopasowywanie plików cookie

Dopasowywanie plików cookie to funkcja, która umożliwia dopasowywanie pliku cookie (np. identyfikatora użytkownika, który przeglądał Twoją witrynę) do odpowiadającego mu identyfikatora użytkownika Google powiązanego z licytującym. Dzięki temu możesz tworzyć listy użytkowników, które ułatwiają podejmowanie skuteczniejszych decyzji dotyczących określania stawek. W tym przewodniku opisane są pojęcia używane w dopasowywaniu plików cookie, a także różne procesy dopasowywania plików cookie i ich warianty w różnych przypadkach użycia.

Pojęcia

Czym jest dopasowywanie plików cookie?

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 2 właściciele domen zgodziliby się na wymianę tych danych, model zabezpieczeń przeglądarek internetowych uniemożliwia jednej przeglądarce odczytanie pliku cookie ustawionego przez inną przeglądarkę.

W kontekście reklam cyfrowych Google identyfikuje użytkowników za pomocą plików cookie należących do domeny doubleclick.net, a oferenci biorący udział w określaniu stawek w czasie rzeczywistym mogą mieć własną domenę, w której identyfikują użytkowników, którym chcą wyświetlać reklamy. Dopasowywanie plików cookie umożliwia licytującemu dopasowanie swoich plików cookie do plików 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 dopasowywania są niezbędne, aby aplikacja oferenta mogła uzyskać dostęp do danych z plików cookie dotyczących użytkownika, któremu wyświetla się reklama.

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 dopasowań. Dzięki temu możesz określić ciąg znaków w bezpiecznym formacie Base64 (zwany dalej hostowanymi danymi służącymi do dopasowywania), 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 pod kątem używania przestarzałego protokołu Google RTB, otrzymasz te dane jako zdekodowane bajty w polu BidRequest.hosted_match_data.

• 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 dopasowania plików cookie: podstawowy URL punktu końcowego, który akceptuje i obsługuje przychodzące żądania w ramach przepływów pracy dopasowywania plików cookie. Uczestnicy aukcji mogą umieszczać w tym adresie URL makra, aby kontrolować kolejność parametrów przekazywanych w ramach przepływów pracy 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 wspomagania dopasowania plików cookie: w przypadku giełd, które implementują przepływ pracy wspomagania dopasowania plików cookie, jest to maksymalna liczba żądań, które ich adres URL dopasowania plików cookie może otrzymać w ciągu sekundy. Ma to zapobiec przeciążeniu serwerów giełdy przez żądania CMA.

Makra dopasowania plików cookie

W przypadku dowolnego obsługiwanego przepływu pracy dopasowania plików cookie parametry adresu URL dopasowania plików cookie oferenta są zwykle dołączane w niegwarantowanej kolejności. Uczestnicy aukcji, którzy korzystają z integracji wymagających spójnego uporządkowania parametrów, mogą umieszczać makra w adresach URL wspomaganego dopasowania plików cookie, aby zagwarantować ich umieszczenie.

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 makro i jego rozwinięte wartości:

Przykład makro

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_cver i google_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

Procesy związane z usługą dopasowywania plików cookie

Usługa dopasowywania plików cookie Google obsługuje obecnie 3 procesy robocze na potrzeby różnych przypadków użycia, które są opisane poniżej.

Inicjowane przez oferentów: dwukierunkowe dopasowywanie plików cookie

Dwukierunkowe dopasowywanie plików cookie to proces inicjowany przez licytanta, w którym umieszcza on w przeglądarce użytkownika tag dopasowujący, który kieruje go do Google. Ten proces pozwala zarówno Google, jak i uczestnikom aukcji na wypełnianie tabeli dopasowań. Poniżej znajdziesz prosty przykład tego procesu.

Krok 1. Umieść tag dopasowania

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 licytantowi 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, jak widać powyżej, może wyglądać tak:

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

Identyfikator użytkownika Google przekazywany przez parametr google_gid to 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 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 będzie się rzadko zmieniać, a po zmianie będzie zwiększany.

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 odpowiadać, wyświetlając niewidoczny obraz o wymiarach 1 x 1 lub zwracając odpowiedź HTTP 204 Brak treści.

Diagram procesu dopasowywania plików cookie

Ten proces ilustruje poniższy diagram, 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

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 oferentę o nazwie z preiksem google_ zostaną zignorowane, ponieważ Google zarezerwowało je na potrzeby przyszłego rozwoju, a utrzymanie ich kolejności nie jest gwarantowane. Tag dopasowania zawierający parametry zdefiniowane przez licytującego może wyglądać tak:

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

Parametry adresu URL przekierowania

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_:

Przykładowe scenariusze dotyczące dopasowania plików cookie

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 czyści 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 ustalania stawek do FinestDSP i innych licytujących za pomocą usługi określania stawek w czasie rzeczywistym.
3. Aplikacja licytanta w platformie 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ę dopasowywania plików cookie Google, podając 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_gid i google_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 adresu URL ustawione przez Google oraz plik cookie Jane w nagłówkach HTTP. Firma FinestDSP może teraz przechowywać w tabeli dopasowania mapowanie pliku cookie na adres IPgoogle_gid.
10. FinestDSP reaguje na przekierowanie, zwracając niewidoczny piksel o wymiarach 1 x 1.

Scenariusz 2. Użytkownik z dotychczasowym mapowaniem

Tydzień po Scenariuszu 1 Jane ponownie odwiedza ExampleNews.com. Teraz, gdy na komputerze Jane są zarówno pliki cookie licytującego, jak i Ad Managera, wyjaśnimy, 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 Jane, 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. Jane może zobaczyć reklamę dostosowaną do jej zainteresowań na podstawie informacji, które posiada FinestDSP.

Inicjowane przez oferentów: dopasowywanie plików cookie w jednym kierunku

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, oferent musi zezwolić Google na hostowanie tabeli dopasowania, nie może już podawać wartości google_cm w żądaniach do usługi dopasowywania plików cookie Google i w konsekwencji nie otrzyma 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.

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

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 stanów USA, w których obowiązują ograniczenia dotyczące prywatności, tag dopasowywania musi kierować przeglądarkę użytkownika do Twojego adresu URL dopasowywania plików cookie. Jeśli na przykład skonfigurujesz dopasowywanie plików cookie z adresem URL https://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. Żądanie to będzie zawierać plik cookie w nagłówku HTTP, który należy wyodrębnić na potrzeby następnego kroku.

Krok 2. Przekieruj do usługi dopasowywania plików cookie Google

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

Krok 3. Przeglądarka użytkownika jest przekierowywana do usługi dopasowywania plików cookie Google

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 piksele w ramach przekierowania po powodzeniu lub błędzie

Jeśli operacja dopasowania plików cookie zakończy się powodzeniem lub na koncie licytującego nie ma określonego adresu URL raportu o dopasowywaniu plików cookie, Google domyślnie wyświetli przezroczysty piksel 1 x 1, a proces zakończy się na tym etapie. 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. Jeśli URL raportu dotyczącego dopasowania plików cookie oferenta to https://ad.network.com/report, adres URL przekierowania będzie wyglądać tak:

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

Krok 5. Przekierowanie przeglądarki użytkownika do adresu URL raportu o dopasowywaniu plików cookie oferenta

Przeglądarka użytkownika przekieruje go na adres URL raportu o dopasowywaniu plików cookie oferenta, w tym podany przez Google w parametrze google_error (jeśli występuje) powód błędu. 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.

Schemat procesu dopasowywania plików cookie w przypadku użytkowników ze stanów w USA, w których obowiązują ograniczenia dotyczące prywatności

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.

Parametry adresu URL służące do przekierowywania licytujących do usługi dopasowania plików cookie Google

Parametry adresu URL przekierowania Google do adresu URL raportu o dopasowaniu plików cookie oferenta

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. Gdy reklama zostanie umieszczona, Google umieści tag dopasowania, który spowoduje, że przeglądarka użytkownika wczyta przezroczysty piksel z adresu URL dopasowania plików cookie wybranego licytującego. Umożliwi to zarówno Google, jak i uczestnikom aukcji wypełnianie tabeli odpowiedników danymi danego użytkownika. 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 wyświetlenie piksela u 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" />

Krok 2. Uczestnik aukcji musi odpowiedzieć przekierowaniem do adresu URL usługi dopasowywania plików cookie Google

Uczestnicy aukcji, którzy otrzymują żądania dopasowania piksela, muszą odpowiedzieć przekierowaniem do usługi dopasowywania plików cookie Google, która jest skonstruowana w następujący sposób:

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 Pixel

Ten proces ilustruje poniższy diagram, na którym żądania i odpowiedzi są oznaczone strzałkami, a elementy danych, które im towarzyszą, są wymienione w nawiasach.

Parametry żądania tagu Google dopasowania do treści

Parametry przekierowania dopasowania pikseli oferenta

Inicjowane przez Google: jednokierunkowe dopasowywanie pikseli

Jednokierunkowe dopasowywanie pikseli różni się od dwukierunkowego tym, że tag dopasowywania Google nie zawiera parametru określającego identyfikator użytkownika Google, ale nadal będzie wypełniać tabelę odpowiedników hostowaną przez Google. 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 dopasowania pikseli oferenta

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

Krok 3. Przekieruj do usługi dopasowywania plików cookie Google

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

Krok 4. Przeglądarka użytkownika jest przekierowywana do usługi dopasowywania plików cookie Google

Google otrzyma przekierowanie zawierające określone przez Ciebie parametry oraz plik cookie Google w nagłówkach HTTP. Jeśli operacja się powiedzie, wyświetlenia dla tego użytkownika w kolejnych żądaniach stawek będą zawierać hostowane dane dopasowywania 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.

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

Cookie Match Assist

Otwarte ustalanie stawek umożliwia giełdom korzystanie z procesów dopasowywania plików cookie inicjowanych przez oferentów i inicjowanych 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 dopasowania z udziałem własnych licytujących.

Jak działa pomoc w dopasowywaniu plików cookie

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 od Google powoduje, że wymiana otrzymuje żądanie piksela za pomocą adresu URL dopasowania plików cookie.

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

Uczestnicy aukcji, którzy korzystają z procesu dopasowywania Pixela, powinni odpowiadać na wszystkie przychodzące żądania dopasowywania Pixela, przesyłając odpowiedź zawierającą 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 też 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.

Wymagania dotyczące zgody użytkowników z UE

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 są wymagane, aby wskazać, że zgoda została uzyskana w jeden z tych sposobów:

• TCFv2: obejmuje parametry gdpr i gdpr_consent. Szczegółowe informacje znajdziesz w  dokumentacji Authorized Buyers dotyczącej zasad IAB TCF w wersji 2.0.
• process_consent: oświadczenie, że licytujący uzyskał niezbędną zgodę użytkownika.

Przykłady

Przykłady poniżej pokazują, jak korzystać z 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 oferentę

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_nid i google_cm. Może to wyglądać tak:

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

Jeśli w przypadku oferenta parametr URL dopasowywania plików cookie ma wartość https://ad.network.com/pixel?id=1, a operacja dopasowywania plików cookie się powiedzie, przekierowanie, które Google wysyła w odpowiedzi na tag dopasowania oferenta, 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 przyczyny błędu. 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 pojedynczego użytkownika

Parametr google_ula można określić w tagu dopasowania oferenta, aby dodać użytkownika do listy użytkowników o danym identyfikatorze. Jeśli w tabeli dopasowania hostowanej przez Google lub przez oferentę znajduje się nowy wpis dotyczący danego użytkownika, oferent może umieścić tag dopasowania, który zawiera parametry google_nid i google_ula, aby dodać użytkownika do określonej listy bez inicjowania pełnego przepływu pracy związanego z dopasowywaniem plików cookie. Więcej informacji znajdziesz w sekcji ograniczenia 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 wyglądać tak:

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 powiodło się, ponieważ konto licytującego nie miało dostępu do określonej listy użytkowników, adres URL przekierowania będzie miał postać:

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 dotyczącej 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 powyższym przekierowaniu widać, że operacja się powiodła w przypadku listy użytkowników o identyfikatorze 45678, ale nie powiodła się w przypadku listy o identyfikatorze 12345, ponieważ licytujący nie miał do niej dostępu.

Przejdź przez proces dopasowywania plików cookie i dodaj użytkowników do 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_cm i google_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_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 tabeli dopasowań hostowanej przez Google

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" />

W przypadku prawidłowej odpowiedzi, w której adres URL dopasowywania plików cookie oferenta 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ł 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 hostowanych danych dopasowania w formacie 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 była zakodowana w formacie base64 (np. chocolate_chunk!), adres URL przekierowania może wyglądać tak:

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

Powyższy adres URL przekierowania 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_hm i google_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" />

W przypadku pomyślnej odpowiedzi, w której adres URL dopasowywania plików cookie oferenta to https://cookie-monster.com/pixel, adres URL przekierowania Google będzie wyglądać tak:

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

Po otrzymaniu przekierowania licytujący może dopasować identyfikator użytkownika Google podany w pliku google_gid do danych z pliku cookie w swojej 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.