Getting Started

Getting Started

Prerequisites

• A modern web browser (Chrome, Firefox, Edge, Safari)
• A Google account (for authentication)
• A Cloudinary account (free tier works for basic usage)

Quick Start

The tool on googleadsagent.ai has a guided 4-step workflow:

Step 1: Upload Your Creative (Free)

Drag & drop any image or click to browse. Supports JPG, PNG, WebP, GIF up to 20MB. The tool shows dimensions, aspect ratio, and file size instantly.

Step 2: Validate Against 50+ Platforms (Free)

Click "Validate" to check your asset against every major advertising platform. Results are grouped into Compatible (green), Off-Size/Fixable (amber), and Incompatible (red). All validation runs client-side — nothing leaves your browser.

Step 3: AI Resize — Fix Off-Size Channels (Credits)

Generate correctly-sized derivatives using Cloudinary's AI Generative Fill. First 5 resizes are free. After that, 1 credit per resize. Batch packages (GDN Essential, Meta Complete, etc.) cost 3 credits each.

Step 4: Animate — Turn Image Into Video (Credits)

Transform your still image into a 4-10 second video ad using Google Veo 3.1. Perfect for Stories, Reels, TikTok, and YouTube Shorts. Choose duration, style, and add an optional motion prompt. Costs 5 credits per generation.

Credits & Sign In

• Sign in with Google (one-time, works across all googleadsagent.ai tools)
• You get 25 free credits to start
• Validation is always free
• Credits can be purchased or earned through Buddy

Setting Up API Keys

Required: Cloudinary

1. Create a free account at cloudinary.com
2. Navigate to Settings > API Keys in the Cloudinary Console
3. In the Creative Asset Validator, go to Settings > API Keys
4. Enter your Cloud Name, API Key, and API Secret

Optional: AI Providers

For AI-powered features (creative analysis, image generation, animation):

Provider	Features Enabled	Where to Get Key
Google AI Studio	Gemini analysis, Imagen generation, Veo animation	aistudio.google.com
OpenAI	GPT-5.2 creative analysis, DALL-E generation	platform.openai.com
Anthropic	Claude strategy analysis	console.anthropic.com

First Upload Walkthrough

Step 1: Upload an Asset

• Drag and drop an image or video onto the upload area
• Or click "Upload" to browse your files
• Supported formats: JPG, PNG, WebP, GIF, MP4, MOV, AVI

Step 2: Review Validation Results

After upload, you'll see:

• Asset details: Dimensions, aspect ratio, file size, format
• Status badge: DRAFT, APPROVED, or OFF-SIZE
• Channel compatibility: Green (compatible), Yellow (off-size with fix available)
• Off-size count: Number of channels that need resizing

Step 3: Fix Off-Size Assets

Click "AI Fix All" to:

1. See all off-size channels grouped by category (Social, Display, Video)
2. Select which channels to generate derivatives for
3. Choose between AI outpainting (Gemini) or Cloudinary gen fill
4. Generate all derivatives with one click

Step 4: Download or Share

• Download individual derivatives
• Download all as a batch
• Share via Cloudinary CDN URLs
• Link to CRM projects

Cloudinary MCP Quick Setup

For AI-assisted workflows, add the Cloudinary MCP to your AI tool:

Cursor / VS Code

Add to ~/.cursor/mcp.json:

{
  "cloudinary-asset-mgmt": {
    "url": "https://asset-management.mcp.cloudinary.com/sse"
  },
  "cloudinary-analysis": {
    "url": "https://analysis.mcp.cloudinary.com/sse"
  }
}

Claude Desktop

Navigate to Settings > Developer > Edit Config and add:

{
  "cloudinary-asset-mgmt": {
    "command": "npx",
    "args": ["mcp-remote", "https://asset-management.mcp.cloudinary.com/sse"]
  }
}

See Cloudinary MCP Setup for detailed instructions and advertising-specific workflows.