Implementation guide (Server-side Pixels)
Prerequisites
-
Knowledge of Page view pixels and Event pixels
-
Familiarity with Pixel integration on the client-side
-
Experience with Event diagnostics and Event alerts dashboard tools
Cookie generation and storage
For server-side pixels, generate and handle the cookie (cookie2 parameter) values in your tracking/UI code. Generate the cookie values using the format mentioned in the cookie2 parameter's details, and store the cookie data in the user's browser. The data should be stored in the local storage as first-party cookie data.
Pass required parameters
Use the Pixel integration API to implement the pixels on your backend. Send an HTTP GET request to the API whenever you handle various user events like page views, Add-to-carts, or searches.
Some query parameters are required for all pixel API calls from the server side, irrespective of the event type. Other required parameters vary based on the type of event, and are listed on each event’s guide under Page view pixels and Event pixels.
Optional parameters can be passed as needed.
The table below lists all required parameters for any type of server-side pixel API call:
| Parameter | Data type | Description | Example value |
|---|---|---|---|
version | String | The version of the Pixel tracker SDK used. For server-side pixels, prefix the tracker version with ss-.The tracker version is for your convenience to maintain the server-side tracker's versioning. | ss-v0.1 |
cookie2 | String | A randomly generated, unique user ID is used for the cookie. Refer to more details about the cookie parameter. | uid%3D8100391390189%3Av%3D12.0% 3Ats%3D1744128139334%3Ahc%3D12 |
client_ip | String | Collect and send a valid IPv4 or IPv6 IP address from the client request. This is equivalent to the remote address on the client side and is important for geolocation-based features to work (like audience segments). | 174.34.55.67 |
client_ts | Unix timestamp | The timestamp when the event was triggered on the client-side. Fetch the exact timestamp in epoch milliseconds from the UI. | 1747741611000 |
rand | String | A random number that acts as a cache buster. Refer to more details about the rand parameter. | 0.4505427809598864 |
url | String | The full URL of the page that the visitor is viewing. Refer to more details about the url parameter. | https%3A%2F%2Fwww.documentation. bloomreach.com%2Fproduct_24448137 |
ref | String | The URL from the referrer screen. Refer to more information about the ref parameter. | https%3A%2F%2Fwww.documentation. bloomreach.com%2F |
type | String | The type of tracking event to fire. Refer to more details on the type parameter. | pageview |
user-agent(Header) | String | A valid user agent string from a supported browser or mobile application. This is required for accurate device type detection and analytics. | Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0Add checks for blocklisted UA values like: curl, wget, python-requests, PostmanRuntime, java/, node-fetch, axios, bot, spider, crawler |
Page view pixels - API call examples
Given below are examples of how you can implement different types of page view pixels on the server-side:
Product page view pixel
curl 'https://p.brsrvr.com/pix.gif
?acct_id=6702
&cookie2=uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D10
&tzo=-330
&rand=0.5379310827904386
&title=Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C
&user_id=undefined
&view_id=us
&domain_key=documentation_site
&ptype=product
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&prod_id=20902475
&prod_name=Women%27s%20Favorite%20Short-Sleeve%20Crewneck%20T-Shirt
&sku=undefined
&type=pageview
&lang=en-GB
&url=https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue
&rc=1
&can_url=https%3A%2F%2Fwww.documentation.bloomreach.com
&version=cde-ss-v0.1
&client_ts=1747741811000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D10",
"tzo": "-330",
"rand": "0.5379310827904386",
"title": "Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
"user_id": "undefined",
"view_id": "us",
"domain_key": "documentation_site",
"ptype": "product",
"ref": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"prod_id": "20902475",
"prod_name": "Women%27s%20Favorite%20Short-Sleeve%20Crewneck%20T-Shirt",
"sku": "undefined",
"type": "pageview",
"lang": "en-GB",
"url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue",
"rc": "1",
"can_url": "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version": "cde-ss-v0.1",
"client_ts": "1747741811000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D10',
tzo: '-330',
rand: '0.5379310827904386',
title: "Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
user_id: 'undefined',
view_id: 'us',
domain_key: 'documentation_site',
ptype: 'product',
ref: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
prod_id: '20902475',
prod_name: "Women%27s%20Favorite%20Short-Sleeve%20Crewneck%20T-Shirt",
sku: 'undefined',
type: 'pageview',
lang: 'en-GB',
url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue',
rc: '1',
can_url: 'https%3A%2F%2Fwww.documentation.bloomreach.com',
version: 'cde-ss-v0.1',
client_ts: '1747741811000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
})
.then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D10",
"tzo" => "-330",
"rand" => "0.5379310827904386",
"title" => "Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
"user_id" => "undefined",
"view_id" => "us",
"domain_key" => "documentation_site",
"ptype" => "product",
"ref" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"prod_id" => "20902475",
"prod_name" => "Women%27s%20Favorite%20Short-Sleeve%20Crewneck%20T-Shirt",
"sku" => "undefined",
"type" => "pageview",
"lang" => "en-GB",
"url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue",
"rc" => "1",
"can_url" => "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741811000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D10',
'tzo' => '-330',
'rand' => '0.5379310827904386',
'title' => 'Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C',
'user_id' => 'undefined',
'view_id' => 'us',
'domain_key' => 'documentation_site',
'ptype' => 'product',
'ref' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'prod_id' => '20902475',
'prod_name' => 'Women%27s%20Favorite%20Short-Sleeve%20Crewneck%20T-Shirt',
'sku' => 'undefined',
'type' => 'pageview',
'lang' => 'en-GB',
'url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue',
'rc' => '1',
'can_url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741811000000',
'client_ip' => '174.34.55.67'
]
]);
Category page view pixel
curl 'https://p.brsrvr.com/pix.gif
?acct_id=6702
&cookie2=uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D14
&tzo=-330
&rand=0.09787488863036642
&title=Men%27s%20Shirt%20Jackets%20%7C%20Thermal%20%26%20Shirts%20%7C
&user_id=undefined
&view_id=us
&domain_key=documentation_site
&ptype=category
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&cat_id=cat562401
&cat=MEN%27S%20SHIRT%20JACKETS
&type=pageview
&lang=en-GB
&url=https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen%27s-favorite-jacket-thermal-shirt
&can_url=https%3A%2F%2Fwww.documentation.bloomreach.com
&version=cde-ss-v0.1
&client_ts=1747741611000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D14",
"tzo": "-330",
"rand": "0.09787488863036642",
"title": "Men%27s%20Shirt%20Jackets%20%7C%20Thermal%20%26%20Shirts%20%7C",
"user_id": "undefined",
"view_id": "us",
"domain_key": "documentation_site",
"ptype": "category",
"ref": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"cat_id": "cat562401",
"cat": "MEN%27S%20SHIRT%20JACKETS",
"type": "pageview",
"lang": "en-GB",
"url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen%27s-favorite-jacket-thermal-shirt",
"can_url": "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version": "cde-ss-v0.1",
"client_ts": "1747741611000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D14',
tzo: '-330',
rand: '0.09787488863036642',
title: "Men%27s%20Shirt%20Jackets%20%7C%20Thermal%20%26%20Shirts%20%7C",
user_id: 'undefined',
view_id: 'us',
domain_key: 'documentation_site',
ptype: 'category',
ref: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
cat_id: 'cat562401',
cat: "MEN%27S%20SHIRT%20JACKETS",
type: 'pageview',
lang: 'en-GB',
url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen%27s-favorite-jacket-thermal-shirt',
can_url: 'https%3A%2F%2Fwww.documentation.bloomreach.com',
version: 'cde-ss-v0.1',
client_ts: '1747741611000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D14",
"tzo" => "-330",
"rand" => "0.09787488863036642",
"title" => "Men%27s%20Shirt%20Jackets%20%7C%20Thermal%20%26%20Shirts%20%7C",
"user_id" => "undefined",
"view_id" => "us",
"domain_key" => "documentation_site",
"ptype" => "category",
"ref" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"cat_id" => "cat562401",
"cat" => "MEN%27S%20SHIRT%20JACKETS",
"type" => "pageview",
"lang" => "en-GB",
"url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen%27s-favorite-jacket-thermal-shirt",
"can_url" => "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741611000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D14',
'tzo' => '-330',
'rand' => '0.09787488863036642',
'title' => "Men%27s%20Shirt%20Jackets%20%7C%20Thermal%20%26%20Shirts%20%7C",
'user_id' => 'undefined',
'view_id' => 'us',
'domain_key' => 'documentation_site',
'ptype' => 'category',
'ref' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'cat_id' => 'cat562401',
'cat' => "MEN%27S%20SHIRT%20JACKETS",
'type' => 'pageview',
'lang' => 'en-GB',
'url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen%27s-favorite-jacket-thermal-shirt',
'can_url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741611000000',
'client_ip' => '174.34.55.67'
]
]);
Search results page view pixel
curl 'https://p.brsrvr.com/pix.gif
?acct_id=6702
&cookie2=uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D13
&tzo=-330
&rand=0.15233613380055178
&title=Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C
&user_id=undefined
&view_id=us
&domain_key=documentation_site
&ptype=search
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&search_term=womens%20shirt
&type=pageview
&lang=en-GB
&url=https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue
&can_url=https%3A%2F%2Fwww.documentation.bloomreach.com
&version=cde-ss-v0.1
&client_ts=1747741611000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D13",
"tzo": "-330",
"rand": "0.15233613380055178",
"title": "Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
"user_id": "undefined",
"view_id": "us",
"domain_key": "documentation_site",
"ptype": "search",
"ref": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"search_term": "womens%20shirt",
"type": "pageview",
"lang": "en-GB",
"url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue",
"can_url": "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version": "cde-ss-v0.1",
"client_ts": "1747741611000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D13',
tzo: '-330',
rand: '0.15233613380055178',
title: "Women's%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
user_id: 'undefined',
view_id: 'us',
domain_key: 'documentation_site',
ptype: 'search',
ref: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
search_term: 'womens%20shirt',
type: 'pageview',
lang: 'en-GB',
url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue',
can_url: 'https%3A%2F%2Fwww.documentation.bloomreach.com',
version: 'cde-ss-v0.1',
client_ts: '1747741611000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D13",
"tzo" => "-330",
"rand" => "0.15233613380055178",
"title" => "Women's%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
"user_id" => "undefined",
"view_id" => "us",
"domain_key" => "documentation_site",
"ptype" => "search",
"ref" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"search_term" => "womens%20shirt",
"type" => "pageview",
"lang" => "en-GB",
"url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue",
"can_url" => "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741611000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D13',
'tzo' => '-330',
'rand' => '0.15233613380055178',
'title' => "Women's%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
'user_id' => 'undefined',
'view_id' => 'us',
'domain_key' => 'documentation_site',
'ptype' => 'search',
'ref' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'search_term' => 'womens%20shirt',
'type' => 'pageview',
'lang' => 'en-GB',
'url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue',
'can_url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741611000000',
'client_ip' => '174.34.55.67'
]
]);
Conversion page view pixel
curl 'http://p.brsrvr.com/pix.gif
?rand=79069731271669680
&type=pageview
&title=Blue+Lace+Dress
&url=http%3A%2F%2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress
&ref=http%3A%2F%2F2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress
&ptype=conversion
&order_id=12123455
&basket=!ip3458755'nCashemere Sweater'q2'p65.95'msweat345'skusweat345'
&sku=123-45
&acct_id=7241
&domain_key=dk
&view_id=vi
&cookie2=uid%3D4020477034248%3Av%3D12.0%3Ats%3D1705583990631%3Ahc%3D17%26catalogs=cat0%3Dbloomcat
&basket_value=132.95
&catalogs=a
&version=cde-ss-v0.1
&client_ts=1747741611000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "http://p.brsrvr.com/pix.gif"
params = {
"rand": "79069731271669680",
"type": "pageview",
"title": "Blue+Lace+Dress",
"url": "http%3A%2F%2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress",
"ref": "http%3A%2F%2F2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress",
"ptype": "conversion",
"order_id": "12123455",
"basket": "!ip3458755'nCashemere Sweater'q2'p65.95'msweat345'skusweat345'",
"sku": "123-45",
"acct_id": "7241",
"domain_key": "dk",
"view_id": "vi",
"cookie2": "uid%3D4020477034248%3Av%3D12.0%3Ats%3D1705583990631%3Ahc%3D17%26catalogs=cat0%3Dbloomcat",
"basket_value": "132.95",
"catalogs": "a",
"version": "cde-ss-v0.1",
"client_ts": "1747741611000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('http://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
rand: '79069731271669680',
type: 'pageview',
title: 'Blue+Lace+Dress',
url: 'http%3A%2F%2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress',
ref: 'http%3A%2F%2F2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress',
ptype: 'conversion',
order_id: '12123455',
basket: "!ip3458755'nCashemere Sweater'q2'p65.95'msweat345'skusweat345'",
sku: '123-45',
acct_id: '7241',
domain_key: 'dk',
view_id: 'vi',
cookie2: 'uid%3D4020477034248%3Av%3D12.0%3Ats%3D1705583990631%3Ahc%3D17%26catalogs=cat0%3Dbloomcat',
basket_value: '132.95',
catalogs: 'a',
version: 'cde-ss-v0.1',
client_ts: '1747741611000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('http://p.brsrvr.com/pix.gif')
params = {
"rand" => "79069731271669680",
"type" => "pageview",
"title" => "Blue+Lace+Dress",
"url" => "http%3A%2F%2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress",
"ref" => "http%3A%2F%2F2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress",
"ptype" => "conversion",
"order_id" => "12123455",
"basket" => "!ip3458755'nCashemere Sweater'q2'p65.95'msweat345'skusweat345'",
"sku" => "123-45",
"acct_id" => "7241",
"domain_key" => "dk",
"view_id" => "vi",
"cookie2" => "uid%3D4020477034248%3Av%3D12.0%3Ats%3D1705583990631%3Ahc%3D17%26catalogs=cat0%3Dbloomcat",
"basket_value" => "132.95",
"catalogs" => "a",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741611000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'http://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'rand' => '79069731271669680',
'type' => 'pageview',
'title' => 'Blue+Lace+Dress',
'url' => 'http%3A%2F%2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress',
'ref' => 'http%3A%2F%2F2Fbloomcat.test.com%2Fproduct%2Fblue%2520lace%2520dress',
'ptype' => 'conversion',
'order_id' => '12123455',
'basket' => "!ip3458755'nCashemere Sweater'q2'p65.95'msweat345'skusweat345'",
'sku' => '123-45',
'acct_id' => '7241',
'domain_key' => 'dk',
'view_id' => 'vi',
'cookie2' => 'uid%3D4020477034248%3Av%3D12.0%3Ats%3D1705583990631%3Ahc%3D17%26catalogs=cat0%3Dbloomcat',
'basket_value' => '132.95',
'catalogs' => 'a',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741611000000',
'client_ip' => '174.34.55.67'
]
]);
Home page view pixel
curl 'https://p.brsrvr.com/pix.gif
?acct_id=6702
&cookie2=uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12
&tzo=-330
&rand=0.7890476645354053
&title=Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C
&user_id=undefined
&view_id=us
&domain_key=documentation_site
&ptype=homepage
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&type=pageview
&lang=en-GB
&url=https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue
&rc=1
&can_url=https%3A%2F%2Fwww.documentation.bloomreach.com
&version=cde-ss-v0.1
&client_ts=1747741611000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12",
"tzo": "-330",
"rand": "0.7890476645354053",
"title": "Women%27s%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
"user_id": "undefined",
"view_id": "us",
"domain_key": "documentation_site",
"ptype": "homepage",
"ref": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"type": "pageview",
"lang": "en-GB",
"url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue",
"rc": "1",
"can_url": "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version": "cde-ss-v0.1",
"client_ts": "1747741611000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12',
tzo: '-330',
rand: '0.7890476645354053',
title: "Women's%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
user_id: 'undefined',
view_id: 'us',
domain_key: 'documentation_site',
ptype: 'homepage',
ref: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
type: 'pageview',
lang: 'en-GB',
url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue',
rc: '1',
can_url: 'https%3A%2F%2Fwww.documentation.bloomreach.com',
version: 'cde-ss-v0.1',
client_ts: '1747741611000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12",
"tzo" => "-330",
"rand" => "0.7890476645354053",
"title" => "Women's%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
"user_id" => "undefined",
"view_id" => "us",
"domain_key" => "documentation_site",
"ptype" => "homepage",
"ref" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"type" => "pageview",
"lang" => "en-GB",
"url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue",
"rc" => "1",
"can_url" => "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741611000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12',
'tzo' => '-330',
'rand' => '0.7890476645354053',
'title' => "Women's%20Favorite%20Short-sleeve%20Crewneck%20shirt%20%7C",
'user_id' => 'undefined',
'view_id' => 'us',
'domain_key' => 'documentation_site',
'ptype' => 'homepage',
'ref' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'type' => 'pageview',
'lang' => 'en-GB',
'url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fwomen%27s-favorite-short-sleeve-crewneck-t-shirt%3Fsp%3D1%26rrec%3Dtrue',
'rc' => '1',
'can_url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741611000000',
'client_ip' => '174.34.55.67'
]
]);
Event pixels - API call examples
Given below are examples of how you can implement different types of event pixels on the server-side:
Add-to-cart event pixel
curl 'https://p.brsrvr.com/pix.gif
?acct_id=6702
&cookie2=uid%3D4368183202681%3Av%3D16.0%3Ats%3D1747806852549%3Ahc%3D3
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&tzo=-330
&rand=0.2508972110018344
&domain_key=documentation_site
&view_id=925
&orig_ref_url=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&ptype=event
&type=event
&cat=Printer%20Paper
&prod_id=24358116
&sku=24411127
&prod_name=Sheets%2FCarton%20
&group=cart
&etype=click-add
&price=101.99
&quantity=1
&lang=en-GB
&url=https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2sheets-carton-1050ct
&version=cde-ss-v0.1
&client_ts=1747741811000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D4368183202681%3Av%3D16.0%3Ats%3D1747806852549%3Ahc%3D3",
"ref": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"tzo": "-330",
"rand": "0.2508972110018344",
"domain_key": "documentation_site",
"view_id": "925",
"orig_ref_url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"ptype": "event",
"type": "event",
"cat": "Printer%20Paper",
"prod_id": "24358116",
"sku": "24411127",
"prod_name": "Sheets%2FCarton%20",
"group": "cart",
"etype": "click-add",
"price": "101.99",
"quantity": "1",
"lang": "en-GB",
"url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2sheets-carton-1050ct",
"version": "cde-ss-v0.1",
"client_ts": "1747741811000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D4368183202681%3Av%3D16.0%3Ats%3D1747806852549%3Ahc%3D3',
ref: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
tzo: '-330',
rand: '0.2508972110018344',
domain_key: 'documentation_site',
view_id: '925',
orig_ref_url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
ptype: 'event',
type: 'event',
cat: 'Printer%20Paper',
prod_id: '24358116',
sku: '24411127',
prod_name: 'Sheets%2FCarton%20',
group: 'cart',
etype: 'click-add',
price: '101.99',
quantity: '1',
lang: 'en-GB',
url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2sheets-carton-1050ct',
version: 'cde-ss-v0.1',
client_ts: '1747741811000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D4368183202681%3Av%3D16.0%3Ats%3D1747806852549%3Ahc%3D3",
"ref" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"tzo" => "-330",
"rand" => "0.2508972110018344",
"domain_key" => "documentation_site",
"view_id" => "925",
"orig_ref_url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"ptype" => "event",
"type" => "event",
"cat" => "Printer%20Paper",
"prod_id" => "24358116",
"sku" => "24411127",
"prod_name" => "Sheets%2FCarton%20",
"group" => "cart",
"etype" => "click-add",
"price" => "101.99",
"quantity" => "1",
"lang" => "en-GB",
"url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2sheets-carton-1050ct",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741811000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D4368183202681%3Av%3D16.0%3Ats%3D1747806852549%3Ahc%3D3',
'ref' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'tzo' => '-330',
'rand' => '0.2508972110018344',
'domain_key' => 'documentation_site',
'view_id' => '925',
'orig_ref_url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'ptype' => 'event',
'type' => 'event',
'cat' => 'Printer%20Paper',
'prod_id' => '24358116',
'sku' => '24411127',
'prod_name' => 'Sheets%2FCarton%20',
'group' => 'cart',
'etype' => 'click-add',
'price' => '101.99',
'quantity' => '1',
'lang' => 'en-GB',
'url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2sheets-carton-1050ct',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741811000000',
'client_ip' => '174.34.55.67'
]
]);
Search event pixel
curl 'https://p.brsrvr.com/pix.gif
?acct_id=6702
&cookie2=uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&tzo=-330
&rand=0.4505427809598864
&user_id=undefined
&view_id=us
&domain_key=documentation_site
&test_data=false
&ptype=product
&ref=https%3A%2F%2Fwww.documentation.bloomreach.com%2F
&group=suggest
&type=event
&etype=submit
&q=men%20shirt
&lang=en-GB
&url=https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen
&prod_id=prod1234
&prod_name=Men%20Shirt%20
&can_url=https%3A%2F%2Fwww.documentation.bloomreach.com
&version=cde-ss-v0.1
&client_ts=1747741611000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12",
"ref": "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"tzo": "-330",
"rand": "0.4505427809598864",
"user_id": "undefined",
"view_id": "us",
"domain_key": "documentation_site",
"test_data": "false",
"ptype": "product",
"group": "suggest",
"type": "event",
"etype": "submit",
"q": "men%20shirt",
"lang": "en-GB",
"url": "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen",
"prod_id": "prod1234",
"prod_name": "Men%20Shirt%20",
"can_url": "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version": "cde-ss-v0.1",
"client_ts": "1747741611000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12',
ref: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
tzo: '-330',
rand: '0.4505427809598864',
user_id: 'undefined',
view_id: 'us',
domain_key: 'documentation_site',
test_data: 'false',
ptype: 'product',
group: 'suggest',
type: 'event',
etype: 'submit',
q: 'men%20shirt',
lang: 'en-GB',
url: 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen',
prod_id: 'prod1234',
prod_name: 'Men%20Shirt%20',
can_url: 'https%3A%2F%2Fwww.documentation.bloomreach.com',
version: 'cde-ss-v0.1',
client_ts: '1747741611000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12",
"ref" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2F",
"tzo" => "-330",
"rand" => "0.4505427809598864",
"user_id" => "undefined",
"view_id" => "us",
"domain_key" => "documentation_site",
"test_data" => "false",
"ptype" => "product",
"group" => "suggest",
"type" => "event",
"etype" => "submit",
"q" => "men%20shirt",
"lang" => "en-GB",
"url" => "https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen",
"prod_id" => "prod1234",
"prod_name" => "Men%20Shirt%20",
"can_url" => "https%3A%2F%2Fwww.documentation.bloomreach.com",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741611000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D8100391390189%3Av%3D12.0%3Ats%3D1744128139334%3Ahc%3D12',
'ref' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2F',
'tzo' => '-330',
'rand' => '0.4505427809598864',
'user_id' => 'undefined',
'view_id' => 'us',
'domain_key' => 'documentation_site',
'test_data' => 'false',
'ptype' => 'product',
'group' => 'suggest',
'type' => 'event',
'etype' => 'submit',
'q' => 'men%20shirt',
'lang' => 'en-GB',
'url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com%2Fp%2F20902475%2Fmen',
'prod_id' => 'prod1234',
'prod_name' => 'Men%20Shirt%20',
'can_url' => 'https%3A%2F%2Fwww.documentation.bloomreach.com',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741611000000',
'client_ip' => '174.34.55.67'
]
]);
Suggest event pixel
curl 'https://p.brsrvr.com/pix.gif?
acct_id=6702
&cookie2=uid%3D1e7724c751a3f6e6241018d150144832e7528383%3Av%3Dapp%3Ats%3D0%3Ahc%3D1
&rand=86838131966165760
&type=event
&title=Home
&url=http%3A%2F%2Fmerchantname.app%2Fhomepage
&ref=http%3A%2F%2Fmerchantname.app%2Fcategory%2Fdresses
&group=suggest
&etype=click
&ptype=homepage
&q=blue%20lace%20dress
&aq=blu
&version=cde-ss-v0.1
&client_ts=1747741611000000
&client_ip=174.34.55.67' \
-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
import requests
url = "https://p.brsrvr.com/pix.gif"
params = {
"acct_id": "6702",
"cookie2": "uid%3D1e7724c751a3f6e6241018d150144832e7528383%3Av%3Dapp%3Ats%3D0%3Ahc%3D1",
"rand": "86838131966165760",
"type": "event",
"title": "Home",
"url": "http%3A%2F%2Fmerchantname.app%2Fhomepage",
"ref": "http%3A%2F%2Fmerchantname.app%2Fcategory%2Fdresses",
"group": "suggest",
"etype": "click",
"ptype": "homepage",
"q": "blue%20lace%20dress",
"aq": "blu",
"version": "cde-ss-v0.1",
"client_ts": "1747741611000000",
"client_ip": "174.34.55.67"
}
headers = {
"user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36"
}
response = requests.get(url, params=params, headers=headers)
const fetch = require('node-fetch');
const url = new URL('https://p.brsrvr.com/pix.gif');
url.search = new URLSearchParams({
acct_id: '6702',
cookie2: 'uid%3D1e7724c751a3f6e6241018d150144832e7528383%3Av%3Dapp%3Ats%3D0%3Ahc%3D1',
rand: '86838131966165760',
type: 'event',
title: 'Home',
url: 'http%3A%2F%2Fmerchantname.app%2Fhomepage',
ref: 'http%3A%2F%2Fmerchantname.app%2Fcategory%2Fdresses',
group: 'suggest',
etype: 'click',
ptype: 'homepage',
q: 'blue%20lace%20dress',
aq: 'blu',
version: 'cde-ss-v0.1',
client_ts: '1747741611000000',
client_ip: '174.34.55.67'
}).toString();
fetch(url, {
headers: {
'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
}
}).then(res => res.arrayBuffer());
require 'net/http'
require 'uri'
uri = URI('https://p.brsrvr.com/pix.gif')
params = {
"acct_id" => "6702",
"cookie2" => "uid%3D1e7724c751a3f6e6241018d150144832e7528383%3Av%3Dapp%3Ats%3D0%3Ahc%3D1",
"rand" => "86838131966165760",
"type" => "event",
"title" => "Home",
"url" => "http%3A%2F%2Fmerchantname.app%2Fhomepage",
"ref" => "http%3A%2F%2Fmerchantname.app%2Fcategory%2Fdresses",
"group" => "suggest",
"etype" => "click",
"ptype" => "homepage",
"q" => "blue%20lace%20dress",
"aq" => "blu",
"version" => "cde-ss-v0.1",
"client_ts" => "1747741611000000",
"client_ip" => "174.34.55.67"
}
uri.query = URI.encode_www_form(params)
req = Net::HTTP::Get.new(uri)
req['user-agent'] = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
response = http.request(req)
end
<?php
require 'vendor/autoload.php';
$client = new \GuzzleHttp\Client();
$response = $client->request('GET', 'https://p.brsrvr.com/pix.gif', [
'headers' => [
'user-agent' => 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36'
],
'query' => [
'acct_id' => '6702',
'cookie2' => 'uid%3D1e7724c751a3f6e6241018d150144832e7528383%3Av%3Dapp%3Ats%3D0%3Ahc%3D1',
'rand' => '86838131966165760',
'type' => 'event',
'title' => 'Home',
'url' => 'http%3A%2F%2Fmerchantname.app%2Fhomepage',
'ref' => 'http%3A%2F%2Fmerchantname.app%2Fcategory%2Fdresses',
'group' => 'suggest',
'etype' => 'click',
'ptype' => 'homepage',
'q' => 'blue%20lace%20dress',
'aq' => 'blu',
'version' => 'cde-ss-v0.1',
'client_ts' => '1747741611000000',
'client_ip' => '174.34.55.67'
]
]);
Testing and validation
Test the pixel integration with debug pixels on your production environment to verify the Pixel API calls on all integrated page views and events. Check the integrity of all the data received.
Note
Pass the
debug=truequery parameter in the test API calls to track debug events in the Integration mode of Event diagnostics. These events are treated as test data and don't affect the live search, reporting, or analytics.
Use the Pixel validator Chrome browser extension to validate your integration. The following issues in the validator directly highlight problems with your server-side pixel parameters, and such events are discarded:
version- Events with invalid "Version"
- Events with missing "Version"
client_ip- Events with invalid "Client IP"
- Events with missing "Client IP"
client_ts- Events with invalid "Client TS"
- Events with missing "Client TS"
user-agent- Events with invalid "User Agent"
- Events with missing "User Agent"
Warning
Sending the same event from both client-side and server-side creates data quality issues that corrupt your analytics. Never run both tracking methods simultaneously for more than a few hours as it can impact your search performance and analytics reporting.
Once you are satisfied with the implementation, use the Event diagnostics tool in the Bloomreach dashboard to monitor the events coming in the Integration mode. Check the events stream for the server-side pixels, and review any detected issues in individual event types.
Updated about 6 hours ago