Chapter 23: Phase 3 - App Store Launch

Goal

Submit AdPriority to the Shopify App Store, pass the review process, and launch publicly. Phase 3 focuses on meeting all Shopify requirements, preparing marketing materials, and establishing the billing infrastructure.

Shopify App Store Submission Requirements

Legal Documents

Two legal documents must be hosted at publicly accessible URLs before submission.

App Listing

The listing is the storefront that merchants see when discovering AdPriority.

Required assets:

Listing description (draft):

AdPriority: Smart Product Scoring for Google Ads

Stop wasting ad spend on the wrong products. AdPriority automatically
scores your products from 0-5 based on category, season, inventory,
and brand, then syncs those scores as custom labels to Google Merchant
Center. Use these labels to build focused Performance Max campaigns
that put your budget where it matters.

KEY FEATURES:

- Automatic 0-5 priority scoring based on configurable rules
- Seasonal calendar that adjusts priorities when seasons change
- New arrival boost gives fresh products maximum visibility
- One-click sync to Google Merchant Center via supplemental feed
- Visual dashboard showing priority distribution and sync health

HOW IT WORKS:

1. Install and import your products (automatic)
2. Configure category rules and seasonal priorities
3. AdPriority calculates a priority score for every product
4. Scores sync to Google Merchant Center as custom labels
5. Segment your PMAX campaigns by priority for smarter budgets

Works with any Shopify store running Google Ads. No Google API
setup required for the AdPriority tier.

Start your 14-day free trial today.

Screenshots

Each screenshot should demonstrate a specific value proposition:

Demo Video

A 60-90 second video covering:

1. Opening: “Stop wasting ad spend” hook (5 seconds)
2. Problem statement: Manual custom label management (10 seconds)
3. Install flow: Click install, products import automatically (15 seconds)
4. Dashboard: Show priority distribution (10 seconds)
5. Products: Browse products with priority badges (10 seconds)
6. Rules: Create a category rule (15 seconds)
7. Sync: Watch labels push to Google Sheet (10 seconds)
8. Closing: “Start your free trial” CTA (5 seconds)

Review Process

Timeline

Shopify App Store review typically takes 5-10 business days from submission to decision. If the app is rejected, the team provides specific feedback, and resubmission restarts the review clock.

Review Checklist

Shopify reviews the app against these criteria:

Common Rejection Reasons

Resubmission Strategy

If rejected:

1. Read the rejection feedback carefully (Shopify is specific)
2. Fix every cited issue (do not submit with partial fixes)
3. Test the fixes thoroughly
4. Add a note in the resubmission explaining what was changed
5. Resubmit (review clock resets to 5-10 business days)

Marketing

App Store SEO

Shopify’s App Store search uses the app name, tagline, and description for ranking. Target keywords:

SEO strategy: Include primary keywords in the tagline (“Google Ads product priorities”) and secondary keywords in the description. The unique terms “product priority” and “priority scoring” have very low competition because no existing app targets this concept.

Launch Campaign

Demo Video Distribution

The demo video serves double duty as a marketing asset and an App Store listing video:

• Upload to YouTube (public, SEO-optimized title and description)
• Embed on the App Store listing
• Embed on the marketing website landing page
• Share in forum posts and social media

Pricing Setup: Shopify Billing API

Subscription Plans

AdPriority uses Shopify’s Billing API for recurring charges. Merchants are charged through their Shopify bill, which eliminates payment friction.

Plan configuration:

Billing Flow

BILLING FLOW
============

  1. Merchant installs app (free during trial)
         |
         v
  2. 14-day trial starts automatically
         |
         v
  3. Trial expiration approaching (day 12):
     Show Banner: "Your trial ends in 2 days. Choose a plan."
         |
         v
  4. Merchant clicks "Choose Plan" on Billing page
         |
         v
  5. App creates subscription via GraphQL:
     appSubscriptionCreate(
       name: "AdPriority Pro"
       price: $149.00
       interval: EVERY_30_DAYS
       trialDays: 0  (already in trial)
       returnUrl: /api/v1/billing/callback
     )
         |
         v
  6. Shopify returns confirmationUrl
         |
         v
  7. Redirect merchant to Shopify payment confirmation
         |
         v
  8. Merchant approves charge
         |
         v
  9. Shopify redirects to returnUrl
         |
         v
  10. App verifies subscription status via GraphQL
          |
          v
  11. Update tenants.plan_tier in database
          |
          v
  12. Enable tier features

Plan Enforcement

When a merchant on the AdPriority tier tries to access a Pro feature, the UI shows a Polaris Banner with an upgrade call-to-action rather than hiding the feature entirely. This educates merchants about available features and drives upgrades.

Billing Webhooks

Addressable Market

The addressable market for AdPriority is estimated at 25,000-35,000 Shopify stores that actively run Google Ads Performance Max campaigns. This estimate is based on:

At a 1% penetration rate, that represents 250-350 paying customers. At an average of $99/mo (blended across both tiers), that is $25K-$35K MRR.

PMAX Onboarding Wizard (Pro Tier)

AdPriority Pro includes a guided PMAX onboarding wizard that helps merchants restructure their Google Ads campaigns to use priority-based segmentation. This is critical because without campaign restructuring, the custom labels have no effect on ad spend.

The wizard is documented in detail in Chapter 18 (Screen 8: PMAX Onboarding Wizard).

Staging Environment

Before App Store submission, a staging environment must be deployed and validated:

All App Store review testing should be performed against the staging environment first.

DR Drill

Before launch, conduct a disaster recovery drill to validate:

1. Database restore: Restore adpriority_db from a pg_dump backup
2. Container rebuild: Rebuild and redeploy all containers from scratch
3. Feed recovery: Verify Google Sheet supplemental feed resumes after outage
4. Webhook replay: Confirm Shopify webhooks are reprocessed after downtime

Document the results and time-to-recovery for each scenario.

Cloud Migration Triggers

AdPriority launches on the Synology NAS (SLA target: 99.0%). If any of these triggers are hit, begin cloud migration planning:

Post-Launch Priorities

After App Store approval, the focus shifts to:

1. Monitor installs: Track daily install rate, conversion from trial to paid
2. Respond to reviews: Reply to every App Store review within 24 hours
3. Support queue: Handle incoming support emails within 24-48 hours
4. Bug fixes: Rapid response to any issues reported by early users
5. Gather testimonials: Ask satisfied merchants for case studies
6. Iterate on onboarding: Reduce time-to-value based on user behavior data

Target Metrics (First 90 Days)