Dopasowywanie plików cookie

Dopasowywanie plików cookie to funkcja, która umożliwia dopasowanie pliku cookie, np. identyfikator użytkownika, który przeglądał Twoją witrynę – z odpowiadającym mu identyfikatorów użytkownika Google dla konkretnego licytującego, a także tworzyć listy użytkowników, bardziej skutecznych opcji określania stawek. W tym przewodniku opisano koncepcje stosowane w plikach cookie dopasowania i różne procesy dopasowywania plików cookie oraz wszelkie odmiany; w określonych przypadkach użycia.

Pojęcia

Na czym polega dopasowywanie plików cookie?

Właściciele domen zwykle ustawiają zawartość plików cookie u użytkowników, którzy przeglądają strony swoich witryn, aby zidentyfikować użytkowników w danej domenie. Nawet wtedy, gdy 2 właściciele domen zgodziliby się na wymianę tych danych, przeglądarek internetowych nie zezwala jednej z nich na odczytywanie plików cookie ustawianych przez inny w Twojej domenie.

W kontekście reklamy cyfrowej Google identyfikuje użytkowników za pomocą plików cookie. należące do domeny doubleclick.net, a także licytujących mogą mieć własną domenę, w której wskazać grupę użytkowników, którym chcemy wyświetlać reklamy. Dopasowywanie plików cookie umożliwia systemowi licytującemu dopasowanie swoich plików cookie do plików Google, co pozwala określać, czy wyświetlenie wysłane w pytaniu o stawkę jest powiązane z jednym z na użytkowników docelowych, otrzymają oni dane z własnych plików cookie albo identyfikatora użytkownika Google, który jest zaszyfrowaną formą doubleclick.net plik cookie w pytaniu o stawkę.

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

Tabele odpowiedników

Tabela odpowiedników może służyć do mapowania identyfikatora lub innych danych z jednej domeny na innego użytkownika. Licytujący mogą używać usługi dopasowywania plików cookie, aby wypełniać własne pola tabele odpowiedników, mapując ich plik cookie danego użytkownika na plik Google tego użytkownika User ID lub uzupełnianie tabeli odpowiedników hostowanej przez Google. Tabele odpowiedników to niezbędne do tego, aby aplikacja licytującego mogła uzyskać dostęp do danych użytkownika w przypadku wyświetlenia reklamy.

Tabele odpowiedników hostowane przez Google

Ułatwienie konserwacji, skrócenie czasu oczekiwania oraz ułatwienie dopasowywania danych użytkowników w określonych regionach, zalecamy zezwolenie Google na hostowanie tabeli odpowiedników. Pozwala to określić bezpieczny w internecie ciąg zakodowany w formacie base64: nazywane dalej hostowanymi danymi dopasowania – które zostaną zmapowane na Identyfikator użytkownika Google. Gdy znajdziemy dopasowanie, w następujący sposób:

• Określanie stawek w czasie rzeczywistym: w kolejnych pytaniach o stawkę za wyświetlenia. powiązanego z użytkownikiem, Google wyśle Ci hostowane dane dopasowania, dopasowane do ich identyfikatora użytkownika Google. Jeśli punkt końcowy ustalania stawek jest skonfigurowany z protokołu RTB firmy Google, otrzymasz go w postaci zdekodowanych bajtów w polu BidRequest.hosted_match_data. W raporcie Google OpenRTB implementacji, BidRequest.user.buyeruid zwróci to jako bezpieczny dla sieci ciąg zakodowany w formacie base64.

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

• Kierowanie wstępne: Możesz skonfigurować kierowanie wstępne, aby otrzymywać tylko pytania o stawkę. zawierających hostowane dane dopasowywania. Pozwala to wyeliminować mniej trafne wyświetlenia reklam użytkownikom poza obszarem plików cookie.

Listy użytkowników

Do tworzenia list użytkowników i zarządzania nimi służy interfejs API określania stawek w czasie rzeczywistym. Po utworzeniu listy możesz ją wypełnić za pomocą procesów dopasowywania plików cookie opisanych poniżej lub za pomocą usługi przesyłania zbiorczego.

Pierwsze kroki

