Rebuy Product Recommendations Integration Guide
Setting up and using Rebuy Product Recommendations in your mobile apps.
Rebuy Product Recommendations Integration Guide
Overview
The Rebuy Product Recommendations integration enables you to display personalized product recommendations on your mobile app across multiple screens including Home, PDP (Product Details Page) and cart. This guide walks you through installation and configuration.
Installation
Getting Your API Key
To get started, you'll need an API key from Rebuy:
- Log in to your Rebuy Dashboard
- Navigate to Settings → API Keys
- Copy your API key (you'll need this in the next step)
Connecting Rebuy in Reactiv
There are two steps to enable the Rebuy integration:
Step 1: Connect the Integration
- Open your Reactiv Dashboard
- On the left-hand navigation, go to Integrations
- Locate Rebuy Product Recommendations
- Paste your API key from the Rebuy Dashboard
- Click Save
Step 2: Set Rebuy as Your Product Recommendations Provider
- Go to App Settings → Integrations
- Find Rebuy Product Recommendations
- Select it as your provider for Product Recommendations
- Click Save
Once both steps are complete, Rebuy will be set as your Product Recommendations provider.
Using Rebuy Recommendations on Your Pages
Adding Recommendation Carousels
Once Rebuy is connected, you can add recommendation carousels to your app pages:
- Go to the page where you want to add recommendations (Home, PDP, and Cart)
- Drag and drop the Recommendation Section into your desired layout
- The section is now added to your page
Configuring Data Sources
Each recommendation carousel must be configured with a Rebuy data source. This determines which products are recommended.
To configure a carousel:
- Click on the recommendation carousel you just added
- In the configuration panel, select your desired Data Source from the dropdown
- Available data sources load automatically, including any custom data sources you've defined in Rebuy
Available Data Sources
Recommended
Displays products related to a specific product. Perfect for showing related items on a product page.
- Works best on: PDP, Cart
- Current limitations: We don't currently support filtering results to specific collections or applying price-based filters
Top Sellers
Shows your most popular products by sales volume.
- Works best on: Home, PDP
- Requirements: None
- Note: Future versions may support price filters
Trending Products
Displays products that are gaining popularity.
- Works best on: Home, PDP
- Requirements: None
- Note: Future versions may support price filters
Purchased ("Buy It Again")
Shows products the shopper has purchased before, encouraging repeat purchases.
- Works best on: Home, Cart
- Requirements: Shopper must be logged in
- What happens if not logged in: Carousel will not display
Viewed ("Recently Viewed")
Displays products the shopper has recently browsed.
- Works best on: Home, PDP, Cart
- Requirements: Shopper must be logged in
- What happens if not logged in: Carousel will not display
Complementary to Viewed ("Complementary to Items you've Viewed")
Shows products that complement items the shopper has recently viewed.
- Works best on: Home, Cart
- Requirements: Shopper must be logged in
- What happens if not logged in: Carousel will not display
Similar Products
Recommends products similar to the currently viewed product.
- Works best on: PDP, Cart
- Requirements: None
Custom Data Sources
You can create custom recommendation rules directly in your Rebuy Dashboard and they'll automatically appear in Reactiv.
Custom data sources support the following rule types:
- Product rules — Product ID, handle, collection membership, etc.
- Customer rules — Customer attributes and segments (requires shopper to be logged in)
- Date rules — Time-based logic
- Klaviyo rules — Customer segments defined in Klaviyo (requires shopper to be logged in)
Custom data sources do not currently support:
- Inventory-based rules
- Cart contents-based rules
- Geolocation rules
- URL-based rules
- Order tag rules
Best Practices
For Maximum Effectiveness:
- Use "Purchased" and "Viewed" carousels on the Cart page to drive repeat purchases
- Place "Recommended" and "Similar Products" on PDPs to increase order value
- Use "Top Sellers" and "Trending" on Home to drive discovery
- Test logged-in vs. guest experiences, as some carousels (Purchased, Viewed, Complementary to Viewed) require authentication
For Mobile Optimization:
- Keep carousels to 2–3 per page to avoid overwhelming shoppers
- Test carousel performance and adjust placement based on your analytics
Troubleshooting
Carousels Not Showing on Specific Pages
If a carousel isn't displaying, check:
- Is the data source appropriate for that page? (e.g., "Recently Viewed" requires a recently viewed product)
- If using Purchased, Viewed, or Complementary to Viewed: Is the shopper logged in?
No Custom Data Sources Appearing
Make sure you've created custom data sources in your Rebuy Dashboard. They'll automatically sync with Reactiv once connected.
Need Help?
Contact our support team or reach out to Rebuy for advanced configuration questions about custom data sources.
What's Next?
Once you've set up your recommendation carousels, monitor their performance through your Reactiv analytics dashboard. Experiment with different data sources and placements to find what resonates with your customers.
For more advanced personalization features, explore custom data sources in your Rebuy account.