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

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 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.

Makra dopasowania plików cookie

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:

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

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

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.

Diagram procesu dopasowywania plików cookie

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

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

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

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, 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.

Krok 1. Umieść tag dopasowywania kierowany na adres URL dopasowywania plików cookie licytującego

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.

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

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

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

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

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

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.

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 w przypadku licytującego przekierowują do usługi Google do dopasowywania plików cookie

Parametry adresu URL służące do przekierowania przez Google do adresu URL raportu o dopasowywaniu plików cookie w oferującym

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

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

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

Parametry przekierowania w dopasowaniu pikseli licytującego

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.

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ę 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.

Cookie Match Assist

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.

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 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.

Wymagania dotyczące zgody użytkownika 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 muszą wskazywać, że użytkownik wyraził zgodę na przetwarzanie danych w jeden z tych sposobów:

• Zasady TCF w wersji 2: obejmują parametry gdpr i gdpr_consent. Więcej informacji znajdziesz w dokumentacji dotyczącej przejrzystości i uzyskiwania zgody na przetwarzanie danych opracowanych przez IAB w Authorized Buyers 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 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_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 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_nid i google_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.

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

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

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.