{"id":5120,"date":"2025-03-11T18:28:02","date_gmt":"2025-03-11T18:28:02","guid":{"rendered":"https:\/\/villpress.com\/?p=5120"},"modified":"2025-03-11T18:32:56","modified_gmt":"2025-03-11T18:32:56","slug":"pinterest-conversions-api-setup-guide","status":"publish","type":"post","link":"https:\/\/villpress.com\/de\/pinterest-conversions-api-setup-guide\/","title":{"rendered":"Pinterest Conversions API Setup Guide"},"content":{"rendered":"

Pinterest\u2019s Conversions API<\/a> (CAPI) helps advertisers track conversions and optimize ads by sending server-side event data directly to Pinterest. This guide walks you through the setup process step by step.<\/p>\n

Step 1: Understand How CAPI Works<\/strong><\/h2>\n

Pinterest CAPI allows you to send events (e.g., purchases, sign-ups) from your server instead of relying only on browser-based tracking like the Pinterest Tag. This improves data accuracy and performance, especially with increased privacy restrictions.<\/p>\n

Step 2: Requirements for Setting Up CAPI<\/strong><\/h2>\n

Before setting up CAPI, ensure you have the following:
\u2705 A Pinterest Business Account<\/strong>
\u2705 Pinterest Tag ID<\/strong> (Get this from your Pinterest Ads Manager)
\u2705 Access to Your Server<\/strong> (or a developer who can implement API calls)
\u2705 Developer Skills<\/strong> (knowledge of APIs, JSON, and server-side scripting)<\/p>\n

Step 3: Choose Your Integration Method<\/strong><\/h2>\n

Pinterest offers multiple ways to integrate CAPI:
Direct API Integration<\/strong> (For businesses with development resources)
Partner Integrations<\/strong> (If you use platforms like Shopify or Google Tag Manager)
Third-Party Connectors<\/strong> (Such as Zapier or Segment)<\/p>\n

Step 4: Generate Access Token<\/strong><\/h2>\n
    \n
  1. Go to Pinterest Business Hub<\/strong><\/li>\n
  2. Navigate to Ads Manager \u2192 Conversions \u2192 API Access<\/strong><\/li>\n
  3. Click Generate Token<\/strong><\/li>\n
  4. Copy and securely store your access token<\/strong> (You\u2019ll use this for authentication)<\/li>\n<\/ol>\n

    Also Read: Pinterest Faces Challenges in Growing Ad Revenue<\/a><\/h4>\n

    Step 5: Set Up Server-Side Event Tracking<\/strong><\/h2>\n

    1. Identify Events to Track<\/strong><\/h3>\n

    Common Pinterest CAPI events include:
    \u2705 Page Visit (page_visit<\/code>)
    \u2705 Add to Cart (add_to_cart<\/code>)
    \u2705 Purchase (checkout<\/code>)
    \u2705 Sign Up (lead<\/code>)<\/p>\n

    2. Format Events in JSON<\/strong><\/h3>\n

    Example of a purchase event:<\/p>\n

    \n
    json<\/div>\n
    {<\/span>
    \n\"event_name\"<\/span>:<\/span> \"checkout\"<\/span>,<\/span>
    \n\"event_time\"<\/span>:<\/span> 1710378000<\/span>,<\/span>
    \n\"event_source_url\"<\/span>:<\/span> \"https:\/\/yourwebsite.com\/thank-you\"<\/span>,<\/span>
    \n\"user_data\"<\/span>:<\/span> {<\/span>
    \n\"hashed_email\"<\/span>:<\/span> \"a7f5f35426b927411fc9231b56382173\"<\/span>,<\/span>
    \n\"hashed_phone\"<\/span>:<\/span> \"7c4a8d09ca3762af61e59520943dc264\"<\/span>
    \n}<\/span>,<\/span>
    \n\"custom_data\"<\/span>:<\/span> {<\/span>
    \n\"currency\"<\/span>:<\/span> \"USD\"<\/span>,<\/span>
    \n\"value\"<\/span>:<\/span> 49.99<\/span>
    \n}<\/span>,<\/span>
    \n\"action_source\"<\/span>:<\/span> \"website\"<\/span>
    \n}<\/span>
    \n<\/code><\/div>\n<\/div>\n
    \n

    Important:<\/strong> Pinterest requires hashed user data<\/strong> (emails, phone numbers) using SHA-256 encryption.<\/em><\/p>\n<\/blockquote>\n

    3. Send Data to Pinterest\u2019s API Endpoint<\/strong><\/h3>\n

    Use a POST request to send event data:<\/p>\n

    \n
    curl -X POST \"https:\/\/api.pinterest.com\/v5\/ad_accounts\/YOUR_AD_ACCOUNT_ID\/events\"<\/span> \\
    \n-H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"<\/span> \\
    \n-H \"Content-Type: application\/json\"<\/span> \\
    \n-d '{
    \n\"event_name\": \"checkout\",
    \n\"event_time\": 1710378000,
    \n\"event_source_url\": \"https:\/\/yourwebsite.com\/thank-you\",
    \n\"user_data\": {
    \n\"hashed_email\": \"a7f5f35426b927411fc9231b56382173\"
    \n},
    \n\"custom_data\": {
    \n\"currency\": \"USD\",
    \n\"value\": 49.99
    \n},
    \n\"action_source\": \"website\"
    \n}'
    \n<\/span><\/code><\/div>\n<\/div>\n

    Step 6: Test Your Integration<\/strong><\/h2>\n

    \u2705 Use Pinterest’s Event Tester<\/strong> in Ads Manager<\/strong> to verify if events are received correctly.
    \u2705 Check logs for errors and confirm successful event transmission.
    \u2705 Use real user actions<\/strong> to test event tracking.<\/p>\n

    Step 7: Monitor and Optimize Performance<\/strong><\/h2>\n

    Regularly review Pinterest Ads Manager<\/strong> for CAPI event data.
    Adjust event parameters based on campaign performance.
    Combine CAPI with Pinterest Tag<\/strong> for a complete tracking strategy.<\/p>\n

    Final Thoughts<\/strong><\/h2>\n

    Setting up Pinterest Conversions API boosts your ad tracking accuracy and campaign effectiveness. Whether integrating manually or using a third-party service, make sure your data is hashed, structured correctly, and tested<\/strong> before launching campaigns.<\/p>\n

    Need help? Check Pinterest Developer Docs<\/strong> <\/a>or consult a developer for assistance!<\/p>\n","protected":false},"excerpt":{"rendered":"

    Pinterest\u2019s Conversions API (CAPI) helps advertisers track conversions and optimize ads by sending server-side event data directly to Pinterest. This guide walks you through the setup process step by step. Step 1: Understand How CAPI Works Pinterest CAPI allows you to send events (e.g., purchases, sign-ups) from your server instead of relying only on browser-based […]<\/p>\n","protected":false},"author":1,"featured_media":5118,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_mi_skip_tracking":false,"footnotes":""},"categories":[75],"tags":[214],"ppma_author":[331],"class_list":{"0":"post-5120","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-marketing","8":"tag-pinterest"},"authors":[{"term_id":331,"user_id":1,"is_guest":0,"slug":"pastakutmanwen","display_name":"Villpress Insider","avatar_url":{"url":"https:\/\/villpress.com\/wp-content\/uploads\/2025\/05\/Logo.png","url2x":"https:\/\/villpress.com\/wp-content\/uploads\/2025\/05\/Logo.png"},"0":null,"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/posts\/5120","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/comments?post=5120"}],"version-history":[{"count":4,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/posts\/5120\/revisions"}],"predecessor-version":[{"id":5124,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/posts\/5120\/revisions\/5124"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/media\/5118"}],"wp:attachment":[{"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/media?parent=5120"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/categories?post=5120"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/tags?post=5120"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/villpress.com\/de\/wp-json\/wp\/v2\/ppma_author?post=5120"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}