Conversions APIs
Zgłaszaj swoje cele do Meta, LinkedIn, TikTok i Google Ads z naszego serwera zamiast z przeglądarki - dopasowane wyłącznie przez identyfikator kliknięcia, który sama sieć ustawiła.
1. Po co w ogóle po stronie serwera?
Piksel w przeglądarce musi przetrwać trzy rzeczy, zanim zgłosi konwersję: bloker reklam, ustawienie ochrony przed śledzeniem i użytkownika, który zamknie kartę, zanim piksel zdąży zadziałać. Wywołanie z naszego serwera przetrwa wszystkie trzy - bo w ogóle nie odbywa się w przeglądarce.
MousePlayer i tak wie, kiedy osiągnięto jeden z Twoich celów; po to są cele. Conversions APIs jedynie przekazują ten fakt do sieci reklamowej.
To nie zastępuje Twojego piksela. Zostaw go. Każda sieć odsiewa duplikaty między jednym a drugim, a my wysyłamy identyfikatory, które są do tego potrzebne.
2. Co wysyłamy - i czego nigdy
Jedyne, co identyfikuje odwiedzającego w tych wywołaniach, to identyfikator, który sama sieć ustawiła. Nic innego o tej osobie nie opuszcza naszego serwera.
| Sieć | Używany identyfikator | Skąd pochodzi |
|---|---|---|
| Meta | _fbp, _fbc | Pliki cookie własne piksela Meta |
li_fat_id | Plik cookie własny LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp to cookie, ttclid pochodzi z adresu kliknięcia w reklamę |
| Google Ads | gclid, wbraid, gbraid | Z adresu kliknięcia w reklamę, potem z pliku cookie _gcl_aw |
| Microsoft Advertising | msclkid | Z adresu kliknięcia reklamy albo z ciasteczka _uetmsclkid, które zapisuje tag UET |
Nigdy nie wysyłamy: adresu e-mail, numeru telefonu, imienia ani adresu IP - również nie w postaci skrótu. Jeśli odwiedzający nie ma identyfikatora kliknięcia, nie wysyłamy nic. Konwersja, której nie da się nikomu przypisać, jest dla Ciebie mniej warta niż uczciwa liczba.
Tylko za zgodą
Każde z tych wywołań stoi za tą samą bramką zgody co samo nagrywanie. Sesja bez zgody nie wytwarza żadnego zgłoszenia konwersji, niezależnie od ustawień Twojego projektu.
3. Google Ads ma trzy identyfikatory, nie jeden
To regularnie zaskakuje, więc wprost: Google używa gclid dla pojedynczego kliknięcia w reklamę. Gdy ochrona przed śledzeniem Apple uniemożliwia przypisanie pojedynczego kliknięcia, Google wysyła zamiast tego wbraid albo gbraid - oba oznaczają grupę kliknięć.
Te trzy wzajemnie się wykluczają; Google odrzuca konwersję, która niesie dwa z nich. Wysyłamy dokładnie jeden, a przy kilku wygrywa gclid, bo jest najdokładniejszy.
W adresie stoją tylko raz
Identyfikator jest w adresie tylko na pierwszej stronie po kliknięciu w reklamę. Tag Google zapisuje go potem w pliku cookie _gcl_aw. Czytamy ten plik jako zapasową drogę - bez niego konwersja na trzeciej stronie wizyty nie znalazłaby już żadnego identyfikatora.
4. Konfiguracja
Meta, LinkedIn i TikTok
Po dwa pola: identyfikator piksela lub reguły konwersji oraz token dostępu, który tworzysz w interfejsie samej sieci. Oba są zapisywane z szyfrowaniem AES-256-GCM i po zapisaniu nigdy więcej nie są pokazywane.
Google Ads wymaga sześciu
Google jest wyjątkiem, a powód należy poznać na początku: w odróżnieniu od pozostałych trzech Google nie wydaje zwykłego tokenu dostępu. Dostęp działa przez OAuth z tokenem odświeżania, a Ads API wymaga dodatkowo tokenu dewelopera.
| Pole | Gdzie je znaleźć |
|---|---|
| Identyfikator klienta | Prawy górny róg w Google Ads. Same cyfry, bez myślników. |
| ID akcji konwersji | Cele i konwersje, potem akcja, na którą ma to trafić. |
| Token dewelopera | Twoje konto menedżera Google Ads, API Center. |
| ID i sekret klienta OAuth | Google Cloud Console, dane logowania, klient OAuth typu "aplikacja desktopowa". |
| Token odświeżania | Generujesz go raz samodzielnie dla zakresu adwords. |
LinkedIn ma dwie drogi, a Ty chcesz tę krótszą
W Campaign Managerze: Dane, Signals Manager, Direct API, Wygeneruj token dostępu. To droga dla reklamodawców wysyłających własne dane - bez aplikacji deweloperskiej, bez weryfikacji. Token nie wygasa, a Campaign Manager nie pokaże go po raz drugi, więc skopiuj go od razu.
Druga droga, aplikacja deweloperska wnioskowana przez Developer Portal LinkedIna, jest przeznaczona dla platform wysyłających w imieniu wielu reklamodawców. Wymaga zweryfikowanej strony firmowej i zatwierdzonego przypadku użycia - nic z tego nie jest tu potrzebne.
Microsoft Advertising jest tym najprostszym
Po Google Ads spodziewasz się tego samego ciężaru - OAuth, tokenu dewelopera, procedury zatwierdzenia. Jest odwrotnie: dwa pola. Identyfikator tagu UET, którego i tak używasz w przeglądarce, oraz token, który kopiujesz w Microsoft Advertising przy tagu UET ("Use Conversions API", "Copy Token"). Nie ma o co wnioskować.
Użyj tego samego identyfikatora tagu co w przeglądarce. Tylko dzięki temu Microsoft rozpozna zdarzenie serwerowe i przeglądarkowe jako JEDNĄ konwersję, a nie dwie.
Token dewelopera wymaga zgody Google ("Basic access"), a to trwa kilka dni. To jedyny krok, którego nie załatwisz w minutę - zacznij więc od niego. Twojego hasła Google nigdy nie widzimy, tylko token odświeżania, który możesz w każdej chwili unieważnić.
5. Kiedy zgłaszana jest konwersja
Dokładnie raz na cel i sesję. MousePlayer odsiewa powtórzenia, zanim wywołanie wyjdzie, a ładunek niesie dodatkowo identyfikator, dzięki któremu sieć może odsiać je po swojej stronie po raz drugi. Odwiedzający, który doda pięć produktów do koszyka, wytwarza jedną konwersję, a nie pięć.
Co zobaczysz na koncie reklamowym
Konwersja niesie nazwę Twojego celu, do tego wartość i walutę, jeśli je ustawiłeś, oraz moment zdarzenia. W normalnej pracy dociera w ciągu minuty.
Jeśli nic nie dociera
- Brak identyfikatora kliknięcia. Odwiedzający nie przyszedł z reklamy tej sieci albo był u Ciebie, zanim piksel ustawił swój plik cookie. Wtedy nie wysyłamy nic - to przypadek oczekiwany, nie błąd.
- Brak zgody. Bramka była pierwsza.
- Sieć przyjęła wywołanie i odrzuciła konwersję. Google, TikTok i inne odpowiadają HTTP 200 z błędem w treści odpowiedzi. Czytamy treść, a nie tylko status; powód trafia wtedy do dziennika doręczeń.
Wszystkie wymienione znaki towarowe należą do ich właścicieli. MousePlayer nie pozostaje w żadnych relacjach biznesowych z tymi dostawcami.