Aby zacząć korzystać z dopasowywania plików cookie, musisz skontaktować się ze swoim Techniczny menedżer konta, który może włączyć określone przepływy pracy i pomóc Ci skonfiguruj te elementy:

• Identyfikator sieci dopasowania plików cookie (NID): identyfikator jednoznacznie identyfikujący ciąg konta licytującego na potrzeby dopasowywania plików cookie i innych powiązanych operacji.
• URL dopasowania plików cookie: podstawowy adres URL punktu końcowego, który akceptuje pliki cookie. i obsługiwania żądań przychodzących w ramach procesów dopasowywania plików cookie. Licytujący mogą umieścić w tym adresie URL makra, aby: kontrolować kolejność parametrów przekazywanych do niej w procesach dopasowywania plików cookie.
• Tag dopasowania: tag, który musisz umieścić w przeglądarce użytkownika dla danej procesu dopasowywania plików cookie inicjowanego przez licytującego. Mogą się wyświetlać z reklamami, lub umieszczane w usługach internetowych poza reklamami.
• URL raportu dotyczącego dopasowywania plików cookie (opcjonalnie): w jednokierunkowym formacie procesu dopasowywania plików cookie, jest to opcjonalny adres URL, który można przekazać Określ punkt końcowy, który będzie otrzymywać szczegóły błędów w przypadku, gdy plik cookie i nie uda się ich dopasować przez przekierowanie HTTP 302. Domyślnie odpowiedzi będą wysłanych na ten adres URL, jeśli wystąpił błąd podczas dopasowywania plików cookie, ale licytujący może zażądać, aby przekierowanie było zawsze wysyłane.
• URL pomocy dotyczącej dopasowywania plików cookie: w przypadku giełd stosujących procesu pomocy dotyczącego dopasowania plików cookie, podstawowy adres URL punktu końcowego przeznaczonego do reagowania na żądania przychodzące.
• Limit dotyczący wspomagania dopasowania plików cookie: w przypadku giełd stosujących procesu pomocy dotyczącego dopasowania plików cookie, maksymalną liczbę żądań, które adres URL dopasowywania plików cookie może otrzymać sekunda. Ma to zapobiec przeciążaniu żądań CMA serwerów Exchange z żądaniami.

Makra dopasowujące pliki cookie

w dowolnym z obsługiwanych procesów dopasowywania plików cookie, do adresu URL dopasowywania plików cookie licytującego parametry są zwykle dodawane w parametrze niegwarantowane elementy zamówienia. Licytujący z integracją wymagającą spójności kolejność parametrów może powodować umieszczenie makr w adresie URL dopasowywania plików cookie w celu zagwarantować miejsce docelowe.

Obsługiwane makra

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

Przykład makra

Licytujący korzysta z integracji z dopasowywaniem plików cookie z punktem końcowym hostowanym w https://user.bidder.com.cookies, a jego wdrożenie wymaga w uzupełnieniu dopasowania pikseli do gotowych parametrów określanych przez licytującego. parametry w tej kolejności: google_push, google_gid, google_cver i google_error Licytujący może to zrobić, ustawiając Adres URL dopasowania plików cookie do:

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 później Google wyśle do tego licytującego prośbę o dopasowanie, zostanie ona rozwinięta. na przykład na taki:

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 usługi dopasowywania plików cookie

Usługa Google dopasowywania plików cookie obsługuje obecnie 3 przepływy pracy dotyczące różne przypadki użycia opisane poniżej.

Inicjowane przez licytującego: dwukierunkowe dopasowywanie plików cookie

Dwukierunkowe dopasowywanie plików cookie odnosi się do przepływu pracy inicjowanego przez licytującego, w którym umieszczają w przeglądarce użytkownika tag dopasowania, który przekierowuje go do Google. Ten umożliwia zarówno Google, jak i licytujący wypełnianie tabel odpowiedników. Poniżej znajdziesz o tym prosty przykład.

Krok 1. Umieść tag dopasowywania

Aby zainicjować ten proces, licytujący musi umieścić tag dopasowania: które są renderowane w przeglądarce użytkownika. Prosty tag dopasowywania, który zwraca 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 dopasowywania można umieszczać dodatkowe parametry, w różnych przypadkach użycia. Więcej informacji o tych parametrach znajdziesz tutaj: Dopasuj parametry adresu URL tagu.

