edcc34aa6d
Create centralized tools/ directory with REGISTRY.md index and 29 integration guides covering analytics, SEO, CRM, payments, referral, email, ads, automation, and commerce platforms. Each guide includes API endpoints, authentication, common operations, and links to relevant skills. Updated AGENTS.md and key skills (referral-program, analytics-tracking, email-sequence, paid-ads) with tool integration references. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
148 lines
3.4 KiB
Markdown
148 lines
3.4 KiB
Markdown
# Meta Ads (Facebook/Instagram)
|
|
|
|
Advertising platform for Facebook, Instagram, Messenger, and Audience Network.
|
|
|
|
## Capabilities
|
|
|
|
| Integration | Available | Notes |
|
|
|-------------|-----------|-------|
|
|
| API | ✓ | Marketing API for campaigns, audiences, reporting |
|
|
| MCP | - | Not available |
|
|
| CLI | - | Not available |
|
|
| SDK | ✓ | Official SDKs for Python, PHP, Node.js |
|
|
|
|
## Authentication
|
|
|
|
- **Type**: OAuth 2.0 Access Token
|
|
- **Header**: Access token as query parameter
|
|
- **Setup**: Create app in Meta Business Suite, generate System User token
|
|
|
|
## Common Agent Operations
|
|
|
|
### Get ad accounts
|
|
|
|
```bash
|
|
GET https://graph.facebook.com/v18.0/me/adaccounts?access_token={access_token}&fields=id,name,account_status
|
|
```
|
|
|
|
### Get campaigns
|
|
|
|
```bash
|
|
GET https://graph.facebook.com/v18.0/act_{ad_account_id}/campaigns?access_token={access_token}&fields=id,name,status,objective,daily_budget
|
|
```
|
|
|
|
### Get campaign insights
|
|
|
|
```bash
|
|
GET https://graph.facebook.com/v18.0/{campaign_id}/insights?access_token={access_token}&fields=impressions,clicks,spend,actions,cost_per_action_type&date_preset=last_30d
|
|
```
|
|
|
|
### Get ad sets
|
|
|
|
```bash
|
|
GET https://graph.facebook.com/v18.0/act_{ad_account_id}/adsets?access_token={access_token}&fields=id,name,status,targeting,daily_budget,bid_amount
|
|
```
|
|
|
|
### Get ads
|
|
|
|
```bash
|
|
GET https://graph.facebook.com/v18.0/{ad_set_id}/ads?access_token={access_token}&fields=id,name,status,creative
|
|
```
|
|
|
|
### Create campaign
|
|
|
|
```bash
|
|
POST https://graph.facebook.com/v18.0/act_{ad_account_id}/campaigns
|
|
|
|
access_token={access_token}
|
|
&name=Campaign Name
|
|
&objective=CONVERSIONS
|
|
&status=PAUSED
|
|
&special_ad_categories=[]
|
|
```
|
|
|
|
### Update campaign status
|
|
|
|
```bash
|
|
POST https://graph.facebook.com/v18.0/{campaign_id}
|
|
|
|
access_token={access_token}
|
|
&status=ACTIVE
|
|
```
|
|
|
|
### Get custom audiences
|
|
|
|
```bash
|
|
GET https://graph.facebook.com/v18.0/act_{ad_account_id}/customaudiences?access_token={access_token}&fields=id,name,approximate_count
|
|
```
|
|
|
|
### Create lookalike audience
|
|
|
|
```bash
|
|
POST https://graph.facebook.com/v18.0/act_{ad_account_id}/customaudiences
|
|
|
|
access_token={access_token}
|
|
&name=Lookalike - Top Customers
|
|
&subtype=LOOKALIKE
|
|
&origin_audience_id={source_audience_id}
|
|
&lookalike_spec={"type":"similarity","country":"US"}
|
|
```
|
|
|
|
## Key Metrics
|
|
|
|
| Metric | Description |
|
|
|--------|-------------|
|
|
| `impressions` | Ad impressions |
|
|
| `clicks` | All clicks |
|
|
| `spend` | Amount spent |
|
|
| `reach` | Unique people reached |
|
|
| `frequency` | Avg impressions per person |
|
|
| `cpm` | Cost per 1000 impressions |
|
|
| `cpc` | Cost per click |
|
|
| `actions` | Conversions array |
|
|
| `cost_per_action_type` | CPA by action |
|
|
|
|
## Campaign Objectives
|
|
|
|
- `AWARENESS` - Brand awareness
|
|
- `TRAFFIC` - Website traffic
|
|
- `ENGAGEMENT` - Post engagement
|
|
- `LEADS` - Lead generation
|
|
- `APP_PROMOTION` - App installs
|
|
- `SALES` - Conversions/catalog sales
|
|
|
|
## Targeting Options
|
|
|
|
```json
|
|
{
|
|
"geo_locations": {
|
|
"countries": ["US"],
|
|
"cities": [{"key": "2420379"}]
|
|
},
|
|
"age_min": 25,
|
|
"age_max": 45,
|
|
"genders": [1, 2],
|
|
"interests": [{"id": "6003139266461", "name": "Marketing"}],
|
|
"behaviors": [{"id": "6002714895372"}]
|
|
}
|
|
```
|
|
|
|
## When to Use
|
|
|
|
- Creating/managing Facebook and Instagram ads
|
|
- Audience targeting and lookalikes
|
|
- Campaign performance analysis
|
|
- Retargeting setup
|
|
|
|
## Rate Limits
|
|
|
|
- 200 calls/hour per ad account
|
|
- 60 calls/hour for marketing API
|
|
- Use batch requests for efficiency
|
|
|
|
## Relevant Skills
|
|
|
|
- paid-ads
|
|
- analytics-tracking
|
|
- page-cro
|