Skip to content
English
  • There are no suggestions because the search field is empty.

How to Integrate Facebook Ads with Wicked Reports

This document is for Facebook Media Buyers who want to learn how to integrate and track Facebook Ads with Wicked Reports

On this Page

Introduction to the Facebook Integration Wizard

The Facebook Ads setup process consists of running one simple integration wizard,  selecting a couple of settings, and then adding the Wicked Tracking Parameter to all of your ads. In this article, we'll walk you through the steps it takes to get integrated, the two settings available, and how to add the Wicked Tracking Parameter.  Furthermore, we'll also touch base on what comes after integrating your Facebook Ads account.

Let's get started.

How to Integrate Facebook

To set up your integration, you'll want to follow these steps:

  1. Login to your Wicked Reports account
  2. In your navigation menu, located on the left side of your dashboard, select the Setup dropdown menu and navigate to the Authorizations page.
  3. In the advertising data column, locate the Facebook section and press the green "Connect" button
    wicked advertising data
  4. When the Wicked Reports Integration Wizard launches for Facebook, press the green "Yes, Proceed" button:

    wicked reports integration wizard
  5. You will now be redirected to a very simple Facebook Wizard, where they will ask you a few questions.
    1. Would you like to continue as the user you're logged in with?
      1. If it's the correct user account you'd like to proceed with, then press the "Continue As ..." button.
      2. Otherwise, select "Not Now" and retry when you are logged into the correct Facebook user account.
    2. Do you want to opt-in with all your business or only the businesses you select?
      1. Select the choice "Opt into current Businesses only". Then select the individual businesses that you'd like Wicked Reports to integrate with.
        Note: These business accounts are not the same as your ad accounts.
    3. Do you want to opt in with all of your pages or only the pages you select?
      1. Select the choice to "Opt into all current and future Pages". 
    4. Lastly, they'll have you review the permissions that you've granted to Wicked.
      Press the "Save" button to continue.
    5. On the final screen, they'll prompt you that your integration was successful.
      Press the "Got it" button to continue. Once you've pressed that button, you'll then be redirected back to the Wicked Reports Authorizations page. 
Congratulations! Your integration has been connected. Continue reading to learn about the final settings you'll need to complete your Facebook setup.

Facebook Authorization Settings 

After integrating your Facebook account, you will be presented with two settings:
  1. Do you want to push Lead Ad Contact Info into your CRM?
    multi touch marketing attribution software

  2. Which Ad Accounts would you like to connect?

Let's take a closer look at each option and get a deeper understanding of these choices. 

Do you want to push Lead Ad Contact Info into your CRM?
With the right permissions, Wicked Reports will automatically attribute Facebook Lead Ads as part of the integration. However, this bonus option gives you the optional choice to push those leads directly into your CRM.

  1. Yes, I'd like to sync my Facebook Lead Ad leads with my CRM (checked). 
    1. If your Facebook Lead Ad leads are not currently synced with your CRM through another integration, then you should select yes here. This will ensure your Facebook Lead Ad leads are being added to your CRM.
    2. If you choose to sync Facebook and your CRM, then you'll be asked to select which CRM you'd like to connect to. Simply select the CRM you'd like the lead flow to populate in.
    3. This feature only works to sync lead data into one CRM.  
  2. No, I do NOT want to sync my Facebook Lead Ad leads with my CRM (unchecked)
    1. Many advertisers using Facebook Lead Ads already have integrations that push their Facebook Lead Ads into their CRM.  If so, leave this unchecked. 
Once you make your choice, your settings will automatically be updated.

 

Which Ad Account would you like to select?
This is the final Facebook Authorization Setting available to you. If the Wicked authorized user has admin permissions to multiple Facebook ad accounts across different Business Managers, then we'll make all those ad accounts available to integrate with. You simply need to select the ad account you'd like to integrate with. 

  1. If you only have one ad account, then this should be selected by default. However, if you have multiple ad accounts to choose from, press the "Edit" button.
  2. Select the ad account, or accounts, that you'd like to integrate with.
  3. Then, click Assign.
  4. Success will show a screen similar to this: 

Great work! Your Facebook Ad Accounts are now integrated and your settings are completed. Now, to finish your integration, you'll need to add the Wicked Tracking Parameter to all of your Facebook Ads.

How to Add the Wicked Tracking Parameter

Adding the Wicked Tracking Parameter to your Facebook URLs is a fundamental step for Wicked Reports to track and attribute traffic coming from your Facebook ads. Luckily, Facebook Ads Manager makes this process relatively straightforward with a bulk update feature that can apply parameters across multiple ads at once.

Keep in mind that when you update your Facebook URL Parameters, Facebook will temporarily place your ads into review. This is expected, and most advertisers can safely proceed without any major disruption.  To learn how to add the Wicked Tracking Parameter, see:

If you have long-running ads with valuable social proof (likes, comments, and shares) that you don’t want to risk losing, be cautious before updating your URL Parameters. There isn’t a reliable way to test or confirm whether social proof will be preserved, so proceed carefully with any ads that are already performing well.

The risk is minimal (around 1%), but if social proof is lost, our team has occasionally been able to help recover it. If that happens, please email support@wickedreports.com for assistance.

    Once you've integrated your Facebook account and added your Wicked Tracking Parameter, your Facebook integration will be fully functional. That completes your Facebook setup!

    Learn: What's Next?

    How to Verify the Wicked Tracking Parameter has been added 

    The purpose of validating your Facebook Tracking Parameters is to ensure your campaigns receive proper attribution inside Wicked Reports. If the Wicked Tracking Parameter is missing or incorrect, your clicks, leads, and sales won’t be attributed to the campaigns they came from.

    At a high level, all we’re doing in this step is confirming that every active ad includes the required WickedSource and WickedID parameters.

    Here’s how to validate them:

    1. Login to your Facebook Ad manager
    2. Drill down to all the ad-level of the targeted Campaign you wish to validate
      Screen Shot 2023-03-16 at 8.21.31 PM
    3. Select all your ads
      Screen Shot 2023-03-16 at 8.20.29 PM
    4. Press the "Create Custom Report" button
      Screen Shot 2023-03-16 at 8.20.06 PM
    5. Press the "Customize" button and include the column named "URL Parameters"
      Screen Shot 2023-03-16 at 8.23.25 PM
    6. Verify the Wicked Tracking Parameter is added to every ad. Note: The Wicked Tracking Parameter looks like this:

      Screen Shot 2023-03-16 at 8.24.59 PM

    That's it! The Wicked Tracking Parameter has been added to all Facebook Ads and verified. Great job!

    What Happens Next?

    Well, now that you're Facebook Ad Accounts are integrated and your Wicked Tracking Parameter has been added:

    • Wicked Reports will start retrieving Ad costs at the campaign, ad set, and ad level.
    • Wicked Reports will start pulling in Facebook Clicks, and other relevant Facebook columns, into your Funnel Vision Report

    In addition, if the Wicked Tracking Script has been added to your website and forms, then: 

    • Wicked Reports will start tracking incoming Facebook clicks, detecting conversions from your CRM and Order Management Systems, and attributing revenue based on all our various models.
    • Your reports will begin to populate with Facebook Ad Attribution for all of the tracked clicks, leads, and sales that we've detected.
    If you haven't already integrated the Wicked Tracking Script on your website, read more on that here. This is a requirement for Wicked Reports to track conversions and populate your reports with ad data. So, go review that document next to make sure your Wicked Tracking Script has been set up. If you have any questions about it or need assistance in setting it up, then you can reach out to your onboarding specialist or customer support. We're always happy to help.

    FAQ

    1. How do I manually add Wicked tagging to a Facebook Ad?
      Simply add this text string to the URL Parameters field of your ad:

    2. When integrating Facebook, will all my historical Facebook data be pulled in?
      No. Only 90 days' historical data will be pulled in after your initial integration.
    3. Can I use Link Shorteners for my ad URLs?
      Yes. However, you need to make sure that you append the text:

      When redirection is complete, the website URL field in your browser should show the appended query parameters, else you need to adjust your redirect settings to allow pass-through parameters (most popular redirect services have this option).
    4. Can I use Link Redirects?
      Yes. However, you need to make sure that you append the final URL with:

      When redirection is complete, the website URL field in your browser should show the appended query parameters, else you need to adjust your redirect settings to allow pass-through parameters (most popular redirect services have this option).
    5. How do I turn on Facebook Lead Ads?
      Facebook Lead Ads is turned on automatically. If you have the correct permissions in your Facebook account, your Lead Ad leads will automatically be attributed to the correct Lead Ad campaign.
    6. For my Facebook Lead Ad "ad", why is Facebook showing a different number of "Leads" than Wicked Reports is showing?
      This is an expected behavior. It's due to the differences in the way the two reports calculate what a "lead" is, which means these two metrics are incomparable.

      In Wicked Reports, if we have already tracked the lead in our system, then the lead submission becomes subject to our re-opt-in logic. Our re-opt-in logic only credits the last re-opt-in that occurred on the same day, whereas Facebook is counting all opt-in submissions as a lead. This results in fewer leads being attributed to your Facebook Lead Ad campaign.
    7. For my Facebook Lead Ad "ad", why is Facebook showing leads but Wicked Reports is showing no leads?
      Likely, the Facebook user you have authorized with Wicked Reports does not have the proper permissions to the Facebook page where the form is hosted. Check to ensure your integrated user has the appropriate page permissions by visiting Facebook's Lead Access Manager on the page itself. If you have verified this yet are still seeing a discrepancy, then please reach out to support@wickedreports.com so that we can identify the cause.
    8. Does updating ads with Wicked source and ID for a Facebook Ad reset the learning phase of the Ad?
      1. Yes. Every edit you make (during the learning phase or after it) has some effect on delivery, but not every edit causes the ad set to reenter the learning phase. Only a significant edit causes an ad set to reenter the learning phase. Updating the Wicked ID manually is considered a significant edit because it's an edit to the ad creative.
      2. See this article by Facebook, "Significant Edits and Learning Phase", for more information.
    9. Why does my Facebook Ads say, "Posted (or Published) by wickedreports.com"?
      Have no fear - this is not customer-facing. This is only visible to the ad manager - Facebook updates this line with the last entity to edit the ad.

    10. Why did my Facebook Token expire?
      Here are the most common reasons your Facebook Token can expire:
      1. It expired automatically after 60 days.
      2. Inside Facebook, you change your login password or a security setting
      3. Your Facebook login lost access to the Facebook ads account that Wicked Reports used to get data.
      To fix these issues, simply deauthorize FB in your authorizations screen, log out of Wicked Reports, clear your cache, and log back in. In the case of option c, make sure you regain access before you re-auth.
    11. Why do I have missing costs?
      Facebook occasionally has a data delay with their API that impacts any 3rd-party integrator, Wicked Reports included. When our software recognizes this delay, Wicked Reports requests the cost data, once again, after two days to catch and update previously missing data.
    12. Why do I see an ID value as my campaign/ad set/ad name?
      This happens because your URL parameters have a UTM value that we could not associate with your paid marketing. Most commonly, we see that Facebook will sometimes auto-generate UTMs on ad URLs. While we catch most of these and attribute them to their respective record, there are some cases where the UTMs do not match your records. Thus, for example, you may see, in your reports, a campaign with the campaign name value of an ID instead of the actual campaign name.
    13. Why do I see Social Lead Gen as my campaign name on the Facebook channel?
      If you have the Wicked Tracking Parameter on your clicks, such as "wickedsource=facebook&wickedid=fish", then you'll see this click get attributed to the campaign name of Social Lead Gen in your reports. That's because your wickedid value is non-numeric. If you give it a text value, we automatically update the UTM to Social Lead Gen. 
    14. Does the FB column "Website Purchases" include FB's View-Through-Conversions?
      Short answer - sometimes.
      Long answer - this column pulls in the data that your Facebook account has for it. So, it depends on what attribution model you have set up for Facebook.  For Wicked Reports ad platform comparisons, you should say that it does.
    15. Why are my Adsets appearing in two different rows with slightly different names?
      If you're using an advantage + catalog campaigns, then you may see duplicate/phantom Adsets in your reports. That's because Facebook's AI is dynamically changing your Ad IDs to internal Ad IDs. This results in two different rows appearing in Wicked Reports.
      1. To fix it future forward, please update your dynamic ad id UTMs to the Ads actual ad id. This prevents  Facebooks AI from dynamically changing it.
      2. To fix it historically, first update your ad UTMs. Then, reach out to our support team to consolidate your duplicated rows.

    Additional Setup (optional):

    If you're interested, there are some optional choices that you can choose to set up with Wicked Reports. Remember, these are not required for a standard Facebook integration. However, if any of these apply to you, then simply read the corresponding instructions and take the actions outlined within the article.

    How do I activate Facebook Lead Conversion API?
    To activate the Facebook Lead Conversion API feature, read here.

    How do I activate Facebook Sales Conversion API?
    To activate the Facebook Sales Conversion API feature, read here.

    How do I set up Facebook Boosted Posts?
    You can read more on how to set up tracking for Facebook Boosted Posts here.

    How do I set up Facebook ads with ManyChat?
    You can read more on how to set up tracking for Facebook ads with ManyChat here.

    How do I set up Facebook ads with AdEspresso?
    You can read more on how to set up tracking for Facebook ads with Adespresso here.

    How do I manually upload historical Facebook Lead Ad leads?
    To manually upload historical Facebook Lead Ad leads, read here.

    Troubleshooting

    • Are you having difficulty trusting your Facebook Ad Tracking?
    • Do you feel like something is off or missing?
    • Are you experiencing one of these issues?
      • I have no costs, leads, or sales
      • I have costs but no leads or sales
      • I have costs and leads but no sales
      • I have leads and sales, but less than Facebook says

    Run through the Tracking Validation Checklist. This checklist is highly recommended, as it will walk you through the process you need to take to validate your tracking setup. If you're currently experiencing an issue, this checklist is designed to find it. However, if you're still experiencing the issue after running this checklist, then reach out to our customer support team and we'll help get things squared away!