Krok 2. Google odpowiada z przekierowaniem z uwzględnieniem danych dopasowania

Tag dopasowania spowoduje, że usługa Google dopasowywania plików cookie otrzyma parametr żądania z przeglądarki użytkownika, co spowoduje wygenerowanie HTTP 302 na adres URL dopasowywania plików cookie licytującego. Przekierowanie będzie zawierać zapytanie parametry określające identyfikator użytkownika Google i numer jego wersji w adresie URL oraz licytujący również otrzyma plik cookie dołączony do nagłówków żądań. W ćwiczenie w przypadku adresu URL dopasowywania plików cookie określonego jako https://ad.network.com/pixel, widoczny powyżej adres URL przekierowania prostego tagu dopasowywania 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 niedopełnione, bezpieczne w internecie zakodowane w formacie base64 ciągu znaków. Licytujący, którzy decydują się na hostowanie tabeli odpowiedników, zalecamy przechowywać dokładny ciąg znaków zwracany przez usługę dopasowywania plików cookie. W kolejnych pytań o stawkę, odpowiada wartościom określonym w BidRequest.google_user_id w protokole RTB Google lub BidRequest.user.id w metodzie Google Implementacja OpenRTB.

Wersja podana w polu google_cver wskazuje wartość liczbową wersji identyfikatora użytkownika Google. Identyfikator użytkownika Google niezbyt często zmieniających się, po czym ich wartość będzie rosnąć.

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

Krok 3. Licytujący przetwarza przekierowanie i odpowiada za pomocą piksela

Licytujący otrzymuje przekierowanie na adres URL dopasowywania plików cookie, który zawiera określone przez nich w pierwszym kroku, a parametry podane przez Google w drugiego etapu. Dodatkowo otrzymają oni również swój plik cookie w żądaniu HTTP nagłówki. Jeśli operacja się udała, licytujący hostujący własną tabelę odpowiedników może dopasować swój plik cookie do identyfikatora User ID Google zawartego w odpowiedzi. Jest zaleca się, aby licytujący przechowywali dokładnie ten ciąg znaków zwracany przez dopasowywanie plików cookie posprzedażna.

Jeśli operacja się nie uda, licytujący otrzyma google_error w przekierowaniu. Jest to wartość liczbowa odpowiadająca różnym stany błędu, które identyfikują konkretny błąd. Dodatkowe informacje więcej informacji o możliwych wartościach błędów znajdziesz tutaj. W przypadku wystąpienia błędu możesz ponownie spróbować dopasowania do tego użytkownika przez umieszczenie nowego tagu dopasowania.

Licytujący musi zawsze na nie odpowiedzieć, wyświetlając obraz niewidocznego piksela 1 x 1. możesz też zwrócić odpowiedź HTTP 204 Brak treści.

Schemat procesu dopasowywania plików cookie

Ten przepływ pracy przedstawiono na diagramie poniżej, gdzie żądania i odpowiedzi są oznaczone strzałką, a towarzyszące im elementy danych są podane w nawiasach.

Parametry adresu URL tagu dopasowania

Oprócz powyższych parametrów licytujący mogą określać własne parametry, które zostanie dołączony do przekierowania jako parametry. Pamiętaj, że funkcje określone przez licytującego parametry z prefiksem google_ będą ignorowane, ponieważ są zarezerwowane przez Google na potrzeby przyszłych rozwoju oraz zachowania parametrów zamówienia nie są gwarantowane. Tag dopasowania ze zdefiniowanym przez licytującego parametry mogą wyglądać tak:

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

Parametry adresu URL przekierowania

Przekierowanie jest tworzone na podstawie podstawowego adresu URL dopasowywania plików cookie skonfigurowanego dla na koncie licytującego, w tym z użyciem parametru google_ i parametrami zdefiniowanymi przez licytującego w zależności od tych określonych w tagu dopasowania. google_: są zdefiniowane parametry odpowiedzi:

Przykładowe scenariusze procesu dopasowywania plików cookie

Poniższe scenariusze opisują, jak może wyglądać dopasowywanie plików cookie w przypadku danej witryny typowy użytkownik przeglądający stronę internetową.

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

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

Jak to działa:

