Tuk Tuk Lisbon
Internal Tool

Google Ads Automation Tool

How Tuk Tuk Lisbon uses the Google Ads API to manage and optimize its advertising campaigns

Overview

Tuk Tuk Lisbon has developed an internal automation tool — tuk-tuk-ads-automation — that integrates with the Google Ads API to streamline the creation, management, and performance monitoring of paid search and display campaigns.

This tool is used exclusively for managing Tuk Tuk Lisbon's own advertising account. It is not a service offered to third parties and does not manage any accounts other than our own Google Ads account (Customer ID: 732-965-3303).

Scope of API usage: This developer token is used solely for managing Tuk Tuk Lisbon's own Google Ads campaigns. No client accounts are managed. No data is sold or shared beyond what is described in our Privacy Policy.

What the Tool Does

📊

Campaign Management

Creates and updates search campaigns, ad groups, keywords, and ad copy via the Google Ads API.

⚡

Budget Automation

Automatically adjusts daily budgets and bids based on campaign performance metrics and seasonal demand.

📈

Performance Reporting

Pulls campaign metrics (impressions, clicks, conversions, cost) and stores them for analysis and decisions.

🔄

Workflow Integration

Connects with our n8n automation workflows to create a unified booking and marketing pipeline.

How It Works

1

API Authentication

The tool authenticates with Google Ads API using OAuth 2.0 credentials linked to our Google Cloud Project (tuk-tuk-ads-automation).

2

Campaign Sync

Existing campaigns are fetched and synced to our internal database (Supabase) for tracking and history.

3

Automated Actions

Scheduled scripts create new campaigns, update bids, pause underperforming ads, and push new seasonal promotions.

4

Reporting & Decisions

Performance data is collected via the Google Ads Reporting API and used to make budget and strategy decisions.

5

Booking Pipeline Integration

Ad conversion data connects to our WhatsApp booking agent (Lisa), helping attribute bookings to specific campaigns.

Technical Stack

Component Technology Purpose
Ads API Integration Google Ads API v17+ Campaign creation, management, reporting
Automation Engine n8n (self-hosted) Workflow orchestration and scheduling
Database Supabase (PostgreSQL) Campaign data storage and booking records
Cloud Project Google Cloud Platform OAuth credentials and API access
Authentication OAuth 2.0 Secure API access without storing passwords

Compliance & Data Handling

Our use of the Google Ads API strictly follows Google Ads API policies:

Contact

For any questions regarding our use of Google Ads API or this tool: