appeeky/ua-skills

cross-channel-performance

When the user wants a unified view of TikTok, Meta, and Apple Search Ads performance in one report.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/appeeky/ua-skills --skill cross-channel-performance

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Cross-Channel Performance Dashboard

You are a paid growth analyst. Produce a unified performance report across all connected ad channels — spend, installs, conversions, CPA, and ROAS — in one executive view.

Initial Assessment

  1. Read app-ads-context.md for active channels, budget, and CPA targets
  2. Check credential status for each platform
  3. Ask for date range: default last 7 days (operational) or last 14 days (strategic)
  4. Identify which channels are connected vs. planned

Credential Check

PlatformMCP Tool
TikToktiktok_ads_credentials_status
Metameta_ads_credentials_status
ASAasa_credentials_status
RevenueCatrc_overview (test with keys)

Report which channels have data vs. which need connection. Don't skip disconnected channels — note them as "not connected" in the dashboard.

Data Collection

Pull last 7d (or user-specified) from each connected channel:

TikTok

tiktok_ads_performance
  level: advertiser
  days: 7

For campaign-level drill-down:

tiktok_ads_performance
  level: campaign
  days: 7

Meta

meta_ads_insights
  target_type: ad_account
  date_preset: last_7d
  level: campaign

If user has a specific ad account:

meta_ads_insights
  target_type: ad_account
  ad_account_id: "act_xxx"
  date_preset: last_7d
  level: campaign

Apple Search Ads

asa_profitability
  rc_key: "<sk_xxx>"
  level: campaign
  days: 7
  min_spend: 5

Revenue context

rc_overview
  rc_key: "<sk_xxx>"
  rc_project: "<proj_xxx>"

rc_attribution_summary
  rc_key: "<sk_xxx>"
  rc_project: "<proj_xxx>"

Unified Metrics Table

Build this table for every connected channel:

ChannelSpendImpressionsClicksInstallsConvCPICPARevenue*ROASTrend
TikTok↑/↓/→
Meta
ASA
Google UACmanual
Total

*Revenue from RC attribution or asa_profitability join where available. Mark estimated revenue with ~ prefix.

Derived metrics

MetricFormulaNotes
CPISpend / InstallsTop-of-funnel efficiency
CPASpend / ConversionsBottom-of-funnel efficiency
ROASRevenue / SpendProfitability signal
CTRClicks / ImpressionsCreative relevance (social)
CVRInstalls / ClicksStore listing quality
Share of spendChannel spend / Total spendBudget allocation check

Channel Fit Guide

Help the user interpret which channels suit their app:

App typeUsually best channelWhy
High-intent utilityASA firstUser is searching for solution
Visual consumer / B2CTikTokDemo-friendly, young audience
Broad demographicMetaScale + lookalike targeting
Subscription beauty/lifestyleTikTok + Meta testUGC creative performs well
Productivity / B2BASA + MetaIntent + professional targeting
GamingTikTok + Google UACVisual gameplay hooks
Niche communityMeta (interest) + RedditPrecise interest targeting

Cross-reference with user's category from app-ads-context.md.

Trend Analysis

Compare current period to prior period (pull days: 14 and split, or use two date ranges):

SignalDiagnosisAction
Spend up, CPA upAudience saturation or creative fatigueRefresh creatives
Spend up, CPA stableHealthy scalingContinue
Spend down, CPA upBudget cut on best ad setsCheck pacing
Installs up, conversions flatLow-quality trafficTighten targeting or event optimization
ASA CPI low, social CPA highNormal — ASA is highest intentDon't compare CPI directly

Reallocation Recommendation

If one channel CPA < 0.8× others with meaningful volume (50+ conversions):

  1. Shift 20% budget from worst-performing channel to best
  2. Document in output with specific dollar amounts
  3. Route to cross-channel-budget for formal reallocation plan

Minimum volume rule: Don't reallocate based on < 20 conversions or < 7 days of data.

Per-Channel Drill-Down

For each channel, include a brief section:

TikTok highlights

  • Top campaign by CPA
  • Worst campaign (pause candidate)
  • Creative fatigue signal (CTR declining 3+ days)

Meta highlights

  • Top ad set by CPA
  • Audience breakdown if available
  • Event optimization status (install vs. purchase)

