---
title: Integration Best Practices
slug: fluid-adserver-api/integration-best-practices
description: Step-by-step recommended integration flow, backend vs. frontend integration guidance, and a full go-live checklist for sandbox and production.
icon: 🎖️
docTags: 
createdAt: 2024-07-05T08:24:26.049Z
---

# Quick Overview

### How the solution works technically

**Step 1. **Customer loads the retailer website​

**Step 2. **Website requests product listings from backend​

**Step 3. **Backend calls Pentaleap Ad server API with list of GTINs with it’s organic sorting order together with a session ID​

**Step 4. **Pentaleap Ad server API responds with a re-ordered list of GTINs where sponsored products have been flagged together with tracking links​

**Step 5. **Backend re-orders their original product listings based on the response and adds tracking URLs to the sponsored product objects and provides it for the website​

**Step 6. **Website displays the products and calls the tracking URLs on impression or click​

**Step 7. **When an order is placed, backend sends a conversion event to Pentaleap containing the session ID​

:::ExpandableHeading{isOpen="true"}
### Component type suggested integration​

Recommended ways to integrate the different components - we do also support frontend Ad Request integrations.

![](https://api.archbee.com/api/optimize/FKG7INSMP0SHaHefhjVDj/wiAJktV7JdlrrVhgH4CsW_spa-works-2.png)


:::

:::ExpandableHeading{isOpen="true"}
### Getting the most out of the algorithms​

Batches of products can be split out in the backend or front-end in various ways

**Integration tip​**

- Send multiple pages of products to the Pentaleap ad server to automatically solve for boosting cross pages and deduplication
- ​For an ideal setup, the requests should always start with the first product on the first page.​

![](https://api.archbee.com/api/optimize/FKG7INSMP0SHaHefhjVDj/BIUxrK15rh8Embb_CSpsd_image.png)
:::

:::ExpandableHeading{isOpen="true"}
### Go-live high level checklist​

**Testing and lower environments**

- [ ] Product feed has been successfully imported and validated​.
- [ ] Ad Request/response on Sandbox endpoints has been tested locally eg. Postman.​
- [ ] If using 3rd party demand - warmup API has been implemented​.
- [ ] Sandbox endpoints have been tested on a lower environment and ads are rendered​.
- [ ] Clicks, impressions and conversion events have been verified on lower environment​.
- [ ] Clicks are fired appropriately eg. On click of image, add to cart action, click of product title/card​.
- [ ] Pentaleap have confirmed that clicks, impressions and conversions are being processed as expected​.



**Production**

- [ ] Feed file has been uploaded to production (via FTP, link or other supported method) and there is a live or planned feed refresh/delta approach​.
- [ ] Production endpoints and details have been implemented and <u>no production site is using Sandbox endpoints​</u>.
- [ ] If using 3rd party demand - warmup API has been implemented​.
- [ ] Clicks, impressions, loaded impressions (optional) and conversion events have been verified on production environment​.
- [ ] Clicks are fired appropriately eg. On click of image, add to cart action, click of product title/card​.
- [ ] Pentaleap have confirmed that clicks, impressions, loaded impressions (optional) and conversions are being processed as expected​.


:::

&#x20;