BB_logo

tab_left
tab_right
Integration on the ‘after purchase’ page

The interaction will enable B-buzzy to present a banner, and to report the purchase to B-buzzy.

The integration is done by setting meta tags that holds the transaction details and also javascript tag that handles the operation of the banner and makes a report to B-buzzy.


The first step of the integration is to open a B-buzzy sandbox account. If you don't have an account click here.

The sandbox is a full feature B-buzzy service that doesn't create real transaction.

Prior production deployment, please check the integration with our sandbox.

When working with the sandbox environment, use sandbox.b-buzzy.com as the domain. When working with the production environment, use b-buzzy.com as the domain.


The 'bbuzzy_refferingRecommendtionId' parameter must contain B-buzzy's recommendation identifier that was passed to the 'product' page as a GET parameter when the referral was made by B-buzzy.

On the javascript source URL a ‘lang’ and ‘sellerId’ parameters must be passed

For example:

* For English: bbuzzySellerIntegration.js.php?lang=en&sellerId=123abc

* For Hebrew: bbuzzySellerIntegration.js.php?lang=he&sellerId=123abc

The ‘sellerId’ is the Id provided by B-buzzy to your ecommerce site and appears on the profile page.


Changes on html page - choose from one of two options

Option 1 - pass parameters through meta tags
<head>
...
<!--
Transaction details
-->
<meta name="bbuzzy_sellerId" content="123abc" />
<meta name="bbuzzy_transactionId" content="123abc " />
<meta name="bbuzzy_refferingRecommendtionId" content="123abc" />
<meta name="bbuzzy_userEmail" content="abc@abc.com" />
<meta name="bbuzzy_userCellphone" content="972521234567" />
<meta name="bbuzzy_promoCode" content="123abc" />


<!--
product data (for each product in shopping cart) - product 1
-->
<meta name="bbuzzy_sellerProductId" content="Your product id" />
<meta name="bbuzzy_productName" content="The product name" />
<meta name="bbuzzy_productCategory" content="he product category" />
<meta name="bbuzzy_manufacturer" content="The product manufacturer" />
<meta name="bbuzzy_productPrice" content="200" />
<meta name="bbuzzy_priceCurrency" content="USD" />
<meta name="bbuzzy_productQuantity" content="2" />
<meta name="bbuzzy_productTotalPrice" content="400" />
<meta name="bbuzzy_productURL" content="http://yourdomain/productId=111" />
<meta name="bbuzzy_imageURL" content="http://yourdomain/yourProductImage.jpg" />
<meta name="bbuzzy_totalAffiliationPercentage" content="10" />


<!--
product data (for each product in shopping cart) - product 2
-->
<meta name="bbuzzy_sellerProductId" content="Your product id" />
<meta name="bbuzzy_productName" content="The product name" />
<meta name="bbuzzy_productCategory" content="he product category" />
<meta name="bbuzzy_manufacturer" content="The product manufacturer" />
<meta name="bbuzzy_productPrice" content="150" />
<meta name="bbuzzy_priceCurrency" content="USD" />
<meta name="bbuzzy_productQuantity" content="1" />
<meta name="bbuzzy_productTotalPrice" content="150" />
<meta name="bbuzzy_productURL" content="http://yourdomain/productId=222" />
<meta name="bbuzzy_imageURL" content="http://yourdomain/yourProductImage.jpg" />
<meta name="bbuzzy_totalAffiliationPercentage" content="15" />


...
</head>


<body>
...
<script type="text/javascript" src="https://b-buzzy.com/API/ecommerce/bbuzzySellerIntegration.js.php?lang=en&sellerId=123abc"></script>


<div id="bbuzzy_div"></div>


<script type="text/javascript">bbuzzy_init();</script>
...
</body>
Option 2 - pass parameters through a JavaScript function
<head>
...
</head>


<body>
...
<script type="text/javascript" src="https://b-buzzy.com/API/ecommerce/bbuzzySellerIntegration.js.php?lang=en&sellerId=123abc"></script>


