Chapter 12: Google Ads Integration

Google Ads is the ultimate consumer of AdPriority’s custom labels. While AdPriority does not directly create or modify Google Ads campaigns in the MVP, understanding how custom labels drive Performance Max (PMAX) campaign structure is essential. This chapter covers the recommended campaign architecture, how PMAX uses custom labels for product segmentation, and the future Google Ads API integration planned for the AdPriority Pro ($149/mo) tier.

10.1 How PMAX Uses Custom Labels

Performance Max campaigns use listing groups (formerly product groups) to segment a merchant’s product catalog. Custom labels are one of the most powerful segmentation dimensions because they are the only attributes fully controlled by the merchant.

Product Group Hierarchy

Performance Max Campaign
|
+-- Asset Group: "All Products"
    |
    +-- Listing Group (root)
        |
        +-- Filter: custom_label_0 = "priority-5"
        |   (Products scored as maximum push)
        |
        +-- Filter: custom_label_0 = "priority-4"
        |   (Strong performers)
        |
        +-- Filter: custom_label_0 = "priority-3"
        |   (Standard products)
        |
        +-- Filter: custom_label_0 IN ("priority-2", "priority-1")
        |   (Low priority, minimal spend)
        |
        +-- Filter: custom_label_0 = "priority-0"
            (Excluded from advertising)

Why Custom Labels Matter for PMAX

Google’s PMAX algorithm optimizes bid strategy across all products in an asset group. Without segmentation, high-margin seasonal items compete for budget with dead stock and low-performers. Custom labels solve this by letting the merchant tell Google which products deserve more budget.

Without AdPriority Labels          With AdPriority Labels
===========================        ==========================

  Single PMAX Campaign               4 Focused Campaigns
  +---------------------+            +--------------------+
  |  ALL 20,000 items   |            | Priority 5 (800)   | --> Aggressive
  |  compete equally    |            +--------------------+
  |  for budget         |            | Priority 4-3 (8K)  | --> Standard
  |                     |            +--------------------+
  |  Google guesses     |            | Priority 2-1 (6K)  | --> Minimal
  |  which to show      |            +--------------------+
  +---------------------+            | Priority 0 (5.2K)  | --> Excluded
                                     +--------------------+

  Result: Budget wasted             Result: Budget focused
  on dead stock and                 on seasonal winners
  off-season items                  and high-margin products

10.2 Recommended Campaign Structure

AdPriority recommends a multi-campaign structure where each campaign targets a priority tier with its own budget and bidding strategy. This provides maximum control over spend allocation.

Campaign Architecture

+-----------------------------------------------------------------------+
|                     Google Ads Account: REDACTED                    |
|                         (Nexus Clothing)                               |
+-----------------------------------------------------------------------+
|                                                                        |
|  Campaign 1: "PMAX - Priority 5 - Maximum Push"                       |
|  +------------------------------------------------------------------+ |
|  | Budget:    $80/day (40% of total)                                 | |
|  | tROAS:     200% (aggressive, prioritize volume)                   | |
|  | Filter:    custom_label_0 = "priority-5"                          | |
|  | Products:  Seasonal peaks, new arrivals, high-margin items        | |
|  | Nexus est: ~800 variants (winter puffers, hoodies, new arrivals) | |
|  +------------------------------------------------------------------+ |
|                                                                        |
|  Campaign 2: "PMAX - Priority 4-3 - Active Products"                  |
|  +------------------------------------------------------------------+ |
|  | Budget:    $80/day (40% of total)                                 | |
|  | tROAS:     350% (standard, balanced)                              | |
|  | Filter:    custom_label_0 IN ("priority-4", "priority-3")         | |
|  | Products:  Steady sellers, year-round staples, name brands        | |
|  | Nexus est: ~8,000 variants (jeans, caps, standard t-shirts)      | |
|  +------------------------------------------------------------------+ |
|                                                                        |
|  Campaign 3: "PMAX - Priority 2-1 - Low Priority"                     |
|  +------------------------------------------------------------------+ |
|  | Budget:    $30/day (15% of total)                                 | |
|  | tROAS:     500% (high threshold, only show if very profitable)    | |
|  | Filter:    custom_label_0 IN ("priority-2", "priority-1")         | |
|  | Products:  Low-margin, off-season, accessories                    | |
|  | Nexus est: ~6,000 variants (underwear, socks, off-season items)  | |
|  +------------------------------------------------------------------+ |
|                                                                        |
|  Campaign 4: "PMAX - Priority 0 - Excluded"                           |
|  +------------------------------------------------------------------+ |
|  | Budget:    $0/day (PAUSED)                                        | |
|  | Status:    Paused                                                  | |
|  | Filter:    custom_label_0 = "priority-0"                          | |
|  | Products:  Dead stock, archived, out of stock                     | |
|  | Nexus est: ~5,200 variants (DEAD50 tagged, archived products)    | |
|  +------------------------------------------------------------------+ |
|                                                                        |
|  Total daily budget: ~$190/day ($5,700/month)                          |
+-----------------------------------------------------------------------+

