Pinterest for WooCommerce

Pinterest for WooCommerce connects your WooCommerce store to Pinterest to help people discover your eCommerce shop. You can promote your products on Pinterest and measure the results of the actions customers take on your website.

With this plugin, you can:

• Sync your WooCommerce catalog to Pinterest to let customers browse products from your Pinterest shop.
• Add the Save to Pinterest button to let customers create full-featured Pins from your products.
• Install the Pinterest tag to track events and conversions.

If you don’t have Pinterest for WooCommerce installed, you can install and activate the plugin:

1. Go to Plugins > Add New and search for Pinterest for WooCommerce.
2. Click Install Now and then Activate.
3. Go to Marketing > Pinterest and follow the instructions in this document to learn how to set up the plugin.

Head to Marketing > Pinterest, then click Get started and follow the steps below.

If you don’t have a Pinterest business account, click on Create a new Pinterest account. You’ll be taken to Pinterest in a new tab to create a business account that you can use to continue.

Once you have a Pinterest business account you intend to use, click Connect. You’ll be taken to Pinterest, and asked to log in if you haven’t already.

If you try to log in with a personal Pinterest account linked with a Business account, you will automatically connect to the linked Business account. Otherwise, you will be given the option to Create a new Business Account or Convert your Personal Account to a Business account.

You’ll be asked to grant the plugin permission to access your Pinterest business account. Follow the prompts to Give access.

Verify your Business ID details.

Confirm your Catalogue

Select your ads account. If you don’t have an ad account, you will be prompted to create one. Do create an ads account for the specific country you wish to target. If you have an ads account, it will be listed and you can select the same.

Setup the conversion tracking tags.

Confirm Pinterest app connections to Pinterest For WooCommerce

Select the permission to start claiming the website.

Wait a few seconds while your website domain is linked to your Pinterest business account. After successful verification, click on complete setup to complete the setup. If another user has claimed the domain, you’ll get an error message and won’t be able to continue.

At any time after completing the initial setup, you can head up to Marketing > Pinterest, and then to the Connection tab, to find a summary and even change some options.

After changing any settings, scroll to the bottom and click Save changes.

Linked account

In this section, you can identify the Pinterest business account connected to the store, disconnect it, and set up a different one. Disconnecting an account will delete all feeds on that Pinterest account.

Billing Status

Setup billing to ensure ads can be placed through your ads account.

Verified domain

In this section, you can identify the domains that are linked to the connected Pinterest business account.

Track conversions with the Pinterest tag

In this section, you can identify and change the Advertiser and Tracking Tag that you are using.

After completing the initial setup, you’ll be taken to the main settings page. You can get there at any time by going to Marketing > Pinterest, and then to the Settings tab.

Options: 

1. Product Sync > Enable Product Sync – Enabled by default
2. Tracking > Track conversions – Enabled by default
3. Tracking > Enhanced Match support – Enabled by default (Automatically disabled if “Track conversions” is disabled)
4. Rich Pins > Add Rich Pins for Products – Enabled by default
5. Rich Pins > Add Rich Pins for Posts – Enabled by default
6. Save to Pinterest > Save to Pinterest – Enabled by default
7. Debug Logging > Enable Debug Logging
8. Plugin Data > Erase Plugin Data 

Sync your WooCommerce catalog to Pinterest

When Enable Product Sync is enabled, the Pinterest for WooCommerce extension will automatically synchronize the products in your WooCommerce and Pinterest catalogs.

To enable this feature:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Set up Product Sync group, then the Product Sync subgroup.
3. Check the Enable Product Sync setting (enabled by default).
4. Scroll down to the bottom and click Save changes.

Add the Save to Pinterest button

The Pinterest for WooCommerce extension can make it really easy for your customers to save your product pins to their own Pinterest boards from your product, post and archive pages.

To enable this feature:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Publish Pins and Rich Pins group, then the Save to Pinterest subgroup.
3. Check the Save to Pinterest setting (enabled by default).
4. Scroll down to the bottom and click Save changes.

With this setting enabled, the Save to Pinterest button is added to your WooCommerce products. Customers who click on it are offered to pin the product or post to a Pinterest board of their choice.

Rich pins

Products and posts can be enriched with metadata, in order to offer more relevant actions when pinned to customers’ Pinterest boards:

