.png)
Campaign Manager 360 Integration Guide
Integrate Campaign Manager 360 with enterprise systems through its REST API, asynchronous reporting, OAuth 2.0, scheduled workflows, and report-file processing.
Campaign Manager 360 integration options at a glance
Campaign Manager 360 provides a Google Discovery-based REST API for retrieving and managing accounts, advertisers, campaigns, placements, ads, creatives, and other trafficking resources. Its reporting workflows support asynchronous report creation, status polling, and downloadable report files. OAuth 2.0 and approved service-account arrangements provide authenticated access subject to CM360 permissions. Martini can orchestrate these calls in scheduled workflows, manage pagination and checkpoints, transform JSON and report-file data, and load results into databases or downstream applications. No general-purpose CM360 webhook mechanism or direct database connection was confirmed, so event-style synchronization should use scheduled API queries and report extraction.
Common Campaign Manager 360 integration patterns
Common Campaign Manager 360 data objects used in integrations
Authentication and security considerations
Google API authentication
Campaign Manager 360 uses Google API authentication and authorization patterns. OAuth 2.0 is the primary model for applications acting on behalf of an authorized Google Marketing Platform user. Approved service-account arrangements may support server-to-server access, subject to the customer’s Google and CM360 configuration.
Permissions and secrets
Access tokens do not by themselves grant every CM360 operation. The identity must have the required user profile and account permissions. Martini should store client credentials, refresh tokens, and service-account material in protected environment configuration and use least-privilege identities.
- Limit OAuth scopes to required Google Marketing Platform APIs.
- Separate read-only reporting access from approved trafficking write access.
- Do not embed credentials or tokens in workflows.
- Log request context without exposing authentication secrets.
Operational considerations for Campaign Manager 360 integrations
Quotas, pagination, and retries
Google APIs apply quota and rate controls. Limit concurrency, cache stable reference data, follow pagination, and retry transient failures with exponential backoff. Separate high-volume report extraction from interactive operations.
Reports and files
Persist report IDs, poll at controlled intervals, enforce maximum polling durations, and download files only after completion. Validate encoding, delimiters, headers, required columns, numeric formats, and time zones before loading data.
Idempotency and schema changes
Use stable CM360 identifiers and deterministic upsert keys. Report ingestion may use account or profile ID, report ID, date range, and resource identifiers. Preserve replay windows for late corrections, validate optional and required fields, and route unexpected schemas for review.
Observability
Distinguish authentication, permission, invalid-resource, quota, temporary API, report-generation, file, and downstream failures. Log correlation data, report IDs, account IDs, and workflow execution identifiers without exposing secrets.
Why use Martini instead of scripts or point-to-point integrations?
Orchestrate more than API calls
Scripts can call CM360 endpoints, but enterprise integrations also need scheduling, pagination, asynchronous report polling, file processing, validation, checkpointing, retries, and controlled downstream delivery. Martini centralizes that behavior in maintainable workflows.
Keep integration logic reusable
Martini can expose standardized APIs for internal consumers while keeping CM360-specific request structures behind workflows. Shared mappings, validation rules, authentication configuration, and error handling reduce duplicated point-to-point logic.
Support operational reliability
- Use scheduled and API-triggered workflows for different operating modes.
- Apply idempotent writes and replay windows for corrected reporting data.
- Preserve checkpoints and report metadata for recovery.
- Monitor executions and separate transient failures from data-quality exceptions.