Shortcodes

In order to be able to track leads as conversions, the plugin provides shortcodes. They need to be added to the thankyou pages to which lead forms redirect to after a form submission.

Additionally there is one shortcode for the view-item event. It would be typically used on custom made product pages, where WooCommerce can’t determine if it is a product page and therefore the plugin can’t automatically inject the necessary scripts for the view-item event. (The view-item event is equals to the ViewContent event in Meta (Facebook), etc.)

Examples

↑ Back to top

[conversion-pixel pixel="google-ads" gads-conversion-label="abcdefg"]

[conversion-pixel pixel="facebook"]

[conversion-pixel pixel="facebook" fbc-event="Schedule"]

[conversion-pixel pixel="twitter"]

[conversion-pixel pixel="twitter" twc-event="Signup"]

[conversion-pixel pixel="ms-ads"]

[conversion-pixel pixel="pinterest"]

[conversion-pixel pixel="pinterest" pinc-event="Signup"]

[conversion-pixel pixel="pinterest" pinc-event="Signup" pinc-lead-type="test-type"]

[conversion-pixel pixel="snapchat" snap-event="SIGN_UP"]

[conversion-pixel pixel="tiktok" tiktok-event="SubmitForm"]

[conversion-pixel pixel="all" gads-conversion-label="aabbcc"]

[conversion-pixel pixel="all" gads-conversion-label="aabbccdd" fbc-event="Schedule" twc-event="Signup" pinc-event="Signup" pinc-lead-type="test-type" snap-event="SIGN_UP" tiktok-event="SubmitForm"]

[view-item pixel-id="14"]

General Instructions

↑ Back to top

The only required parameter for all use cases is pixel. With this parameter you can choose which conversion pixel to fire, or, if you want to fire all of them.

pixel="google-ads"

pixel="all"

All pixels use default parameters that can be overridden.

Google Ads

↑ Back to top

For each Google Ads conversion you need to set the gads-conversion-label. It is the only required parameter for a Google Ads lead conversion.

[conversion-pixel pixel="google-ads" gads-conversion-label="abcdefg"]

If you need to you can also set the gads-conversion-id as an additional parameter. If you omit that parameter, the plugin will automatically use the conversion ID which is set in the plugin.

Meta (Facebook)

↑ Back to top

For the Meta (Facebook) lead conversion shortcode there are no required parameters other than the pixel parameter. By default the event type is being reported as Lead.

[conversion-pixel pixel="facebook"]

In order to override the default event you can set the fbc-event parameter.

[conversion-pixel pixel="facebook" fbc-event="Schedule"]

Microsoft Ads

↑ Back to top

For the Mircrosoft Ads lead conversion shortcode there are no required parameters other than the pixel parameter. By default the event is being reported as submit and the event label as lead.

[conversion-pixel pixel="ms-ads"]

You can set an override all of the following parameters:

ms-ads-event

ms-ads-event-category

ms-ads-event-label

ms-ads-event-value

Twitter

↑ Back to top

For the Twitter lead conversion shortcode there are no required parameters other than the pixel parameter. By default the event is being reported as CompleteRegistration.

[conversion-pixel pixel="twitter"]

In order to override the default event you can set the twc-event parameter.

[conversion-pixel pixel="twitter" twc-event="Signup"]

Pinterest

↑ Back to top

For the Pinterest lead conversion shortcode there are no required parameters other than the pixel parameter. By default the event is being reported as lead.

[conversion-pixel pixel="pinterest"]

In order to override the default event you can set the pinc-event parameter.

[conversion-pixel pixel="pinterest" pinc-event="signup"]

Additionally you can set the lead-type parameter which is empty by default:

[conversion-pixel pixel="pinterest" pinc-event="signup" pinc-lead-type="New release promotion"]

Snapchat

↑ Back to top

For the Snapchat lead conversion shortcode there are no required parameters other than the pixel parameter. By default the event is being reported as SIGN_UP.

[conversion-pixel pixel="snapchat"]

In order to override the default event you can set the snap-event parameter.

[conversion-pixel pixel="snapchat" snap-event="SIGN_UP"]

TikTok

↑ Back to top

For the TikTok lead conversion shortcode there are no required parameters other than the pixel parameter. By default the event is being reported as SubmitForm.

[conversion-pixel pixel="tiktok"]

In order to override the default event you can set the tiktok-event parameter.

[conversion-pixel pixel="tiktok" tiktok-event="SubmitForm"]

view-item shortcode

↑ Back to top

The view-item shortcode fires all enabled pixels with their own view-item event, including all product information. That shortcode is necessary on custom made product pages where WooCommerce can’t detect that it is a product page and therefore our plugin can’t automatically inject the necessary scripts for the view-item event.

In order to fire the view-item event on a custom product page add the following shortcode:

[view-item product-id="14"]

The product-id must contain the post ID of the product where all product information is stored.