Datafeed Guide - Banana IT (TH)

Last updated on June 25, 2021

An Overview

The following serves as a technical guide and step by step process on how to obtain the Datafeed for a specific offer.

Section 1: Obtaining the feed URL

1. Login to your publisher dashboard at https://app.involve.asia/ or https://app.involve.asia/publisher/datafeed

2. Navigate to the “Tools’’ menu.

3. Under the drop down menu click on “Datafeed” option.

4. You will notice the Datafeed list contains a number of offers.

5. Identify the offer that you wish to get the datafeed and copy the details listed under the “URL” column.
Important Note:
The Datafeed can only be obtained via the URL using the below URL:

Description Value

URL https://www.bnn.in.th/feed/acommerce/acommerce.csv

Section 2: Understanding the feed structure

The table below explains the structure of the feed together with some important notes that may have an impact on your
conversion.

Item Description Example

id ● The product id 17817731348

title ● The product name Bose In-Ear Wireless SoundSport Aqua

description ● The product description หูฟังบลูทธ

ู Bose SoundSport Wireless สีฟ้า หูฟัง In Ear
่ มต่อ
น้ำหนักเบา ใส่สบาย พร ้อมสายคล ้องคอ ใส่เล่นกีฬาได ้ เชือ
 ทาง Bluetooth และ NFC แบตใช ้ได ้ 6 ชม. ชาร์จด ้วยสาย micro
USB

availability ● The availability of the product out of stock

condition ● The condition of the product new

adult ● If the product is for adult no

price ● The price of the product 8900.00 THB

sale_price ● The sale price of the product 1350.00 THB

sale_price_effectiv ● The sale date of the product 2021-03-01UTC00:00+0000

e_date

link ● The URL of the product https://www.bnn.in.th/th/p/bose-in-ear-wireless-soundsport-a

qua-017817731348_gdxner

image_link ● The image URL of the product https://media-cdn.bnn.in.th/3561/017817731348-1-square_

medium.jpg

brand ● The brand of the product BOSE

product_type ● The type of the product Home Entertainment>Headphone>In-ear|Home
Entertainment>Headphone|Home
Entertainment>Headphone>Sport / Waterproof
Headphone|Home Entertainment>Headphone>Bluetooth /
True Wireless|Smartphone &
Accessories>Headphone|Smartphone &
Accessories>Headphone>In-ear|Smartphone &
Accessories>Headphone>Bluetooth / True
Wireless|Smartphone & Accessories>Headphone>Sport /
Waterproof Headphone|Home Entertainment|Smartphone &
Accessories

color ● The color of the product Aqua

gender ● The gender type for the product unisex

Short Descriptiion ● The short description of the product หูฟังไร ้สาย Bose SoundSport In-Ear Wireless ให ้เสียงเบส
เสียงย่านเบสมีความนุ่มลึก ให ้ความรู ้สึกฟั งสบาย แต่กม ็ ค
ี วามหนา
และอิม่ ในตัว คุมโทนไม่ล้ำไปย่านอืน ่ เสียงร ้องแม ้ว่าจะเป็ นหูฟัง
แบบ In-Ear แต่กใ็ ห ้เสียงร ้องทีอ
่ ม
ิ่ มีมวลหนา

weight ● The weight of the product 0.3

Section 3: Generating individual product deeplink

In order to have a valid tracking link, you need to make changes to the “link” data in the datafeed you just downloaded. To generate a
valid tracking link that points your users directly to the product page, you will have to combine the prefix URL and the encoded URL
for a specific product.

Below is the step by step instructions on how to achieve this goal.

A. Preparing the Prefix URL:

Prefix URL is the first component of the tracking link, it indicates the offer that you’re promoting as well as your
publisher account. Below is the format of the Prefix URL:

Prefix URL format

https://invol.co/aff_m?offer_id=OFFER_ID&aff_id=TRACKING-
LINK-ID&source=feed&url=

i. Replace the OFFER-ID in the Prefix URL with the below value:
 Offer ID

100934

Important Note:
Do note that the above value is unique for each offer, make sure you use it only for this offer.

ii. Replace the TRACKING-LINK-ID in the tracking_url with the Tracking Link ID assigned to your publisher account.
Your Tracking Link ID can be found by navigating to “Account Setting” -> “Profile Information” section.

Example:

Assuming your Tracking Link ID is 1010, once you updated the Offer ID and your Tracking Link ID in the Prefix
URL, the result will be as below:

https://invol.co/aff_m?offer_id=100934&aff_id=1010&source=feed&url=

B. URL encoding the direct product URL:

The URL encoded product URL is the second component of the tracking link, it indicates the direct product URL that
your user will be visiting.
 Example:

Assuming below product URL, it was looked like below.

https://www.bnn.in.th/th/p/bose-in-ear-wireless-soundsport-aqua-017817731348_gdxner

The product URL require to handle accordingly. Once encoded, it will look like below:

https%3A%2F%2Fwww.bnn.in.th%2Fth%2Fp%2Fbose-in-ear-wireless-soundsport-aqua-017817731348
_gdxner

C. Combining Prefix URL with the product URL:

In order to generate a valid tracking URL, you will have to combine the Prefix URL generated in Step A with the
product URL in Step B, the result will be as below:

Example:

https://invol.co/aff_m?offer_id=100934&aff_id=1010&source=feed&url=https%3A%2F%2Fwww.bn
n.in.th%2Fth%2Fp%2Fbose-in-ear-wireless-soundsport-aqua-017817731348_gdxner

Section 4: Tips and tricks

● The tracking URL serves as a key component for performance marketing.

 ● While the datafeed has gone through all the necessary processes, it is always a good idea to test it out.

● Make sure the Offer ID and your Tracking Link ID are valid.

● If you’re unable to locate your Tracking Link ID, kindly get in touch with your affiliate manager.

● That’s it. You’re good to go.

Enjoy promoting and make sure you optimise your feeds fully!