• WooCommerce products can be rendered as product rich pins.
• WordPress posts can be rendered as article rich pins.

To enable this enhancement:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Publish Pins and Rich Pins group, then the Rich Pins subgroup.
3. Check all the specific Add Rich Pins settings that you need (enabled by default).

Scroll down to the bottom and click Save changes.

It is possible to expose OpenGraph metadata for products and posts to enable Rich Pins. Metadata passes validation in Pinterest Rich Pins Validator.

Example for a product:

<meta property="og:url" content="https://<<URLsite>>/product/beanie/">
<meta property="og:site_name" content="Mass Grasshopper">
<meta property="og:title" content="Beanie">
<meta property="og:type" content="og:product">
<meta property="og:image" content="https://<<URLsite>>/wp-content/uploads/2021/11/beanie.jpg">
<meta property="product:price:currency" content="USD">
<meta property="product:price:amount" content="18">
<meta property="og:price:standard_amount" content="20">
<meta property="og:description" content="Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum tortor quam, feugiat vitae, ultricies eget, tempor sit amet, ante. Donec eu libero sit amet quam egestas semper. Aenean ultricies mi vitae est. Mauris placerat eleifend leo.">
<meta property="og:availability" content="instock">

Example for a Post:

<meta property="og:url" content="https://<<URLsite>>/2021/11/08/hello-world/">
<meta property="og:site_name" content="Mass Grasshopper">
<meta property="og:type" content="article">
<meta property="og:title" content="Hello world!">
<meta property="og:description" content="Welcome to WordPress. This is your first post. Edit or delete it, then start writing!">
<meta property="article:published_time" content="2021-11-08T11:12:15+00:00">
<meta property="article:author" content="demo">

Install the Pinterest Tag

The Pinterest for WooCommerce extension can easily allow you to track the events and conversions that help you understand how customers are interacting with your website.

To enable this feature:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Publish Pins and Rich Pins group, then the Tracking subgroup.
3. Check the Track conversions setting (enabled by default).
4. Scroll down to the bottom and click Save changes.

The Pinterest tag code is added to relevant pages of your website. Then, you can set up and follow conversions from your Pinterest business account, on the specific advertiser that is configured in Ads > Conversions.

Examples:

• Page Visit: Should send the event every time the user visits a page

<script>pintrk( 'track', 'pagevisit', );</script>

• View Category: This should send the event every time a user visits a category page.

<script>pintrk( 'track', 'ViewCategory' , {"product_category":16,"category_name":"Accessories"},); </script>

• Search: This should send the event every time a user searches for something on the page. 

<script>pintrk('track', 'search', {search_query: 'hoodie'},);</script>

• Add to Cart: The event should be sent every time user adds product to the cart from Shop/Category/Product page

<script>pintrk('track', 'AddToCart', {product_id: 10,order_quantity: 1,});</script>

• Checkout: The event should be sent every time User places an order. 

<script>pintrk( 'track', 'checkout' , {"order_id":45,"value":"220.00","order_quantity":4,"currency":"USD","line_items":[{"product_id":3,"product_name":"Belt","product_price":"55","product_quantity":3,"product_category":["Accessories"]},{"product_id":4,"product_name":"Hoodie with Logo","product_price":"45","product_quantity":1,"product_category":["Hoodies"]}]});</script>

Tip: Need to see if/when these events are firing properly? Use the Pinterest Tag Helper Chrome extension.

Enhanced match support

You can increase the accuracy of your tracking by leveraging Pinterest’s Enhanced match feature.

To enable this enhancement:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Publish Pins and Rich Pins group, then the Tracking subgroup.
3. Check the Enhanced Match support setting (enabled by default). (This field will be disabled if “Tracking conversions” is disabled.)

Scroll down to the bottom and click Save changes.

Enhanced Match is used when: 

• The user is logged in to the site
• Cookies saved on the browser After placing the order (Guests users)

It adds a hashed email to the Tracking Conversion event so it can be matched on Pinterest

pintrk('load', '2613101893693', { em: '8302f4115fded8c3885dbc5cc115fe90' });

If you disable product sync, the feed will be deleted from the site but not from the Pinterest account.

Technical log

You can keep a detailed log of what the plugin does. This is especially useful when contacting Customer Support for assistance.

To enable this feature:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Advanced Settings group, then the Debug Logging subgroup.
3. Check the Enable Debug Logging setting.