1. exampleNews.com renderuje i wywołuje reklamy z Google (Ad Manager).
2. Jednostka reklamowa obsługuje alokację dynamiczną, więc Google wysyła stawkę do FinestDSP i innych licytujących za pomocą usługi określania stawek w czasie rzeczywistym.
3. aplikacja licytującego FinestDSP otrzymuje i przetwarza pytanie o stawkę, i wysyła odpowiedź na pytanie o stawkę.
4. Google otrzymuje od licytujących odpowiedzi na pytania o stawkę, w tym odpowiedź od FinestDSP , która wskazuje reklamę z tagiem dopasowania (piksela).
5. aukcję wygrywa FinestDSP. Google wyświetla reklamę FinestDSP i tag dopasowania na Jane.
6. Tag dopasowywania wywołuje usługę Google Cookie Match Service, określającą Parametry google_nid i google_cm.
7. Usługa Cookie Match Service odczytuje plik cookie Anny Google i wysyła jej w przeglądarce przekierowuje użytkownika do adresu URL dopasowywania plików cookie FinestDSP z parametrem Ustawiono parametry google_user_id i google_cver.
8. Przeglądarka Janiny wczytuje przekierowanie na adres URL dopasowywania plików cookie usługi FinestDSP.
9. Punkt końcowy dopasowywania plików cookie FinestDSP przetwarza żądanie przekierowania, który obejmuje parametry adresu URL ustawione przez Google i ich plik cookie dla Anny Nagłówki HTTP. FinestDSP może teraz zapisać mapowanie swojego pliku cookie na google_user_id w tabeli odpowiedników.
10. FinestDSP odpowiada na przekierowanie za pomocą niewidocznego piksela 1 x 1.

Scenariusz 2. Użytkownik z istniejącym mapowaniem

Tydzień po scenariuszu 1 Jan ponownie odwiedza stronę exampleNews.com. Teraz gdy Jane ma na komputerze pliki cookie zarówno dla licytującego, jak i Ad Managera, Google.

1. Strona się renderuje, przez co Google (Ad Manager) wysyła żądania reklam, które zostaną wyświetlone na stronie.
2. Podczas aukcji reklam Google wysyła do odpowiednich licytujących pytanie o stawkę. w tym FinestDSP.
3. FinestDSP otrzymuje pytanie o stawkę, w tym sygnały takie jak google_user_id
4. FinestDSP wyszukuje obiekt google_user_id w tabeli odpowiedników, i znajduje plik cookie powiązany z Anną, który został utworzony tydzień wcześniej. (w scenariuszu 1).
5. Określanie stawek określone przez FinestDSP jest określane na podstawie informacji powiązanych z plikiem cookie określa stawkę za wyświetlenie i wygrywa aukcję.
6. Janina może zobaczyć reklamę dostosowaną do ich zainteresowań wybieraną na podstawie informacji posiadane przez FinestDSP.

Inicjowane przez licytującego: jednokierunkowe dopasowywanie plików cookie

Jednokierunkowe dopasowywanie plików cookie jest podobne do dwukierunkowego procesu, z wyjątkiem tego, że został zmieniony w taki sposób, że tylko Google hostuje i wypełnia dopasowanie tabeli. Tej opcji można używać, gdy licytujący nie może hostować identyfikatorów użytkowników Google w osobnej tabeli odpowiedników. Aby skorzystać z tego procesu, musi zezwalać Google na przechowywanie tabeli odpowiedników, nie można już określać google_cm w żądaniach wysyłanych do usługi dopasowywania plików cookie Google, w związku z tym nie otrzymają parametru google_gid w celu zapełnienia własnych tabeli odpowiedników. Gdy Google znajdzie dopasowanie dla użytkownika, licytujący mogą dodawać do list użytkowników z użyciem ich danych z plików cookie. Podobnie pytania o stawkę ci użytkownicy wykluczą identyfikator użytkownika Google, ale uwzględnią hostowane dane dopasowania. O prosty przykład zmienionego przepływu pracy został opisany poniżej.

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

Aby zainicjować ten proces, licytujący musi umieścić tag dopasowania, renderowanych w przeglądarce użytkownika. W odróżnieniu od procedury w przypadku użytkowników spoza stanu USA, w którym obowiązują ograniczenia dotyczące prywatności tag dopasowania musi kierować przeglądarkę użytkownika do Twojego pliku cookie Pasujący adres URL. Na przykład: jeśli URL dopasowania plików cookie jest skonfigurowany jako https://ad.network.com/pixel, będzie wyglądać tak:

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

