LinkedIn Audience Network

  • Article

Warning

Deprecation Notice
The Marketing version 202304 (Marketing April 2023) and below has been sunset and the unversioned APIs are going to be sunset soon. We recommend that you migrate to the versioned APIs as well as migrate to the new Content and Community Management APIs to avoid disruptions. See the Migration page for more details. If you haven’t yet migrated and have questions, submit a request on the LinkedIn Developer Support Portal.

In addition to appearing in the LinkedIn feed, Sponsored Content can appear on LinkedIn's partner sites. Only SPONSORED_UPDATES campaigns with CPC bidding can serve Sponsored Content beyond the LinkedIn feed. CPM bidding is not supported.

To learn more about how Sponsored Content can be delivered beyond the LinkedIn network, see the LinkedIn Audience Network FAQs.

Permissions

Permission Description
rw_ads Manage and read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles.
  • ACCOUNT_BILLING_ADMIN
  • ACCOUNT_MANAGER
  • CAMPAIGN_MANAGER
  • CREATIVE_MANAGER
r_ads Read an authenticated member's ad accounts. Restricted to ad accounts in which the authenticated member has one of the following ad account roles.
  • ACCOUNT_BILLING_ADMIN
  • ACCOUNT_MANAGER
  • CAMPAIGN_MANAGER
  • CREATIVE_MANAGER
  • VIEWER

See Account Access Controls for more information on ad account roles.

Enable Offsite Sponsored Content Delivery

The offsiteDeliveryEnabled flag on a campaign indicates whether or not it can be delivered off network.

Campaigns can also be excluded from certain websites or applications. This can be done by excluding IAB categories or individually specified websites/apps. See Manage Audience Restrictions for more information.

Create a Campaign with Offsite Delivery Enabled

When you create a campaign, offsiteDeliveryEnabled is set to false by default. Set it to true if the campaign should be served off network.

Sample Request

See Create a Campaign for a full sample request.

POST https://api.linkedin.com/rest/adAccounts/{adAccountId}/adCampaigns

{
   // See link above for examples of full campaign creation request bodies.
   "offsiteDeliveryEnabled":true
}

POST https://api.linkedin.com/rest/adCampaigns

{
   // See link above for examples of full campaign creation request bodies.
   "offsiteDeliveryEnabled":true
}

POST https://api.linkedin.com/v2/adCampaignsV2

{
   // See link above for examples of full campaign creation request bodies.
   "offsiteDeliveryEnabled":true
}

Enable Offsite Delivery for an Existing Campaign

Existing campaigns can be updated to set offsiteDeliveryEnabled to true to enable offsite delivery. It uses the same update method as any other campaign update.

POST https://api.linkedin.com/rest/adAccounts/{adAccountId}/adCampaigns/{campaignId}

{
    "patch": {
        "$set": {
            "offsiteDeliveryEnabled": true
        }
    }
}

POST https://api.linkedin.com/rest/adCampaigns/{campaignId}

{
    "patch": {
        "$set": {
            "offsiteDeliveryEnabled": true
        }
    }
}

POST https://api.linkedin.com/v2/adCampaignsV2/{campaignId}

{
    "patch": {
        "$set": {
            "offsiteDeliveryEnabled": true
        }
    }
}

Disable Offsite Delivery

Campaigns can be disabled for off network delivery by using the same update endpoint while settingoffsiteDeliveryEnabled to false.

Note that if offsiteDeliveryEnabled is set to false, the offsitePreferences field on the campaign managing exclusions cannot be modified.

POST https://api.linkedin.com/rest/adAccounts/{adAccountId}/adCampaigns/{campaignId}

{
    "patch": {
        "$set": {
            "offsiteDeliveryEnabled": false
        }
    }
}

POST https://api.linkedin.com/rest/adCampaigns/{campaignId}

{
    "patch": {
        "$set": {
            "offsiteDeliveryEnabled": false
        }
    }
}

POST https://api.linkedin.com/v2/adCampaignsV2/{campaignId}

{
    "patch": {
        "$set": {
            "offsiteDeliveryEnabled": false
        }
    }
}