Data Manager API (ang. Google Data Manager API) to interfejs programistyczny Google służący do przesyłania danych własnych reklamodawcy — konwersji offline, konwersji rozszerzonych dla potencjalnych klientów oraz list odbiorców Customer Match — bezpośrednio do Google Ads i innych platform reklamowych Google. Od 15 czerwca 2026 roku jest to podstawowy sposób importu danych offline, zastępujący dotychczasowe metody wysyłania konwersji i list odbiorców przez Google Ads API. Dla marketera oznacza to jedno, ujednolicone „wejście” dla danych z CRM, dzięki któremu kampanie mogą optymalizować się pod realne efekty biznesowe, a nie tylko pod wypełnione formularze.
Jak działa Data Manager API?
Data Manager API przyjmuje dane przez zapytania REST i mapuje je na obiekty reklamowe w Google Ads. Zamiast osobnych narzędzi do konwersji offline i osobnych do list odbiorców w Google Ads, reklamodawca korzysta z jednego interfejsu, który rozróżnia dwa główne typy danych:
- Zdarzenia (events) — konwersje offline, np. podpisana umowa, zakwalifikowany lead, zakup sfinalizowany telefonicznie. Zdarzenie zawiera identyfikator (np. gclid lub zahaszowane dane klienta), datę, wartość i walutę.
- Odbiorcy (audience members) — rekordy klientów trafiające do list Customer Match, używanych do remarketingu, wykluczeń i tworzenia podobnych grup.
Dane osobowe (e-mail, telefon, imię i nazwisko, adres) przed wysyłką są normalizowane i haszowane algorytmem SHA-256, co pozwala Google dopasować rekord do zalogowanego użytkownika bez przekazywania danych w jawnej postaci. Dokumentacja techniczna dostępna jest na stronie Google for Developers.
Jakie dane można przesyłać przez Data Manager API?
| Typ danych | Identyfikator dopasowania | Zastosowanie w kampaniach |
|---|---|---|
| Konwersje offline | gclid, gbraid, wbraid | Optymalizacja pod sprzedaż zamkniętą po kliknięciu reklamy |
| Konwersje rozszerzone dla potencjalnych klientów | Zahaszowany e-mail lub telefon z formularza | Import konwersji, gdy gclid nie został zapisany w CRM |
| Listy odbiorców (Customer Match) | Zahaszowany e-mail, telefon, adres | Remarketing, wykluczenia obecnych klientów, segmentacja |
Jak skonfigurować przesyłanie danych krok po kroku?
- Utwórz w Google Ads akcję konwersji typu „import” (dla konwersji offline) lub włącz konwersje rozszerzone dla potencjalnych klientów.
- Skonfiguruj projekt w Google Cloud, włącz Data Manager API i nadaj uprawnienia OAuth kontu, które ma dostęp do konta Google Ads.
- W CRM zapisuj gclid przy każdym leadzie z reklamy lub — jeśli to niemożliwe — zbieraj e-mail/telefon w ustandaryzowanym formacie.
- Przygotuj ładunek danych: normalizacja (małe litery, brak spacji), haszowanie SHA-256, format daty ze strefą czasową.
- Wysyłaj dane cyklicznie (np. codziennie) i monitoruj w Google Ads raport diagnostyczny dopasowań.
Kiedy warto wdrożyć Data Manager API, a kiedy nie?
Wdrożenie ma największy sens, gdy proces sprzedażowy kończy się poza stroną — w call center, na spotkaniu lub w systemie CRM — a ostateczna wartość klienta znana jest dopiero po dniach lub tygodniach. Firmy B2B, deweloperzy, branża finansowa i motoryzacyjna zyskują najwięcej, bo Google Ads uczy się rozpoznawać leady, które faktycznie stają się klientami. Jeżeli natomiast cała konwersja odbywa się online (e-commerce z płatnością na stronie), wystarczy zwykłe tagowanie, a API nie wnosi dużej wartości.
Najczęstsze błędy
- Brak zapisu gclid w CRM — konwersji nie da się przypisać do kliknięcia, a dopasowanie po danych klienta jest mniej precyzyjne.
- Niepoprawna normalizacja przed haszowaniem — różnica w wielkości liter lub spacji powoduje, że hash się nie zgadza.
- Przesyłanie danych po upływie okna atrybucji akcji konwersji — konwersja nie zostanie zaliczona.
- Traktowanie API jako projektu wyłącznie IT — bez zdefiniowanych etapów lejka w CRM system otrzyma dane bez wartości biznesowej.
Data Manager API w praktyce ICBM
W projektach generowania leadów najpierw ustalamy z klientem, który etap w CRM oznacza „wartościowego leada”, a dopiero potem projektujemy przepływ danych do Google Ads. Zwykle łączymy import konwersji offline z listami Customer Match: sprzedane leady zasilają optymalizację, a obecni klienci trafiają na listy wykluczeń, co ogranicza marnowanie budżetu. Migrację ze starych metod importu planujemy z wyprzedzeniem, aby zmiana zasad Google w 2026 roku nie przerwała ciągłości danych w koncie Google Ads.
Najczęściej zadawane pytania
Czy Data Manager API wymaga programisty?
Do wdrożenia integracji z CRM zazwyczaj tak — konieczne jest przygotowanie zapytań, haszowanie danych i automatyzacja wysyłki. Alternatywą pozostają gotowe integracje w Google Ads oraz konektory dostawców CRM, które korzystają z tego samego interfejsu w tle.
Co się stanie ze starymi importami konwersji offline po 15 czerwca 2026?
Zgodnie z komunikacją Google dotychczasowe metody przesyłania danych offline przez Google Ads API są zastępowane przez Data Manager API. Reklamodawcy korzystający z własnych integracji powinni zaplanować migrację, aby uniknąć luk w danych konwersji.
Czym różni się konwersja offline od konwersji rozszerzonej dla potencjalnych klientów?
Konwersja offline dopasowuje się do kliknięcia po identyfikatorze gclid zapisanym przy leadzie. Konwersja rozszerzona dla potencjalnych klientów wykorzystuje zahaszowany e-mail lub telefon z formularza, dzięki czemu działa nawet wtedy, gdy CRM nie przechowuje gclid.