Podczas ładowania w przeglądarce użytkownika aplikacja wysyła żądanie piksela od licytującego Adres URL dopasowania plików cookie. Będzie ono zawierać plik cookie w nagłówku HTTP, który powinien zostać wyodrębniony 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 pliku cookie Google Pasująca usługa, w tym parametr google_hm wypełniony wartością z plikami cookie zakodowanymi w standardzie base64. Przekierowanie 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 parametry określone przez Ciebie w polu oprócz pliku 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 dopasowywania plików cookie zakończy się powodzeniem – lub jeśli plik cookie się nie powiedzie Określono URL raportu dopasowania dla konta licytującego – Google domyślnie będzie wyświetlać przezroczysty piksel 1 x 1, a proces zostanie zakończony na tym etapie. Wyświetlenia w przypadku tego użytkownika w kolejnych pytaniach o stawkę będą obejmować dane licytującego hostowane dane dopasowania w BidRequest.hosted_match_data dla Google protokół lub BidRequest.user.buyeruid dla OpenRTB firmy Google implementacji. Licytujący mogą też wypełniać listy użytkowników, korzystając z hostowanych danych dopasowania określonych przez nich.

W przeciwnym razie, jeśli wystąpi błąd, Google przekieruje użytkownika na adres URL raportu dotyczącego dopasowywania plików cookie z przyczyną błędu określonego w parametrze google_error. Jeśli adres URL raportu o dopasowaniu plików cookie licytującego byłoby https://ad.network.com/report, adres URL przekierowania wyglądałby tak lubię:

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

Krok 5. Przeglądarka użytkownika przekierowuje użytkownika na adres URL raportu na temat dopasowania plików cookie licytującego

Przeglądarka użytkownika zostanie przekierowana na adres URL raportu na temat dopasowania plików cookie licytującego, w tym ewentualne przyczyny błędu określone przez Google w google_error. Aby dowiedzieć się więcej o interpretowaniu błędu przeczytaj opis parametru.

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

Licytujący musi na nie odpowiedzieć, wyświetlając przezroczysty piksel 1 x 1 przeglądarki.

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 został przedstawiony na diagramie poniżej, gdzie żądania i odpowiedzi są oznaczone strzałką, a dane, powiązane z nimi elementy są wymienione w nawiasach.

Parametry adresu URL w przypadku licytującego przekierowują do usługi Google dopasowującej pliki cookie

Parametry adresu URL dla przekierowania Google na adres URL raportu dotyczącego dopasowywania plików cookie licytującego

Zainicjowane przez Google: dwukierunkowe dopasowywanie pikseli

Dwukierunkowe dopasowywanie pikseli to proces dopasowywania plików cookie Google Usługa, w której Google próbuje dopasować identyfikator użytkownika Google do wybranym licytującym innym niż zwycięzca aukcji z określaniem stawek w czasie rzeczywistym. Gdy reklama jest Google umieszcza tag dopasowywania, który nakazuje przeglądarce użytkownika wczytanie przezroczysty piksel z adresu URL dopasowywania plików cookie wybranego licytującego. Włączenie tej opcji i Google, i licytującego, aby wstawić dane użytkownika do tabeli odpowiedników. Poniżej oto prosty przykład tego procesu.

Krok 1. Google umieszcza tag dopasowania

Gdy w przeglądarce użytkownika zostanie wczytana strona wydawcy uczestniczącego w programie, boks reklamowy na tej stronie zostanie wypełniony przez Google, można umieścić tag dopasowania, który wysyła żądanie piksela od licytującego wybranego algorytmicznie. Dopasowywanie pikseli umieszczony przez Google łączy adres URL dopasowywania plików cookie licytującego z dodatkowe parametry może użyć go do wypełnienia tabeli odpowiedników. W przypadku adresu URL dopasowania plików cookie określony jako https://ad.network.com/pixel, ma strukturę następujące:

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

Krok 2. Licytujący musi odpowiedzieć, używając przekierowania na adres URL usługi dopasowywania plików cookie Google

