Click-to-Messenger Ads

You can use click-to-Messenger ads to get more users for your bot. These ads are shown to users on Facebook News Feed and Instagram feed.

When a user clicks or taps on the ad in Facebook News Feed or Instagram Feed, a conversation with your bot will immediately open in the Messenger app.


Creating an Ad

1. To get started, go to Ads Creation.

2. Select Messages objective, then click Continue.

3. Specify the audience and budget for your ad set.

4. Select Carousel, Image, or Video as your format.

5. Go to the Message Setup section to configure the user experience in Messenger when the ad is clicked. All Messenger Platform features, including quick replies, postbacks and templates are supported in the Messenger content, which can be specified two ways:

  • Click the JSON tab, and manually enter JSON that describes the message.
  • Click the Standard tab, and use the quick creation tool.

6. For ad creation using the quick creation tool, fill in the fields to set the content of your ad. You may also optionally specify the following calls to action, under Customer Actions':

  • Quick replies: Places up to 10 standalone buttons at the bottom of the conversation for the user to click. Quick replies will post text to the conversation, and can optionally by configured to send a postback webhook event to your webhook by clicking the 'Connect Your Bot' link, and specifying a payload. For more information on quick replies, see Quick Replies.
  • Buttons: Attaches up to three buttons to the message template. Buttons can be set to send either a postback webhook event or open a website in the Messenger webview. For more information on postback and URL buttons, see Buttons.

7. Optional: To use referral parameters with your ad, under Advanced Options, specify the ref in the URL Parameters field:

8. Click Place Order to finish creating your ad.

User Experience

When the user clicks or taps on the ad, the user will switch to a conversation in the Messenger app and receive the message you specified as your Messenger content.

To protect the user's privacy, this conversation is only visible to the advertiser/developer after user takes an action in the conversation (sending a message, tapping on quick reply, or tapping a CTA).

Ad Attribution

To make it easier for developers to identify which ad the user came from, the details of the last ad user was referred from are available in the user profile in "last_ad_referral" field

  "first_name": "Peter",
  "last_name": "Chang",
  "last_ad_referral": {
    "source": "ADS",
    "type": "OPEN_THREAD",
    "ad_id": "6045246247433"

Postbacks Only

If this is the first interaction with your bot, the referral will be included as part of first postback ("Get Started" or any other postback specified in Persistent Menu or in Structured Message). Other message types, such as quick replies, will not trigger a messaging_referrals event.

In existing user scenario, the referral is sent over messaging_referrals. Check links guide for more details.

The referral always follows this format:

   "source": "ADS",
   "type": "OPEN_THREAD",
   "ad_id": "6045246247433",
   "ref": "myparam" // Only included if specified in "URL Params" in the Ad as "ref=myparam"

Verify Ad Attribution

To verify Ad Attribution, select you Ad in Ads Manager and click on "Preview":

And then send yourself Preview Message:

This will send you the message on Messenger and also update the ad attribution.

Ads Insights

The performance of the ad is available in Ads Manager. In addition to standard ad metrics, the number of replies, blocks and new conversations which are attributed are available. You can select "Messenger Engagement" from the list of columns to see the Messaging metrics for your ad:

Note that the "New Conversation" metrics only includes two way conversation. When users clicks on the ad, they receive the "Structured Message" (if one is not defined, they'll receive a copy of the ad) in the conversation with your page/bot. Until the user takes an action, the conversation is visible only to the user (and not to the page) and is not counted as part of "New Conversations".

Conversion Tracking

You can track actions taken by the user (e.g. purchase, add to cart, content view etc) and attribute these to ads.

  • Log the user actions using app events API. Check Messenger Platform app events guide for more details.
  • You should use one of the predefined events (e.g. fb_mobile_add_to_cart, fb_mobile_purchase). The complete list is available here
  • While creating the ad, enable app events tracking in Advanced section of Ad Setup (Note: You need to have advertising permission on the App)
  • To view the results, in Ads Manager customize the columns and add the corresponding columns for the events you added (e.g. for purchase add "Mobile App Purchases" column)
  • The purchases attributed to your ad will now be visible in Ads Manager along with "Cost per Purchase"


To retarget the users who have interacted with your bot/page before you can use Custom Audience. Custom Audiences can be created using:

  • Uploading the list of Page Scoped User IDs