Skip to main content

Maximizing Catalog Intelligence: How to Build and Activate Performance Product Sets with Kargo's ACE Integration

Zane Ruttenberg

Introduction:

How to Automate Product Tagging with Performance Product Sets and ACE

In today’s competitive retail media landscape, staying ahead means identifying and amplifying your top-performing products—fast. That’s where Kargo’s Performance Product Sets (PPS) come in. Designed to dynamically filter and tag high-performing products using real-time analytics, PPS streamlines campaign setup by integrating seamlessly with tools like ACE and Creative Suite.

This training guide will walk you through how to build a Performance Product Set, enable smart output labels like “Best Seller,” and connect that data to Kargo’s ACE platform. From there, you’ll unlock automated ad updates and dynamic badge rendering across platforms like Meta and Snapchat. Whether your goal is to streamline catalog management, scale creative automation, or supercharge ad performance, this guide helps you shift from manual effort to intelligent automation.

Training Overview:

  • This training covers how to build a performance product set and enable a structured output (S output) that can be used within ACE to join with a product catalog.

  • This allows users to assign performance labels to specific products—such as identifying top performers within a catalog.

  • These labeled products can then be leveraged in tools like Creative Suite to automatically apply visual badges, enhancing product presentation.

  • While there are additional use cases, this automated badging of high-performing products was the core functionality envisioned during development.

Section 1: What is a Performance Product Set (PPS)?

  • A dynamic list of high-performing products.

  • Filtered using Google Analytics data.

  • Primary Use Case:

    • Tagging top-selling products with performance labels (like “Best Seller”) for creative automation.

  • Bonus Uses:

    • Data-driven campaign optimization.

    • Integration with ad platforms (Meta, Snapchat).

    • Feeding logic into Creative Suite for smart badges.

Section 2: Prerequisites Before You Build.

How to Create and Manage Product Sets in Kargo Commerce: A Step-by-Step Guide

Section 3: Building Your Performance Product Set

Create the Performance Product Set (PPS)

Performance Product Sets Demo - Step 1.gif

Select Your Google Analytics Data Source

Select the source that you wish to use.

Performance Product Sets Demo - Step 2.gif

Choose Third Part Stats (TPS) Integration

Select the Google Analytics account and property that you want to use as your data source.

Performance Product Sets Demo - Step 3.gif

Set Filters in the Performance Product Set Builder

Input filters to limit the scope of your product data

  • Date Range

    • Rolling date range showing the last “number of days” of data.

  • Additional Filters

    • Specify metric and number of products for your product set.

  • Order

    • Customize sorting products based on your preferred metric, whether higher or lower values are better.

  • Product Limit

    • Set the maximum number of products for your Product Set.

Performance Product Sets Demo - Step 4.gif

Click “Preview Data” to Preview a Sample of your Results:

  • Preview a sample of your Google Analytics results.

  • Preview is limited to a maximum of 50 products.

  • The “Preview Data” function will give a total number of results based upon the filters input above.

Performance Product Sets Demo - Step 5.gif

Schedule Updates

  • Set time for the Performance Product Set to automatically run.

  • Options: Daily, Weekly, Monthly.

  • Recommendation: Daily or Weekly depending on campaign needs.

  • Performance Product Sets will change based upon the data in a Product Set.

    • i.e. if a Product Set updates “Daily” the Performance Product Set for “Best Sellers” will update along with it.

Performance Product Sets Demo - Step 6.gif

Connect Product Feed

Connect your integration to an existing product set.

Performance Product Sets Demo - Step 7.gif

Field Mapping Selection

Select the field in your product catalog that matched the field in the Google Analytics (GA) data.

Performance Product Sets Demo - Step 8.gif

Enable ACE and Input ACE Output Label:

  • This features allows the user to decide whether they want to send the output file to ACE.

  • the Output Label provides a meaningful label to the output e.g. “best_seller” or “top_product”.

Performance Product Sets Demo - Step 9.gif

Output File Example:

  • This Excel file should show a list of product IDs and the “Performance Label”.

Performance Product Sets Demo - Step 10.gif

Performance Product Set Dashboard

  • The newly created Performance Product Set can be viewed in the Dashboard.

  • If the “ACE Opt In” was selected, the relevant data will be shown in the corresponding column.

  • If you don’t opt into ACE, the system instead pushes product updates directly to external platforms (e.g., Meta, Snapchat, or other connected social publishers).

  • In the PPS Dashboard you can quickly view the following information:

    • Publisher

    • GA Source

    • ACE Opt In

    • Catalog

    • Product Set

    • Schedule

    • Last Run

    • Status

Performance Product Sets Demo - Step 11.gif

Section 4: Connecting to ACE – Enabling Downstream Automation

Why use ACE?

Transform static data into a dynamic, connected system for labeling and creative automation.

Exporting the Performance Product Set

  • When S3 Output is enabled, an export file with Product ID and performance label is created.

  • Use this file as a data source for ACE.

  • In the top left Choose “Data Sources” and Click “New Data Source”

  • Toggle between the Dashboard and Data Sources by clicking tabs in the top left.

Performance Product Sets Demo - Step 12.gif

Setting Up A Data Source

  • Click the “New Data Source” button in the top left.

  • Or Click the Pencil Icon to “Edit Data Source”.

Performance Product Sets Demo - Step 20.gif