Licytujący otrzymujący żądania dopasowania pikseli muszą przesłać w odpowiedzi parametr 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

Powyższe przekierowanie jest podobne do adresu URL używanego w atrybucie Match dla procesu dopasowywania plików cookie inicjowanego przez licytującego. W dopasowaniu pikseli parametr google_cm jest zastępowany przez google_push, a jego wartość musi być równa wartości podane przez Google w żądaniu. Podobnie jak w przypadku inicjowania przez licytującego przepływ pracy, dodatkowe parametry można określić tak, aby spełniać dodatkowe przypadki użycia.

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

Google rejestruje utworzenie dopasowania dla użytkownika i obsługuje wszystkie dodatkowych operacji żądanych przy użyciu parametrów zapytania. Google odpowiada też z przezroczystym pikselem 1 x 1.

Schemat procesu dopasowywania pikseli

Ten przepływ pracy przedstawiono na diagramie poniżej, gdzie żądania i odpowiedzi są oznaczone strzałką, a towarzyszące im elementy danych są podane w nawiasach.

Parametry żądania tagu dopasowania Google

Parametry przekierowania w dopasowaniu pikseli licytującego

Zainicjowane przez Google: jednokierunkowe dopasowywanie pikseli

Jednokierunkowe dopasowywanie pikseli różni się od przepływu pracy dwukierunkowego w że tag dopasowania Google nie zawiera parametru ID, ale nadal będzie wypełniać tabelę odpowiedników na serwerze Google. Tej opcji można użyć w przypadkach, gdy licytujący nie może przechowywać identyfikatorów użytkowników Google w swoich danych w swojej tabeli odpowiedników. Prosty przykład zmienionego przepływu pracy został podsumowany w opisane poniżej.

Krok 1. Google umieszcza tag dopasowania

Google umieszcza tag dopasowania w przypadku licytującego wybranego na podstawie algorytmu. Tag dopasowywania zawiera element 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 z adresu URL dopasowywania plików cookie licytującego, łącznie z plikiem cookie licytującego w nagłówkach HTTP.

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

Punkt końcowy dopasowywania plików cookie licytującego musi przekierowywać do pliku cookie Google Pasująca usługa, w tym parametr google_hm wypełniony wartością z plikami cookie zakodowanymi w standardzie base64. Przekierowanie 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 Google dopasowywania plików cookie

Google otrzyma przekierowanie zawierające parametry określone przez Ciebie w polu oprócz pliku cookie Google w nagłówkach HTTP. Jeśli operacja uda się, wyświetlenie w przypadku tego użytkownika w kolejnych pytaniach o stawkę będzie uwzględniać hostowane dane o dopasowaniu licytującego w: BidRequest.hosted_match_data dla: protokół Google lub BidRequest.user.buyeruid dla protokołu Google Implementacja OpenRTB. Licytujący mogą też wypełniać listy użytkowników za pomocą hostowanych danych i określonych przez nich danych.

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

Obsługa dopasowania plików cookie

Otwarte ustalanie stawek pozwala giełdom korzystać z zainicjowanych przez licytującego. i zainicjowane przez Google dopasowywania plików cookie, tak by dopasować identyfikator użytkownika Google do jego pliku cookie. Plik cookie Wspomaganie dopasowania to dodatkowa funkcja dostępna na giełdach, która pozwala tworzyć tabele odpowiedników z własnymi licytującymi.

Jak działa Asystent dopasowania plików cookie

1. Przy umieszczaniu reklamy algorytmicznie wybiera i umieszcza w niej tag wspomagania dopasowywania plików cookie z poniższym struktura:

   <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 będzie otrzymywać żądanie piksela.

3. Punkt końcowy dopasowywania plików cookie na giełdzie odbiera żądanie, gdzie za dopasowanie identyfikatora użytkownika do parametru jednego z licytujących. Na diagramie poniżej widać, że dopasowywanie plików cookie giełdy odpowiada przeglądarce użytkownika, przekierowując je do któregoś z tagów i punktów końcowych.
4. Licytujący otrzyma żądanie wraz z parametrami określonymi przez parametr w ramach giełdy, aby dopasować identyfikator użytkownika do jego pliku cookie.

Ograniczenia

