Smar Documentation: Difference between revisions

From Barion Documentation
Jump to navigation Jump to search
Line 14: Line 14:
Paste the following snippet before the closing body tag:
Paste the following snippet before the closing body tag:


<nowiki>
    <nowiki>
<!-- SMar.js -->
        <!-- SMar.js -->
<script src="https://pixel.barion.com/smar.js" id="barion_smar" async="true" grantconsent="<accept button selector>"
        <script src="https://pixel.barion.com/smar.js" id="barion_smar" async="true" grantconsent="<accept button selector>" rejectconsent="<reject button selector>" add2cart="<add to cart button selector>"></script>
rejectconsent="<reject button selector>" add2cart="<add to cart button selector>"></script>
    </nowiki>
</nowiki>


Write the selectors for the buttons to the attributes respectively.
Write the selectors for the buttons to the attributes respectively.
- _grantconsent_: The selector of the element on which the user clicks a grantconsent event should be sent
* _grantconsent_: The selector of the element on which the user clicks a _grantConsent_ event should be sent
- _rejectconsent_: The selector of the element on which the user clicks a rejectconsent event should be sent
* _rejectconsent_: The selector of the element on which the user clicks a _rejectConsent_ event should be sent
- _add2cart_: The selector of the element on which the user clicks an addtocart event should be sent. This attribute is optional
* _add2cart_: The selector of the element on which the user clicks an _addToCart_ event should be sent. This attribute is optional.
As the smar.js library relies on jQuery, all the selector or selectors can be used here. More information on selectors can be found here: https://api.jquery.com/category/selectors/
As the smar.js library relies on jQuery, all the selector or selectors can be used here. More information on selectors can be found here: https://api.jquery.com/category/selectors/



Revision as of 08:52, 8 September 2021

Documentation of smar.js

Prerequisites

The current version of smar.js does not send initiateCheckout and initiatePurchase events. All pages (including the order summary) need to include the following libraries:

  • jQuery 1.1+
  • bp.js

Installation

Paste the following snippet before the closing body tag:

   
        <!-- SMar.js -->
        <script src="https://pixel.barion.com/smar.js" id="barion_smar" async="true" grantconsent="<accept button selector>" rejectconsent="<reject button selector>" add2cart="<add to cart button selector>"></script>
    

Write the selectors for the buttons to the attributes respectively.

  • _grantconsent_: The selector of the element on which the user clicks a _grantConsent_ event should be sent
  • _rejectconsent_: The selector of the element on which the user clicks a _rejectConsent_ event should be sent
  • _add2cart_: The selector of the element on which the user clicks an _addToCart_ event should be sent. This attribute is optional.

As the smar.js library relies on jQuery, all the selector or selectors can be used here. More information on selectors can be found here: https://api.jquery.com/category/selectors/

Examples

Here is an example of the embedding code:

Példák a consent események implementációira

<script src="https://pixel.barion.com/smar.js" async="true" id="barion_smar" grantconsent="button.cc-allow" rejectconsent="button.cc-dismiss" add2cart=".add-to-cart, button#add-to-cart"></script>

The selectors can be checked with the help of Google Chrome console (Ctrl + Shift + I on Windows), then click on the arrow icon in the top left corner, then click on the button as shown on the screenshot below. In the selected line, copy a unique label from the class attribute of the button tag to the appropriate attribute of the embedding script tag.

The grantconsent event listener is attached to a button with cc-allow class: <button class=”cc-btn cc-allow”>Accept</button> The addtocart event listener is attached to any element with add-to-cart class and a button with add-to-cart id. <span class=”add-to-cart”>Add to cart</span> <button id=”add-to-cart”>Add to cart</button>

Event Description Identifiers
Event grantConsent
Description Customer grants access to storing marketing cookies
Identifiers Fill the _grantconsent_ attribute with the appropriate selector A _grantconsent_ is also sent, when the user clicks on a button with _.cc-btn-accept-all_ class A _grantconsent_ is also sent, if the checkbox with _#marketing-cookies-checkbox_ is checked