Google Ads Webhook Architecture
Incoming lead submissions and offline conversion feedback follow an automated closed-loop lifecycle:Setting Up Google Ads Webhook
To connect your Google Ads account to BrokerOS:- In your Google Ads dashboard, navigate to Tools & Settings -> Assets -> Lead Form.
- Scroll to the Export leads from Google Ads section.
- Select Other data integration (Webhook).
- Enter your BrokerOS endpoint:
- Enter your Key: Value from
GOOGLE_ADS_WEBHOOK_KEYin the root.envfile. - Click Send Test Data in Google Ads to verify the handshake. BrokerOS returns
200 OKand logs a test lead in your dashboard.
GCLID Capture and Offline Conversion Tracking
A major architectural advantage of Google Ads integration is Google Click ID (GCLID) capture:- When a searcher submits a lead form, Google transmits the encrypted
gclidparameter. - BrokerOS stores this identifier permanently on the
Leadrecord.
Offline Conversion Tracking in Real Estate
High-value property purchases occur offline over multiple weeks:- A prospect is captured on Google Search with an encrypted
gclid. - Two weeks later, the client completes an on-site, GPS-verified Site Visit.
- Four weeks later, the client confirms an $850,000 Booking.
- BrokerOS compiles offline conversion milestone events and transmits them back to Google Ads linked to the original
gclid. - Google Smart Bidding algorithms automatically optimize future ad auctions toward users resembling high-converting property buyers.
Campaign and Keyword Attribution
Leads ingested from Google Ads automatically capture granular search attribution:- Campaign Name: For example, Search_Brand_Grand_Horizon_Downtown.
- Ad Group Name: For example, High_Intent_Luxury_Penthouses.
- Matched Search Query: The exact search term the user typed into Google before clicking your ad.
- Placement: Specifies whether the submission occurred via Google Search, YouTube TrueView, or the Google Display Network.