name: ops-marketing\ndescription: Marketing command center. Email campaigns (Klaviyo), paid ads (Meta/Google), analytics (GA4), SEO, and social media metrics. One dashboard for all marketing channels.\nargument-hint: \"[email|ads|analytics|seo|social|campaigns|setup]\"\nallowed-tools:
\nBefore executing, load available context:
\nPreferences: Read ${CLAUDE_PLUGIN_DATA_DIR:-$HOME/.claude/plugins/data/ops-ops-marketplace}/preferences.json
timezone — display all timestamps correctlyklaviyo_private_key, meta_ads_token, meta_ad_account_id, ga4_property_id, google_search_console_site — check userConfig keys before env varsgoogle_ads_developer_token, google_ads_client_id, google_ads_client_secret, google_ads_refresh_token, google_ads_customer_id, google_ads_login_customer_id — Google Ads credentialsDaemon health: Read ${CLAUDE_PLUGIN_DATA_DIR}/daemon-health.json
action_needed is not null → surface it before running any channel queriesSecrets: Resolve API keys via userConfig → env vars → Doppler MCP (mcp__doppler__*) → Doppler CLI fallback (see Credential Resolution section below)
| Endpoint | \nMethod | \nDescription | \n
|---|---|---|
https://a.klaviyo.com/api/lists/?fields[list]=name,id,profile_count | \nGET | \nAll lists + subscriber counts | \n
https://a.klaviyo.com/api/campaigns/?filter=equals(messages.channel,'email')&sort=-created_at | \nGET | \nRecent campaigns | \n
https://a.klaviyo.com/api/flows/?filter=equals(status,'live') | \nGET | \nActive flows | \n
https://a.klaviyo.com/api/metrics/ | \nGET | \nAvailable metrics | \n
Auth header: Authorization: Klaviyo-API-Key ${KLAVIYO_KEY} | Revision header: revision: 2024-10-15
| Endpoint | \nMethod | \nDescription | \n
|---|---|---|
https://graph.facebook.com/v18.0/${META_ACCOUNT}/insights?fields=spend,...&date_preset=last_7d | \nGET | \nAccount-level ad spend | \n
https://graph.facebook.com/v18.0/${META_ACCOUNT}/campaigns?fields=name,status,insights{...} | \nGET | \nCampaign breakdown | \n
https://graph.facebook.com/v18.0/me/accounts?fields=instagram_business_account | \nGET | \nLinked Instagram account | \n
Auth header: Authorization: Bearer ${META_TOKEN}
| Endpoint | \nMethod | \nDescription | \n
|---|---|---|
https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runReport | \nPOST | \nRun custom report | \n
Auth: gcloud ADC — GA4_TOKEN=$(gcloud auth application-default print-access-token)
| Endpoint | \nMethod | \nDescription | \n
|---|---|---|
https://searchconsole.googleapis.com/webmasters/v3/sites/${GSC_SITE_ENCODED}/searchAnalytics/query | \nPOST | \nSearch performance data | \n
Auth: Same gcloud ADC token as GA4
\nIf CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is set, use Agent Teams when gathering channel data in parallel. This enables:
Team setup (only when flag is enabled):
\nTeamCreate(\"marketing-team\")\nAgent(team_name=\"marketing-team\", name=\"email-metrics\", prompt=\"Pull Klaviyo subscriber counts, campaign stats, and flow metrics\")\nAgent(team_name=\"marketing-team\", name=\"ads-metrics\", prompt=\"Pull Meta Ads spend, ROAS, and campaign breakdown\")\nAgent(team_name=\"marketing-team\", name=\"analytics-metrics\", prompt=\"Pull GA4 sessions, conversions, and traffic sources\")\nAgent(team_name=\"marketing-team\", name=\"seo-metrics\", prompt=\"Pull Search Console clicks, impressions, and top queries\")\nIf the flag is NOT set, use standard fire-and-forget subagents.
\nResolve credentials in this order for each service:
\nKLAVIYO_KEY=\"${KLAVIYO_PRIVATE_KEY:-$(claude plugin config get klaviyo_private_key 2>/dev/null)}\"\nif [ -z \"$KLAVIYO_KEY\" ]; then\n KLAVIYO_KEY=\"$(doppler secrets get KLAVIYO_PRIVATE_KEY --plain 2>/dev/null)\"\nfi\nMETA_TOKEN=\"${META_ADS_TOKEN:-$(claude plugin config get meta_ads_token 2>/dev/null)}\"\nMETA_ACCOUNT=\"${META_AD_ACCOUNT_ID:-$(claude plugin config get meta_ad_account_id 2>/dev/null)}\"\nif [ -z \"$META_TOKEN\" ]; then\n META_TOKEN=\"$(doppler secrets get META_ADS_TOKEN --plain 2>/dev/null)\"\nfi\nGA4_PROPERTY=\"${GA4_PROPERTY_ID:-$(claude plugin config get ga4_property_id 2>/dev/null)}\"\n# GA4 uses gcloud application default credentials — check if configured:\ngcloud auth application-default print-access-token 2>/dev/null\nGSC_SITE=\"${GOOGLE_SEARCH_CONSOLE_SITE:-$(claude plugin config get google_search_console_site 2>/dev/null)}\"\n# Uses same gcloud ADC as GA4\nGADS_API_VERSION=\"v23\"\nGADS_DEV_TOKEN=\"${GOOGLE_ADS_DEVELOPER_TOKEN:-$(claude plugin config get google_ads_developer_token 2>/dev/null)}\"\nGADS_CLIENT_ID=\"${GOOGLE_ADS_CLIENT_ID:-$(claude plugin config get google_ads_client_id 2>/dev/null)}\"\nGADS_CLIENT_SECRET=\"${GOOGLE_ADS_CLIENT_SECRET:-$(claude plugin config get google_ads_client_secret 2>/dev/null)}\"\nGADS_REFRESH_TOKEN=\"${GOOGLE_ADS_REFRESH_TOKEN:-$(claude plugin config get google_ads_refresh_token 2>/dev/null)}\"\nGADS_CUSTOMER_ID=\"${GOOGLE_ADS_CUSTOMER_ID:-$(claude plugin config get google_ads_customer_id 2>/dev/null)}\"\nGADS_LOGIN_CUSTOMER_ID=\"${GOOGLE_ADS_LOGIN_CUSTOMER_ID:-$(claude plugin config get google_ads_login_customer_id 2>/dev/null)}\"\n\n# Doppler fallback\nif [ -z \"$GADS_REFRESH_TOKEN\" ]; then\n GADS_REFRESH_TOKEN=\"$(doppler secrets get GOOGLE_ADS_REFRESH_TOKEN --plain 2>/dev/null)\"\nfi\nif [ -z \"$GADS_DEV_TOKEN\" ]; then\n GADS_DEV_TOKEN=\"$(doppler secrets get GOOGLE_ADS_DEVELOPER_TOKEN --plain 2>/dev/null)\"\nfi\n\n# Strip dashes from customer ID (API requires no dashes)\nGADS_CUSTOMER_ID=\"${GADS_CUSTOMER_ID//-/}\"\n\n# Refresh access token (expires in ~1 hour — always refresh before API calls)\nGADS_ACCESS_TOKEN=$(curl -s -X POST https://oauth2.googleapis.com/token \\\n --data \"client_id=${GADS_CLIENT_ID}\" \\\n --data \"client_secret=${GADS_CLIENT_SECRET}\" \\\n --data \"refresh_token=${GADS_REFRESH_TOKEN}\" \\\n --data \"grant_type=refresh_token\" | jq -r '.access_token')\n\n# Common headers for all Google Ads API calls\nGADS_HEADERS=(-H \"Content-Type: application/json\" -H \"Authorization: Bearer ${GADS_ACCESS_TOKEN}\" -H \"developer-token: ${GADS_DEV_TOKEN}\")\nif [ -n \"$GADS_LOGIN_CUSTOMER_ID\" ]; then\n GADS_HEADERS+=(-H \"login-customer-id: ${GADS_LOGIN_CUSTOMER_ID}\")\nfi\nRoute $ARGUMENTS to the correct section below:
| Input | \nAction | \n
|---|---|
| (empty), dashboard | \nRun full marketing dashboard | \n
| email, klaviyo | \nKlaviyo email metrics | \n
| ads, meta | \nMeta Ads performance (read-only overview) | \n
| meta-manage, meta create-campaign, meta target, meta creative, meta rules, meta audiences, meta advantage | \nMeta Ads campaign management (see ## meta-manage section) | \n
| google-ads, gads | \nGoogle Ads dashboard + campaign management (see ## google-ads section) | \n
| analytics, ga4 | \nGA4 sessions + conversions | \n
| ga4 realtime, ga4 funnel, ga4 cohort, ga4 audience, ga4 pivot | \nGA4 advanced analytics (see ## ga4-advanced section) | \n
| seo, gsc | \nSearch Console metrics | \n
| social | \nSocial media aggregator | \n
| instagram, instagram post, instagram reel, instagram story, instagram insights, instagram demographics | \nInstagram publishing + insights (see ## instagram section) | \n
| campaigns | \nCross-channel campaign overview (all platforms) | \n
| optimize | \nCross-platform ad optimization agent | \n
| attribution | \nUnified attribution table (Meta + Google + Klaviyo + GA4) | \n
| setup | \nConfigure API keys | \n
Pull Klaviyo metrics for last 30 days.
\ncurl -s \"https://a.klaviyo.com/api/lists/?fields[list]=name,id,profile_count\" \\\n -H \"Authorization: Klaviyo-API-Key ${KLAVIYO_KEY}\" \\\n -H \"revision: 2024-10-15\" | jq '.data[] | {name: .attributes.name, id: .id, count: .attributes.profile_count}'\ncurl -s \"https://a.klaviyo.com/api/campaigns/?filter=equals(messages.channel,'email')&sort=-created_at&page[size]=10&fields[campaign]=name,status,created_at,send_time\" \\\n -H \"Authorization: Klaviyo-API-Key ${KLAVIYO_KEY}\" \\\n -H \"revision: 2024-10-15\" | jq '.data[] | {name: .attributes.name, status: .attributes.status, sent: .attributes.send_time}'\ncurl -s \"https://a.klaviyo.com/api/flows/?filter=equals(status,'live')&fields[flow]=name,status,created,trigger_type\" \\\n -H \"Authorization: Klaviyo-API-Key ${KLAVIYO_KEY}\" \\\n -H \"revision: 2024-10-15\" | jq '.data[] | {name: .attributes.name, trigger: .attributes.trigger_type}'\n# Get metric IDs first\ncurl -s \"https://a.klaviyo.com/api/metrics/\" \\\n -H \"Authorization: Klaviyo-API-Key ${KLAVIYO_KEY}\" \\\n -H \"revision: 2024-10-15\" | jq '.data[] | select(.attributes.name | test(\"Opened Email|Clicked Email|Placed Order\")) | {name: .attributes.name, id: .id}'\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n EMAIL (KLAVIYO) — last 30d\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Lists: [list_name] — [N] subscribers\n Campaigns: [N sent] | [N drafts]\n Active Flows: [N]\n\n RECENT CAMPAIGNS\n [name] [status] sent [date]\n ...\nPull Meta Ads insights for the configured ad account.
\ncurl -s \"https://graph.facebook.com/v18.0/${META_ACCOUNT}/insights?fields=spend,impressions,clicks,ctr,cpc,actions,action_values&date_preset=last_7d&level=account\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq '{spend: .data[0].spend, impressions: .data[0].impressions, clicks: .data[0].clicks, ctr: .data[0].ctr, cpc: .data[0].cpc}'\ncurl -s \"https://graph.facebook.com/v18.0/${META_ACCOUNT}/campaigns?fields=name,status,daily_budget,lifetime_budget,insights{spend,impressions,clicks,actions,action_values}&date_preset=last_7d\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq '.data[] | {name: .name, status: .status, spend: .insights.data[0].spend}'\nFrom action_values array: extract action_type == \"purchase\" value, divide by spend.
curl -s \"https://graph.facebook.com/v18.0/${META_ACCOUNT}/ads?fields=name,adset_id,insights{spend,impressions,clicks,actions,action_values,ctr,cpc}&date_preset=last_7d&limit=10\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq '.data | sort_by(.insights.data[0].spend | tonumber) | reverse | .[0:5] | .[] | {name: .name, spend: .insights.data[0].spend, ctr: .insights.data[0].ctr}'\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n META ADS — last 7d\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Spend: $[X]\n ROAS: [X]x\n Purchases: [N] ($[X] revenue)\n Impressions: [N] CTR: [X]%\n CPC: $[X]\n\n CAMPAIGNS\n [name] [status] $[spend] [roas]x ROAS\n ...\n\n TOP ADS (by spend)\n [name] $[spend] [ctr]% CTR\nFull Meta Ads campaign management. Uses same META_TOKEN and META_ACCOUNT credentials as read-only ads section.
Credential check: If META_TOKEN is empty, print Meta Ads not configured. Run /ops:marketing setup. and stop.
Route $ARGUMENTS within meta-manage:
| Input | \nAction | \n
|---|---|
| create-campaign | \nCreate a new campaign (always PAUSED) | \n
| target <ADSET_ID> | \nConfigure ad set targeting | \n
| creative <CAMPAIGN_ID> | \nUpload image + create ad with copy | \n
| rules | \nList / create automation rules | \n
| audiences | \nCreate custom or lookalike audiences | \n
| advantage | \nCreate Advantage+ AI-optimized campaign | \n
Collect via AskUserQuestion (max 4 options each call):
\n[OUTCOME_TRAFFIC, OUTCOME_SALES, OUTCOME_LEADS, OUTCOME_AWARENESS]Then confirm via AskUserQuestion: \"Create Meta campaign '<NAME>' with $<BUDGET>/day budget?\" options [Create, Cancel]
BUDGET_CENTS=$(awk \"BEGIN {printf \\\"%d\\\", ${BUDGET_DOLLARS} * 100}\")\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/campaigns\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"name=${CAMPAIGN_NAME}\" \\\n -F \"objective=${OBJECTIVE}\" \\\n -F \"status=PAUSED\" \\\n -F \"special_ad_categories=[]\" \\\n -F \"daily_budget=${BUDGET_CENTS}\" | jq '{id: .id, error: .error.message}'\nPrint: Campaign \"${CAMPAIGN_NAME}\" created (ID: <ID>, status: PAUSED, budget: $<BUDGET>/day). Enable via Meta Ads Manager or add ad sets first.
If error, print the error message.
\nConfigure targeting for an existing ad set. Collect via AskUserQuestion:
\nUS,CA,GB) — free text[18-34, 25-54, 35-65, 18-65][All, Men only, Women only, Skip]# Build geo_locations JSON\nGEO_JSON=$(echo \"$COUNTRIES\" | tr ',' '\\n' | jq -Rc '.' | jq -sc '{\"countries\": .}')\n\n# Build targeting spec\nTARGETING_JSON=$(jq -n \\\n --argjson geo \"$GEO_JSON\" \\\n --arg age_min \"$AGE_MIN\" \\\n --arg age_max \"$AGE_MAX\" \\\n '{\n geo_locations: $geo,\n age_min: ($age_min | tonumber),\n age_max: ($age_max | tonumber)\n }')\n\n# Add gender filter if requested\nif [ \"$GENDER\" = \"Men only\" ]; then\n TARGETING_JSON=$(echo \"$TARGETING_JSON\" | jq '. + {\"genders\": [1]}')\nelif [ \"$GENDER\" = \"Women only\" ]; then\n TARGETING_JSON=$(echo \"$TARGETING_JSON\" | jq '. + {\"genders\": [2]}')\nfi\n\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${ADSET_ID}\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"targeting=${TARGETING_JSON}\" | jq '{success: .success, error: .error.message}'\nPrint: Ad set ${ADSET_ID} targeting updated: ${COUNTRIES}, ages ${AGE_MIN}-${AGE_MAX}${GENDER_LABEL}.
Upload an image and create an ad. Collect via AskUserQuestion:
\nThen collect headline (free text, up to 40 characters) via a second AskUserQuestion.
\n# Step 1: Upload image\nif [[ \"$IMAGE_INPUT\" == http* ]]; then\n # Upload by URL\n UPLOAD_RESP=$(curl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/adimages\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"url=${IMAGE_INPUT}\")\nelse\n # Upload by file (multipart)\n UPLOAD_RESP=$(curl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/adimages\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"filename=@${IMAGE_INPUT}\")\nfi\nIMAGE_HASH=$(echo \"$UPLOAD_RESP\" | jq -r '.images | to_entries[0].value.hash // empty')\n\nif [ -z \"$IMAGE_HASH\" ]; then\n echo \"Image upload failed: $(echo \"$UPLOAD_RESP\" | jq -r '.error.message // \"unknown error\"')\"\n exit 0\nfi\n\n# Resolve the Facebook Page ID. Meta's `object_story_spec.page_id` requires a\n# real Page ID — the ad account ID (with `act_` stripped) is NOT a Page ID and\n# the API call will fail. Require META_PAGE_ID in env or plugin prefs.\nMETA_PAGE_ID=\"${META_PAGE_ID:-$(claude plugin config get meta_page_id 2>/dev/null || echo \"\")}\"\nif [ -z \"$META_PAGE_ID\" ]; then\n echo \"META_PAGE_ID is required to create an ad creative. Set it via:\"\n echo \" claude plugin config set meta_page_id <your_fb_page_id>\"\n echo \"Find your Page ID at https://www.facebook.com/<your-page>/about_profile_transparency\"\n exit 0\nfi\n\n# Step 2: Create ad creative\nCREATIVE_RESP=$(curl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/adcreatives\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"name=Creative for ${AD_NAME}\" \\\n -F \"object_story_spec={\\\"page_id\\\": \\\"${META_PAGE_ID}\\\", \\\"link_data\\\": {\\\"image_hash\\\": \\\"${IMAGE_HASH}\\\", \\\"message\\\": \\\"${PRIMARY_TEXT}\\\", \\\"name\\\": \\\"${HEADLINE}\\\"}}\")\nCREATIVE_ID=$(echo \"$CREATIVE_RESP\" | jq -r '.id // empty')\n\nif [ -z \"$CREATIVE_ID\" ]; then\n echo \"Creative creation failed: $(echo \"$CREATIVE_RESP\" | jq -r '.error.message // \"unknown error\"')\"\n exit 0\nfi\n\n# Step 3: Create ad (status PAUSED — Rule 5)\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/ads\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"name=${AD_NAME}\" \\\n -F \"adset_id=${ADSET_ID}\" \\\n -F \"creative={\\\"creative_id\\\": \\\"${CREATIVE_ID}\\\"}\" \\\n -F \"status=PAUSED\" | jq '{id: .id, error: .error.message}'\nPrint: Ad created (ID: <ID>, creative: <CREATIVE_ID>, status: PAUSED). Enable via Meta Ads Manager when ready.
List existing rules or create a new automation rule.
\nList rules:
\ncurl -s \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/adrules_library?fields=name,status,evaluation_spec,execution_spec\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq '.data[] | {id: .id, name: .name, status: .status}'\nCreate rule (prompt via AskUserQuestion):
\n[Pause low performers, Scale winners, Increase budget, Decrease budget]For \"Pause low performers\":
\n# Pause ads where CPA > $50 and spend > $20 in last 7 days\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/adrules_library\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"Pause high CPA ads\",\n \"schedule_spec\": {\"schedule_type\": \"SEMI_HOURLY\"},\n \"evaluation_spec\": {\n \"evaluation_type\": \"SCHEDULE\",\n \"filters\": [\n {\"field\": \"cost_per_result\", \"value\": [50], \"operator\": \"GREATER_THAN\"},\n {\"field\": \"spent\", \"value\": [20], \"operator\": \"GREATER_THAN\"},\n {\"field\": \"entity_type\", \"value\": [\"AD\"], \"operator\": \"EQUAL\"},\n {\"field\": \"time_preset\", \"value\": [\"LAST_7_DAYS\"], \"operator\": \"EQUAL\"}\n ]\n },\n \"execution_spec\": {\n \"execution_type\": \"PAUSE\"\n },\n \"status\": \"ENABLED\"\n }' | jq '{id: .id, error: .error.message}'\nFor \"Scale winners\":
\n\n\n⚠️ Scope this to prospecting ad sets. A bare
\npurchase_roas > 3filter auto-scales retargeting ad sets too — whose ROAS is inflated by warm-audience demand capture (conversions that would have happened anyway), not incremental growth. Blanket-scaling them pours budget into demand you already own while starving prospecting, and the funnel contracts a month later. Add an ad-set-name/audience filter that excludes retargeting/remarketing (or restrict the rule to your prospecting ad sets), and confirm a winner's lift with a holdout before scaling on ROAS alone.
# Increase budget 20% for ad sets with ROAS > 3x in last 7 days\n# NOTE: restrict to prospecting ad sets — see caveat above\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/adrules_library\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"Scale winning ad sets\",\n \"schedule_spec\": {\"schedule_type\": \"DAILY\"},\n \"evaluation_spec\": {\n \"evaluation_type\": \"SCHEDULE\",\n \"filters\": [\n {\"field\": \"purchase_roas\", \"value\": [3], \"operator\": \"GREATER_THAN\"},\n {\"field\": \"entity_type\", \"value\": [\"ADSET\"], \"operator\": \"EQUAL\"},\n {\"field\": \"time_preset\", \"value\": [\"LAST_7_DAYS\"], \"operator\": \"EQUAL\"}\n ]\n },\n \"execution_spec\": {\n \"execution_type\": \"INCREASE_BUDGET\",\n \"execution_options\": [{\"field\": \"budget_value\", \"value\": \"20\", \"operator\": \"PERCENTAGE\"}]\n },\n \"status\": \"ENABLED\"\n }' | jq '{id: .id, error: .error.message}'\nPrint: Rule created (ID: <ID>). Runs semi-hourly and will auto-pause ads with CPA > $50.
Create Custom Audience or Lookalike Audience.
\nPrompt via AskUserQuestion:
\n[Custom — website, Custom — customer list, Lookalike, Skip]Custom — website (Pixel-based):
\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/customaudiences\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"Website visitors — last 30 days\",\n \"subtype\": \"WEBSITE\",\n \"retention_days\": 30,\n \"rule\": {\"inclusions\": {\"operator\": \"or\", \"rules\": [{\"event_sources\": [{\"id\": \"<PIXEL_ID>\", \"type\": \"pixel\"}], \"retention_seconds\": 2592000, \"filter\": {\"operator\": \"and\", \"filters\": [{\"field\": \"event\", \"operator\": \"eq\", \"value\": \"PageView\"}]}}]}}\n }' | jq '{id: .id, name: .name, error: .error.message}'\nNote: Replace <PIXEL_ID> with actual pixel ID from Meta Events Manager.
Lookalike Audience (requires origin audience with min 100 matched profiles):
\n# Prompt for origin audience ID via AskUserQuestion (free text)\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/customaudiences\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"name\\\": \\\"Lookalike — ${ORIGIN_AUDIENCE_NAME} 1%\\\",\n \\\"subtype\\\": \\\"LOOKALIKE\\\",\n \\\"origin_audience_id\\\": \\\"${ORIGIN_AUDIENCE_ID}\\\",\n \\\"lookalike_spec\\\": {\n \\\"country\\\": \\\"US\\\",\n \\\"ratio\\\": 0.01,\n \\\"type\\\": \\\"similarity\\\"\n }\n }\" | jq '{id: .id, name: .name, error: .error.message}'\nPrint: Lookalike audience created (ID: <ID>). Typically takes 1-6 hours to populate.
Create an Advantage+ Shopping Campaign (AI-optimized).
\nCollect via AskUserQuestion:
\nThen confirm: \"Create Advantage+ campaign '<NAME>' with $<BUDGET>/day?\" options [Create, Cancel]
BUDGET_CENTS=$(awk \"BEGIN {printf \\\"%d\\\", ${BUDGET_DOLLARS} * 100}\")\ncurl -s -X POST \"https://graph.facebook.com/v20.0/${META_ACCOUNT}/campaigns\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"name\\\": \\\"${CAMPAIGN_NAME}\\\",\n \\\"objective\\\": \\\"OUTCOME_SALES\\\",\n \\\"status\\\": \\\"PAUSED\\\",\n \\\"special_ad_categories\\\": [],\n \\\"daily_budget\\\": ${BUDGET_CENTS},\n \\\"smart_promotion_type\\\": \\\"AUTOMATED_SHOPPING_ADS\\\"\n }\" | jq '{id: .id, error: .error.message}'\nPrint: Advantage+ campaign \"${CAMPAIGN_NAME}\" created (ID: <ID>, status: PAUSED). Meta AI will optimize targeting and creative delivery once enabled.
Pull GA4 data via the Data API using gcloud ADC.
\nGA4_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\ncurl -s -X POST \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"dateRanges\": [{\"startDate\": \"7daysAgo\", \"endDate\": \"today\"}],\n \"metrics\": [\n {\"name\": \"sessions\"},\n {\"name\": \"totalUsers\"},\n {\"name\": \"conversions\"},\n {\"name\": \"totalRevenue\"},\n {\"name\": \"bounceRate\"},\n {\"name\": \"averageSessionDuration\"}\n ]\n }' | jq '.rows[0].metricValues | {sessions: .[0].value, users: .[1].value, conversions: .[2].value, revenue: .[3].value, bounce_rate: .[4].value}'\ncurl -s -X POST \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"dateRanges\": [{\"startDate\": \"7daysAgo\", \"endDate\": \"today\"}],\n \"dimensions\": [{\"name\": \"sessionDefaultChannelGrouping\"}],\n \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"conversions\"}],\n \"orderBys\": [{\"metric\": {\"metricName\": \"sessions\"}, \"desc\": true}],\n \"limit\": 8\n }' | jq '.rows[] | {channel: .dimensionValues[0].value, sessions: .metricValues[0].value, conversions: .metricValues[1].value}'\ncurl -s -X POST \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"dateRanges\": [{\"startDate\": \"7daysAgo\", \"endDate\": \"today\"}],\n \"dimensions\": [{\"name\": \"pagePath\"}],\n \"metrics\": [{\"name\": \"screenPageViews\"}, {\"name\": \"averageSessionDuration\"}],\n \"orderBys\": [{\"metric\": {\"metricName\": \"screenPageViews\"}, \"desc\": true}],\n \"limit\": 10\n }' | jq '.rows[] | {page: .dimensionValues[0].value, views: .metricValues[0].value}'\nIf GA4_TOKEN is empty or gcloud not available, output: GA4 not configured — run /ops:marketing setup or configure gcloud ADC.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n ANALYTICS (GA4) — last 7d\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Sessions: [N] Users: [N]\n Conversions: [N] CVR: [X]%\n Revenue: $[X]\n Bounce Rate: [X]% Avg Session: [Xm Xs]\n\n TRAFFIC SOURCES\n [channel] [N sessions] [N conversions]\n ...\n\n TOP PAGES\n [path] [N views]\nAdvanced GA4 analytics: realtime, funnel, cohort, audience export, and pivot reports.
\nCredential check: If GA4_TOKEN is empty or GA4_PROPERTY is missing, print GA4 not configured — run /ops:marketing setup or configure gcloud ADC and stop.
Route $ARGUMENTS within ga4-advanced (matches ga4 <sub> pattern):
| Input | \nAction | \n
|---|---|
| realtime | \nActive users right now (last 30 min) | \n
| funnel | \nConversion funnel with step visualization | \n
| cohort | \nCohort retention analysis by device | \n
| audience | \nAsync audience segment export | \n
| pivot | \nMulti-dimensional pivot report | \n
GA4_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\nRESULT=$(curl -s -X POST \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runRealtimeReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"minuteRanges\": [{\"startMinutesAgo\": 29, \"endMinutesAgo\": 0}],\n \"dimensions\": [\n {\"name\": \"unifiedScreenName\"},\n {\"name\": \"deviceCategory\"}\n ],\n \"metrics\": [{\"name\": \"activeUsers\"}],\n \"orderBys\": [{\"metric\": {\"metricName\": \"activeUsers\"}, \"desc\": true}],\n \"limit\": 10\n }')\n\nTOTAL=$(echo \"$RESULT\" | jq '[.rows[]?.metricValues[0].value | tonumber] | add // 0')\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" GA4 REALTIME — Last 30 Minutes\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\necho \"Active Users Right Now: ${TOTAL}\"\necho \"\"\necho \"Top Pages:\"\nprintf \"| %-40s | %-8s | %-7s |\\n\" \"Page\" \"Device\" \"Users\"\nprintf \"|%s|%s|%s|\\n\" \"------------------------------------------\" \"----------\" \"---------\"\necho \"$RESULT\" | jq -r '.rows[]? | [.dimensionValues[0].value, .dimensionValues[1].value, .metricValues[0].value] | @tsv' 2>/dev/null | \\\n while IFS=$'\\t' read -r page device users; do\n printf \"| %-40s | %-8s | %-7s |\\n\" \"${page:0:40}\" \"$device\" \"$users\"\n done\nAsk user for funnel steps via AskUserQuestion (free text). Default template uses session_start → page_view → purchase.
\n# NOTE: Uses v1alpha — breaking changes possible per Google's versioning policy\nGA4_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\n\n# Prompt for funnel type first\n# AskUserQuestion: \"Funnel mode?\" options [Closed funnel, Open funnel]\n\nIS_OPEN=$([ \"$FUNNEL_MODE\" = \"Open funnel\" ] && echo \"true\" || echo \"false\")\n\nRESULT=$(curl -s -X POST \"https://analyticsdata.googleapis.com/v1alpha/properties/${GA4_PROPERTY}:runFunnelReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"dateRanges\\\": [{\\\"startDate\\\": \\\"30daysAgo\\\", \\\"endDate\\\": \\\"today\\\"}],\n \\\"funnel\\\": {\n \\\"isOpenFunnel\\\": ${IS_OPEN},\n \\\"steps\\\": [\n {\n \\\"name\\\": \\\"Session Start\\\",\n \\\"filterExpression\\\": {\\\"funnelEventFilter\\\": {\\\"eventName\\\": \\\"session_start\\\"}}\n },\n {\n \\\"name\\\": \\\"Page View\\\",\n \\\"filterExpression\\\": {\\\"funnelEventFilter\\\": {\\\"eventName\\\": \\\"page_view\\\"}}\n },\n {\n \\\"name\\\": \\\"Purchase\\\",\n \\\"filterExpression\\\": {\\\"funnelEventFilter\\\": {\\\"eventName\\\": \\\"purchase\\\"}}\n }\n ]\n },\n \\\"funnelBreakdown\\\": {\n \\\"breakdownDimension\\\": {\\\"name\\\": \\\"deviceCategory\\\"},\n \\\"limit\\\": 4\n }\n }\")\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" GA4 FUNNEL — Last 30 Days (${FUNNEL_MODE})\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\necho \"$RESULT\" | jq -r '\n .funnelTable.rows[]? |\n \"Step: \\(.dimensionValues[0].value) Users: \\(.metricValues[0].value) Completion: \\(.metricValues[1].value)% Abandoned: \\(.metricValues[2].value)\"\n' 2>/dev/null || echo \"No funnel data — ensure purchase events are firing in GA4.\"\nWeekly cohort retention for users acquired in the past month, broken down by device.
\nGA4_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\nSTART_DATE=$(date -v-30d +%Y-%m-%d 2>/dev/null || date -d '30 days ago' +%Y-%m-%d)\nEND_DATE=$(date +%Y-%m-%d)\n\nRESULT=$(curl -s -X POST \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"dimensions\\\": [\n {\\\"name\\\": \\\"cohort\\\"},\n {\\\"name\\\": \\\"cohortNthWeek\\\"},\n {\\\"name\\\": \\\"deviceCategory\\\"}\n ],\n \\\"metrics\\\": [\n {\\\"name\\\": \\\"cohortActiveUsers\\\"},\n {\\\"name\\\": \\\"cohortRetentionFraction\\\"}\n ],\n \\\"cohortSpec\\\": {\n \\\"cohorts\\\": [{\n \\\"dimension\\\": \\\"firstSessionDate\\\",\n \\\"dateRange\\\": {\\\"startDate\\\": \\\"${START_DATE}\\\", \\\"endDate\\\": \\\"${END_DATE}\\\"}\n }],\n \\\"cohortsRange\\\": {\n \\\"granularity\\\": \\\"WEEKLY\\\",\n \\\"startOffset\\\": 0,\n \\\"endOffset\\\": 5\n }\n }\n }\")\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" GA4 COHORT RETENTION — Last 30 Days\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\nprintf \"| %-12s | %-6s | %-8s | %-10s | %-10s |\\n\" \"Cohort\" \"Week\" \"Device\" \"Users\" \"Retention%\"\nprintf \"|%s|%s|%s|%s|%s|\\n\" \"--------------\" \"--------\" \"----------\" \"------------\" \"------------\"\necho \"$RESULT\" | jq -r '.rows[]? | [\n .dimensionValues[0].value,\n .dimensionValues[1].value,\n .dimensionValues[2].value,\n .metricValues[0].value,\n (.metricValues[1].value | tonumber * 100 | tostring | split(\".\")[0])\n] | @tsv' 2>/dev/null | \\\n while IFS=$'\\t' read -r cohort week device users retention; do\n printf \"| %-12s | %-6s | %-8s | %-10s | %-10s |\\n\" \"$cohort\" \"$week\" \"$device\" \"$users\" \"${retention}%\"\n done\nAsync audience export: create → poll until ACTIVE → show user count.
\nGA4_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\n\n# Step 1: List available audiences so user can pick one\nAUDIENCES=$(curl -s \"https://analyticsadmin.googleapis.com/v1alpha/properties/${GA4_PROPERTY}/audiences\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\")\necho \"Available audiences:\"\necho \"$AUDIENCES\" | jq -r '.audiences[]? | \"\\(.name | split(\"/\") | last): \\(.displayName)\"' 2>/dev/null\n\n# AskUserQuestion: \"Enter audience ID from list above:\" (free text)\n\n# Step 2: Create export\nEXPORT_RESP=$(curl -s -X POST \\\n \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}/audienceExports\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"audience\\\": \\\"properties/${GA4_PROPERTY}/audiences/${AUDIENCE_ID}\\\",\n \\\"dimensions\\\": [\n {\\\"dimensionName\\\": \\\"deviceId\\\"},\n {\\\"dimensionName\\\": \\\"isAdsPersonalizationAllowed\\\"}\n ]\n }\")\nEXPORT_NAME=$(echo \"$EXPORT_RESP\" | jq -r '.name // empty')\n\nif [ -z \"$EXPORT_NAME\" ]; then\n echo \"Failed to create export: $(echo \"$EXPORT_RESP\" | jq -r '.error.message // \"unknown error\"')\"\n exit 0\nfi\n\necho \"Export created: ${EXPORT_NAME}\"\necho \"Polling for completion (small audiences: ~30s, large: up to 15 min)...\"\n\n# Step 3: Poll until ACTIVE or FAILED\nATTEMPTS=0\nwhile [ $ATTEMPTS -lt 60 ]; do\n STATUS_RESP=$(curl -s \"https://analyticsdata.googleapis.com/v1beta/${EXPORT_NAME}\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\")\n STATE=$(echo \"$STATUS_RESP\" | jq -r '.state // \"UNKNOWN\"')\n PCT=$(echo \"$STATUS_RESP\" | jq -r '.percentageCompleted // 0')\n \n if [ \"$STATE\" = \"ACTIVE\" ]; then break; fi\n if [ \"$STATE\" = \"FAILED\" ]; then\n echo \"Export failed. Try again or check GA4 audience configuration.\"\n exit 0\n fi\n echo \" State: ${STATE} (${PCT}% complete)...\"\n sleep 10\n ATTEMPTS=$((ATTEMPTS + 1))\ndone\n\n# Step 4: Query results\nQUERY_RESP=$(curl -s -X POST \\\n \"https://analyticsdata.googleapis.com/v1beta/${EXPORT_NAME}:query\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\")\nROW_COUNT=$(echo \"$QUERY_RESP\" | jq '.rowCount // 0')\n\necho \"\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" GA4 AUDIENCE EXPORT\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" Audience ID: ${AUDIENCE_ID}\"\necho \" Users exported: ${ROW_COUNT}\"\necho \" Ads-eligible: $(echo \"$QUERY_RESP\" | jq '[.audienceRows[]? | select(.dimensionValues[1].value == \"true\")] | length') users\"\necho \"\"\necho \"Export ready. Use this audience for retargeting in Meta or Google Ads.\"\nMulti-dimensional pivot: channel group × device category × conversions.
\nGA4_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\n\nRESULT=$(curl -s -X POST \"https://analyticsdata.googleapis.com/v1beta/properties/${GA4_PROPERTY}:runPivotReport\" \\\n -H \"Authorization: Bearer ${GA4_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}],\n \"dimensions\": [\n {\"name\": \"sessionDefaultChannelGrouping\"},\n {\"name\": \"deviceCategory\"}\n ],\n \"metrics\": [\n {\"name\": \"sessions\"},\n {\"name\": \"conversions\"},\n {\"name\": \"totalRevenue\"}\n ],\n \"pivots\": [\n {\n \"fieldNames\": [\"sessionDefaultChannelGrouping\"],\n \"limit\": 6\n },\n {\n \"fieldNames\": [\"deviceCategory\"],\n \"limit\": 3\n }\n ]\n }')\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" GA4 PIVOT — Channel × Device (Last 30 Days)\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\nprintf \"| %-20s | %-8s | %-10s | %-11s | %-10s |\\n\" \"Channel\" \"Device\" \"Sessions\" \"Conversions\" \"Revenue\"\nprintf \"|%s|%s|%s|%s|%s|\\n\" \"----------------------\" \"----------\" \"------------\" \"-------------\" \"------------\"\necho \"$RESULT\" | jq -r '.rows[]? | [\n .dimensionValues[0].value,\n .dimensionValues[1].value,\n .metricValues[0].value,\n .metricValues[1].value,\n (.metricValues[2].value | tonumber | . * 100 | round / 100 | tostring)\n] | @tsv' 2>/dev/null | \\\n while IFS=$'\\t' read -r channel device sessions convs revenue; do\n printf \"| %-20s | %-8s | %-10s | %-11s | \\$%-9s |\\n\" \"${channel:0:20}\" \"$device\" \"$sessions\" \"$convs\" \"$revenue\"\n done\nPull Google Search Console data.
\nGSC_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\nGSC_SITE_ENCODED=$(python3 -c \"import urllib.parse; print(urllib.parse.quote('${GSC_SITE}', safe=''))\" 2>/dev/null || echo \"${GSC_SITE}\" | sed 's|:|%3A|g; s|/|%2F|g')\ncurl -s -X POST \"https://searchconsole.googleapis.com/webmasters/v3/sites/${GSC_SITE_ENCODED}/searchAnalytics/query\" \\\n -H \"Authorization: Bearer ${GSC_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"startDate\": \"'$(date -v-28d +%Y-%m-%d 2>/dev/null || date -d '28 days ago' +%Y-%m-%d)'\",\n \"endDate\": \"'$(date +%Y-%m-%d)'\",\n \"dimensions\": [],\n \"rowLimit\": 1\n }' | jq '{clicks: .rows[0].clicks, impressions: .rows[0].impressions, ctr: .rows[0].ctr, position: .rows[0].position}'\ncurl -s -X POST \"https://searchconsole.googleapis.com/webmasters/v3/sites/${GSC_SITE_ENCODED}/searchAnalytics/query\" \\\n -H \"Authorization: Bearer ${GSC_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"startDate\": \"'$(date -v-28d +%Y-%m-%d 2>/dev/null || date -d '28 days ago' +%Y-%m-%d)'\",\n \"endDate\": \"'$(date +%Y-%m-%d)'\",\n \"dimensions\": [\"query\"],\n \"rowLimit\": 20,\n \"dimensionFilterGroups\": []\n }' | jq '.rows[] | {query: .keys[0], clicks: .clicks, impressions: .impressions, position: (.position | floor)}'\ncurl -s -X POST \"https://searchconsole.googleapis.com/webmasters/v3/sites/${GSC_SITE_ENCODED}/searchAnalytics/query\" \\\n -H \"Authorization: Bearer ${GSC_TOKEN}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"startDate\": \"'$(date -v-28d +%Y-%m-%d 2>/dev/null || date -d '28 days ago' +%Y-%m-%d)'\",\n \"endDate\": \"'$(date +%Y-%m-%d)'\",\n \"dimensions\": [\"page\"],\n \"rowLimit\": 10\n }' | jq '.rows[] | {page: .keys[0], clicks: .clicks, impressions: .impressions, position: (.position | floor)}'\nIf GSC not configured, output: Search Console not configured — run /ops:marketing setup.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n SEO (SEARCH CONSOLE) — last 28d\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Clicks: [N]\n Impressions: [N]\n CTR: [X]%\n Avg Position: [X]\n\n TOP QUERIES\n [query] [clicks] clicks pos [N]\n ...\n\n TOP PAGES\n [url] [clicks] clicks [impressions] impr\nAggregate available social media metrics. Check which are configured.
\n# Get Instagram Business Account ID linked to the ad account\ncurl -s \"https://graph.facebook.com/v18.0/me/accounts?fields=instagram_business_account\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq '.data[].instagram_business_account.id' 2>/dev/null\n\n# Then pull media insights\ncurl -s \"https://graph.facebook.com/v18.0/${IG_ACCOUNT_ID}?fields=followers_count,media_count,profile_views\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq '{followers: .followers_count, posts: .media_count, profile_views: .profile_views}'\nYT_TOKEN=$(gcloud auth application-default print-access-token 2>/dev/null)\ncurl -s \"https://www.googleapis.com/youtube/v3/channels?part=statistics&mine=true\" \\\n -H \"Authorization: Bearer ${YT_TOKEN}\" | jq '.items[0].statistics | {subscribers: .subscriberCount, views: .viewCount, videos: .videoCount}'\nShow [not configured] for any unconfigured channels rather than failing.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n SOCIAL MEDIA\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n Instagram: [N followers] [N posts] [N profile views]\n YouTube: [N subscribers] [N total views]\n TikTok: [not configured] — set TIKTOK_ACCESS_TOKEN\nInstagram publishing and insights via Instagram Graph API (same META_TOKEN as Meta Ads).
Prerequisites:
\nMETA_TOKEN configured (same as Meta Ads)IG_ACCOUNT_ID resolved via: curl \"https://graph.facebook.com/v21.0/me/accounts?fields=instagram_business_account\" -H \"Authorization: Bearer ${META_TOKEN}\" → data[0].instagram_business_account.idRate limit: 200 API calls/hour per app. Demographics require 48h reporting delay. Media insights require account with >1,000 followers.
\nResolve IG account ID at the start of every instagram invocation:
\nIG_ACCOUNT_ID=$(claude plugin config get instagram_account_id 2>/dev/null)\nif [ -z \"$IG_ACCOUNT_ID\" ]; then\n IG_ACCOUNT_ID=$(curl -s \"https://graph.facebook.com/v21.0/me/accounts?fields=instagram_business_account\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq -r '.data[0].instagram_business_account.id // empty')\n # Cache it\n [ -n \"$IG_ACCOUNT_ID\" ] && claude plugin config set instagram_account_id \"$IG_ACCOUNT_ID\" 2>/dev/null\nfi\nif [ -z \"$IG_ACCOUNT_ID\" ]; then\n echo \"Instagram Business account not linked to your Meta token. Ensure your Facebook Page has an Instagram Business account connected.\"\n exit 0\nfi\nRoute $ARGUMENTS within instagram:
| Input | \nAction | \n
|---|---|
| post <IMAGE_URL> | \nPublish image post to feed | \n
| reel <VIDEO_URL> | \nPublish a Reel | \n
| story <IMAGE_URL|VIDEO_URL> | \nPublish a Story | \n
| insights <MEDIA_ID> | \nPer-post metrics | \n
| account-insights [days] | \nAccount-level reach + impressions | \n
| demographics | \nAudience age/gender/location | \n
Publish an image post (two-step: create container → publish).
\nCollect via AskUserQuestion:
\n# Step 1: Create media container\nCONTAINER=$(curl -s -X POST \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/media\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"image_url=${IMAGE_URL}\" \\\n -F \"caption=${CAPTION}\" \\\n -F \"media_type=IMAGE\")\nCONTAINER_ID=$(echo \"$CONTAINER\" | jq -r '.id // empty')\n\nif [ -z \"$CONTAINER_ID\" ]; then\n echo \"Failed to create media container: $(echo \"$CONTAINER\" | jq -r '.error.message // \"unknown error\"')\"\n exit 0\nfi\n\n# Step 2: Publish\nPUBLISH=$(curl -s -X POST \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/media_publish\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"creation_id=${CONTAINER_ID}\")\nMEDIA_ID=$(echo \"$PUBLISH\" | jq -r '.id // empty')\n\nif [ -n \"$MEDIA_ID\" ]; then\n echo \"Post published (Media ID: ${MEDIA_ID}). View at https://www.instagram.com/ — may take 1-2 min to appear.\"\nelse\n echo \"Publish failed: $(echo \"$PUBLISH\" | jq -r '.error.message // \"unknown error\"')\"\nfi\nPublish a Reel. Video must be an HTTPS URL (MP4, H.264, max 15 min, min 500px width).
\nCollect via AskUserQuestion:
\n# Step 1: Create video container (async — must poll for status)\nCONTAINER=$(curl -s -X POST \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/media\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"media_type=REELS\" \\\n -F \"video_url=${VIDEO_URL}\" \\\n -F \"caption=${CAPTION}\" \\\n -F \"share_to_feed=true\")\nCONTAINER_ID=$(echo \"$CONTAINER\" | jq -r '.id // empty')\n\nif [ -z \"$CONTAINER_ID\" ]; then\n echo \"Failed to create Reel container: $(echo \"$CONTAINER\" | jq -r '.error.message // \"unknown error\"')\"\n exit 0\nfi\n\necho \"Reel uploading... polling for ready status.\"\n\n# Poll until status is FINISHED\nATTEMPTS=0\nwhile [ $ATTEMPTS -lt 30 ]; do\n STATUS=$(curl -s \"https://graph.facebook.com/v21.0/${CONTAINER_ID}?fields=status_code\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq -r '.status_code // \"UNKNOWN\"')\n [ \"$STATUS\" = \"FINISHED\" ] && break\n [ \"$STATUS\" = \"ERROR\" ] && echo \"Reel processing failed.\" && exit 0\n sleep 10\n ATTEMPTS=$((ATTEMPTS + 1))\ndone\n\n# Step 2: Publish\nPUBLISH=$(curl -s -X POST \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/media_publish\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"creation_id=${CONTAINER_ID}\")\nMEDIA_ID=$(echo \"$PUBLISH\" | jq -r '.id // empty')\n\nif [ -n \"$MEDIA_ID\" ]; then\n echo \"Reel published (Media ID: ${MEDIA_ID}). Reach and plays metrics available after 24-48h.\"\nelse\n echo \"Reel publish failed: $(echo \"$PUBLISH\" | jq -r '.error.message // \"unknown error\"')\"\nfi\nPublish a Story (image or video, 24h expiry).
\nCollect via AskUserQuestion:
\n[Image story, Video story]if [ \"$CONTENT_TYPE\" = \"Video story\" ]; then\n MEDIA_TYPE=\"VIDEO\"\n URL_FIELD=\"video_url\"\nelse\n MEDIA_TYPE=\"IMAGE\"\n URL_FIELD=\"image_url\"\nfi\n\nCONTAINER=$(curl -s -X POST \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/media\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"media_type=STORIES\" \\\n -F \"${URL_FIELD}=${CONTENT_URL}\")\nCONTAINER_ID=$(echo \"$CONTAINER\" | jq -r '.id // empty')\n\nif [ -z \"$CONTAINER_ID\" ]; then\n echo \"Failed to create Story container: $(echo \"$CONTAINER\" | jq -r '.error.message // \"unknown error\"')\"\n exit 0\nfi\n\nPUBLISH=$(curl -s -X POST \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/media_publish\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" \\\n -F \"creation_id=${CONTAINER_ID}\")\nMEDIA_ID=$(echo \"$PUBLISH\" | jq -r '.id // empty')\n\nif [ -n \"$MEDIA_ID\" ]; then\n echo \"Story published (Media ID: ${MEDIA_ID}). Expires after 24 hours.\"\nelse\n echo \"Story publish failed: $(echo \"$PUBLISH\" | jq -r '.error.message // \"unknown error\"')\"\nfi\nPer-post metrics. Note: reach, saves, shares deprecated for non-Reels video; plays only for Reels/video.
\nMETRICS=\"reach,saved,shares,comments_count,like_count,impressions\"\n# For Reels, add plays: detect via media_type field\nMEDIA_TYPE=$(curl -s \"https://graph.facebook.com/v21.0/${MEDIA_ID}?fields=media_type\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\" | jq -r '.media_type // \"IMAGE\"')\n[ \"$MEDIA_TYPE\" = \"VIDEO\" ] || [ \"$MEDIA_TYPE\" = \"REEL\" ] && METRICS=\"${METRICS},plays\"\n\nRESULT=$(curl -s \"https://graph.facebook.com/v21.0/${MEDIA_ID}/insights?metric=${METRICS}&period=lifetime\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\")\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" INSTAGRAM POST INSIGHTS — ${MEDIA_ID}\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\necho \"$RESULT\" | jq -r '.data[]? | \" \\(.name): \\(.values[0].value)\"' 2>/dev/null || \\\n echo \"No insights data — account must have >1,000 followers for insights access.\"\nAccount-level reach and impressions. Default: last 7 days.
\nDAYS=\"${DAYS:-7}\"\nEND_DATE=$(date +%Y-%m-%d)\nSTART_DATE=$(date -v-${DAYS}d +%Y-%m-%d 2>/dev/null || date -d \"${DAYS} days ago\" +%Y-%m-%d)\n\nRESULT=$(curl -s \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/insights?metric=reach,impressions,profile_views&period=day&since=${START_DATE}&until=${END_DATE}\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\")\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" INSTAGRAM ACCOUNT INSIGHTS — Last ${DAYS} Days\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" Note: Data reflects 24-48h reporting delay\"\necho \"\"\n\nREACH=$(echo \"$RESULT\" | jq '[.data[]? | select(.name == \"reach\") | .values[]?.value | tonumber] | add // 0')\nIMPRESSIONS=$(echo \"$RESULT\" | jq '[.data[]? | select(.name == \"impressions\") | .values[]?.value | tonumber] | add // 0')\nPROFILE_VIEWS=$(echo \"$RESULT\" | jq '[.data[]? | select(.name == \"profile_views\") | .values[]?.value | tonumber] | add // 0')\n\necho \" Reach: ${REACH}\"\necho \" Impressions: ${IMPRESSIONS}\"\necho \" Profile Views: ${PROFILE_VIEWS}\"\nAudience breakdown by age/gender and top locations. Requires lifetime period (48h delay).
\nRESULT=$(curl -s \"https://graph.facebook.com/v21.0/${IG_ACCOUNT_ID}/insights?metric=audience_gender_age,audience_city,audience_country&period=lifetime\" \\\n -H \"Authorization: Bearer ${META_TOKEN}\")\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" INSTAGRAM DEMOGRAPHICS\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" Note: Top 45 segments shown. Data has 48h delay.\"\necho \"\"\n\necho \"AGE / GENDER BREAKDOWN:\"\necho \"$RESULT\" | jq -r '.data[]? | select(.name == \"audience_gender_age\") | .values[0].value | to_entries[] | \" \\(.key): \\(.value)%\"' 2>/dev/null | head -20\n\necho \"\"\necho \"TOP CITIES:\"\necho \"$RESULT\" | jq -r '.data[]? | select(.name == \"audience_city\") | .values[0].value | to_entries | sort_by(-.value) | .[0:10][] | \" \\(.key): \\(.value)%\"' 2>/dev/null\n\necho \"\"\necho \"TOP COUNTRIES:\"\necho \"$RESULT\" | jq -r '.data[]? | select(.name == \"audience_country\") | .values[0].value | to_entries | sort_by(-.value) | .[0:10][] | \" \\(.key): \\(.value)%\"' 2>/dev/null\nCredential check: If GADS_DEV_TOKEN or GADS_REFRESH_TOKEN is empty after resolution, print:\nWarning: Google Ads not configured. Run /ops:setup marketing to set up credentials.\nand stop.
Token refresh: Run the access token refresh curl (from Credential Resolution above) at the start of every google-ads invocation. If GADS_ACCESS_TOKEN is null or \"null\", print:\nWarning: Google Ads token refresh failed. Check client_id/client_secret/refresh_token in /ops:setup.\nand stop.
Route $ARGUMENTS within the google-ads section:
| Input | \nAction | \n
|---|---|
| (empty), dashboard, overview | \nCampaign performance dashboard (last 7 days) | \n
| search-terms, terms | \nSearch Terms Report with negative keyword candidates (last 30 days) | \n
| budget-recs, recommendations, recs | \nBudget optimization recommendations from Google | \n
| campaigns, manage | \nCampaign management — list, create, pause, enable, adjust budget | \n
| keywords, kw, keyword-planner | \nKeyword Planner — discover keywords with volume and bid data | \n
| ad-groups, ag | \nAd group management — list, create, add/remove keywords, adjust bids | \n
dashboard, overview)# Campaign performance — last 7 days\nCAMPAIGNS=$(curl -s -X POST \\\n \"https://googleads.googleapis.com/${GADS_API_VERSION}/customers/${GADS_CUSTOMER_ID}/googleAds:searchStream\" \\\n \"${GADS_HEADERS[@]}\" \\\n --data-binary '{\n \"query\": \"SELECT campaign.id, campaign.name, campaign.status, campaign_budget.amount_micros, metrics.cost_micros, metrics.impressions, metrics.clicks, metrics.conversions, metrics.conversions_value FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status != REMOVED ORDER BY metrics.cost_micros DESC LIMIT 20\"\n }')\n\n# Check for API error\nGADS_ERROR=$(echo \"$CAMPAIGNS\" | jq -r '.[0].error.message // empty' 2>/dev/null)\nif [ -n \"$GADS_ERROR\" ]; then\n echo \"Google Ads API error: ${GADS_ERROR}\"\n echo \"Check credentials with /ops:marketing setup.\"\n exit 0\nfi\n\n# Check for empty results\nCAMPAIGN_COUNT=$(echo \"$CAMPAIGNS\" | jq '[.[].results[]?] | length' 2>/dev/null || echo \"0\")\nif [ \"$CAMPAIGN_COUNT\" -eq 0 ]; then\n echo \"No active campaigns found in the last 7 days.\"\n exit 0\nfi\n\n# Compute totals\nTOTAL_SPEND=$(echo \"$CAMPAIGNS\" | jq '[.[].results[]?.metrics.costMicros // \"0\" | tonumber] | add / 1000000' 2>/dev/null)\nTOTAL_CONVERSIONS=$(echo \"$CAMPAIGNS\" | jq '[.[].results[]?.metrics.conversions // \"0\" | tonumber] | add' 2>/dev/null)\nTOTAL_VALUE=$(echo \"$CAMPAIGNS\" | jq '[.[].results[]?.metrics.conversionsValue // \"0\" | tonumber] | add' 2>/dev/null)\nOVERALL_ROAS=$(awk \"BEGIN { if (${TOTAL_SPEND:-0} > 0) printf \\\"%.2f\\\", ${TOTAL_VALUE:-0} / ${TOTAL_SPEND:-1}; else print \\\"—\\\" }\")\nTOTAL_SPEND_FMT=$(awk \"BEGIN { printf \\\"%.2f\\\", ${TOTAL_SPEND:-0} }\")\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" GOOGLE ADS — Last 7 Days\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\necho \"Total Spend: \\$${TOTAL_SPEND_FMT}\"\necho \"Total Conversions: ${TOTAL_CONVERSIONS}\"\necho \"Overall ROAS: ${OVERALL_ROAS}\"\necho \"\"\n\n# Print table header\nprintf \"| %-30s | %-8s | %-10s | %-10s | %-8s | %-8s | %-6s | %-6s | %-6s |\\n\" \\\n \"Campaign\" \"Status\" \"Budget/day\" \"Spend\" \"Impr\" \"Clicks\" \"CTR\" \"Conv\" \"ROAS\"\nprintf \"|%s|%s|%s|%s|%s|%s|%s|%s|%s|\\n\" \\\n \"--------------------------------\" \"----------\" \"------------\" \"------------\" \"----------\" \"----------\" \"--------\" \"--------\" \"--------\"\n\n# Print each campaign row\necho \"$CAMPAIGNS\" | jq -r '.[].results[]? | [\n .campaign.name,\n .campaign.status,\n (.campaignBudget.amountMicros // \"0\" | tonumber / 1000000),\n (.metrics.costMicros // \"0\" | tonumber / 1000000),\n (.metrics.impressions // \"0\" | tonumber),\n (.metrics.clicks // \"0\" | tonumber),\n (.metrics.conversions // \"0\" | tonumber),\n (.metrics.conversionsValue // \"0\" | tonumber),\n (.metrics.costMicros // \"0\" | tonumber)\n] | @tsv' 2>/dev/null | while IFS=$'\\t' read -r name status budget_raw spend_raw impr_raw clicks_raw conv_raw value_raw cost_raw; do\n BUDGET=$(awk \"BEGIN { printf \\\"%.2f\\\", ${budget_raw:-0} }\")\n SPEND=$(awk \"BEGIN { printf \\\"%.2f\\\", ${spend_raw:-0} }\")\n CTR=$(awk \"BEGIN { if (${impr_raw:-0} > 0) printf \\\"%.2f\\\", ${clicks_raw:-0} / ${impr_raw:-0} * 100; else print \\\"0.00\\\" }\")\n ROAS=$(awk \"BEGIN { if (${spend_raw:-0} > 0) printf \\\"%.2f\\\", ${value_raw:-0} / ${spend_raw:-1}; else print \\\"—\\\" }\")\n printf \"| %-30s | %-8s | \\$%-9s | \\$%-9s | %-8s | %-8s | %-5s%% | %-6s | %-6s |\\n\" \\\n \"${name:0:30}\" \"$status\" \"$BUDGET\" \"$SPEND\" \"$impr_raw\" \"$clicks_raw\" \"$CTR\" \"$conv_raw\" \"$ROAS\"\ndone\nsearch-terms, terms)SEARCH_TERMS=$(curl -s -X POST \\\n \"https://googleads.googleapis.com/${GADS_API_VERSION}/customers/${GADS_CUSTOMER_ID}/googleAds:searchStream\" \\\n \"${GADS_HEADERS[@]}\" \\\n --data-binary '{\n \"query\": \"SELECT search_term_view.search_term, search_term_view.status, campaign.name, ad_group.name, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS AND metrics.impressions > 0 ORDER BY metrics.impressions DESC LIMIT 100\"\n }')\n\n# Check for API error\nGADS_ST_ERROR=$(echo \"$SEARCH_TERMS\" | jq -r '.[0].error.message // empty' 2>/dev/null)\nif [ -n \"$GADS_ST_ERROR\" ]; then\n echo \"Google Ads API error: ${GADS_ST_ERROR}\"\n echo \"Check credentials with /ops:marketing setup.\"\n exit 0\nfi\n\nTERM_COUNT=$(echo \"$SEARCH_TERMS\" | jq '[.[].results[]?] | length' 2>/dev/null || echo \"0\")\nif [ \"$TERM_COUNT\" -eq 0 ]; then\n echo \"No search term data found for the last 30 days.\"\n exit 0\nfi\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" SEARCH TERMS REPORT — Last 30 Days\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\n\nprintf \"| %-30s | %-10s | %-20s | %-15s | %-6s | %-6s | %-7s | %-6s |\\n\" \\\n \"Search Term\" \"Status\" \"Campaign\" \"Ad Group\" \"Impr\" \"Clicks\" \"Cost\" \"Conv\"\nprintf \"|%s|%s|%s|%s|%s|%s|%s|%s|\\n\" \\\n \"--------------------------------\" \"------------\" \"----------------------\" \"-----------------\" \"--------\" \"--------\" \"---------\" \"--------\"\n\n# Status mapping and table rows\necho \"$SEARCH_TERMS\" | jq -r '.[].results[]? | [\n .searchTermView.searchTerm,\n .searchTermView.status,\n .campaign.name,\n .adGroup.name,\n (.metrics.impressions // \"0\" | tostring),\n (.metrics.clicks // \"0\" | tostring),\n (.metrics.costMicros // \"0\" | tonumber / 1000000 | tostring),\n (.metrics.conversions // \"0\" | tostring)\n] | @tsv' 2>/dev/null | while IFS=$'\\t' read -r term status campaign adgroup impr clicks cost_raw conv; do\n case \"$status\" in\n ADDED) STATUS_LABEL=\"✓ Added\" ;;\n EXCLUDED) STATUS_LABEL=\"✗ Excluded\" ;;\n *) STATUS_LABEL=\"○ New\" ;;\n esac\n COST=$(awk \"BEGIN { printf \\\"%.2f\\\", ${cost_raw:-0} }\")\n printf \"| %-30s | %-10s | %-20s | %-15s | %-6s | %-6s | \\$%-6s | %-6s |\\n\" \\\n \"${term:0:30}\" \"$STATUS_LABEL\" \"${campaign:0:20}\" \"${adgroup:0:15}\" \"$impr\" \"$clicks\" \"$COST\" \"$conv\"\ndone\n\necho \"\"\necho \"Negative keyword candidates (high spend, zero conversions):\"\n\necho \"$SEARCH_TERMS\" | jq -r '.[].results[]? | select(\n (.metrics.conversions // \"0\" | tonumber) == 0 and\n (.metrics.costMicros // \"0\" | tonumber) > 1000000\n) | \" • \\(.searchTermView.searchTerm) — $\\(.metrics.costMicros | tonumber / 1000000 | tostring | split(\".\") | .[0] + \".\" + (.[1] // \"00\")[0:2])\"' 2>/dev/null || echo \" (none found)\"\nbudget-recs, recommendations, recs)RECS=$(curl -s -X POST \\\n \"https://googleads.googleapis.com/${GADS_API_VERSION}/customers/${GADS_CUSTOMER_ID}/googleAds:searchStream\" \\\n \"${GADS_HEADERS[@]}\" \\\n --data-binary '{\n \"query\": \"SELECT recommendation.resource_name, recommendation.type, recommendation.campaign, recommendation.impact, recommendation.campaign_budget_recommendation FROM recommendation WHERE recommendation.type IN (CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET)\"\n }')\n\n# Check for API error\nGADS_REC_ERROR=$(echo \"$RECS\" | jq -r '.[0].error.message // empty' 2>/dev/null)\nif [ -n \"$GADS_REC_ERROR\" ]; then\n echo \"Google Ads API error: ${GADS_REC_ERROR}\"\n echo \"Check credentials with /ops:marketing setup.\"\n exit 0\nfi\n\nREC_COUNT=$(echo \"$RECS\" | jq '[.[].results[]?] | length' 2>/dev/null || echo \"0\")\nif [ \"$REC_COUNT\" -eq 0 ]; then\n echo \"No budget recommendations available. Google needs campaign data to generate recommendations.\"\n exit 0\nfi\n\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \" BUDGET RECOMMENDATIONS\"\necho \"━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\"\necho \"\"\n\nprintf \"| %-22s | %-25s | %-15s | %-13s | %-20s |\\n\" \\\n \"Type\" \"Campaign\" \"Current Budget\" \"Recommended\" \"Impact\"\nprintf \"|%s|%s|%s|%s|%s|\\n\" \\\n \"------------------------\" \"---------------------------\" \"-----------------\" \"---------------\" \"----------------------\"\n\necho \"$RECS\" | jq -r '.[].results[]? | [\n .recommendation.type,\n .recommendation.campaign,\n (.recommendation.campaignBudgetRecommendation.currentBudgetAmountMicros // \"0\" | tonumber / 1000000 | tostring),\n (.recommendation.campaignBudgetRecommendation.recommendedBudgetAmountMicros // \"0\" | tonumber / 1000000 | tostring),\n (.recommendation.impact.baseMetrics.impressions // \"0\" | tonumber | tostring),\n (.recommendation.impact.potentialMetrics.impressions // \"0\" | tonumber | tostring)\n] | @tsv' 2>/dev/null | while IFS=$'\\t' read -r rec_type campaign current_raw recommended_raw base_impr_raw pot_impr_raw; do\n case \"$rec_type\" in\n CAMPAIGN_BUDGET) TYPE_LABEL=\"Increase Budget\" ;;\n MOVE_UNUSED_BUDGET) TYPE_LABEL=\"Move Unused Budget\" ;;\n MARGINAL_ROI_CAMPAI\n