Budget Allocation by Priority

Why Multiple Campaigns (Not Asset Groups)

Multiple campaigns give the merchant explicit budget and tROAS control per priority tier. With asset groups in a single campaign, Google’s algorithm decides how to split the budget, which often means high-volume low-margin products consume disproportionate spend.

10.3 Secondary Label Segmentation

Beyond the primary custom_label_0 (priority) segmentation, merchants can create additional product groups using the other labels for analysis and fine-tuning.

Seasonal Analysis

Using custom_label_1 (product peak season) within each campaign:

Campaign: "PMAX - Priority 5 - Maximum Push"
|
+-- Asset Group: "Priority 5 - Winter Items"
|   Filter: custom_label_0 = "priority-5" AND custom_label_1 = "winter"
|
+-- Asset Group: "Priority 5 - Year-Round Items"
    Filter: custom_label_0 = "priority-5" AND custom_label_1 != "winter"

Category-Level Reporting

Using custom_label_2 (category) for performance reports:

This data, when fed back into AdPriority (AdPriority Pro tier), enables data-driven priority adjustments.

Brand Tier Analysis

Using custom_label_4 (brand tier):

10.4 Nexus Google Ads Account

Current State vs. Target State

Current State (Feb 2026)           Target State (With AdPriority)
============================       ================================

1 PMAX Campaign                    4 PMAX Campaigns (by priority)
  - All products in one group        - Priority 5: Aggressive
  - Single budget                    - Priority 4-3: Standard
  - Single tROAS                     - Priority 2-1: Conservative
  - No custom label filtering        - Priority 0: Paused

No segmentation by:                Full segmentation by:
  - Season                           - Priority (label_0)
  - Category                         - Product peak season (label_1)
  - Inventory status                 - Category (label_2)
  - Brand tier                       - Inventory status (label_3)
                                     - Brand tier (label_4)

Manual priority decisions          Automated priority scoring
  - Guesswork                        - Rules engine
  - Infrequent updates               - Seasonal calendar
  - No data backing                  - Tag-based modifiers

10.5 Google Ads API (Future AdPriority Pro)

The Google Ads API integration is planned for the AdPriority Pro tier ($149/month). It enables AdPriority to read campaign performance data and provide automated recommendations.

Planned Capabilities

Authentication Requirements

GAQL Queries (Google Ads Query Language)

Performance by product (Shopping Performance View):

SELECT
  segments.product_item_id,
  segments.product_custom_attribute0,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.conversions_value
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.conversions_value DESC
LIMIT 1000

Performance by priority tier (aggregated):

SELECT
  segments.product_custom_attribute0,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.conversions_value
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND segments.product_custom_attribute0 IS NOT NULL

Campaign-level performance:

SELECT
  campaign.name,
  campaign.status,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.average_cpc
FROM campaign
WHERE campaign.advertising_channel_type = 'PERFORMANCE_MAX'
  AND segments.date DURING LAST_30_DAYS

Performance Tracking Dashboard (AdPriority Pro)

The AdPriority Pro dashboard will display ROAS and key metrics segmented by priority tier:

+-----------------------------------------------------------------------+
|  AdPriority Pro - Performance by Priority Tier (Last 30 Days)          |
+-----------------------------------------------------------------------+
|                                                                        |
|  Priority 5 - Maximum Push                                             |
|  +---------+----------+--------+--------+----------+--------+         |
|  | Impress | Clicks   | Cost   | Conv   | Revenue  | ROAS   |         |
|  | 85,000  | 2,400    | $1,920 | 168    | $12,600  | 656%   |         |
|  +---------+----------+--------+--------+----------+--------+         |
|                                                                        |
|  Priority 4-3 - Active Products                                       |
|  +---------+----------+--------+--------+----------+--------+         |
|  | Impress | Clicks   | Cost   | Conv   | Revenue  | ROAS   |         |
|  | 120,000 | 3,100    | $1,860 | 195    | $9,750   | 524%   |         |
|  +---------+----------+--------+--------+----------+--------+         |
|                                                                        |
|  Priority 2-1 - Low Priority                                          |
|  +---------+----------+--------+--------+----------+--------+         |
|  | Impress | Clicks   | Cost   | Conv   | Revenue  | ROAS   |         |
|  | 45,000  | 850      | $510   | 38     | $1,520   | 298%   |         |
|  +---------+----------+--------+--------+----------+--------+         |
|                                                                        |
|  Priority 0 - Excluded                                                 |
|  +---------+----------+--------+--------+----------+--------+         |
|  | Impress | Clicks   | Cost   | Conv   | Revenue  | ROAS   |         |
|  | 0       | 0        | $0     | 0      | $0       | N/A    |         |
|  +---------+----------+--------+--------+----------+--------+         |
|                                                                        |
|  TOTAL                                                                 |
|  +---------+----------+--------+--------+----------+--------+         |
|  | 250,000 | 6,350    | $4,290 | 401    | $23,870  | 556%   |         |
|  +---------+----------+--------+--------+----------+--------+         |
|                                                                        |
+-----------------------------------------------------------------------+

