A guide to Penny Black's integration with Rebuy
Rebuy is a recommended product engine built specifically for Shopify. If you’re already using Rebuy to recommend products to your customers, you can also use it to power recommendations to your customers on Penny Black inserts.
This guide describes how to set up the integration between Penny Black and Rebuy to use recommended product details in your campaigns. See our separate guide on how to use this data in a campaign and design your artwork.
Overview
Once configured, recommended products will be retrieved for each order as part of our enriching the customer order once it's been placed.
We use the Shopify customer ID to get a tailored set of recommendations and store up to 8 along with images, links and pricing info to be used in your campaigns.
💡 We recommend adding an enrichment delay of at least 5 minutes to ensure that Rebuy has updated their recommendations based on the most recent order (you don’t want to recommend a product that they’ve just bought!)
Setup
First, you will need an API key from within the Rebuy app:
- Go to Settings → API Keys on the menu
- Create a new API key specifically for Penny Black
- Copy this key
- Now head to the Penny Black app and to Settings → Integrations → Rebuy
- Paste it into the Rebuy API Key field and Save.
The Rebuy Ruleset ID is also a required field. This allows you to set rules to determine which products are recommended. Here is a guide on creating rulesets in Rebuy.
- Once you've created or chosen your ruleset, go to Datasources → Custom Datasources from the Rebuy menu. This lists all of your rulesets and the left-most column contains the ID.
- Copy this ID
- Head back to the Penny Black app and to Settings → Integrations → Rebuy
- Paste the ID into the Rebuy Ruleset ID field and Save.
💡 You can change the ruleset at any time but it will only affect orders placed after you have made the change.
Integration technical detail
This integration uses the Rebuy Custom API Endpoint, but we’re only providing the following parameters:
- shopify_customer_id
- presentment_prices=yes
These mean that we get recommendations for the customer of that order and we require prices (as we assume you’ll most likely want to include these on your inserts).
If prices or any other required information is missing then we’ll skip that recommended product from the import.
Checking the integration is working
Recommended products for each order can be found by clicking on the order on the Activity page. If this information is missing for orders placed after you have configured the integration there might be an issue with either the API key or the ruleset