Data Source Types

Select the Data Source Type To Be Provided:

  • File Upload

  • (s)FTP

  • URL

  • Google Sheets

  • S3

Performance Product Sets Demo - Step 21.gif

Data Source: In this Exercise We’ll Use A Google Sheet

  • Manually copy your details into the fields to create a data source for ACE.

  • Test the connection to confirm validity.

  • Click “Save”

Performance Product Sets Demo - Step 13.gif

Creating an ACE Workflow

Click the “Create Custom Workflow” in the top right-hand corner.

Performance Product Sets Demo - Step 14.gif

Input Data in the New Workflow

  • Name your workflow.

  • Select the data source for the workflow.

  • Here, you can “+ Create a New Datasource” as well.

  • Once finished, click “+ Create Workflow” to proceed to the next steps.

Performance Product Sets Demo - Step 15.gif

Click the Plus (plus) Icon to Transform Your ACE Workflow

  • In this instance, we’re going to choose a “Join”

Transform Options:

  1. Data Cleanup

  2. Columns Re-Mapping

  3. Advanced SQL

  4. Plugins

  5. Transformer

  6. Filter

  7. Join

Performance Product Sets Demo - Step 16.gif

Add New Component/Join

Custom Label Component - Add a custom label to the component to better identify it in a workflow.

Input 1 - The component you will use for the left side input for merging.

Input 2 - Select which component you would like as your right side input for merging.

Join Types - Select which join you would like to apply.

Performance Product Sets Demo - Step 17.gif

Different Joins

Left Join - Keep all data from input 1 and data that matches between both inputs.

Right Join - Keep all data from input 2 and data that matches between both inputs.

Inner Join - Fully merge all data that matches between both inputs.

Full Join - Fully merge both inputs into an output.

Performance Product Sets Demo - Step 18 - Add in btwn 16 and 17.gif

Select Fields and Their Interaction In Both Input 1 and Input 2

Select Fields to Match Between Both Inputs:

  • Input 1 Matching Field Selection

  • Input 2 Matching Field Selection

Choose How They Interact:

  • Equals

  • Contains (case sensitive)

  • Contains (case in-sensitive)

Click “+ Add Field Matching” to Create More Options:

  • Combing more filters with “AND” / “OR”

Performance Product Sets Demo - Step 22.gif

Click “Save” Before Proceeding to “Add Component”

  • Output Preview can be toggled in the bottom left of the screen.

  • Click “Add Component” to apply these changes.

Performance Product Sets Demo - Step 23.gif

Click “Add Component” to Apply Changes

Performance Product Sets Demo - Step 24.gif

ACE Dashboard | Actions Icons Overview:

  • Edit Workflow

  • Schedule Workflow

  • Manually Run Workflow

  • View Workflow Output(s)

  • Three Dots Subsection:

    • Duplicate Workflow

    • Configure Workflow

    • Delete Workflow

    • Pause workflow schedule

    • Kill Import

Performance Product Sets Demo - Action Icons ACE 1.pngPerformance Product Sets Demo - Step 25.gif

Data Sources | Actions Icons Overview:

  • Edit Data Source

  • View Sample Data

  • Manually Trigger Datasource Processing

  • Copy Download URL to Clipboard

  • Download Data Source

  • Delete Data Source

Performance Product Sets Demo - Action Icons ACE 2.pngPerformance Product Sets Demo - Step 26.gif

Section 5: Final Output & Use in Creative Suite

  • The joined output example we created includes:

    • Original product catalog fields.

    • Matched Product ID + Performance Label (e.g., "Best Seller").

  • This data can now do the following:

    • Update ads automatically on platforms like Meta/Snapchat.

    • Drive dynamic badge rendering in Creative Suite using Smart Logic.

  • Real-world example:

    • “Add a ‘Best Seller’ badge to all products with that performance label.”

Section 6: Why This Matters

  • Efficiency: Removes the manual process of reviewing product performance.

  • Agility: Daily updates mean creative reflects the latest data spikes.

  • Consistency: Labels update across platforms in sync—creative, ad, and product catalogs.

Section 7: Pro Tips & Troubleshooting

  • If data doesn’t show up:

    • Recheck S3 mapping.

    • Ensure the correct join direction (Feed should be Input 1).

  • Product ID mismatch? Double-check field mappings between feed and PPS file.

Summary:

Kargo’s Performance Product Set and ACE workflow together unlock a powerful, automated system for labeling, tracking, and activating high-performing products across your marketing ecosystem. With minimal setup and recurring automation, your teams can focus less on sorting data and more on selling smarter.

Conclusion:

Unlock Smarter Campaigns with Dynamic Product Performance Labeling

With Kargo’s Performance Product Sets and ACE integration, you’re not just tagging products—you’re building an automated intelligence layer across your entire catalog. By combining Google Analytics data with ACE’s workflow tools, your team can dynamically surface and label top sellers, ensuring your ads, badges, and product creatives are always aligned with the latest performance data.

Instead of relying on manual reviews, this solution enables daily or weekly updates, giving you the agility to adapt campaigns instantly. From powering “Best Seller” badges in Creative Suite to feeding the most effective product data into ad platforms, Performance Product Sets and ACE make your catalog smarter, faster, and more scalable.

Ready to drive performance with precision? Follow this guide, and let your best products do the talking—automatically.

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk