linkOverview
linkFeatures
linkGeneral information
This add-on is designed to run retargeting in the advertising systems of Facebook and Instagram.
Technically add-on extends another add-on Advanced Product Export (documentation link) adding product feed template with supported format and adds analytic part (pixel) of user activity tracking in your store.
Pixel tracks the following user behaviour events:
- ViewContent - product view (quick view and product page view);
- AddToCart - add product to cart;
- InitiateCheckout - view checkout page;
- Purchase - order create (full checkout and buy in 1 click);
- AddToWishlist - add product to wishlist;
- Search - use products search.
- PageView - all pages.
linkCompatibility
Available add-on version | CS-Cart/Multi-Vendor compatible versions |
---|---|
v1.6.0 |
4.11.1 – 4.17.2 |
v1.5.1 |
4.9.3 – 4.12.1 |
v1.3 |
4.3.3 – 4.9.2 |
Add-on is compatible with the following Themes:
- YoupiTheme (compatible with correspond CS-Cart version);
- UniTheme2 (compatible with correspond CS-Cart version);
- Responsive.
linkSupport
General technical support conditions are available at this link (be sure to review these conditions, all solutions from the AlexBranding development team come with limited technical support).
In order to use our technical support, you need to:
- Log in with your order owner account on https://cs-cart.alexbranding.com;
- Go to the page My Account → Orders;
- Find the corresponding order with the problem add-on in the orders list and pass to its details;
- Find the “Support” link next to the corresponding add-on name (near you can find Documentation link also) and click on it;
- Fill in the data with the problem, provide access to your CS-Cart installation (path to the administration panel, admin mail, admin password + FTP access) and create a ticket (after you will create the ticket, you will receive an e-mail and a special code to track the ticket in the future);
- Wait for the specialist answer in accordance with the regulations of the technical support service and the priority of your ticket.
If you didn't receive an answer within the deadlines, according to the chosen ticket priority, send e-mail info@alexbranding.com with the ticket number, for which you did not receive an answer in time, and the team manager will solve the problem in compliance with regulations.
link Demo
You can test the addon work with admin access using our demo server Demos for CS-Cart solutions from Alexbranding by choosing it in Addons list or just follow the link.
linkRestrictions and warnings
We recommend to note general restrictions:
- All solutions from AlexBranding developers team require pre-installation of the AB: Addons Manager service addon. It is delivered free of charge and is responsible for such services: installation, upgrades, license verifications. Excluding this service addon usage is not possible;
- Addon files may have a closed (encoded) part, in which only a license check is located;
- The addon will work only on those domains, that are specified in the user's license. If you try to use the solution on CS-Cart installations, whose domains are not included in the license, the addon will be automatically turned off;
- Local installation is not possible, so that the addon works on the additional domain (subdomain), enter this domain (subdomain) in the Domain field, when ordering (or write to info@alexbranding.com) - adding technical domains for the developing or for testing is always free.
linkUsage
linkInstallation
After your order has been processed by our manager, it will be transferred to Completed state, you will receive an email to your mailbox with ordered add-ons license numbers (usually it takes from 15 minutes to 8 hours depending on the day time and week day).
Then follow the steps below, which differs depending on your version of the CS-Cart platform:
You can also install the add-on with a standard installation for CS-Cart. To do this, download the appropriate archive with an add-on version compatible with your version of the CS-Cart platform.
Go to the website cs-cart.alexbranding.com, log in under the account of the order holder and go to the page My Profile → Orders → Relevant Order, go to details and you will see a list of available archives for the ordered add-on. Download the version (archive) you need and make the installation (standard for CS-Cart installation: Add-ons → Downloaded add-ons and in the gearwheel menu select Manual installation).
linkSettings
For access to the add-on settings you should go to the page Administration panel → Add-ons → Manage add-ons and at the add-on name in the gearwheel menu select appropriate menu item.
link Facebook pixel ID
linkSet up of dynamic advertising
This add-on adds Facebook Pixel on your site, tracking the following events:
- ViewContent - product view (quick view and product page view);
- AddToCart - add product to cart;
- InitiateCheckout - view checkout page;
- Purchase - order create (full checkout and buy in 1 click);
- AddToWishlist - add product to wishlist;
- Search - use products search.
- PageView - all pages.
In the add-on settings be sure to specify FB_PIXEL_ID
.
Create a feed for retargeting in Facebook:
- Create template with csv format using documentation of AB: Advanced Product Export (select default datafeed template Facebook remarketing feed);
- Next, following the documentation, create the datafeed using created template and generate the feed file;
- Configure the frequency of file regeneration using the proposed link for generating CRON (tab General settings in the feed editing page - bottom part).
linkAdditional feed settings
To edit additional feed settings, go to the Additional parameters tab on the edit datafeed page.
linkSettings on the editing product page
To get to the settings of product feed export go to the page Administration panel → Products → Products → [product name] → "Add-ons" tab. There are three values available in the section AB: Product feed export (Facebook remarketing template) in the field Product condition:
- New;
- Refurbished;
- Used.
linkExport/Import of the product condition
You can work with Facebook remarketing through the CSV file. There is the field of product condition that is specified on the editing product page.
To make export/import go to the page Administration panel → Administration → Export/Import data → Products.
linkIntegrations
- Dynamic Facebook and Instagram ads (pixel + product feed)
- Advanced Product Export (xml and csv formats)
Add-on Advanced Product Export (xml and csv formats) is a mandatory for work of the Dynamic Facebook and Instagram ads (pixel + product feed) add-on. It provides a feed template to make a product feed. The add-on Dynamic Facebook and Instagram ads (pixel + product feed) cannot work alone.
linkHow to update
AB: Add-ons Manager will notify you about available updates (you will see an indicator of new alerts). The recommended way is to update via the CS-Cart Upgrade center (a regular procedure of the platform). This method will allow lossless configuration of the transition to the new add-on version, that is guaranteed to be compatible with your CS-Cart platform version.
To make updates procedure:
- Go to the Administration panel → Administration → Upgrade center;
- Find the appropriate update among the available updates and click the Update button;
- Follow all the instructions, that will be shown during the upgrade procedure;
- Clear CS-Cart cache and start using new add-on version.
linkHooks
linkPHP-hooks
linkab__pfe05_is_valid_event
File app/addons/ab__product_fe05_facebook_ads/func.php
.
Use this hook to forbid send specific events by Pixel or to change data to send. Available params:
$event
- string - event name,
$data
- array - properties,
$result
- bool - whether sending is allowed.
linkList of releases
Subscribe to our Telegram-channel to get info about new releases.
v1.6.0 from 19 January 2021
New features and improvements:
[+] Added compatibility with CS-Cart 4.12.1.
[+] Added Ukrainian language support.
[+] Added privileges for managing help view.
Functionality changes:
[*] "AB: Advanced Product Export (xml and csv formats)" add-on. The template has been adapted to the basic add-on 3.8.0 version.
Bug fixes:
[!] Prices were inserting into a feed with default currency, and not with currency is set in the datafeed. Fixed.
v1.5.1 from 21 November 2019
Functionality changes:
[*] Was added PHP-hook ab__pfe05_is_valid_event
, which allows for other addons allow or deny sending some specific events;
Bug fixes:
[!] When the checkbox "Show shipping cost and time on product pages" of the addon "Maps and geolocation" was checked, it sent extra addToCart events. Fixed.
v1.5.0 from 24 October 2019
New features and improvements:
[+] Added tracking of adding product to cart.
[+] Added tracking of adding product to wishlist.
[+] Added tracking of products search.
[+] Added tracking of quick view product.
[+] Added tracking of buying in 1 click.
[+] Added ability to export product_type
field.
v1.4.0 from 25 March 2019
- added connector for further updates;
https://cs-cart.alexbranding.com/en/ab__product_fe05_facebook_ads.doc
v1.3 from 14 June 2018
https://cs-cart.alexbranding.com/en/ab__product_fe05_facebook_ads.doc
v1.2 from 14 January 2018
https://cs-cart.alexbranding.com/en/ab__product_fe05_facebook_ads.doc
v1.1 from 12 December 2017
https://cs-cart.alexbranding.com/en/ab__product_fe05_facebook_ads.doc