Pinterest—Create a website app integration

For:
Marketers
Last update:

At a glance: Set up a Pinterest integration for your website app to send web conversion events to Pinterest for campaign optimization and reporting.

Set up integration

Prerequisites:

 

To activate or edit the integration:

  1. To activate: In AppsFlyer, from the side menu, select Collaborate > Partner Integrations > Marketplace tab.
    To edit: In AppsFlyer, from the side menu, select Collaborate > Partner Integrations > Active integrations tab.
  2. Search for Pinterest and click Integrate.
  3. Select your website app from the dropdown menu above.
  4. In the Integration tab, turn on the Activate partner toggle.
    Note: The toggle must remain on (activated) for as long as you work with Pinterest.
  5. Complete the configuration in the Integration tab as described below.

Integration tab

Activate partner

On the first visit, turn on the Activate Partner toggle to enable setup of the integration tab's parameters. The toggle must remain on for as long as you work with Pinterest.

Learn more about partner activation.

In-app event settings

To send in-app event postbacks to Pinterest, provide the following Pinterest credentials. These credentials are included in the event postbacks sent to Pinterest.

  • Ad Account ID - The unique identifier of your Pinterest ad account.
  • Access Token - An access token generated in Pinterest.

You can find your Ad Account ID and Access Token in the Pinterest Ads Manager UI (see the Pinterest documentation). Contact Pinterest support if you need assistance.

To set the Pinterest credentials:

  1. In AppsFlyer, on the Pinterest Active integration page > Integration tab, scroll to In-app event settings.
  2. Enter the Ad Account ID and Access Token values in their respective fields.

In-app event postbacks

In this section, you map your AppsFlyer web events to Pinterest events via postbacks.

  1. In the Pinterest integration settings, scroll to In-app event postbacks.
  2. Turn on In-app event postbacks.
  3. Set the in-app event postback window.
  4. Select the postback settings and mappings for events.
Parameter name Description
AppsFlyer event name

The name of the web event, as received by AppsFlyer from either the Web SDK integrated on your website or from server-to-server events. 

Note: If you don't see the event you want in the list, make sure the event has been activated and recheck.
Partner event name The Pinterest event to map to, selected from Pinterest's predefined event list. For Pinterest event names, see the Pinterest documentation.
To users from

This partner only: Events coming only from users attributed to Pinterest. 

All media sources, including organic: Your entire user base is available to be reported to the partner.
Including Select whether event revenue or parameter values are sent to the partner in the postback. AppsFlyer can send all parameters of the rich web event except the revenue parameter (contained in af_revenue), or all parameters including the revenue value (if present).
  1. Click Add Event to add an event to the list.