Merge pull request #1485 from segmentio/DOC-148_Pinterest-audiences

DOC 148 Pinterest audiences

Author: markzegarelli

src/_data/catalog/destination_categories.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# destination categories last updated 2021-03-10 
+# destination categories last updated 2021-03-29 
 items:
 - display_name: Email Marketing
   slug: email-marketing

src/_data/catalog/destinations.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# destination data last updated 2021-03-10 
+# destination data last updated 2021-03-29 
 items:
 - display_name: ActiveCampaign
   slug: activecampaign
@@ -13672,6 +13672,26 @@ items:
       required: false
       description: Map your Segment properties to the Marketo Activity Fields
       settings:
+      - name: marketoAttributeType
+        display_name: Marketo Field Type
+        type: SELECT
+        deprecated: false
+        required: true
+        select_validators:
+          select_options:
+          - string
+          - boolean
+          - number
+          - date
+        description: Enter the Marketo Field type.
+        settings: []
+      - name: primaryKey
+        display_name: Set as Primary Key
+        type: BOOLEAN
+        deprecated: false
+        required: false
+        description: Mark this property as the Primary field in Marketo.
+        settings: []
       - name: segmentProperty
         display_name: Segment Property Name
         type: STRING
@@ -13694,26 +13714,6 @@ items:
           Enter the Marketo Field name. Make sure to copy and paste the exact
           API Name for your field as it appears in Marketo.
         settings: []
-      - name: marketoAttributeType
-        display_name: Marketo Field Type
-        type: SELECT
-        deprecated: false
-        required: true
-        select_validators:
-          select_options:
-          - string
-          - boolean
-          - number
-          - date
-        description: Enter the Marketo Field type.
-        settings: []
-      - name: primaryKey
-        display_name: Set as Primary Key
-        type: BOOLEAN
-        deprecated: false
-        required: false
-        description: Mark this property as the Primary field in Marketo.
-        settings: []
     - name: event
       display_name: Segment Event Name
       type: STRING
@@ -16689,6 +16689,59 @@ items:
       server: false
   previous_names:
   - Pingdom
+- display_name: Pinterest Audiences
+  slug: pinterest-audiences
+  name: catalog/destinations/pinterest-audiences
+  description: >-
+    The Pinterest Audiences integration lets you add user audiences for
+    remarketing.
+  hidden: false
+  url: connections/destinations/catalog/pinterest-audiences
+  status: PUBLIC
+  logo:
+    url: 'https://cdn.filepicker.io/api/file/p3vCawmQ2CtnbacRnRHD'
+  mark:
+    url: 'https://cdn.filepicker.io/api/file/GBX5NV3USYmSOcpePkA1'
+  categories:
+  - Advertising
+  components:
+  - type: CLOUD
+  platforms:
+    browser: false
+    server: true
+    mobile: false
+  browserUnbundlingSupported: false
+  browserUnbundlingPublic: true
+  methods:
+    alias: false
+    group: false
+    identify: false
+    page_view: false
+    track: true
+  settings:
+  - name: account
+    display_name: account
+    type: STRING
+    deprecated: false
+    required: true
+    string_validators:
+      regexp: ^\d+$
+    description: >-
+      You can find your Account ID on the **Account Settings** page of your
+      [Pinterest Ads account](https://ads.pinterest.com/). It should be a series
+      of numbers, like `319762813599`.
+    settings: []
+  connection_modes:
+    device:
+      web: false
+      mobile: false
+      server: false
+    cloud:
+      web: false
+      mobile: true
+      server: true
+  previous_names:
+  - Pinterest Audiences
 - display_name: Pinterest Tag
   slug: pinterest-tag
   name: catalog/destinations/pinterest-tag

src/_data/catalog/source_categories.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# source cateogries last updated 2021-03-10 
+# source cateogries last updated 2021-03-29 
 items:
 - display_name: Server
   slug: server

src/_data/catalog/sources.yml

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PLATFORM API. DO NOT EDIT
-# sources last updated 2021-03-10 
+# sources last updated 2021-03-29 
 items:
 - display_name: .NET
   slug: net

src/connections/destinations/catalog/pinterest-audiences/index.md

@@ -0,0 +1,54 @@
+---
+title: 'Pinterest Audiences Destination'
+---
+Pinterest Ads provides a way to target advertisements on Pinterest to a global audience. Segment's Pinterest Audiences integration allows Segment Personas customers to sync audiences from Personas to Pinterest for better retargeting and higher-performing ads.
+
+For more information about advertising with Pinterest, see:
+- [Pinterest Developers](https://developers.pinterest.com/docs/widgets/getting-started/?)
+- [Pinterest for Business](https://business.pinterest.com/)
+
+## Quick info
+
+**Requirements**
+- Personas enabled with an existing Personas space
+- A Pinterest Ads account with the `owner`, `admin`, or `audience_manager` role
+
+**Supported identifiers**
+- Email
+- iOS IDFA
+- Android ID
+
+> warning ""
+> **Note**: The Segment iOS SDK version 4.0 and up does not collect automatically collect IDFA. For more information, see the [iOS 14 Guide](/docs/connections/sources/catalog/libraries/mobile/ios/ios14-guide/).
+
+**Connection type**
+- Server-side
+
+## Set up
+
+The Pinterest Audiences destination syncs data from Segment Personas to Pinterest Ads. To begin:
+
+1. Navigate to the Destinations section of your Personas space, and click Add Destination.
+2. Search for `Pinterest Audiences` and click Configure Pinterest Audiences.
+3. Confirm the Source. The default value is the source connected to the Personas space to which you’re adding the destination.
+4. On the Pinterest Audiences configuration screen, click Connect to Pinterest Audiences. Log in to Pinterest with an account that has access to the Pinterest Ads dashboard. Once authenticated, confirm the connection to Segment.
+5. Select the Pinterest Ad account that will receive audience data. This account may be your personal Pinterest account, but it must have an ad account attached. After you select the account, the destination is active.
+6. Add the Pinterest Audiences destination to an existing Personas Audience.
+    1. Navigate to the Personas space that contains the audience, and select it from the Audiences tab.
+    2. Click Add Destination.
+    3. The configured Pinterest Audiences destination should appear in the Send as User List category of available destinations.
+    4. Select the destination, and click Add Destination.
+
+The initial synchronization of audience data may take several hours, depending on the size of the audience. Once the initial sync occurs, you'll see a new audience in the Pinterest Audiences dashboard.
+
+## FAQ
+
+### What does the audience size represent? 
+The audience size represented in Pinterest is the final count of matched users between your customer profiles in Segment and Pinterest users. This number denotes your targetable audience size within Pinterest.
+
+The initial synchronization of audience data may take several hours, depending on the size of the audience. Once the initial sync occurs, you’ll see a new Audience in the Pinterest Audiences dashboard.
+
+### Are lists/audiences processed on some interval, or on customer list update? Do we need to wait 24-48 hours every time we add/remove identifiers from a list? 
+Processing happens regularly and automatically throughout the day - but can take up to 24 hours. 
+
+You do not need to wait to continue sending data; however, any campaigns using those audiences will not see the changes until after processing (they'll continue running against whatever users have already been matched).