{"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":["post-5120","post","type-post","status-publish","format-standard","has-post-thumbnail","category-marketing","tag-pinterest"],"authors":[{"term_id":331,"user_id":1,"is_guest":0,"slug":"pastakutmanwen","display_name":"Staff Writer","avatar_url":{"url":"https:\/\/villpress.com\/wp-content\/uploads\/2025\/05\/Logo.png","url2x":"https:\/\/villpress.com\/wp-content\/uploads\/2025\/05\/Logo.png"},"author_category":"1","first_name":"Staff","last_name":"Writer","user_url":"http:\/\/villpress.com","job_title":"Staffs At Villpress","description":"The Villpress Staff Writers are an in-house team of experienced editors and industry experts dedicated to producing clear, insightful content. As part of Villpress, they cover the latest trends and innovations across business, technology, artificial intelligence, advertising, and more, delivering stories that inform, engage, and add real value to readers."}],"_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}]}}