Install the Pinterest for Salesforce Commerce Cloud app to promote products that you’re already selling on Salesforce Commerce Cloud and measure the results of the actions people take on your website. The Pinterest for Salesforce Commerce Cloud app also allows businesses to enable conversion tracking (
Below, you’ll find out how to integrate the Pinterest cartridge into the Salesforce B2C Commerce. The cartridge is designed for rapid installation and requires minimal configuration. There are options for further customization.
The Pinterest cartridge supports the following:
Your catalog will be updated daily and some attribute updates (like stock and price) will be sent in real-time after the Pins are ingested. Additionally, you’ll be able to track Pinterest conversions as the app provides a frontend JavaScript tracking code, as well as backend conversion API tracking for more accurate conversion data.
The app is designed to only work with Pinterest business accounts and cannot be used with a personal Pinterest account or an account that has been set up via Pinterest’s
For additional information,
- Upload the Pinterest cartridge to your environment
- For Sandboxes, you can use VSCode with the Prophet extension
- Click Administration at the top of the page, then Sites, followed by Manage Sites
- Select your site, then click Settings
- Add the cartridge (“int_pinterest_sfra”) to each site’s cartridge path to the left of app_storefront_base
- Use a colon to separate the cartridge from existing cartridges in the path
- Repeat step 2, then select Business Manager, followed by Settings
- Add the cartridge (“bm_pinterest”) to the Business Manager Site cartridge path to the left of bm_app_storefront_base
- Use a colon to separate the cartridge from existing cartridges in the path
- Click Administration at the top of the page, followed by Site Development
- Select Code Deployment, then toggle code versions
- Repeat step 7, then select Site Import and Export
- Upload the zip file located in the metadata folder called Pinterest.zip and click Import
- Click Administration at the top of the page, then Organization, followed by Roles & Permissions
- Select Administrator, then Business Manager Modules
- Add Business Manager Modules permissions for Manage App Connection and Domain Verification to the appropriate organization roles
- Click Merchant Tools at the top of the page, then Site Preferences, followed by Custom Preferences
- Configure the site preferences
- Default values will work in most cases
- Click Merchant Tools at the top of the page, then Pinterest, followed by View App Connection
- Click Connect to connect the site to your Pinterest app
The JavaScript in this cartridge is contained within a script tag in a template file and static JavaScript files. You do not need to compile JavaScript.
You’ll need to generate credentials so Pinterest can fetch your product data. There are two options:
- Create a new Account Manager User: This has to be a real email that you have access to so you can set up two-factor authentication. Once created, assign the role of Business Manager User under eCommerce Platform in Account Manager. Then, you’ll need to define the scope for the role and assign the instances that this user will need to have access to.
- Use your own account: This option suits non-production instances.
Once you’ve identified the user, follow the steps below:
- Log in to the instance you’re configuring
- If you’re not already on the profile page, click the gray profile picture at the top-right corner
- Click Manage Access Keys
- Click Generate Access Key
- Select WebDAV File Access and UX Studio
- Click Generate
Your email will be the pinterestWebDAVUser and the access key generated is your pinterestWebDAVPassword that you’ll need to save for future use.
After importing the metadata outlined in the previous section, you now have a new role that you’ll have to assign to the user. If you’re an admin, you can self-assign the role to your user. If you created a new account, you’ll need an admin to assign you the role.
- Click Merchant Tools at the top of the page
- Click Site Preferences
- Click Custom Preferences
- Click Pinterest Configurations
- Configure the following site preferences:
Name | ID | Description |
---|---|---|
Pinterest Enabled Conversion Clientside Calls |
pinterestEnabledConversionClientsideCalls | Flag for sending clientside conversion calls. This disables the clientside JS library. Default is true. |
Pinterest Enabled Conversion Serverside Calls |
pinterestEnabledConversionServersideCalls | Flag for sending serverside conversion calls. Default is true. |
Pinterest Enabled GDPR | pinterestEnabledGDPR | Flag for enabling GDPR check. Default is False. Once this is enabled user consent is checked through SFCC inbuilt session.privacyCache.get('consent') value. |
Pinterest Enabled Realtime Catalog Calls | pinterestEnabledRealtimeCatalogCalls | Flag for allowing catalog inventory update calls to happen when an order is placed. Default is true. |
Pinterest App ID | pinterestAppID | These values should not be changed to anything besides 1484575 or 1484576. Before considering changing to anything else please reach out to Pinterest. Production value is 1484575 and all other environments are 1484576. These are not unique to your site. Default is 1484575. |
Pinterest WebDAV User | pinterestWebDAVUser | User the Pinterest API will use to connect to this environment to pull the XML catalog feeds from. |
Pinterest WebDAV Password | pinterestWebDAVPassword | Password the Pinterest API will use to connect to this environment to pull the XML catalog feeds from. |
Pinterest API Test Mode Enabled | pinterestAPITestModeEnabled | Enable Test Mode when interacting with Pinterest API. This only affects server side conversion event handlers. Default is false. |
Pinterest Catalog Feed Product Image Size | pinterestCatalogFeedProductImageSize | Selects what product image size group to use in the catalog feed. The max product image size for the Pinterest catalog feed is an area of 89478485 pixels, or 9450 width x 9450 height. Defaults to 'large'. |
Pinterest Refresh Token Expiration Buffer Seconds | pinterestRefreshTokenExpirationBufferSeconds | How many seconds before an API refresh token expires should it be refreshed. Default is 7 days (604,800 seconds). |
Pinterest Integration Base URL | pinterestIntegrationBaseURL | Used for integration iframes in Business Manager. Default is 'https://commerce-app.pintergration.com' |
- Select the site you want to set up
- Click Merchant Tools at the top of the screen
- Select Pinterest
- Click Manage App Connection
- Click Connect
- Follow the prompts in the popup window
Once completed, you’ll be directed to a connection status page.
If you need help with the Pinterest for Salesforce Commerce Cloud app, please contact your Account Manager or