<div id="bbuzzy_div"></div>


<script type="text/javascript">


bbuzzy_setParms(bbuzzy_sellerId,bbuzzy_transactionId,bbuzzy_refferingRecommendtionId,
bbuzzy_userEmail,bbuzzy_userCellphone,bbuzzy_promoCode);


// product data (for each product in shopping cart) - product 1
bbuzzy_addProductToCartParms(bbuzzy_sellerProductId,bbuzzy_productName,
bbuzzy_productCategory,bbuzzy_manufacturer,bbuzzy_productPrice,bbuzzy_priceCurrency,
bbuzzy_productQuantity,bbuzzy_productTotalPrice,bbuzzy_productURL,bbuzzy_imageURL,
bbuzzy_totalAffiliationPercentage);


// product data (for each product in shopping cart) - product 2
bbuzzy_addProductToCartParms(bbuzzy_sellerProductId,bbuzzy_productName,
bbuzzy_productCategory,bbuzzy_manufacturer,bbuzzy_productPrice,bbuzzy_priceCurrency,
bbuzzy_productQuantity,bbuzzy_productTotalPrice,bbuzzy_productURL,bbuzzy_imageURL,
bbuzzy_totalAffiliationPercentage);


...


bbuzzy_init();
</script>
...
</body>


NVP data dictionary description

Parameter nameParameter descriptionPer productRequiredExample
bbuzzy_sellerIdThe Id provided by B-buzzy (on the profile page)NoYesNQ12
bbuzzy_transactionIdThe ecommerce unique transaction idNoYes2121wAj40622
bbuzzy_refferingRecommendtionIdThe reffering id passed as a parameter to the page ("bbRefId")NoYes
(if transaction is referred)
ur41
bbuzzy_userEmailThe email of the purchasing userNoYespurchasing_user@gmail.com
bbuzzy_userCellphoneThe cellphone of the purchasing user (if you want to send the reward to the user through a SMS)NoNo9725612345678
bbuzzy_promoCodeThe seller's promotion code for the transactionNoNopromo2012
bbuzzy_sellerProductIdThe ecommerce unique product idYesYes2113A
bbuzzy_productNameThe product nameYesYesIphone 4 16GB
bbuzzy_productCategoryThe category of the productYesNoSmart phones
bbuzzy_manufacturerThe manufacturer of the productYesNoApple inc.
bbuzzy_productPriceThe price of the product for a single unitYesYes300
bbuzzy_priceCurrencyThe currency of the price.

Currently support is for:
'USD' - United States Dollars
'ILS' - Israel, New Shekels
YesYesUSD
bbuzzy_productQuantityThe quantity of the product purchasedYesYes2
bbuzzy_productTotalPriceThe product price per unit * quantityYesYes600
bbuzzy_productURLThe product page landing page URL
YesYeshttp://www.yoursite.com/?item=123
bbuzzy_imageURLThe product's image URLYesYeshttp://www.yoursite.com/img/1.jpg
bbuzzy_totalAffiliationPercentageThe total percentage of the affiliation including the "recommender" , "buyer" and "B-buzzy"

In the example, 10 percent will be divided to:
4% to the "recommender".
4% to the "buyer".
2% percent to "B-buzzy".

To use a default affiliation percentage or a default sum, provided on the profile page on B-buzzy’s seller site, use 'default'.

To end a B-buzzy campaign for a product, use '0'.
YesYes10

* All of the parameters passed must be URL encoded.


* To use a default compensation percentage or a default sum, provided on the profile page on B-buzzy’s seller site, on the meta tag “bbuzzy_totalAffiliationPercentage” use content="default”.

For example (using meta tags):

<meta name="bbuzzy_totalAffiliationPercentage" content=”default" />


* To end a B-buzzy campaign for a product, put “0” on the bbuzzy_totalAffiliationPercentage tag.

For example (using meta tags):
<meta name="bbuzzy_totalAffiliationPercentage" content=”0" />


Download a code sample





© 2019 B-buzzy Systems Ltd. All Rights Reserved.