Pixels for WordPress: Documentation

Λογισμικό: Pixels

Πλατφόρμα: WordPress
Audience Measurements for Meta/Facebook Advertising. Open Source WordPress Plugin.
WordPress Meta Pixel Integration: Measure, optimize, and build audiences for GDPR-compliant ad campaigns. Learn More.
The documentation is also available within the application by using the Documentation button, or by hovering the mouse over help points.


Quick Start


Welcome to Eorisis Pixels for WordPress! For initial installation, install the plugin through the Plugins > Add Plugins > Upload Plugin section in WordPress. After installation the ID of your Meta Pixel is not set. Insert the ID of your Meta Pixel into the corresponding field in the Meta Pixel section.


Installation & Updates


The downloadable package zip file can be used as an initial install or as an update without the need to uninstall the previous version. Once you have downloaded the zip file, login to your WordPress backend Dashboard area and navigate to the Plugins > Add Plugins > Upload Plugin section from the left menu. Then click the Browse button, select the zip file and click Install Now.

IMPORTANT:
The zip file is intended to be used as-is at the WordPress installer.
1. DO NOT unzip/extract or upload separate files that are included in the package in order to perform an install or update.
2. DO NOT rename the zip file, or the destination directory of the plugin in the WordPress /wp-content/plugins/ directory.
Doing so may lead to errors.

Always take a backup of your website before you install any plugin.



Απεγκατάσταση


To uninstall the plugin, always use your WordPress Plugins area from the left menu. Find the plugin in the list, click Deactivate and then Delete. This will remove the plugin properly.



Adblock Notice


Users employing browser plugins, such as Adblock, may encounter issues, such as an empty advertising sections or buttons. It is important to note that this occurrence is not a flaw in the application but rather an outcome of browser plugins identifying keywords associated with ads/advertising on pages. In such instances, it is recommended to whitelist your domain within Adblock or deactivate the respective browser plugins. You are also encouraged to report any such case to our support so that we can provide solutions with updates.


Updates


Authorization Code
The Authorization Code is required for the Pro edition in order to get live updates. To install updates using the Eorisis Setup plugin for WordPress, insert your Authorization Code in the corresponding field in the Updates section of the plugin. Get your Authorization Code from your Eorisis account - Subscriptions & Renewals - page on eorisis.com.


Meta Pixel

Global options for Meta Pixel.

Enabled
(On / Off)


Integrate with Eorisis Consent
(On / Off)
Enables full communication between Eorisis Pixels and Eorisis Consent. For more information on Eorisis Consent, please visit the application page on eorisis.com.


Pixel ID
Get your Pixel ID from your Meta/Facebook's Business settings > Data sources > Datasets, or Ads Manager > All Tools > Events Manager. It looks like this: 139544101993912.
Note: You have to create at least one Pixel on Meta/Facebook to get the ID, then set it in this field.


Automatic Configuration
(On / Off)
The Meta Pixel will send button click and page metadata (such as data structured according to Opengraph or Schema.org formats) from your website to improve your ads delivery and measurement and automate your Pixel setup. To configure the Meta Pixel to not send this additional information, turn this off.


Agent
Include the agent string in every pixel fire. The string helps Meta systems analyze downstream pixel traffic.


Code Position
(Start of Head / End of Head / Start of Body / End of Body)
Default: End of Head (Recommended)
One of the main advantages of the asynchronous snippet is that you can position it at the top of the HTML document. This increases the likelihood that the tracking beacon will be sent before the user leaves the page. It is customary to place JavaScript code in the HEAD section, and we recommend placing the snippet at the bottom of the section for best performance.

Note that the noscript code will always be placed at the end of the body.


NoScript Tag
Default: On
Select whether to place the noscript tag at the end of the body of the page.


DNT Support
(On / Off)
Do Not Track (DNT) is an HTTP header sent by the client software to prevent tracking by web services. It requests the web application to disable tracking. When enabled and a visitor sends the DNT header, the application will abort for the particular visitor. No connection to the Meta servers will occur, thus, the visitor will not be tracked.


Traffic Filters


Filters
Control the application of traffic filters created within the Traffic Filters section.


Traffic Filters

Create, manage, and add filters to be used in Meta Pixels.

General


Enabled
(On / Off)
Enable or disable this filter.


Title
Set a title for the list in the backend. It will not be used in the generated HTML.


Category
The category that this item is assigned to.


Active On
(Everyone / Logged out users / Logged in users)
Choose which types of users this item will be active on.