Scroll down to the bottom and click Save changes.

Clean uninstall

You can ensure no related data will remain on your website when uninstalling the plugin.

To enable this feature:

1. Head to Marketing > Pinterest, then to the Settings tab.
2. Find the Advanced Settings group, then the Debug Logging subgroup.
3. Check the Erase Plugin Data setting.
4. Scroll down to the bottom and click Save changes.

A data feed with information from your WooCommerce products is automatically generated and maintained. Pinterest fetches it regularly and updates the catalog in your business account.

You can see the status of the sync (along with any errors or required actions) at any time by heading to Marketing > Pinterest, and then to the Catalog tab.

Please note that the first synchronization can take up to 24 hours.

If everything is working well, you will find your WooCommerce products in the catalog of your Pinterest business account.

Starting version v1.2.9 the plugin product feed file includes the following product types by default:

• Simple product.
• Variation products (a corresponding parent Variable product is not included since version v1.0.9).

The plugin product feed file excludes the following product types (since v1.2.9):

• Grouped products.
• Subscription products.

Please, note that included/excluded product types can be modified by using pinterest_for_woocommerce_included_product_types and pinterest_for_woocommerce_excluded_product_types filters. The filter to exclude product types takes precedence over the include filter (since v1.2.9)

The Pinterest plugin will add 2 fields to the products page for simple products: Condition and Google Category. These fields are not required by Pinterest but if they are not filled they will show a Warning message on Catalog Tab (Alert message).

For variable products, the Pinterest tab will be added to the main product (parent) containing the Google category. Product condition will be added to each product variation.

The Pinterest Condition and Google Category attribute available on the Pinterest tab of the product editing screen can be bulk edited via CSV. The steps involve exporting products using the built-in Product CSV Importer and Exporter, adding the Condition and the Google Category information in the CSV, and then using it to update existing products on the site. Here are the steps:

1. Assign the condition and Google product category to one product directly on your site in the Pinterest tab of the product editing screen. (The product column will serve as a guide in the CSV)

2. Navigate to WooCommerce > Products, and click ‘Export’ at the top

3. Select the column, product type, and category of products you wish to export (Leave the default settings to export all products and columns)

