Interactive Platform Demo

Experience Bamzal

Explore a fully interactive simulation of our Shopify app. See how AI-powered competitor analysis, ad copy generation, and multi-channel campaign creation across Google, Meta (Facebook & Instagram), TikTok, Pinterest and X work in real time.

ⓘ Important: This is an interactive demo — not the production application.

Bamzal is a Shopify embedded app that runs inside the Shopify Admin dashboard. Merchants install it from the Shopify App Store, and the entire application loads within their Shopify admin panel — it does not run on this marketing website.

The demo below is a static simulation of the actual application screens, built to showcase the user interface, features, and our multi-channel ad API integration flow (Google, Meta, TikTok, Pinterest). All data shown is sample data for demonstration purposes.

The production app is built with React Router 7, uses Prisma ORM for data management, and integrates with the Google Ads API v17, Meta Marketing API (Facebook & Instagram), TikTok Marketing API, Pinterest Ads API and Anthropic Claude AI for intelligent ad generation across every channel.

Bamzal
Dashboard
Store Connected Google · Meta · TikTok · Pinterest · X Linked

Store Health Score

0 of 100
Grade A
Ad Quality78%
Product Coverage100%
Competitor Intel80%
Budget Efficiency72%
Products
0
All Scanned
Avg Score
0
+5 vs last week
Keywords
0
+120 new
Campaigns
0
2 active

Live Campaign Pulse

Impressions
12,400
Clicks
520
CTR
4.2%
Spend
$310

Your Products

Competitor Gap Finder

Keyword GapCompetitorsEst. Lost Clicks/moMonthly Loss
luxury bed sheets king4320$480
organic cotton duvet cover3210$315
best weighted blanket adults5540$810
silk pillowcase benefits2180$270
bamboo sheets queen set3290$435
Product Analysis
AI-Powered

Analyze Your Product Catalog

Our AI will scan all 24 products, analyze competitors, generate keywords, and score each product for ad readiness.

Keyword Research
AI-Powered
KeywordVolumeCompetitionCPCTrend
Campaign Wizard
8 Steps
Campaigns
3 Campaigns
CampaignStatusBudgetClicksCTRConv.
Bedding Essentials - Search
Search Campaign
ACTIVE
$25/day
520
4.2%
18
Premium Sheets - PMax
Performance Max
ACTIVE
$40/day
890
3.8%
24
Winter Blankets Sale
Shopping Campaign
PAUSED
$15/day
210
2.9%
6
Settings

Ad Network Connections

Connected to Google, Meta, TikTok & Pinterest
Google Ads Customer ID123-456-7890
Meta Ad Accountact_987654321 (Facebook + Instagram)
TikTok Advertiser ID7281234567890
Pinterest Ad Account549876543210
Connected OnJanuary 15, 2026
OAuth Scopesgoogle-ads · ads_management, business_management, pages_read_engagement, instagram_basic · advertiser.read/write · ads:read/write

Bamzal connects to your Google Ads, Meta (Facebook & Instagram), TikTok Ads, Pinterest Ads and X Ads accounts via each platform's official OAuth 2.0 flow. We request only the minimum permissions needed to create and manage campaigns on your behalf. You can revoke access per network at any time.

Shopify Store

Connected to Shopify
Storedreamhome-bedding.myshopify.com
Products24 synced
PlanStarter ($29/mo)

API Usage This Month

Campaign Mutations12
Ad Group Mutations18
Keyword Mutations156
Reporting Queries1,240
OAuth Refreshes48

How Bamzal Uses the Google, Meta, TikTok & Pinterest Ad APIs

A detailed technical overview of our multi-channel ad API integrations for Shopify merchants

🛠 About Our Application Architecture

Bamzal is a Shopify embedded application — it runs as an iframe inside the Shopify Admin dashboard, not as a standalone website. Merchants install the app from the Shopify App Store, and the app loads within their existing Shopify admin panel at https://admin.shopify.com/store/{shop}/apps/v-40.

