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:
- Create an advertising campaign in Facebook Ads
- Configure "Call to Action" → "Send Message"
- Select "Message Template" → "Create New" → "Partner App" → "Select Flow"
- 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"andActionBody
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:
- Create unique scenario — for each advertising campaign
- Configure keyboard — with correct button types
- Get JSON code — from Kwizbot and insert into Facebook Ads
- 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
- Create "Message with keyboard" block
- Add buttons according to types
- Get JSON code from Kwizbot
- Insert JSON into Facebook Ads
Related Documents
- Reference: Facebook Messenger Platform — official Facebook documentation
- Explanation: Facebook Ads Referral Tags — tracking traffic source
- Explanation: Inline Keyboard — keyboard configuration