Filter


Filter Action
(Exclude / Include Only)
Choose the action for this filter. Remember that when a filter is set to 'Include Only', the item will display only if all the filter settings qualify.


Filter Type
Choose the type of incoming traffic for this filter.

IP Address: You can specify an IPv4 or IPv6 IP address.
CIDR: You can specify a CIDR (Classless Inter-Domain Routing) in both IPv4 or IPv6.
Hostname: Specify a hostname. Remember that a hostname lookup could impact performance.
User Agent: Specify a User-Agent string.
Referrer: Specify a referrer URL.
Country: Specify a country. (Requires Cloudflare)
Local Server: Exclude or include only traffic from the local server.
LAN: Exclude or include only traffic from the local area network.
Cloudflare: Exclude or include only traffic from the Cloudflare CDN. Note that this specifically applies to traffic originating from visitors whose IP addresses are associated with Cloudflare.
TOR: Exclude or include only traffic from the TOR network. This applies to traffic originating from visitors using TOR. It uses the official bulk exit list with local caching.


Filter Condition
Determine the criteria for this filter's decision process.

Equals: Apply this filter on pages where the Filter Type is the same as the given string.
Contains: Apply this filter on pages where the Filter Type contains the given string.
Starts with: Apply this filter on pages where the Filter Type starts with the given string.
Ends with: Apply this filter on pages where the Filter Type ends with the given string.
Does not equal: Apply this filter on pages where the Filter Type is not the same as the given string.
Does not contain: Apply this filter on pages where the Filter Type does not contain the given string.
Does not start with: Apply this filter on pages where the Filter Type does not start with the given string.
Does not end with: Apply this filter on pages where the Filter Type does not end with the given string.


Case Sensitive
(On / Off)
Enable or disable sensitivity to letter case in comparisons.


IP Address
You can specify an IPv4 or IPv6 IP address.


CIDR
You can specify a CIDR (Classless Inter-Domain Routing) in both IPv4 or IPv6.


Hostname
Specify a hostname. Remember that a hostname lookup could impact performance.


User Agent
Specify a User-Agent string.


Referrer
Specify a referrer URL.


Country
Specify a country. (Requires Cloudflare)


Local Server
Exclude or include only traffic from the local server.


LAN
Exclude or include only traffic from the local area network.


Cloudflare
Exclude or include only traffic from the Cloudflare CDN. Note that this specifically applies to traffic originating from visitors whose IP addresses are associated with Cloudflare.


TOR
Exclude or include only traffic from the TOR network. This applies to traffic originating from visitors using TOR. It uses the official bulk exit list with local caching.


Traffic Filter Categories

Items can be organized in categories.
Enabled
(On / Off)
Enable or disable this category.


Title
Set a title for the list in the backend. It will not be used in the generated HTML.


Active On
(Everyone / Logged out users / Logged in users)
Choose which types of users this item will be active on.


Preferences

Global Preferences.

General


HTML5
Default: On
Enable HTML5 to support modern elements and functionality, or disable it to revert to older HTML standards in case your WordPress template is old.


Notifications

Display notifications in the administration area.
If the application detects any kind of misconfiguration, it will display a notification in the Dashboard or a specific section of the application.


Quick Start
(On / Off)
Display a notification in the administration area. You can safely turn it off.

Adblock
(On / Off)
Display a notification in the administration area. You can safely turn it off.

Pixel ID
(On / Off)
Display a notification in the administration area. If the application detects any kind of misconfiguration, it will display a notification in the backend for you. It is recommended to keep this On.

Setup Plugin
(On / Off)
Display a notification in the administration area. If the application detects any kind of misconfiguration, it will display a notification in the backend for you. It is recommended to keep this On.

cURL
(On / Off)
Display a notification in the administration area. If the application detects cURL missing on your server, it will display a notification in the backend for you. It is recommended to keep this On.

ZipArchive
(On / Off)
Display a notification in the administration area. If the application detects ZipArchive missing on your server, it will display a notification in the backend for you. It is recommended to keep this On.


Notes


The position of the noscript element of the official Meta Pixel code
The Meta Pixel code uses an alternative noscript element which includes an img element in order for measurements to work on browsers with JavaScript disabled. The official suggested code given by Facebook places this in the head section of the document. In general it is not allowed to place a noscript element in the head section according to the XHTML Strict DTD which allows only script, style, meta, link, object, title and base. It is invalid HTML even in HTML5. For this reason our application places the noscript element at the end of the body section of the document.