Key Performance Indicators

10.6 Automated Recommendations (AdPriority Pro v2)

In the second phase of AdPriority Pro development, AdPriority will use Google Ads performance data to generate priority adjustment recommendations.

Recommendation Logic

Recommendation Engine Flow
===========================

1. Fetch last 30 days of shopping performance data
   (product-level: impressions, clicks, conversions, revenue, cost)

2. Calculate per-product metrics:
   - ROAS = conversions_value / (cost_micros / 1_000_000)
   - Conversion rate = conversions / clicks
   - Cost efficiency = cost_micros / conversions

3. Compare actual performance vs. expected for priority tier:

   Product at Priority 3 with ROAS = 650%?
   --> RECOMMEND: Increase to Priority 5
       Reason: "ROAS of 650% is 86% above the tier average.
                This product is undervalued at Priority 3."

   Product at Priority 5 with ROAS = 120%?
   --> RECOMMEND: Decrease to Priority 2
       Reason: "ROAS of 120% is 70% below the tier average.
                Budget is being wasted on this product."

   Product at Priority 4 with 0 conversions in 30 days?
   --> RECOMMEND: Decrease to Priority 1
       Reason: "Zero conversions in 30 days despite 2,400
                impressions. Move budget to better performers."

4. Present recommendations in dashboard with one-click accept

Safety Guardrails

10.7 Implementation Timeline

10.8 PMAX Onboarding Workflow

When a new merchant installs AdPriority and labels are live in GMC, the app provides a guided PMAX campaign setup flow.

Onboarding Steps

PMAX Onboarding Flow (in-app guide)
=====================================

Step 1: Verify Labels in GMC
  - AdPriority checks supplemental feed status
  - Confirm all 5 custom labels populated
  - Estimated time: 24-48 hours after first sync

Step 2: Review Priority Distribution
  - Dashboard shows how products are distributed across P0-P5
  - Merchant can adjust rules before campaign setup
  - Goal: ensure distribution matches business intent

Step 3: Campaign Structure Recommendation
  - Show recommended 4-campaign structure (see Section 10.2)
  - Provide budget allocation based on merchant's total ad budget
  - Calculate per-campaign tROAS targets

Step 4: Manual Setup (AdPriority tier)
  - Step-by-step guide with screenshots
  - Merchant creates campaigns in Google Ads UI
  - AdPriority verifies label filters are correct

Step 4 (alt): Assisted Setup (AdPriority Pro tier, future)
  - Google Ads API creates campaigns programmatically
  - Merchant approves structure before activation
  - Automatic listing group configuration

Producthero Labelizer Comparison

Producthero Labelizer is a competing product that also writes custom labels to GMC for PMAX segmentation. Understanding the competitive landscape:

AdPriority’s differentiation: Merchant-controlled rules with full seasonal awareness, 5 label dimensions vs. 1, and native Shopify embedded experience. Producthero is stronger for merchants who want fully automated labeling without configuring rules.

10.9 Chapter Summary

Google Ads is the downstream beneficiary of AdPriority’s custom labels. The recommended campaign structure uses four PMAX campaigns segmented by custom_label_0 (priority), with independent budgets and tROAS targets per tier. Priority 5 products receive aggressive spend, while Priority 0 products are excluded entirely.

For the MVP and AdPriority ($49/mo) tier, AdPriority provides a campaign setup guide and the labels in GMC. Merchants configure their Google Ads campaigns manually. The AdPriority Pro ($149/mo) tier adds Google Ads API integration for performance tracking, ROAS analysis by tier, and automated priority recommendations.

Key takeaways for Nexus Clothing:

• Current state: Single PMAX campaign, no custom label segmentation
• Target state: 4 campaigns segmented by priority tier
• Estimated active variant distribution: ~800 at P5, ~8,000 at P4-3, ~6,000 at P2-1, ~5,200 at P0
• 2 pricing tiers: AdPriority ($49/mo) and AdPriority Pro ($149/mo)
• AdPriority Pro adds: Performance data, ROAS by tier, automated recommendations
• No Google Ads API access needed for AdPriority tier – labels in GMC are sufficient
• Competitive differentiation vs. Producthero: rules-based control, 5 label dimensions, seasonal awareness