Ogranicz częstotliwość żądań dla nowych dopasowań

Licytujący są odpowiedzialni za ograniczenie liczby wywołań pliku cookie Odpowiednia usługa dla użytkowników, którzy mają nowy wpis w dopasowaniu obsługiwanym przez Google. tabeli. Wpis w hostowanej tabeli odpowiedników możemy uznać za wygasły za 14 dni, po którym można ją odświeżyć.

Odpowiadanie na wszystkie żądania dopasowania pikseli

Licytujący, którzy korzystają z procesu dopasowywania pikseli, powinni odpowiedzieć na wszystkie przychodzące żądania dopasowania Pixela z odpowiedzią zawierającą google_push . Dzięki temu Google może egzekwować zasady przez monitorowanie użycia. Jeśli współczynnik odpowiedzi licytującego spadnie poniżej 90%, Google ograniczy liczbę Prośby o dopasowanie pikseli zostały wysłane na ich konta.

Użyj punktów końcowych HTTPS

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

Gdy odpowiadasz na żądanie dopasowania piksela wysłane do Ciebie przez HTTPS, wymagane do przekierowania do usługi dopasowywania plików cookie przez HTTPS. Podobnie, punkt końcowy pomocy dotyczącej dopasowywania plików cookie, który przekierowuje do licytujących, musi też używać protokołu HTTPS. Jeśli wysyłasz do Google żądania przez HTTP częściej niż co 2 minuty, liczba próśb o dopasowanie wysłanych na Twoje konto zostanie ograniczona.

Wymagania dotyczące zgody użytkownika z UE

Żądania dopasowania plików cookie, które podlegają Użytkownik Google z UE Polityka w zakresie zgody użytkownika powinna wskazywać zgodę użytkownika. Takie wnioski są wymagane, aby: wskazują, że zgodę uzyskano na jeden z tych sposobów:

• Zasady TCF w wersji 2: obejmują gdpr i gdpr_consent . Szczegółowe informacje znajdziesz tutaj: Dokumentacja Zasad IAB dotyczących przejrzystości i uzyskiwania zgody na przetwarzanie danych w Authorized Buyers w wersji 2.0.
• process_consent: deklaracja otrzymana przez licytującego. niezbędną zgodę użytkownika.

Przykłady

Przykłady poniżej pokazują, jak używać usługi dopasowywania plików cookie do realizowanie określonych celów. O ile nie wskazano inaczej, założyli, że użytkownik, na który podjęto działania, nie pochodzi Stan w USA z ograniczeniami dotyczącymi prywatności.

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

Licytujący może użyć procesu dopasowywania plików cookie, aby wypełnić własne dopasowania podając tylko google_nid i google_cm w tagu dopasowywania. 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 jest ustawiony na https://ad.network.com/pixel?id=1, i operacja dopasowania plików cookie zakończy się powodzeniem, przekierowanie Google odpowiedź na tag dopasowania licytującego może wyglądać tak:

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

Jeśli operacja dopasowywania plików cookie nie powiedzie się, ponieważ użytkownik nie ma pliku cookie Google, odpowiedź będzie wyglądać tak:

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

Kod błędu zależy od jego przyczyny. Aby się uczyć więcej informacji o możliwych kodach błędów dotyczących procesu dopasowywania plików cookie znajdziesz w parametry przekierowania.

Dodaj do listy pojedynczych użytkowników

Parametr google_ula można określić w dopasowaniu licytującego aby dodać użytkownika do listy o podanym identyfikatorze. Jeśli Google lub Tabela odpowiedników hostowana przez licytującego zawiera nowy wpis użytkownika, który może umieścić tag dopasowania zawierający google_nid i google_ula dodawania użytkownika do określonej listy bez inicjowania pełnej Proces dopasowywania plików cookie. Zobacz ograniczenia na wywoływanie usługi dopasowywania plików cookie w przypadku kolejnych zgłoszeń. Odpowiednik tag dopasowywania może wyglądać tak:

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

Aby odpowiedź była udana, gdy adres URL dopasowywania plików cookie licytującego to https://ad.network.com/pixel, przekierowanie Google wyglądałoby 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 – przekierowanie będzie zawierać parametr 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 otrzymasz google_ula. W przeciwieństwie do odpowiadającym odpowiedniemu parametrowi tagu dopasowania, zastąpi on sygnaturę czasową stanem wskazujący powodzenie operacji. 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 wyglądałby tak:

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