4. On the export screen, select `Yes, export all custom meta’:

5. Select ‘Generate CSV’ and wait for the export to finish

6. Open and edit the CSV using the recommended editors

7. Locate the column with the label Meta: _wc_pinterest_condition and Meta: _wc_pinterest_google_product_category and use the product you assigned the condition and Google product category on the site as a guide to assign the attributes to all products.

8. Save the CSV file and update the existing products using it.

Pinterest For WooCommerce supports mapping of WooCommerce shipping settings to Pinterest products shipping costs. Because both systems operate on different rules the mapping is not perfect, still it allows a granular and fine-tuned setting. Free Shipping and Flat Rate Shipping methods are supported, with certain limitations.

When the products are synced to ( check Sync your WooCommerce catalog to Pinterest for more information ) the shipping information gets extracted from the WooCommerce shipping settings and added to the synchronized products.

The following Free shipping requires... settings are supported:

• N/A
• A minimum order amount – The minimum order amount is calculated against the value of a single product.

The Flat Rate Shipping method is supported with shipping classes and no class costs settings.

Zones with continents, countries, and regions are supported. Zones with zip postcodes are discarded. If the zone defines a country or a number of countries that are not supported the not supported countries will not be present in the shipping configuration. The remaining supported countries will be added to the configuration.

Please check the Pinterest documentation for the list of supported countries https://help.pinterest.com/en/business/availability/shopping-availability

Disconnecting your website from or switching between Pinterest accounts currently needs to be done from the Pinterest side. If this feature affects you, we’d like to hear from you; please contact Support to let us know.

To disconnect or switch Pinterest accounts, follow the instructions below:

1. Log on to Pinterest.com
2. Click the down arrow next to your profile avatar visible top right
3. Select Settings > Claimed Accounts
4. Next to the website you want to disconnect, click Unclaim

The following product types are supported:

• simple
• variable

All Products for WooCommerce Subscriptions products are partially supported:

• One-time purchase products are fully supported
• Products with recurring subscription options are not supported
• Products that are subscription-only are not supported

The following products aren’t supported by default and are not synced:

1. Grouped products
2. Hidden/private/draft products
3. Products in the trash
4. Out-of-stock products will be excluded if Hide out of stock products from the catalog is enabled in WooCommerce > Settings > Products > Inventory.
5. Parent products of the variable product (only should be present the variables)
6. Free or 0-price products
7. Subscription products

Included/excluded product types can be modified using the pinterest_for_woocommerce_included_product_types and pinterest_for_woocommerce_excluded_product_types filters. The filter to exclude product types takes precedence over the include filter.

Note that we provide this information to help you in the right direction; we can’t offer customization support.

Pinterest flags the tag health as unhealthy if a checkout event isn’t detected on the site in a couple of days:

For the checkout event to be triggered, the order must require a payment – Pinterest doesn’t support “0” checkouts, so they don’t count for checkout events. This means you need to have customers checking out with paid products to avoid your tag health being flagged as unhealthy.

If your tag is health is being flagged as unhealthy, to confirm that your Pinterest tag is working as expected and to trigger checkout events to clear the unhealthy tag errors, follow these steps:

1. Add the Pinterest Tag Helper Chrome extension to your browser if you haven’t yet.
2. Visit your site in Chrome and view the red Pin icon in your browser and a gray number registering events to ensure the tag is installed.
3. Enable test mode in your payment gateway or enable a gateway like Bank Transfer or Check Payments
4. Add a product to your cart, and proceed to checkout. (Do not use a coupon to zero out the purchase total)
5. Click on the Pin icon extension to see more details about the events.
6. Confirm that the Checkout event registers with a green check and message that it was sent successfully:

This will ensure Pinterest gets data from your site to mark your tag as healthy. After testing, be sure to disable test mode in your payment gateway and cancel the orders to prevent fulfilment. If you don’t have an order for some time, you’d have to repeat this to tell Pinterest that the tag is still active and working.

If you perform the steps and find your checkout events aren’t being triggered, please contact our Happiness Engineers for assistance.

The following WooCommerce data is synced to the Pinterest catalog:

An XML feed file with the products is generated at /wp-content/uploads/pinterest-for-woocommerce-xxxxxx.xml The feed URL can be found in Marketing > Pinterest > Catalog tab:

Notes:

1. The Pinterest feed file is updated every 10 minutes in WooCommerce. The hook pinterest-for-woocommerce-handle-sync is used for the update and can be triggered manually in WooCommerce > Status > Scheduled Actions if you wish to trigger the feed update immediately.
2. While the feed file update happens every 10 minutes in WooCommerce, Pinterest ingests the feed every 24 hours to update the feed/products on Pinterest.
3. The Feed file URL ID changes every time “Enable Product Sync” is disabled and re-enabled in Pinterest settings. (Marketing > Pinterest > Settings)
4. The description field will be filled with “Short description” if the description is not present. Variable products need to have the Description of each variable so they have it on the feed.

First, make sure that Enable Product Sync is enabled in the extension’s settings page in Marketing > Pinterest > Settings (tab). Product sync is enabled by default.

Typically, the feed file is updated every 10 mins in WooCommerce and pulled by Pinterest every 24 hours to update the catalog on Pinterest. If you find your feed isn’t pulled every 24 hours, please restart the catalog following these steps:

1. Go to Marketing > Pinterest > Settings
2. Uncheck the box for “Enable product sync”
3. Check the box “Erase Plugin Data” and Save
4. Go to the Connection tab on ​Marketing > Pinterest and disconnect your account by clicking on “Disconnect”
5. Deactivate and delete the “Pinterest for WooCommerce” extension.
   — At this point, no feed should be present on /wp-content/uploads, no settings on the table wp-options, no Scheduled actions related to Pinterest, and no feed registered on Pinterest—
6. Reinstall “Pinterest for WooCommerce” in Plugins > Add new
7. Restart the Pinterest onboarding
8. Wait for 24 hours for Pinterest to approve the catalog

If that doesn’t help, please check with Pinterest that there’s no issue with your account and contact our Happiness Engineers for further assistance

Make sure that the site is not hidden behind a coming soon or maintenance page. Pinterest will not be able to read the meta tag to confirm ownership unless the site is public.

If the website is claimed on another Pinterest account, it can’t be claimed again. Confirm that you’ve connected the correct Pinterest account, or unclaim the website on the previous account. If you do not have access to the previous account, contact Pinterest support.