Explanation
Article MarkdownReport an error

About Launching Scenario from Facebook Ads

Facebook Ads allows launching different bot scenarios for different advertising campaigns. This allows creating personalized experiences for different audiences and tracking effectiveness of each campaign separately.


Context and Problem

In many cases, you need to launch different scenarios for different advertising campaigns:

  • Different offers for different audiences
  • Personalization based on traffic source
  • Tracking effectiveness of each campaign
  • Optimizing conversions for different campaigns

Launching scenario from advertising solves this task by allowing configuring a unique scenario for each advertising campaign.


Key Concepts

Configuration in Facebook Ads

To launch a scenario from advertising, you need to:

  1. Create an advertising campaign in Facebook Ads
  2. Configure "Call to Action" → "Send Message"
  3. Select "Message Template" → "Create New" → "Partner App" → "Select Flow"
  4. Get JSON code from Kwizbot and insert into Facebook Ads

JSON Configuration

JSON code contains keyboard configuration with buttons:

  • Buttons that lead to another block
  • Link buttons with parameters ActionType: "open-url" and ActionBody

Approach Options

One Scenario vs Many Scenarios

One scenario for all campaigns:

  • ✅ Pros: Simplicity of maintenance
  • ❌ Cons: Impossibility of personalization for different audiences

Many scenarios for different campaigns:

  • ✅ Pros: Personalization, effectiveness tracking
  • ❌ Cons: More complex maintenance

Why we use many scenarios: This allows creating personalized experiences for different audiences and tracking effectiveness of each campaign separately.


Adopted Solutions

Using Referral Tags

For tracking traffic source, referral tags (ref, ref_source, ref_ad_id) are used, which allow:

  • Determining which campaign the user came from
  • Personalizing messages based on source
  • Tracking effectiveness of each campaign

Button Limitations

Facebook Messenger Platform has limitations on button count:

  • Maximum button count: 3 for initial message
  • Some button types may not be supported in advertising

Implications for Users and Implementation

For Integrators

When configuring scenario launch from advertising, it's important to:

  1. Create unique scenario — for each advertising campaign
  2. Configure keyboard — with correct button types
  3. Get JSON code — from Kwizbot and insert into Facebook Ads
  4. Add referral tags — for tracking traffic source

Common Errors

Error: JSON code does not work in Facebook Ads
Problem: JSON does not match Facebook Messenger Platform format
Solution: Check JSON format and Facebook Messenger Platform limitations

Error: Buttons do not display
Problem: Button count limit exceeded or incorrect format
Solution: Check button count and format

Error: Cannot track traffic source
Problem: Referral tags are not added to URL
Solution: Add referral tags to advertising campaign URL


Usage Examples

JSON Button Configuration

{
  "ActionType": "open-url",
  "ActionBody": "http://example.com"
}

Scenario Structure

  1. Create "Message with keyboard" block
  2. Add buttons according to types
  3. Get JSON code from Kwizbot
  4. Insert JSON into Facebook Ads

Using your own AI agent?Install the open skill so your AI agent can work with current official ConnectiveOne documentation.Get the skillNeed support?Couldn’t find the answer or need help from the ConnectiveOne team? Create a request in Client Portal.Create a request