Dodawanie do wielu list użytkowników

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

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

Stan operacji w przypadku każdej listy użytkowników jest raportowany w podobny sposób: odrębne parametry google_ula w przekierowaniu:

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

W przypadku powyższego przekierowania widzimy, że operacja została wykonana w przypadku użytkownika lista o identyfikatorze 45678, ale niepowodzenie w przypadku listy użytkowników o identyfikatorze 12345 bo licytujący nie ma do niego dostępu.

Przejdź przez proces dopasowywania plików cookie i dodaj go do listy użytkowników

Do dopasowywania plików cookie i dodawania użytkownika do listy użytkowników w jednym żądania, tag dopasowania licytującego powinien zawierać parametry google_cm oraz 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ć ciąg google_gid, google_cver i google_ula. Może to wyglądać tak: :

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

Zapisywanie dopasowań w tabeli odpowiedników hostowanej przez Google

Jeśli licytujący chce przechowywać dane z plików cookie w tabeli odpowiedników hostowanej przez Google, i nie zamierza przechowywać identyfikatora użytkownika Google we własnym dopasowaniu. tabeli, ich tag dopasowania musi zawierać parametr google_hm, gdzie jego wartość musi być możliwym w internecie ciągiem zakodowanym w formacie base64. W przypadku użytkownika, w którym niezakodowane dane z plików cookie licytującego to Cookie number 1!, miałoby wartość Q29va2llIG51bWJlciAxIQ==, która zostałaby użyta w jak poniżej:

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

Aby odpowiedź była udana, gdy adres URL dopasowywania plików cookie licytującego to https://cookie-monster.com/pixel, przekierowanie Google być:

https://cookie-monster.com/pixel

Parametru google_gid nie ma w przekierowaniu, ponieważ tag dopasowania nie zawierał słowa google_cm, a google_hm to nieuwzględnione w udanych odpowiedziach. W przyszłych pytaniach o stawkę o wyświetlenia dotyczące tego użytkownika, licytujący otrzyma hostowane dane dopasowania w BidRequest.hosted_match_data w przypadku protokołu RTB Google lub BidRequest.user.buyeruid w przypadku implementacji OpenRTB firmy Google.

Jeśli licytujący zamiast tego użył tagu dopasowania, w którym wartość Kod google_hm nie został zakodowany w formacie base64, na przykład chocolate_chunk! – przekierowanie może wyglądać tak: :

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

Powyższe przekierowanie zawiera wartość google_hm z 2, co oznacza, że operacja nie powiodła się, ponieważ wartość może nie mogą zostać zdekodowane.

Tabele odpowiedników hostowane przez licytujących i hostowane przez Google z listami użytkowników

jeśli licytujący hostuje własną listę użytkowników oprócz użytkownika hostowanego przez Google; i chce mieć jeden tag dopasowania, który będzie pasował do obu tabel i doda użytkownika dla danej listy użytkowników, jego tag dopasowania musi zawierać te atrybuty: google_cm, Parametry google_hm i google_ula. Jeśli licytujący dane z pliku cookie to Cookie number 1!, zakodowana wartość będzie Q29va2llIG51bWJlciAxIQ==, który wygeneruje tag dopasowania, taki jak :

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

Aby odpowiedź była udana, gdy adres URL dopasowywania plików cookie licytującego to https://cookie-monster.com/pixel, przekierowanie Google 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 w google_gid z danymi z plików cookie w tabeli odpowiedników. W mogą też określić, że tabela odpowiedników i lista użytkowników na serwerze Google powiodły się. W efekcie każde kierowanie wstępne na licytującego skonfigurowane pod kątem kierowania reklam na określony identyfikator listy użytkowników spowoduje, że licytujący będzie otrzymywać od użytkownika pytania o stawkę za wyświetlenia. Podobnie, w przypadku tych stawek licytujący otrzyma hostowane dane dopasowania w ciągu BidRequest.hosted_match_data w przypadku protokołu RTB Google lub BidRequest.user.buyeruid w przypadku implementacji OpenRTB firmy Google.