Created : 08 June 2022
Last Modified : 08 June 2022
***********************************************************************************
Contents:
A. SUMMARY
B. FILE STRUCTURE
C. INSTALLATION INSTRUCTION
D. HOW IT WORKS
E. CONFIGURATION SETTINGS
F. DATABASE TABLES MODIFIED
G. LANGUAGE SETTINGS CHANGED
H. CHANGE LOGS
I. TROUBLESHOOTING
J. FAQ
K. COPYRIGHT NOTICE
L. TERMS AND CONDITIONS
***********************************************************************************
A. SUMMARY
==========
This interface is for use to integrate Facebook conversion API/Pixel to Meta Business Suite.
***********************************************************************************
B. FILE STRUCTURE
===================
Files included in the zip are:
- $READ_ME_FIRST_fbconversion.HTML
- shop_fb_conversion_config.asp
- shop_fb_conversion_subs.asp
- sha256.asp
- admin/fbconversion_setup.asp
-
admin/fbconversion_setup_config.asp
-
admin/fbconversion_setup_process.asp
-
admin/shopa_facebookfeed_subs.asp
-
admin/shopa_fb_conversion_config.asp
-
admin/shopa_fb_conversion_subs.asp
- admin/help/shoph_fb_conversion.asp
- admin/js/fbconversion/fb_conversion.css
- admin/js/fbconversion/fb_conversion.js
- admin/images/fbconversion/*
-
admin/sqlscripts/fbconversion/*
***********************************************************************************
C. INSTALLATION INSTRUCTION
============================
1. Upload below files to your shopping cart folder.
- shop_fb_conversion_config.asp
- shop_fb_conversion_subs.asp
- sha256.asp
2.
Upload below files to your ADMIN folder. If you have renamed your ADMIN folder, then this must be placed in the renamed folder.
- admin/fbconversion_setup.asp
-
admin/fbconversion_setup_config.asp
-
admin/fbconversion_setup_process.asp
-
admin/shopa_facebookfeed_subs.asp
-
admin/shopa_fb_conversion_config.asp
-
admin/shopa_fb_conversion_subs.asp
- admin/help/shoph_fb_conversion.asp
- admin/js/fbconversion/fb_conversion.css
- admin/js/fbconversion/fb_conversion.js
- admin/images/fbconversion/*
-
admin/sqlscripts/fbconversion/*
3. Modify below files:
3a. open file shopmodules_include.asp
3ai. Locate to the end of the file:
Please insesrt:
<!-- #include file="shop_fb_conversion_subs.asp"-->
3aii. Save file shopmodules_include.asp
3b. open file shopaddtocart.asp
3bi. Locate below code: (Estimate line 276)
CartAddItem strinputarray(icnt), rc
After this code, please insert:
'fb conversion
fb_conversion_add_items_process strinputarray(icnt), strcname, quantity, ProductPrice
3c. Open file shopthanks.asp
3ci. Locate below code: (Estimate line
94)
setsess "googleordertotal",getsess("OrderTotal")
After this code, please insert:
'fb conversion
fb_conversion_thankyou_process
3cii. Save file shopthanks.asp
3d. Open files templates/default/shoppage_header.htm and
templates/default/shopfrontpage_header.htm
3di. Locate below code: (Estimate line 168)
</head>
Before this code, please insert:
<%'facebook conversion%>
<%insert_facebook_pixel%>
3dii. Save files templates/default/shoppage_header.htm and templates/default/shopfrontpage_header.htm
3e. Open files templates/default/shoppage_trailer.htm and
templates/default/shopfrontpage_trailer.htm
3ei. Locate below code: (Estimate line 99)
<%adjustachorlink%>
After this code, please insert:
<%'facebook conversion%>
<%insert_facebook_pixel_track%>
3eii. Save files templates/default/shoppage_trailer.htm and templates/default/shopfrontpage_trailer.htm
4. Log into super admin and execute page below:
http://www.yourdomain.com/<your admin folder>/fbconversion_setup.asp
Note: Replace the below with your VPCart site
{ www.yourdomain.com } : your site domain
{ your admin folder } : your admin folder
Click Install Now button.
4. After installation completed, click Next button:
5. You will be redirected to Facebook conversion configuration page.
6. You are required to get Access token Pixel ID before activate the module.
How to retrieved Access token:
Please follow below guide to retrieve Facebook conversion Access Token.
1. Log in to Meta Business Suite panel with your Facebook user name/phone and password.
2. After loggen into the account, click All tools.
3. Locate and click Events Manager, it should open a new window.
4. If you do not have any Pixel Data source for your site, please follow below steps (Number 4) to create a new Pixel Data Source, otherwise please follow instructions from step Number 5 onwards:
4a. Click + icon, Connect Data Sources from left side icons.
4b. Choose Web, then click Connect button.
4c. Name your pixel, then click Create Pixel button.
4d. Enter your website URL, then click Check button.
4e. Click Next button after Check URL.
4f. Choose Conversion API and Meta Pixel, after that click Next button.
4g. Click Next or Setup button until on the screen of Set up Convrsion API to connect website activity, please select Set up manually then click Next button.
4h. You have created a new Pixel, please ignore the other steps for the moment.
4i. Click < icon to go back to this Pixel Data Source overview page.
5. Locate the Pixel Data Source and click Settings.
6. Scroll down, locate and click Generate access token.
7. Click and copy the Access token.
8. Paste the Access token to VPCart setup page.
How to retrieve Pixel ID:
1. After log into Meta Business Suite panel, Locate the Pixel Data Source and click Settings.
2. Locate and click Pixel ID.
3. Paste the Pixel ID to VPCart setup page.
***********************************************************************************
D. HOW IT WORKS
===============
The facebook conversion/pixel module would post visitor informations to Meta Business Suite.
***********************************************************************************
E. CONFIGURATION SETTINGS
=================
Refer to Facebook Conversion/Pixel configuraiton page
F. DATABASE TABLES MODIFIED
===========================
NONE
G. LANGUAGE SETTINGS CHANGED
============================
New languages for Facebook Conversion/Pixel
H. CHANGE LOGS
============================
NONE
***********************************************************************************
I. TROUBLESHOOTING
============================
Please submit a ticket to our helpdesk at https://helpdesk.vpcart.com and our support team will assist you.
***********************************************************************************
J. FAQ
============================
NONE
***********************************************************************************
K. COPYRIGHT NOTICE
============================
Copyright (c) 1999-2023 Rocksalt International Pty. Ltd.
All rights reserved.
This software and documentation constitute a published work and
contains valuable trade secrets and proprietary information
belonging to Rocksalt International Pty. Ltd. .
None of the foregoing material may be copied,
duplicated or disclosed without the express written permission
of Rocksalt International Pty. Ltd. .
LICENSEE ACCEPTS VP-ASP Shopping Cart "AS IS" "WITH ALL FAULTS",
Rocksalt International Pty. Ltd. accepts no responsibility for the
operation or performance of the VP-ASP Shopping Cart.
The entire risk of use and consequences of use of the
VP-ASP Shopping Cart falls completely on the Licensee
and Rocksalt International Pty. Ltd. shall not be liable in any respect
for any claims, loss or injury alleged to have resulted
from use of or in reliance on VP-ASP Shopping Cart.
Licensee acknowledges that it has read the foregoing
disclaimers of warranty and limitation of liability
and understands that Licensee assumes
the entire risk of using VP-ASP Shopping Cart.
***********************************************************************************
L. TERMS AND CONDITIONS
============================
ROCKSALT INTERNATIONAL GRANTS TO THE LICENSEE A NON-EXCLUSIVE,
NON-SUB LICENSABLE, NONTRANSFERABLE LICENSE
TO INSTALL AND USE THIS APPLICATION ON A SINGLE DOMAIN FOR
A SINGLE SHOP.
THE CODE IN THE APPLICATION MAY BE MODIFIED FOR USE IN
SETTING UP A SINGLE SHOPPING SITE ON THE WORLD WIDE WEB.
LICENSEE MAY MAKE A COPY OF THE APPLICATION FOR
BACK-UP AND ARCHIVAL PURPOSES, PROVIDED THAT ANY COPY
MUST CONTAIN ALL PROPRIETARY NOTICES INCLUDED
WITH THE APPLICATION.
LICENSEE IS PROHIBITED FROM SELLING OR DISTRIBUTING
THE APPLICATION IN ANY MANNER.
LIMITATION OF LIABILITY.
ROCKSALT INTERNATIONAL AND ITS LICENSORS SHALL
NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE OR ANY
THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING THIS
APPLICATION.
IN NO EVENT WILL ROCKSALT INTERNATIONAL OR ITS LICENSORS
BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA,
OR FOR DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES,
HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LI
ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE,
EVEN IF ROCKSALT INTERNATIONAL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.