Facebook Pixel
How to use Facebook Pixel in mini-landings
How to send events to Pixel from the bot
To transfer events from the bot’s workflow, you need to have a business account. You can register here
How to create a new pixel
Choose API Conversions
Attention! If the following window opens up during the conversion API configuration, it’s better to leave the settings and start again.
Choose the Pixel you need
Generate an access token and save it in a safe space.
How to transfer events to Facebook
To transfer events to Facebook, you have to have your own domain set up in the mini-landing, it has to be approved on Facebook and “Saving values from cookies to client variables” has to be turned on for Facebook in the mini-landing’s settings:
Now, there will be an automatically filled out variable _fbp in the card of the client that came from the mini-landing. This variable can be transferred to Pixel with the event
You need to configure the following settings in the block, through which you need to transfer the event:
URL of the function: https://store.salebot.ai/function/fb_pixel
An example of the parameters: { "pixel_id": "#{pixel_id}", "access_token": "#{access_token}", "event_name": "Entered the bot", "event_source_url": "https://my_best_site.com", "action_source": "chat", "fbp": "#{_fbp}", "fbc": "#{_fbc}" }
Mandatory parameters:
pixel_id - id of the pixel access_token - the token for accessing API event_name - the name of the event. You can use standard names (like Lead, PageView, Purchase and so on; see more here), as well as your own (like Entered the bot) event_source_url - the approved on Facebook domain fbp - the client’s browser id
Optional parameters:
action_course - (other by default) this field lets you specify where exactly the conversions happened. The information on where the events happened helps to make sure that your advertisements are shown to the right audience. You can set the following values in the field action_source:
| Value | Description |
|---|---|
| Conversion took place through email |
| Conversion took place on a site |
| Conversion took place through the phone |
| Conversion took place through a messenger, SMS or an online-chat |
| Conversion took place in the physical store |
| Conversion happened automatically, i.e. as a result of a monthly subscription renewal |
| Conversion happened another way |
How to test events
To test, you need to add the parameter test_event_code with the text stored in the Testing messages tab, to the body of the request.
{ "pixel_id": "#{pixel_id}", "access_token": "#{access_token}", "event_name": "Entered the bot", "event_source_url": "https://my_best_site.com", "fbp": "#{_fbp}", "fbс": "#{_fbс}", "test_event_code": "TEST11421" }
Attention! Don’t forget to delete this parameter from the request when launching the test version!
Additional optional parameters:
fn - first name ln - last name email - the client’s email phone - the client’s phone number fbc - click id gender - the client’s gender (f - female, m - male) country - self explanatory state - self explanatory city - self explanatory index - the client’s postal index (zip code) external_id - any unique client id, i.e. user id or id of third-party cookie files client_ip_address - the client’s IP address client_user_agent - user agent of the client’s browser
You can also transfer your own parameters into Pixel (optional), for this you need to add an additional parameter my_params and specify your own fields in it.
Example: “my_params”: {“value1”: “Hello”, “val2”: “Hi”}
Full example:
{ "pixel_id": "#{pixel_id}", "access_token": "#{access_token}", "event_name": "Entered the bot", "event_source_url": "https://my_best_site.com", "email": "test@test.com", "phone": "1234567890", "currency": "USD", "value": "142.52", "test_event_code": "TEST11421", "external_id": "#{client_id}", "fn": "#{name}", "gender": "m", "post_index": "12345", "my_params": {“value1”: “Hello”, “val2”: “Hi”} }
Attention! Don’t forget to delete this parameter from the request when launching the test version!
How to add a promotional account
First, you need to open access to your account
Save and move to the tab Related Objects -> Add Objects
And then add your promotional account
Last updated
