managing-apps

Add App to My Apps

How to Add an App to My Apps My Apps list Learn how to add a Shopify app to your portfolio in Ranksy so you can track its performance and analytics. What is "My Apps"? "My Apps" is your personal portfolio of Shopify apps you want to track in Ranksy. When you add an app to My Apps, you unlock: - Complete analytics dashboard - Revenue and MRR tracking (when Partner API is connected) - Traffic and conversion metrics - Category and keyword ranking history - Customer insights - AI-powered suggestions - Performance trends over time How to Add an App Method 1: Use Global Search (Fastest) 1. Click the search bar at the top of any page 2. Start typing your app's name 3. Your app appears in the dropdown results 4. Click on your app to open its profile 5. Click the "Add to My Apps" button Method 2: Browse the Apps Directory Browse apps directory 1. Click "Apps" in the main navigation 2. Use the search box to find your app by name 3. Or filter by category, pricing, or rating 4. Click on your app when you find it 5. Click the "Add to My Apps" button Method 3: From a Category or Keyword Page 1. Navigate to any category or keyword page 2. Find your app in the rankings list 3. Click on your app to open its profile 4. Click the "Add to My Apps" button After Adding Your App Once you click "Add to My Apps": 1. The button immediately changes to "Remove from My Apps" 2. Your app appears in the My Apps section in the sidebar 3. You can immediately access the analytics dashboard That's it - no confirmation needed. The app is added instantly. What Data is Available Immediately Without any integrations: - Category rankings and history - Keyword rankings and history - Public reviews and ratings - App store listing details - Competitor comparisons Unlocking Full Analytics To see revenue, traffic, and customer data, you need to connect integrations: 1. Go to your app's Settings page 2. Connect Shopify Partner API for revenue and customer data 3. Connect Google BigQuery for traffic and conversion data See Connect Partner API and Connect BigQuery for detailed setup guides. Viewing Your Apps Access My Apps Click "My Apps" in the sidebar to see your complete portfolio. App Cards Show Each app card displays: - App name and icon - Current category rank - Rating and review count - Quick status indicators Open Analytics Dashboard Click any app card to open its full analytics dashboard with: - Performance metrics - Ranking trends - Traffic analysis (with BigQuery) - Revenue data (with Partner API) - AI suggestions Managing Your Apps Switch Between Apps If you have multiple apps: 1. Click the app selector in the sidebar 2. Choose the app you want to view 3. The dashboard updates immediately Remove an App If you no longer want to track an app: 1. Go to the app's Settings page 2. Scroll to the bottom 3. Click "Remove from My Apps" 4. Confirm the removal Note: Removing an app disconnects integrations but your historical data is preserved for 90 days. App Settings Each app in My Apps has its own Settings page where you can: Integration Settings - Shopify Partner API: Connect to track revenue, MRR, and customers - Google BigQuery: Connect to analyze traffic and conversions Integration Status For each integration, you can see: - Connection status (Connected, Error, Inactive) - Last sync timestamp - Error messages if any issues - Sync controls Actions Available - Test connection - Trigger manual sync - Update credentials - Disconnect integration See App Settings for detailed information about configuring your app. Tips for Managing Multiple Apps For Agencies - Add all client apps to your portfolio - Use the app selector to quickly switch between clients - Each app has separate integration settings - Team members can access all team apps For Multi-App Developers - Track all your apps in one place - Compare performance across your portfolio - Identify your best and worst performers - Allocate resources based on data Tracking Competitors You can add competitor apps to My Apps: - Public data (rankings, reviews) is fully available - You won't have access to their private data - Use for benchmarking and competitive analysis Frequently Asked Questions Q: How many apps can I add? A: This depends on your plan. Check your plan limits in Settings > Billing. Q: Can I add apps I don't own? A: Yes! You can add any public Shopify app. You'll see public data like rankings and reviews. Private data (revenue, customers) requires integration credentials. Q: What data can I see without integrations? A: Rankings, reviews, ratings, listing details, and competitive positioning. For revenue and traffic data, you need to connect integrations. Q: Will the app developer know I'm tracking their app? A: No. Adding an app to My Apps is completely private. Q: Can I export my app data? A: Yes, most analytics pages have export options for CSV download. Q: What happens to my data if I remove an app? A: Data is preserved for 90 days. If you re-add the app, historical data is restored. Next step: Configure your app's integration settings to unlock full analytics.

App Settings