This website (bamzal.com) is our marketing and information site only. The demo above is a static HTML/CSS/JavaScript simulation of the actual app interface, created to showcase the platform features and our multi-channel ad API usage (Google, Meta, TikTok, Pinterest). The production application is a full-stack Node.js app built with:

  • Frontend: React 18 + React Router 7 + Shopify Polaris design system + Shopify App Bridge
  • Backend: Node.js server with React Router server-side rendering
  • Database: Prisma ORM (SQLite in development, PostgreSQL/MySQL in production)
  • AI Engine: Anthropic Claude API for product analysis, ad copy generation, and competitor intelligence
  • Ads Integrations: Google Ads API v17 (REST & gRPC), Meta Marketing API (Facebook & Instagram, incl. Pages + Instagram Business), TikTok Marketing API, and Pinterest Ads API — for campaign creation, management, and performance tracking across every channel
  • Authentication: Shopify OAuth for app installation + official OAuth 2.0 flows for Google Ads, Meta, TikTok and Pinterest ad-account linking

Data Flow Architecture

Shopify Store
Product & order data
Bamzal
AI analysis & optimization
Ad Platform APIs
Google · Meta · TikTok · Pinterest · X
Merchant's Account
Campaigns & ads live here

Ad Platform API Operations (Google, Meta, TikTok, Pinterest)

OperationAPIs UsedWhen Used
Campaign CreationGoogle Ads CampaignService + Meta Marketing API /act_{id}/campaigns + TikTok /campaign/create/ + Pinterest /ad_accounts/{id}/campaignsWhen a merchant creates a new campaign through our wizard. Campaign is always created in PAUSED state across every selected network for merchant review.
Budget ManagementGoogle CampaignBudgetService + Meta adsets daily_budget + TikTok adgroup budget + Pinterest ad_groups budgetWhen the merchant sets or modifies the daily budget in the campaign wizard. Budgets are applied per network, mirrored from a single unified input.
Audience & Keyword TargetingGoogle AdGroupCriterionService (KeywordInfo) + Meta adsets targeting spec + TikTok targeting spec + Pinterest ad_groups targetingApplies AI-generated keywords (Google) and interest/behavior/lookalike audiences (Meta, TikTok, Pinterest), including exclusions and negatives.
Ad Creative UploadGoogle AdGroupAdService (ResponsiveSearchAd) + Meta /act_{id}/adcreatives + TikTok /creative/upload + Pinterest /pins, /adsUploads AI-generated headlines, descriptions, images and short-form video adapted per network's native best practices.
Meta Pages & InstagramMeta Pages API + Instagram Business API (instagram_basic, pages_read_engagement, pages_show_list)Reads the merchant's Facebook Pages and Instagram Business account to attach as ad identities for Facebook & Instagram placements.
Meta Lead RetrievalMeta Marketing API /leadgen_forms, /leads (leads_retrieval)Retrieves leads generated by Facebook/Instagram lead-gen forms so merchants can view and export them inside Bamzal.
Performance DataGoogleAdsService.Search (GAQL) + Meta Insights API + TikTok Reporting API + Pinterest Analytics APIDashboard metrics: impressions, clicks, CTR, conversions, cost, ROAS — unified across Google, Meta, TikTok, Pinterest and X with per-network and blended views.
Campaign ControlPer-network status mutation (PAUSED ↔ ACTIVE)When merchant pauses or enables a campaign on any connected network.
Conversion TrackingGoogle ConversionActionService + Meta Conversions API + TikTok Events API + Pinterest Conversions APISets up purchase conversion tracking linked to Shopify checkout events for unified ROAS measurement.
Catalog & ShoppingGoogle Merchant Center feed + Meta Commerce/Catalog API + TikTok Catalog + Pinterest CatalogsSyncs the merchant's Shopify product catalog into each network so Shopping / Advantage+ / Catalog campaigns can run.
Bidding StrategyGoogle BiddingStrategyService + Meta bid_strategy + TikTok bid_type + Pinterest bid_strategyApplies the merchant's chosen bidding strategy (Max Conversions, Target CPA, Target ROAS, lowest_cost_with_bid_cap, etc.) per network.

Security & Compliance

🔒

OAuth 2.0 Authentication

Industry-standard OAuth 2.0 flow with PKCE. Merchants authenticate directly with Google. We store only encrypted refresh tokens.

Campaigns Created PAUSED

All campaigns are created in PAUSED state. Merchants must explicitly review and enable campaigns before any ad spend occurs.

🔐

Encrypted Transmission

All API communication uses TLS 1.2+ encryption. Refresh tokens are AES-256 encrypted at rest. No credentials stored in plaintext.

👤

Merchant Retains Control

