Markifact - Google & Meta Ads

View saved version →

---
name: getting-started
description: Learn how to use the Markifact plugin to discover and run marketing operations, select connections and accounts, and work with files. Use for onboarding or guidance on the plugin's workflow.
---

# Getting Started

Markifact provides 1,000+ operations across 50+ advertising, analytics, commerce, and productivity platforms, including Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Google Analytics 4, Shopify, and Google Sheets. Use it to create campaigns and ads, refresh ad creatives, update budgets and bids, manage audiences, analyze performance, generate reports, and move data between connected platforms.

Never assume a requested action is unavailable without searching. These examples are not the full capability list; discover the operations available to the authenticated user for the task at hand.

## Find, inspect, run

Work from the user's task and ask only for missing inputs. Do not run operations just because the plugin is enabled.

1. **Find:** Call `find_operations` with a short platform-and-action query, such as `Google Ads create campaign`, `Meta Ads update ads`, or `GA4 report`. Use the returned operation ID. Try a clearer query or a higher `limit` if the expected operation is missing. If no dedicated operation fits, search for and inspect the platform's generic fallback, such as `gads_mutate`, before concluding the action is unsupported. Do not execute writes merely to test whether a capability exists.
2. **Inspect:** Call `get_operation_inputs` to get the operation's fields, types, and requirements. Reuse schemas already fetched in the conversation. Prefer a dedicated operation when available.
3. **Run:** Build `input_data` using only fields from the schema. For `requires_approval: false`, use `run_operation`. For `requires_approval: true`, explain the action, target, and key values, confirm with the user, then use `run_write_operation`. Present budgets and bids in the ad account's currency, such as "$100 daily", while following the schema's units in tool inputs.

Operation IDs are inputs to the execution tools, not standalone tools. This flow also applies to prerequisite operations such as account selection and report-field listing.

For reports, resolve account names through the platform's account-selection operation, using substring matches. Discover its report-field operation to check metric and dimension names; never guess them. Resolve the date range before execution. Prefer `gads_get_report` for Google Ads and use `gads_run_gaql_query` for advanced or unsupported reporting queries, after discovery and inspection.

## Connections and accounts

A **connection** is a saved, authenticated link between a Markifact workspace and an external platform, such as Google Ads or Meta Ads. It gives operations access through a particular platform login or set of credentials. Connecting the Markifact plugin to ChatGPT does not itself connect those external platforms.

Users create and manage connections on the [Connections page](https://www.markifact.com/app/connections): choose a platform, add a connection, and complete its sign-in and authorization flow or enter credentials there when required. Direct users to this page to update, reconnect, or remove connections. `list_connections` only lists saved connections; it does not create or edit them. Keep credential entry in Markifact's connection flow.

A connection is different from a platform account. For example, one Google Ads connection may provide access to several ad accounts. `connection_id` selects the saved login; account, customer, and property IDs are separate inputs selecting resources accessible through it.

Connections usually resolve automatically when `connection_id` is omitted. Use `list_connections` when the user wants a specific saved login or has multiple connections for the same platform; optionally filter by `connection_type`, such as `gads` or `meta_ads`. Results include `id`, `type`, and `display_name`. Pass the

Preview of the first 4,000 characters. Read full instructions →