ASA highlights

  • Top campaign by ROAS
  • Bleeder campaign (ROAS < 1.0)
  • Link to asa-roas-analysis for keyword detail

Output Template

markdown
# Cross-Channel Performance — [App Name] — [Period]

## Executive summary
- Total spend: $___
- Total installs: ___
- Blended CPI: $___
- Blended CPA: $___
- Best channel: [name] (CPA $___)
- Worst channel: [name] (CPA $___)
- Recommendation: [reallocate / hold / pause X]

## Channel dashboard
| Channel | Spend | Installs | Conv | CPI | CPA | Revenue | ROAS | Trend |
|---------|-------|----------|------|-----|-----|---------|------|-------|
| | | | | | | | | |

## Channel details

### TikTok
- Connected: Yes/No
- Top campaign: [name] — CPA $___
- Issue: [if any]

### Meta
- Connected: Yes/No
- Top ad set: [name] — CPA $___
- Issue: [if any]

### Apple Search Ads
- Connected: Yes/No
- Top campaign: [name] — ROAS ___×
- Issue: [if any]

## Reallocation recommendation
- Move $___/day from [channel] → [channel]
- Reason: [CPA difference, volume sufficient]

## Not connected
- [Channel]: connect via Appeeky Settings to include in dashboard

## Next steps
→ `campaign-profitability` for margin analysis
→ `cross-channel-budget` for formal budget plan
→ `asa-roas-analysis` for ASA keyword detail

Update app-ads-context.md

Offer to update Historical Performance section with latest CPAs and channel status.

Cadence

FrequencyUse this skill for
WeeklyOperational check alongside channel audits
Day 14 of new channelFirst meaningful comparison
MonthlyStrategic channel mix review
Before budget changeEvidence for reallocation

Cross-Skill Handoffs

NeedRoute to
Profitability verdictcampaign-profitability
Budget allocationcross-channel-budget
ASA keyword detailasa-roas-analysis
TikTok campaign audittiktok-campaign-audit
Meta campaign auditmeta-campaign-audit
MMP issues (0 conversions)mmp-setup

Related Skills

  • cross-channel-budget — allocate budget based on performance
  • campaign-profitability — LTV vs CPA margin analysis
  • asa-roas-analysis — ASA keyword profitability
  • app-ads-context — channel config and targets
  • tiktok-campaign-setup / meta-campaign-setup — channel execution

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
appeeky
社区

ads-router

Single entry point that routes paid UA, mobile app ads, ad creatives, TikTok/Meta/ASA campaigns, ROAS, MMP setup, or Spark Ads requests to the correct specialist skill. Use FIRST when the user mentions ads, TikTok ads, Meta ads, Facebook ads, Apple Search Ads, ASA, CPA, CPI, ROAS, ad creative, Spark Ads, MMP, AppsFlyer, paid UA, or "help with my ad campaign" but the right skill is not obvious. Triggers "/ua-skill", "/ads-skill", "/growth-ads", "app ads help". Skip when user explicitly invokes a

安装量
1
GitHub Stars
71
最近更新
8月23日
appeeky
社区

app-ads-context

When the user wants to create or update their paid growth context document with app info, ad accounts, budgets, CPI/CPA targets, LTV, and connected channels. Use when starting any paid ads project or when the user mentions "ads context", "growth brief", "my ad budget", or "target CPA". All other paid growth skills check for this file first. For organic ASO context, see app-marketing-context.

安装量
1
GitHub Stars
71
最近更新
8月23日
appeeky
社区

asa-negative-keywords

When the user wants to add Apple Search Ads negative keywords from search terms reports or block wasted spend. Use when the user mentions "ASA negatives", "negative keywords Apple Search Ads", "search terms waste", "block search terms ASA", or "stop wasting ASA budget". For full weekly optimization, see asa-weekly-optimization. For profitability context, see asa-roas-analysis.

安装量
1
GitHub Stars
71
最近更新
8月23日
appeeky
社区

campaign-profitability

When the user wants to know if their paid ads are profitable — LTV vs CPA, break-even CPI, ROAS, or margin after ad spend. Use when the user mentions "am I profitable on ads", "LTV vs CPA", "ad margin", "break even CPI", "can I scale ads", or "ROAS by channel". For subscription health baseline, see subscription-snapshot. For unified channel dashboard, see cross-channel-performance.

安装量
1
GitHub Stars
71
最近更新
8月23日