Skip to content

iamwaqargulzar/Marketing-Agent-OS / skills/ads

When the user wants to plan, run, or fix paid ads on Google, Meta, and LinkedIn, or asks a judgement call on them: are ads worth it, which channel or budget split, why CPA rose, kill or keep a campaign. End with facts, hypotheses, and missing data; label unavailable inputs MISSING instead of estimating. For ad copy, see ad-creative. For pixels and CAPI, see conversion-tracking. For landing pages, see cro.

FileKindSize
LICENSE.txtmarkdown12.1 KB
NOTICE.mdmarkdown381 B
SKILL.mdskill md28.4 KB
references/abm-playbook.mdmarkdown7.6 KB
references/account-evidence.mdmarkdown3.1 KB
references/ad-copy-templates.mdmarkdown4.7 KB
references/additions.mdmarkdown1.9 KB
references/audience-targeting.mdmarkdown5.9 KB
references/audit-guardrails.mdmarkdown8.0 KB
references/b2b-paid-playbook.mdmarkdown7.8 KB
references/continued.mdmarkdown1.9 KB
references/creative-research-automation.mdmarkdown10.2 KB
references/google-ads-audit-checklist.mdmarkdown12.5 KB
references/google-search-playbook.mdmarkdown10.6 KB
references/linkedin-b2b-playbook.mdmarkdown9.0 KB
references/meta-andromeda-playbook.mdmarkdown8.0 KB
references/meta-decision-system.mdmarkdown15.3 KB
references/operating-check.mdmarkdown7.1 KB
references/operating-review.mdmarkdown1.8 KB
references/payback-period.mdmarkdown6.8 KB
references/platform-setup-checklists.mdmarkdown7.4 KB
references/reading-google-ads-data.mdmarkdown8.5 KB
references/rsa-output-spec.mdmarkdown3.6 KB
references/shared/skills-ad-creative-references-meta-creative-formats.mdmarkdown10.5 KB
references/shared/tools-REGISTRY.mdmarkdown38.2 KB
references/shared/tools-integrations-ga4.mdmarkdown5.8 KB
references/shared/tools-integrations-google-ads.mdmarkdown10.1 KB
references/shared/tools-integrations-linkedin-ads.mdmarkdown5.6 KB
references/shared/tools-integrations-meta-ads.mdmarkdown5.2 KB
references/shared/tools-integrations-segment.mdmarkdown5.7 KB
references/shared/tools-integrations-tiktok-ads.mdmarkdown3.5 KB
references/skill-contract.mdmarkdown2.4 KB

references/shared/tools-integrations-tiktok-ads.md

View on GitHub
# TikTok Ads

Advertising platform for TikTok's short-form video audience.

## Capabilities

| Integration | Available | Notes |
|-------------|-----------|-------|
| API | ✓ | Marketing API for campaigns, audiences, reporting |
| MCP | - | Not available |
| CLI | - | Not available |
| SDK | ✓ | Python SDK available |

## Authentication

- **Type**: Access Token
- **Header**: `Access-Token: {access_token}`
- **Setup**: Create app in TikTok for Business, get access token

## Common Agent Operations

### Get advertiser info

```bash
GET https://business-api.tiktok.com/open_api/v1.3/advertiser/info/?advertiser_ids=["{advertiser_id}"]

Access-Token: {access_token}
```

### Get campaigns

```bash
GET https://business-api.tiktok.com/open_api/v1.3/campaign/get/?advertiser_id={advertiser_id}&page=1&page_size=20

Access-Token: {access_token}
```

### Get campaign report

```bash
GET https://business-api.tiktok.com/open_api/v1.3/report/integrated/get/?advertiser_id={advertiser_id}&report_type=BASIC&dimensions=["campaign_id"]&metrics=["spend","impressions","clicks","conversion"]&data_level=AUCTION_CAMPAIGN&start_date=2024-01-01&end_date=2024-01-31

Access-Token: {access_token}
```

Send report parameters in the query string. JSON-encode array values such as
`dimensions` and `metrics`, then URL-encode the query values (the example shows
decoded values for readability).

### Create campaign

```bash
POST https://business-api.tiktok.com/open_api/v1.3/campaign/create/

Access-Token: {access_token}

{
  "advertiser_id": "{advertiser_id}",
  "campaign_name": "Campaign Name",
  "objective_type": "CONVERSIONS",
  "budget_mode": "BUDGET_MODE_DAY",
  "budget": 100
}
```

### Update campaign status

```bash
POST https://business-api.tiktok.com/open_api/v1.3/campaign/status/update/

Access-Token: {access_token}

{
  "advertiser_id": "{advertiser_id}",
  "campaign_ids": ["{campaign_id}"],
  "opt_status": "ENABLE"
}
```

### Get ad groups

```bash
GET https://business-api.tiktok.com/open_api/v1.3/adgroup/get/?advertiser_id={advertiser_id}&filtering={"campaign_ids":["{campaign_id}"]}

Access-Token: {access_token}
```

Campaign IDs belong inside the JSON-encoded `filtering` query parameter.
URL-encode that value before sending the request.

### Get audiences

```bash
GET https://business-api.tiktok.com/open_api/v1.3/dmp/custom_audience/list/?advertiser_id={advertiser_id}

Access-Token: {access_token}
```

## Key Metrics

| Metric | Description |
|--------|-------------|
| `spend` | Amount spent |
| `impressions` | Ad impressions |
| `clicks` | Clicks |
| `ctr` | Click-through rate |
| `cpc` | Cost per click |
| `cpm` | Cost per 1000 impressions |
| `conversion` | Conversions |
| `cost_per_conversion` | CPA |
| `video_play_actions` | Video views |
| `video_watched_6s` | 6s views |

## Campaign Objectives

- `REACH` - Brand awareness
- `TRAFFIC` - Website traffic
- `VIDEO_VIEWS` - Video views
- `LEAD_GENERATION` - Lead forms
- `CONVERSIONS` - Website conversions
- `APP_PROMOTION` - App installs

## Targeting Options

### Demographics
- Age ranges
- Gender
- Languages
- Locations

### Interests & Behavior
- Interest categories
- Video interactions
- Creator interactions
- Hashtag interactions

### Custom Audiences
- Customer file uploads
- Website visitors (pixel)
- App activity
- Engagement audiences

## When to Use

- Reaching younger demographics (18-34)
- Video-first advertising
- Viral/creative campaigns
- App promotion

## Rate Limits

- 10 requests/second
- 100,000 requests/day

## Relevant Skills

- ads
- analytics
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall