Disco Monetize
Display the DiscoFeed post-purchase on your order confirmation page. This helps learn more about your shoppers to improve advertising performance and feature complimentary brands.
What is the DiscoFeed?β
The DiscoFeed is an experience that all Disco Brands feature on their post-purchase, Thank you/Order Confirmation and Order Tracking pages. It's by this method that you will show up on other brands as an advertiser as well. This experience will dynamically determine the most relevant brands to show to shoppers based on what they've purchased.
If you utilize the Shopify ecommerce platform, please install our app here and you don't need to do anything else on this page.
Step 1: Creating your Diso Accountβ
- Create your Disco account here
- Set your categories & exclusions.
- Set your categories and subcategories.(Settings > Brand and DiscoFeed > Manage
- We will automatically exclude any advertisers within the same categories or subcategories as you.
- Categories: Be as specific as possible.
- Subcategories: Based on each category selected, choose the subcategory that best describes your products. Only select subcategories that directly relate to your product catalog.
- Add any additional specific shop-level exclusions (DiscoFeed > Manage
- You can also add more specific shop-level and subcategory-level exclusions.
- We will automatically exclude any advertisers within the same categories or subcategories as you.
- Set your categories and subcategories.(Settings > Brand and DiscoFeed > Manage
π‘ Best practice: Donβt overly exclude advertisers, as it will reduce your earnings.
Step 2: Integrating the DiscoFeedβ
The Disco WebSDK consists of a few lines of Javascript that allows the Disco experience to be easily embedded on your Thank you/Order Confirmation and Order Tracking pages. The default location for placement on the page is at the top to ensure the greatest visibility.
Find your Disco Publisher ID under Settings > Integrations.
<!DOCTYPE html>
<html lang="en">
<head>
<!-- Meta tags -->
<!-- Part #1 - Load the Web SDK -->
<script
src="https://d1zcmvsklxjbur.cloudfront.net/static/disco-sdk.js"
type="text/javascript"
publisher_id="<<PUBLISHER_ID>>"
></script>
<!-- Other scripts and meta tags -->
</head>
</html>
Step 2: Mounting point for the Disco Feedβ
Use the following to specify exactly where on the page the DiscoFeed should load.
<body>
<!-- Your HTML content here -->
<div id="disco-widget"></div>
</body>
Step 3: Passing Order Data on Loadβ
To ensure we're providing the most relevant recommendation to the Shopper, Disco also requests passing Order data on the load of Thank you/Confirmation Pages and Order Tracking pages.
<!-- Part #2 - As soon as the order data attributes are available, execute the below JavaScript to display a disco widget -->
window.discoLauncher.loadWidget({
email: String, // (required if email_hash is not provided)
email_hash: String, // (required if email is not provided)
phone: String,
first_name: String, // (required)
last_name: String,
shipping: {
address_line_1: String,
address_line_2: String,
city: String,
state: String,
zip: String,
},
billing: {
address_line_1: String,
address_line_2: String,
city: String,
state: String,
zip: String,
},
confirmation_id: String,
purchases: [
{
product_id: String,
type: String,
name: String,
description: String,
variant: String,
quantity: String,
},
], // (required)
cost: String,
order_id: String, // (required)
page_type: string, // (required)
});
Field Descriptionsβ
The page_type
field only accepts two values: "thank_you"
or "order_status"
. Any other value will result in an error.
Field Name | Type | Details | Example |
---|---|---|---|
String | Plain text as provided by the shopper. | monica@disconetwork.com | |
email_hash | String | The shopper's email as a SHA-256 hash | e13eda620ca8ef9ba97a97aaecd4d1afbb741f8ce62d83413a993b7c7611624f |
phone | String | The shopper's phone number | 4151234567 or +1 (415) 123-4567 |
first_name | String | The first name as provided by the shopper. | Monica |
last_name | String | The last name as provided by the shopper. | Stone |
shipping | Object | Shipping address details. | See below |
billing | Object | Billing address details. | See below |
confirmation_id | String | Unique confirmation identifier. | 12345ABC |
purchases | Array | List of purchased items. | See below |
cost | String | Total cost of the order. | 100.00 |
order_id | String | Unique order identifier. | 67890XYZ |
page_type | Enum | Type of page where widget is mounted. | "thank_you" or "order_status" |
Shipping and Billing Address Fieldsβ
Field Name | Type | Details | Example |
---|---|---|---|
address_line_1 | String | First line of the address. | 123 Main St |
address_line_2 | String | Second line of the address (if any). | Apt 4B |
city | String | City name. | San Francisco |
state | String | State or province. | CA |
zip | String | Postal or ZIP code. | 94105 |
Purchases Fieldsβ
Field Name | Type | Details | Example |
---|---|---|---|
product_id | String | Unique identifier for the product. | PROD123 |
type | String | Type or category of the product. | Electronics |
name | String | Name of the product. | Headphones |
description | String | Description of the product. | Noise-cancelling headphones |
variant | String | Variant of the product (e.g., color, size). | Black |
quantity | String | Quantity purchased. | 2 |