Merchants retain full ownership and control of their Google, Meta, TikTok, Pinterest and X ad accounts. They can revoke access or disconnect any network at any time.

Campaign Lifecycle

1

Install on Shopify

Merchant installs Bamzal from the Shopify App Store

2

Connect Ad Networks

OAuth 2.0 flows authenticate Google, Meta, TikTok, Pinterest and X ad accounts

3

AI Scans Products

AI analyzes products, competitors, and keyword landscape

4

Generate Ad Copy

AI creates optimized headlines, descriptions, and keywords

5

Review in Wizard

Merchant reviews and customizes all campaign settings

6

Create PAUSED

Campaigns created via Google, Meta, TikTok, Pinterest and X APIs in PAUSED state

7

Review in Native UI

Merchant reviews campaign in Google Ads, Meta Ads Manager, TikTok Ads or Pinterest Ads Manager

8

Enable When Ready

Merchant enables campaign when satisfied with setup

Technical Implementation Details

Authentication Flow:
1. Merchant clicks "Connect Ad Networks" (Google / Meta / TikTok / Pinterest)
2. Redirect to each platform's official OAuth consent screen
3. Merchant grants scoped permissions per network (e.g. google-ads; ads_management + business_management + pages_read_engagement + instagram_basic on Meta; advertiser.read/write on TikTok; ads:read/write on Pinterest)
4. Authorization code exchanged for tokens per network
5. Refresh tokens encrypted and stored separately
6. Access tokens auto-refreshed before expiry
Campaign Creation Flow:
1. Create CampaignBudget resource
2. Create Campaign (status: PAUSED)
3. Create AdGroup(s) under campaign
4. Upload ResponsiveSearchAd(s)
5. Add KeywordInfo criteria
6. Link ConversionAction for tracking

Demo & Platform FAQ

Common questions about Bamzal and our Google, Meta, TikTok & Pinterest ad integrations

How does Bamzal connect to my ad accounts?+
We use the industry-standard OAuth 2.0 protocol for each network. When you click "Connect" on Google, Meta, TikTok or Pinterest, you are redirected to that platform's official consent screen where you grant permission. We never see or store your passwords. For each network we only request the minimum scopes needed (e.g. google-ads; ads_management + business_management + pages_read_engagement + instagram_basic on Meta; advertiser.read/write on TikTok; ads:read/write on Pinterest) and store encrypted refresh tokens.
Will Bamzal spend my money without my permission?+
No. All campaigns created by Bamzal are initially set to PAUSED status on every network. You must explicitly review and enable each campaign before any ad spend occurs. You retain full control over your budget and campaigns at all times.
Which ad platform APIs does Bamzal use?+
On Google Ads: CampaignService, CampaignBudgetService, AdGroupCriterionService, AdGroupAdService, GoogleAdsService.Search and ConversionActionService. On Meta (Facebook & Instagram): the Meta Marketing API (adaccount/campaigns/adsets/ads/creatives), Pages API and Instagram Business API for catalog and creative assets, plus the Leads API for retrieving lead-gen form submissions. On TikTok: the TikTok Marketing API (campaign/adgroup/ad/creative/reporting). On Pinterest: the Pinterest Ads API (ad_accounts, campaigns, ad_groups, pins, analytics).
Can I revoke Bamzal's access to my ad accounts?+
Yes, at any time and per network. You can disconnect any individual network (Google, Meta, TikTok, Pinterest) from within our app's Settings page, or revoke access directly from each platform's account security settings. Revoking access will not delete any campaigns already created in those accounts.
How does the AI generate ad copy and creatives?+
Our AI analyzes your product titles, descriptions, and images, then studies competitor ads on each network to understand what performs well in your niche. For Google it generates optimized headlines (up to 30 characters) and descriptions (up to 90 characters) with exact/phrase/broad match keywords. For Meta, TikTok and Pinterest it generates primary text, headlines, descriptions and creative concepts (image + short-form video) that match each platform's native best practices and audience-targeting style.
Is my data secure?+
Absolutely. All data transmission uses TLS 1.2+ encryption. OAuth refresh tokens are AES-256 encrypted at rest. We follow Google's API Services User Data Policy and only access the data necessary to provide our service. We never share your data with third parties.

Like what you see? Start running AI-powered ads today.

Join Shopify merchants who use AI to create smarter, data-driven campaigns across Google, Meta, TikTok & Pinterest.

Request Early Access → See Pricing Learn More