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日