Merge pull request #8286 from braze-inc/lx-bd-3584

BD-3584: Update LinkedIn Audience Sync article

_docs/_partners/canvas_steps.md

@@ -20,15 +20,18 @@ guide_featured_list:
 
 guide_menu_title: "Available sync partners"
 guide_menu_list:
+  - name: Criteo Audience Sync
+    link: /docs/partners/canvas_steps/criteo_audience_sync
+    image: /assets/img/braze_icons/lightning-01.svg
   - name: Facebook Audience Sync
     link: /docs/partners/canvas_steps/facebook_audience_sync
     image: /assets/img/braze_icons/facebook.svg
   - name: Google Audience Sync
     link: /docs/partners/canvas_steps/google_audience_sync
     image: /assets/img/braze_icons/google.svg
-  - name: Criteo Audience Sync
-    link: /docs/partners/canvas_steps/criteo_audience_sync
-    image: /assets/img/braze_icons/lightning-01.svg
+  - name: LinkedIn Audience Sync
+    link: /docs/partners/canvas_steps/linkedin_audience_sync
+    image: /assets/img/braze_icons/linkedin.svg
   - name: Pinterest Audience Sync
     link: /docs/partners/canvas_steps/pinterest_audience_sync
     image: /assets/img/braze_icons/pinterest.svg

_docs/_partners/canvas_steps/criteo_audience_sync.md

@@ -2,7 +2,7 @@
 nav_title: Criteo
 article_title: Canvas Audience Sync to Criteo
 description: "This reference article will cover how to use Braze Audience Sync to Criteo, to deliver advertisements based upon behavioral triggers, segmentation, and more."
-page_order: 4
+page_order: 1
 alias: "/audience_sync_criteo/"
 
 Tool:

_docs/_partners/canvas_steps/facebook_audience_sync.md

@@ -2,7 +2,7 @@
 nav_title: Facebook
 article_title: Canvas Audience Sync to Facebook
 description: "This reference article will cover how to use Braze Audience Sync to Facebook, to deliver advertisements based upon behavioral triggers, segmentation, and more."
-page_order: 1
+page_order: 2
 alias: "/audience_sync_facebook/"
 
 Tool:

_docs/_partners/canvas_steps/google_audience_sync.md

@@ -5,7 +5,7 @@ alias: /google_audience_sync/
 description: "This reference article will cover how to use Braze Audience Sync to Google, to deliver advertisements based upon behavioral triggers, segmentation, and more."
 Tool:
   - Canvas
-page_order: 2
+page_order: 3
 
 ---
 

_docs/_hidden/private_betas/linkedin_audience_sync.md → _docs/_partners/canvas_steps/linkedin_audience_sync.md

@@ -1,11 +1,12 @@
 ---
-nav_title: Audience Sync to LinkedIn
+nav_title: LinkedIn
 article_title: Canvas Audience Sync to LinkedIn
-permalink: /linkedin_audience_sync/
+alias: /linkedin_audience_sync/
 description: "This reference article will cover how to use Braze Audience Sync to LinkedIn to deliver advertisements based upon behavioral triggers, segmentation, and more."
 Tool:
   - Canvas
-hidden: true
+page_order: 4
+
 ---
 
 # Audience Sync to LinkedIn
@@ -38,17 +39,17 @@ You must make sure that you have the following items created, completed, or acce
 
 ### Step 1: Connect to LinkedIn
 
-In the Braze dashboard, go to **Technology Partners** and select **LinkedIn**. In the LinkedIn Audience Export module, click **Connect LinkedIn**.
+In the Braze dashboard, go to **Technology Partners** and select **LinkedIn**. In the **LinkedIn Audience Sync** section, select **Connect LinkedIn**.
 
-![LinkedIn technology page in Braze includes an Overview module and LinkedIn Audience Export module with the Connected LinkedIn button.][3]{: style="max-width:75%;"}
+![LinkedIn technology page in Braze includes an Overview section and LinkedIn Audience Sync section with the Connected LinkedIn button.][3]{: style="max-width:75%;"}
 
 You’ll then be redirected to the LinkedIn OAuth page to authorize Braze for the permissions related to your Audience Sync integration. After you have selected **Confirm**, you’ll be redirected back into Braze to select which LinkedIn ad accounts you wish to sync to. 
 
-![][7]{: style="max-width:75%;"}
+!["Braze Self Service" is selected as the ad account to connect.][7]{: style="max-width:75%;"}
 
 Once you have successfully connected, you will be returned to the partner page, where you can view which accounts are connected and disconnect existing accounts.
 
-![][6]{: style="max-width:75%;"}
+![A successfully connected LinkedIn account.][6]{: style="max-width:75%;"}
 
 Your LinkedIn connection will be applied at the Braze workspace level. If your LinkedIn admin removes you from your LinkedIn ad account, Braze will detect an invalid token. As a result, your active Canvases using LinkedIn will show errors, and Braze will not be able to sync users.
 
