Rankbase Documentation

What is Rankbase

Rankbase is a Shopify App Store optimization and keyword ranking analytics platform built specifically for Shopify app developers. It connects to your Google Analytics 4 property and analyzes how users discover your app through App Store search. Rankbase shows which keywords drive the most traffic and install clicks, how your search position changes over time, and what you can do to rank higher.

Rankbase is for Shopify app developers who already have an app listed on the Shopify App Store and have Google Analytics 4 connected to their listing. It is not a general SEO tool and does not work with websites or other app stores. The entire platform is focused on one thing: helping you get more installs from the Shopify App Store.

Have questions? Check the frequently asked questions about Shopify App Store optimization for quick answers.

Getting Started

Follow these steps to set up your account and start tracking keyword rankings.

1. Create an account at rankbase.io and start your free trial (no credit card required).
2. Add your first Shopify app by pasting the App Store URL.
3. Rankbase will automatically scrape your app listing details.
4. Connect your Google Analytics 4 account using OAuth. See the GA4 Setup section for details.
5. Select the correct GA4 property that matches your Shopify app listing.
6. Once connected, Rankbase begins analyzing your keyword data and generating reports.

Keyword Position Tracking

Rankbase tracks your app's position in the Shopify App Store search results for every keyword that brings users to your listing. Daily position reports show how your ranking changes over time.

You can view position history for up to 365 days. Each position record includes the keyword, your app's position in search results, the date, the locale (language/country), and whether the traffic came from organic search or paid ads. The dashboard lets you filter by date range using preset options (7, 14, 30, 60, 90 days) or custom date ranges.

Install Click Analytics

An "install click" means a user clicked the install button on your app listing page. This is different from an impression (someone saw your app in search results) or a page view (someone visited your listing). Install clicks represent real purchase intent and are the most important metric for measuring keyword effectiveness.

Rankbase focuses on install clicks rather than impressions or views because install clicks filter out bot traffic and represent genuine user interest. You can filter install click data by organic search, paid ads, or both.

Potential Score Algorithm

The Potential Score is a proprietary algorithm that identifies keywords with the highest growth opportunity. It considers your current position for a keyword and the number of install clicks you receive from it. If you are getting install clicks while ranked in lower positions, the Potential Score will be high because moving to a higher position would likely increase your installs significantly.

Keywords with a Potential Score below 10 may not represent meaningful opportunities. The keyword list is sorted by Potential Score by default so you can focus on keywords with the highest upside first. Use the Potential Score to prioritize which keywords to optimize for in your listing.

App Listing Scraper

When you add a Shopify app to Rankbase, the platform automatically scrapes your app listing from the Shopify App Store. This includes your app name, description, screenshots, pricing, and other publicly available listing details.

The scraper supports multiple languages. Rankbase fetches listing information across different locales so you can see how your listing appears in different markets. You can manually trigger a re-scrape from your app settings to update the stored listing data after making changes to your Shopify app listing.

App Listing Changelog

Rankbase tracks changes to your app listing over time. Whenever your listing details change (title, description, pricing, screenshots, etc.), the changelog records what changed and when. This helps you correlate listing changes with position changes.

Use the changelog to understand which listing updates had a positive or negative impact on your keyword rankings. You can access the changelog from your app's navigation menu.

Community Forum Notifications

Rankbase monitors the Shopify Community forums for posts that mention keywords related to your apps. When someone posts a question or discussion that matches your tracked keywords, you receive a notification.

This helps you discover potential users who are actively looking for solutions your app provides. You can respond to forum posts to help users and increase awareness of your app. Notification frequency is configurable in your notification settings.

Traffic Sources

The Traffic Sources report breaks down where your app listing traffic comes from. You can see the distribution across different source types and understand which channels drive the most users to your listing.

Use this report to identify your strongest traffic channels and discover opportunities to grow underperforming sources. The report supports date range filtering so you can analyze traffic patterns over different time periods.

Install Sources

Install Sources provide shop-level data about where your installs come from. You can see individual shop IDs, referrer information, and installation dates. This data helps you understand your install funnel at a granular level.

Filter by date range to analyze install patterns over time. This feature requires a Shopify Partner ID to be configured in your app settings.

Google Analytics 4 Setup

Rankbase requires Google Analytics 4 to be properly configured on your Shopify app listing. The GA4 property must be the same one that Shopify uses to track your app listing traffic.

Connecting GA4

1. Go to your app settings in Rankbase.
2. Click "Connect Google Analytics".
3. Sign in with your Google account and grant read-only access.
4. Select the correct GA4 property from the dropdown.

For a visual step-by-step guide on setting up Google Analytics for your Shopify app, read this blog post: How to Set Up Google Analytics for a Shopify App.

Slack Integration

Connect your Slack workspace to receive keyword reports and alerts directly in a Slack channel. Go to Notification Settings and click "Connect to Slack" to authorize the integration.

After connecting, select a channel where notifications should be posted. You can send a test notification to verify the setup is working correctly. Slack notifications include daily keyword reports and community forum alerts.

Email Notifications

Rankbase sends email notifications for keyword position reports and community forum mentions. You can configure notification frequency and types in the Notification Settings page.

Available notification types include daily keyword reports and community forum notifications. You can unsubscribe from individual notification types or all notifications using the unsubscribe link in each email.

Team Collaboration

Invite team members to your Rankbase account so they can access the same app data and reports. Go to the Team page and enter the email address of the person you want to invite.

Team members share access to all apps and data within the team. The team owner manages billing and can invite or remove members. All API keys are also scoped to the team level.

CSV Export

Export your keyword ranking data as a CSV file for further analysis in spreadsheets or other tools. The export includes keyword names, positions, dates, locales, and install click data.

Access the export feature from your app's navigation menu. The exported data respects your current date range and filter settings.

Multi-Language Support

Rankbase tracks keyword positions across different locales and languages. The Shopify App Store serves different search results based on the user's language and country. Rankbase captures this locale information for each position record.

The "latest position" displayed on your dashboard uses the most dominant locale for each keyword. If most of your traffic for a keyword comes from the English (US) locale, your latest position will reflect the English search results. You can still view position data for all locales in the detailed keyword view.

REST API

Rankbase provides a REST API for programmatic access to your keyword ranking data. You can use the API to build custom dashboards, automate reporting, feed data into spreadsheets, or integrate keyword insights into your own tools.

Create API keys from the API section in your dashboard. Each team can have up to 5 API keys. For complete API documentation including endpoints, parameters, and example responses, visit the API Documentation page.

Pricing and Plans

Rankbase offers two plans:

Both plans include a free trial period with no credit card required. All features (keyword tracking, community forum notifications, Slack integration, API access, CSV export, team collaboration) are available on both plans. The only difference is the number of apps you can track and the support level.

Have questions about which plan is right for you? Check the FAQ page for more details.