Google Ads API – Server‑to‑Server Conversion Tracking

This page explains how FV Empreendimentos em Negócios Digitais Ltda uploads offline sales & leads to Google Ads while complying with Google Ads API policies and the Brazilian LGPD.

About FV Empreendimentos em Negócios Digitais Ltda

FV Empreendimentos em Negócios Digitais Ltda. (CNPJ 26.344.298/0001‑40) is a Brazilian performance‑marketing agency operating since 2016. We manage Search and Display campaigns for our own e‑commerce offers and for selected third‑party clients across 20+ countries.

Google Ads API Scope

ConversionUploadService – UploadClickConversions and UploadCallConversions to register offline sales & qualified leads.
GoogleAdsService.SearchStream – reporting only (performance dashboards and diagnostics).
No campaign creation, ad‑group management or keyword‑planning endpoints are used.

Data‑flow Diagram

graph TD
  A[User click
GCLID / GBRAID] --> B[Landing page]
  B --> C[CRM / Checkout
stores click ID]
  C --> D[Sale or Lead]
  D -->|Hourly batch| E[Server → Google Ads API
ConversionUploadService]
  E --> F[Attribution in Google Ads UI]
  E --> G[Reporting via SearchStream]

Privacy & Data Handling

FV Empreendimentos em Negócios Digitais Ltda collects Google click identifiers (GCLID, GBRAID, WBRAID) solely for conversion measurement. Data are hashed in transit, stored for up to 90 days and uploaded to Google Ads via the Google Ads API in line with the Google Ads API Terms and Brazilian LGPD.

Expected API Volumes

Daily uploads: 1,000 – 1,500 conversions
Hourly batches: ≤ 2,000 rows
Peak QPS: ≤ 0.03

Developer Contact

Email: [email protected]
Address: Alameda Rio Negro 1030, Barueri‑SP, 06454‑000, Brazil