@@ -58,7 +59,7 @@ When building audiences for Ad Tracking, you may wish to include or exclude cert
 
 If you have collected the [iOS IDFA through the Braze SDK]({{site.baseurl}}/developer_guide/platform_integration_guides/swift/initial_sdk_setup/overviewother_sdk_customizations/#optional-idfa-collection), you will be able to use the **Ads Tracking Enabled** filter. Select the value as `true` to only send users into Audience Sync destinations where they have opted in. 
 
-![][5]{: style="max-width:75%;"}
+![An entry audience with the filter "Ad Tracking Enabled is true".][5]{: style="max-width:75%;"}
 
 If you are collecting `opt-ins`, `opt-outs`, `Do Not Sell Or Share`, or any other relevant custom attributes, you should include these within your Canvas entry criteria as a filter:
 
@@ -70,17 +71,17 @@ To learn more on how to comply with these Data Protection laws within the Braze
 
 Add a component in your Canvas and select Audience Sync. Click on the **Custom Audience** button to open the component editor.
 
-![][2]{: style="max-width:35%;"} ![][1]{: style="max-width:29%;"}
+![The Canvas editor with the list of available components.][2]{: style="max-width:35%;"} ![The selected Audience Sync component.][1]{: style="max-width:29%;"}
 
 ### Step 4: Sync setup
 
 Select **LinkedIn** as the desired Audience Sync partner.
 
-![][9]{: style="max-width:70%;"}
+![The "Set up Audience Sync" details with the multiple partners to choose from.][9]{: style="max-width:70%;"}
 
 Then select the desired LinkedIn ad account. Under the **Choose a New or Existing Audience** dropdown, type in the name of a new or existing audience.
 
-![][11]
+![Audience Sync to LinkedIn with Braze selected as the ad account.][11]
 
 {% tabs %}
 {% tab Create a New Audience %}
@@ -93,11 +94,11 @@ Enter a name for the new audience, select **Add Users to Audience**, and select
 
 Next, save your audience by clicking the **Create Audience** button at the bottom of the step editor.
 
-![]({% image_buster /assets/img/linkedin/linkedin10.png %})
+![An example "leads" audience with the selected Braze ad account, "leads" audience, the action to add users to the audience, and email, Android GAID, and first and last name as fields to match.]({% image_buster /assets/img/linkedin/linkedin10.png %})
 
 Users will be notified at the top of the step editor if the audience is created successfully or if errors arise during this process. Users can also reference this audience for user removal later in the Canvas journey because the audience was created in draft mode.
 
-![]({% image_buster /assets/img/linkedin/linkedin9.png %})
+![Confirmation that the "leads" audience was created.]({% image_buster /assets/img/linkedin/linkedin9.png %})
 
 When you launch a Canvas with a new audience, Braze syncs users in near real-time as they enter the Audience Sync component.
 
@@ -124,7 +125,7 @@ You can view the audience on LinkedIn by going into your ad account and selectin
 
 As users reach the Audience Sync Step, Braze will sync these users in near real-time while respecting LinkedIn’s API rate limits. In practice, Braze will try to batch and process as many users every 5 seconds before sending these users to LinkedIn.
 
-LinkedIn’s API rate limit states no more than ten queries per second and 100k users per request. If a Braze customer reaches this rate limit, Braze the Canvas will retry the sync for up to ~13 hours. If the sync is not possible, these users are listed under the Users Errored metric.
+LinkedIn’s API rate limit states no more than ten queries per second and 100,000 users per request. If a Braze customer reaches this rate limit, Braze the Canvas will retry the sync for up to about 13 hours. If the sync is not possible, these users are listed under the Users Errored metric.
 
 ## Understanding analytics
 
@@ -146,11 +147,11 @@ Remember that there will be a delay in reporting for users synced and users erro
 {% endalert %}
 
 {% alert important %}
-LinkedIn provides additional metrics around match rates within their platform. To review the match of your specific Audience Sync, click the Audience Sync step metrics to go into the **Canvas Step Details** page. 
+LinkedIn provides additional metrics around match rates within their platform. To review the match of your specific Audience Sync, select the Audience Sync step metrics to go into the **Canvas Step Details** page. 
 <br><br>
 Select the partner as **LinkedIn**, your ad account, and the audience to see the audience size and match rate from LinkedIn.
 
-![]({% image_buster /assets/img/linkedin/linkedin11.png %})
+![An example of Audience Sync step metrics with 10,000 entered users.]({% image_buster /assets/img/linkedin/linkedin11.png %})
 {% endalert %}
 
 ## Troubleshooting

_docs/_partners/canvas_steps/pinterest_audience_sync.md

@@ -2,7 +2,7 @@
 nav_title: Pinterest
 article_title: Canvas Audience Sync to Pinterest
 description: "This reference article will cover how to use Braze Audience Sync to Pinterest, to deliver advertisements based upon behavioral triggers, segmentation, and more."
-page_order: 3
+page_order: 5
 alias: "/audience_sync_pinterest/"
 
 Tool:

_docs/_partners/canvas_steps/snapchat_audience_sync.md

@@ -2,7 +2,7 @@
 nav_title: Snapchat
 article_title: Canvas Audience Sync to Snapchat
 description: "This reference article will cover how to use Braze Audience Sync to Snapchat, to deliver advertisements based upon behavioral triggers, segmentation, and more."
-page_order: 4
+page_order: 6
 alias: "/audience_sync_snapchat/"
 
 Tool:

_docs/_partners/canvas_steps/tiktok_audience_sync.md

@@ -5,7 +5,7 @@ alias: /tiktok_audience_sync/
 description: "This reference article will cover how to use Braze Audience Sync to TikTok to deliver advertisements based upon behavioral triggers, segmentation, and more."
 Tool:
   - Canvas
-page_order: 5
+page_order: 7
 
 ---