Powered by Google Ads API v23

Google Ads Campaign Management

RankPulse connects to the Google Ads API through our MCC (Manager Account) to provide full campaign lifecycle management. Create, optimize, and monitor your Google Ads campaigns from a single, unified dashboard.

How RankPulse Uses the Google Ads API

RankPulse is an internal marketing automation platform that uses the Google Ads API to manage campaigns for websites owned by the organization. Here's the technical architecture and API usage.

Technical Architecture

Django Web Application

Python 3.12 backend with Django 6.0.2 framework. Admin authenticates via Django session auth to access the management interface.

Google Ads API Layer

GoogleAdsManager class in ads_client.py connects to the Google Ads API v23 via the official google-ads Python SDK (gRPC).

OAuth 2.0 Security

Installed application OAuth flow. Admin generates refresh token once; stored securely in DB + environment variables. No end-user OAuth interaction.

Google Ads API Services We Use

CampaignService

Create, update, and manage campaign status (enable, pause, remove). Set campaign types (Search, Display) and bidding strategies.

CampaignBudgetService

Create and manage daily campaign budgets. Link budgets to campaigns with configurable daily spend limits.

AdGroupService

Create and organize ad groups within campaigns. Set CPC bids and manage ad group structure for targeting optimization.

AdGroupCriterionService

Add and remove keywords with match types (exact, phrase, broad). Manage negative keywords to refine targeting and reduce wasted spend.

AdGroupAdService

Create Responsive Search Ads (RSAs) with multiple headlines and descriptions. Google's machine learning optimizes the best combinations.

ConversionActionService

Create and manage conversion tracking actions. Define conversion windows, attribution models, and value settings for ROI tracking.

GoogleAdsService (Search)

Execute GAQL (Google Ads Query Language) queries for performance reporting. Retrieve metrics like impressions, clicks, conversions, cost, and CTR.

CustomerService

Fetch account details and verify MCC (Manager Account) access. List accessible customer accounts under the manager hierarchy.

AI Audit Engine

AI-powered campaign auditor analyzes Google Ads performance data and generates optimization recommendations with one-click auto-apply actions.

What You Can Do

Read Operations

  • Account Information

    Fetch account details, verify MCC access, list accessible customers

  • Campaign Listing

    List all campaigns with status, budget, type, and bidding strategy

  • Performance Reports

    Impressions, clicks, conversions, cost, CTR, CPC via GAQL queries

  • Keyword & Ad Group Data

    List keywords, match types, ad groups, and conversion actions

Write Operations

  • Create Campaigns

    Search and Display campaigns with budget, bidding, and targeting settings

  • Build Responsive Search Ads

    Multiple headlines and descriptions with Google's AI-optimized combinations

  • Keyword Management

    Add/remove keywords (exact, phrase, broad) and negative keywords

  • Conversion Tracking

    Set up conversion actions with custom windows and attribution models

  • Campaign Status Updates

    Pause, enable, or update campaigns and adjust budgets

Campaign Dashboard Preview

A unified view of your Google Ads campaigns, performance metrics, and optimization recommendations.

RankPulse — Google Ads Dashboard

Google Ads Overview

Account: 329-436-3393 · MCC: 259-958-1821

Connected Last 30 days

Impressions

24,891

+15.2%

Clicks

1,847

+22.8%

Conversions

127

+8.5%

Cost

R$ 4,250

CPA: R$ 33.46

Campaign Status Budget/day Clicks Conv. CTR
Brand Search — Beezle Active R$ 50.00 892 67 7.4%
Product Launch — RSA Active R$ 80.00 641 42 5.1%
Retargeting Display Paused R$ 30.00 314 18 2.8%

AI Recommendation

Add 5 negative keywords to "Product Launch — RSA" to reduce irrelevant clicks. Estimated savings: R$ 180/month.

Data retrieved via Google Ads API v23 · google-ads SDK v29.2.0 · OAuth 2.0

Compliance & Data Handling

RankPulse follows Google Ads API policies and best practices for data security and responsible API usage.

OAuth 2.0 Only

Credentials stored server-side in environment variables. No frontend exposure. No password storage.

Low API Volume

Less than 100 API calls per day. Campaign data cached locally to minimize API load.

Internal Use Only

Single-tenant platform. Only authenticated admins access campaign data. No public API. No third-party sharing.

Admin-Only Actions

No automated bidding changes. All campaign modifications require admin action. No data scraping.

Start managing your Google Ads campaigns

Create your free account and connect your Google Ads account in minutes.

Get Started Free