App Settings App settings page App Settings is where you configure integrations and manage your app's data connections. Each app in your portfolio has its own settings page. Accessing App Settings 1. Go to My Apps and select your app 2. Click Settings in the sidebar navigation 3. The Integration Settings page opens Integration Settings Overview The settings page shows your integration status at a glance: | Integration | What It Provides | | ------------------- | ------------------------------------------- | | Shopify Partner API | Revenue, MRR, customers, subscriptions | | Google BigQuery | Traffic, sessions, conversions, attribution | Integration Status Indicators Each integration shows its current status: - Connected (Green): Working correctly, syncing data - Error (Red): Connection issue, needs attention - Inactive (Gray): Not yet configured - Connecting (Yellow): Setup in progress - Pending (Yellow): Waiting for initial sync Shopify Partner API Integration What You Get When connected, you'll see: - Daily, weekly, monthly revenue - MRR (Monthly Recurring Revenue) - Customer counts and details - Subscription changes (upgrades, downgrades, churn) - Transaction history - Customer lifecycle data Connection Requirements You'll need from your Shopify Partner Dashboard: - Organization ID: Your partner account identifier - API Access Key: Generated API credentials - App ID: Your specific app's identifier How to Connect 1. Click Configure in the Shopify Partner API section 2. Enter your Organization ID 3. Enter your API Access Key 4. Enter your App ID 5. Click Test Connection 6. If successful, click Save 7. Click Run Historical Sync to import past data Connection Status After connecting, you'll see: - Status: Connected, Error, or other state - Last Sync: When data was last updated - Error Message: If there's a problem, details are shown Manual Sync To refresh data immediately: 1. Click the Sync Now button 2. Wait for sync to complete (usually 1-5 minutes) 3. Dashboard data updates Troubleshooting "Invalid credentials" error: - Double-check your Organization ID - Verify API key is copied correctly - Ensure no extra spaces in any field "App not found" error: - Confirm App ID is correct - Verify app is in your Partner account Data not updating: - Check last sync timestamp - Try manual sync - Verify credentials are still valid Google BigQuery Integration What You Get When connected, you'll see: - Pageviews and sessions - Traffic sources (Google, Direct, Referral, etc.) - Geographic data (countries, regions) - Device breakdown (desktop, mobile, tablet) - Conversion funnel (views → clicks → installs) - Attribution data Connection Requirements Before connecting, ensure you have: - Google Analytics 4 (GA4) tracking your app - GA4 exporting data to BigQuery - Access to the Google Cloud project with BigQuery data How to Connect 1. Click Configure in the BigQuery section 2. Click Connect Google Account 3. Sign in with your Google account 4. Grant read-only permissions 5. Select your Google Cloud Project 6. Select your GA4 dataset (usually analytics_XXXXXXXXX) 7. Click Test Import 8. If successful, click Save 9. Click Start Historical Import Connection Status After connecting, you'll see: - Status: Connected, Error, or other state - Last Query: When data was last imported - Project ID: Your Google Cloud project - Dataset ID: Your GA4 dataset Troubleshooting "No datasets found" error: - Verify GA4 is exporting to BigQuery - Check you selected the correct project - Wait 24-48 hours after enabling GA4 export "Permission denied" error: - Ensure you have BigQuery Data Viewer role - Try disconnecting and reconnecting - Check Google Cloud IAM permissions No data appearing: - Verify GA4 tracking is working - Check date range in analytics - Wait for daily export to complete Data Sync Behavior Automatic Syncing Ranksy automatically syncs your data: | Integration | Frequency | | ----------- | ----------------- | | Partner API | Daily (overnight) | | BigQuery | Daily (morning) | Manual Syncing You can trigger a manual sync anytime: 1. Go to Settings 2. Click Sync Now for the integration 3. Wait for completion Manual syncs are useful when: - You need the latest data immediately - You suspect sync issues - After making changes in Shopify Remove App What Happens When You Remove At the bottom of Settings, you can remove the app from My Apps: 1. Click Remove from My Apps 2. Confirm the removal When removed: - App disappears from your My Apps list - Integrations are disconnected - Historical data is preserved for 90 days - You can re-add the app later Re-adding an App If you remove and re-add an app within 90 days: - Historical data is restored - You'll need to reconnect integrations - Rankings history is preserved Best Practices Integration Setup 1. Connect both integrations for complete data 2. Run historical imports after connecting 3. Verify data appears in dashboards 4. Set up a routine to check sync status Maintaining Connections - Check settings weekly for any errors - Re-authorize if you change Google passwords - Update API keys if you rotate credentials - Monitor last sync timestamps Data Quality - Wait 24-48 hours after connecting for full data - Compare Ranksy data with source dashboards - Use manual sync if data seems stale - Contact support for persistent issues FAQ Q: How often does data sync automatically? A: Partner API syncs daily overnight. BigQuery imports daily each morning. Q: Can I connect multiple apps to the same Partner account? A: Yes, each app uses its own App ID but can share Organization ID and API key. Q: Will syncing affect my Shopify or Google billing? A: Partner API is free. BigQuery has a generous free tier (1 TB/month queries). Q: What if my integration shows an error? A: Check the error message, verify credentials, and try reconnecting. Contact support if issues persist. Q: Can I pause syncing temporarily? A: Currently, you can disconnect and reconnect. Pausing is not yet supported. Q: How do I update my API credentials? A: Go to Settings, update the fields, and click Save. Then test the connection. Need help with integrations? See Connect Partner API and Connect BigQuery for detailed setup guides.