Conversation Ads

Warning

Deprecation Notice
The Marketing Version 202310 (Marketing October 2023) and earlier versions (excluding 202306 and 202307) have been sunset. Additionally, the unversioned APIs will 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.

A Conversation Ad is a LinkedIn ad format that allows advertisers to deliver pre-determined messages to an inbox of a targeted LinkedIn member. It provides a chat-like experience between both the member and the advertiser. The Conversation Ads API allows advertisers to deliver customizable, branded messages directly to members' LinkedIn messaging inboxes.

Within our API, Conversation Ads are represented by the Sponsored Conversation entity. Sponsored Conversations are composed of Sponsored Message Content.

Create a Conversation Ad

  1. Create an Ad Campaign.
  2. Create a Sponsored Conversation.
  3. If you use attachments in a conversation, upload SponsoredMessageContent Asset to the Images API using these steps.
  4. Create a tree of SponsoredMessageContent to represent a conversation.
  5. Update SponsoredConversation with reference to the first SponsoredMessageContent.
  6. Create an AdInMailContent using GuidedReplies as sub-content by using the Urn of the completed Sponsored Conversation.
  7. Create a DRAFT conversation ad creative with the adInMailContent URN returned in the previous step as its content reference. See Create and Manage Creatives.
  8. Test the DRAFT conversation ad.
  9. Make any necessary modifications based on testing.

    Note

    The creative should be in DRAFT status.

  10. Activate the creative by updating the creative status to ACTIVE.

    Note

    The creative will be directed to the review queue after activation.

Help Articles