Campaigns App
Connect custom checkouts to NEXT Campaigns API
Campaigns App simplifies and accelerates the deployment of custom marketing funnels and checkouts with Next Commerce's Campaigns API.
Preparing to Go Live?
Add each launch domain to the Campaigns App allowlist and mark production traffic as Production. Development domains can accept live orders, but analytics tracking events are not recorded for them.
Campaigns is an installable App in your Next Commerce store. Head to the Apps menu on the NEXT dashboard to install it.
Custom Funnels with Campaigns API
Next Commerce supports fully custom marketing funnels, including checkouts and post-purchase upsells. The server-side API method for creating fully custom flows is to use the Admin API with a server-to-server connection.
With Campaigns App, there is no need for server-to-server backend API integration. The Campaigns App uses a frontend CORS-enabled API to allow custom funnels without a backend integration.
Developers can use the pre-built Campaign Cart SDK and Campaign Page Kit starter templates to accelerate custom marketing funnel development in Campaigns App.
Learn more about the NEXT Campaigns API and the best practices for creating and deploying fully custom customer experiences.
Configure Campaigns App
Once installed, open Campaigns App from the dashboard sidebar. If Campaigns App is not pinned yet, open it from the Apps menu and pin it for faster access.
Hint - Pin the Campaigns App to the dashboard sidebar for quick access.
From the Campaigns App sidebar, select Settings.
- Select Add Domain to whitelist a domain for your custom marketing funnel.
- Specify the domain's Environment - whether it should be used for Development or Production.
Both domain types accept live orders, but analytics tracking events are not recorded on Development domains.
Campaigns API requires that all API calls are made from a whitelisted domain for security purposes.
Next, from the Campaigns App main workspace, select New Campaign to configure your campaign. Enter the following:
- Name - the internal reference name for your campaign.
- Default Currency - choose the base currency for the campaign.
- Additional Currencies - optionally add additional currencies for multi-geo campaigns.
- Language - select from a list of the languages supported by the store.
- Payment Gateway Group - assign a gateway group to the campaign, or leave blank to use the store's default gateway group.
- Available Payment Methods - define the payment methods to be accepted on your campaign's checkout.
- Available Express Payment Methods - define the express payment methods (PayPal, Apple Pay, etc.) to use on your campaign's checkout.
- PayPal Account ID - assign a PayPal account to the campaign, or leave blank to use the store's default PayPal account.
- Statement Descriptor - define a custom descriptor to appear on your customer's card statement for your campaign (for payment gateways supporting dynamic descriptors only).
- Enable Package Retail Price & Quantity - compatibility setting for existing campaigns that still depend on package-level Retail Price or Quantity fields. Leave disabled for new campaigns and use Offers & Discounts for quantity pricing and compare-at savings.
Campaigns App Logs
From the Campaigns App sidebar, select Logs. The activity logs show recent Campaigns API requests and responses for debugging checkout, payment, upsell, and tracking behavior.
Logs are filterable by the following factors to help with debugging and performance analysis:
- API Method
- Campaign
- Payment Method
- Referrer
- Date created from/to
- Email Address
- Status (Success / Failed)