Facebook Ads

This document covers the steps required to send conversion data from Gamesight Marketing Analytics to Facebook. This is a two-way data sync that pushes your conversions to Facebook Ads enabling automated install-based optimization, in addition to pulling cost metrics in from Facebook which enables ROAS reporting in Gamesight.

Integration Comparison

Please use the table below to compare the different levels of integration that can be achieved with your Facebook ads

Base

Standard (Data Sync)

Full (Postbacks)

Required Steps

Steps 4-6 only

Steps 1-6

Steps 1-6 & "Postback Conversions"

Impressions

None

Impression volume sync

Impression volume sync

Clicks

Click-through attribution

Click-through attribution

Click-through attribution

Conversion Tracking

Yes

Yes

Yes + postback conversions to Facebook Pixel

Cost

None

Ad spend sync

Ad spend sync

Report Structure

Syncs with Facebook campaign structure

Syncs with Facebook campaign structure

Syncs with Facebook campaign structure

  • All Facebook campaigns are measured with click-through conversions only. Even with the Impression volume sync integration enabled.
  • Impression volume and ad spend sync processes can be delayed by up to 6 hours compared to Facebook reporting
  • Retargeting & Optimization If you would like to perform retargeting or automated ad optimization on conversions, please see the postback section of this guide

Standard Integration

The following guide walks you through the process for linking your Facebook account for the Standard Facebook integration.

1. Link your Facebook Ads Account

First, you will need to link your Facebook Ads account to your Gamesight account. You can do this by opening the drop-down by your name at the top right of the page followed by selecting Settings.

On this page you will find a button labeled "Link Facebook Account" which will bring you through the Facebook oAuth flow and request permission to your Facebook Ads account.

Facebook will now ask you to confirm that Gamesight can get access to your Ad account.

Once the oAuth flow is completed you should see your Ad account(s) listed as shown below.

🚧

Facebook Ads Accounts

Note that you will see all of your Facebook Ads accounts listed here. No one else will be able to see your list of Ads accounts and Gamesight will not sync any campaign information from these accounts. We only pull reporting information from Ads Accounts that you have completed the Request Access flow for. You will white-list Teams with access to your account in a later step.

2. Approve Business Manager Request

From here, you will need to press "Request Access" on the Ad Account that you would like to measure with Gamesight. Once you press this button, we will send a request on Facebook to access that Ads account via Business Manager.

Now you can switch over to your Facebook account and find the Account Access Request notification.

Clicking on the notification should bring you to your Ad account settings.

Clicking on "Response to Request" will bring up a screen enabling you to approve the request.

Once this step is complete you should see Gamesight as an Agency attached to your Ad account.

Return to the Gamesight Console and upon refresh you should see the status of your account as "Approved", meaning your Ad account is ready to be used by Gamesight!

3. Share your Facebook Account

Next, you'll need to grant your other team members access to use this account. To do this, press the "Manage" button next to your linked Facebook account. This should bring up the Facebook account management modal.

From here you can select the teams that you want to grant access to. This will allow all members in the team to create Trackers and see reporting details for that Facebook Ad Account.

4. Create your Tracker

Now that you have your account linked you should proceed to create a new Facebook Network Tracker.

You should see that your Facebook account is automatically populated in the drop-downs on the Tracker creation screen. Select your Pixel and click "Finalize and Review". Do not continue on to the Campaign step!

Once you have your Tracker created, copy the click tracker. It should be of the following form:

https://gsght.com/c/XXXXXX?campaign={{campaign.id}}&campaign_name=
{{campaign.name}}&ad_group={{adset.id}}&ad_group_name={{adset.name}}
&ad={{ad.id}}&ad_name={{ad.name}}

👍

Just use the Network Tracker!

You do not need to proceed to the Campaign / Ad Group / Ad levels of Tracker creation for the Facebook integration. Simply copy your full Network-level Tracking link and Gamesight will automatically mirror the Campaign structure that you set up in your Facebook Ads account.

5. Setup your Facebook Campaign

To track your Facebook campaigns all you need to do is drop your Gamesight tracking link in as the Destination URL for your Facebook Ad!

You should be ready to run your campaign now! You can use the same Tracking link for multiple Facebook Ads Campaigns. Gamesight will automatically separate out your traffic all the way down to the Ad level.

6. Measure and Optimize

After running your Facebook campaign for a day or two, you should start to see campaign performance details in your Gamesight reports. You'll automatically get impression, click, and cost data for all of your Facebook campaigns.

Postback Conversions to Facebook

Gamesight, in partnership with Facebook, has created an integration for sending conversion data from your game back to Facebook. This enables automated optimization towards install, in addition to unlocking re-targeting, exclusions, and audience creation!

Facebook Pixel

Sharing access to the Facebook Pixel with Gamesight is quick and easy! The following steps walk you through this process using Facebook Business Manager.

1. Go to the Partners page in your Business Manager.
2. Click on "Gamesight" in the Partner listing or enter our Business Manager ID 500711843669397.
3. Click the "Share Assets" button.
4. Provide Manage Pixel permissions to the pixel that you want Gamesight to post conversions to.
5. Click "Save Changes".

Once you have completed the above steps to share pixel access, please contact us through live chat or email us at [email protected] so that we can finalize the setup on our end and walk you through Tracker configuration.

Mobile Postbacks (Optional)

The following steps are only necessary if you are seeing low match rates in Facebook Ads Manager. The standard Postback integration described above this step works for both Desktop and Mobile users alike. You do not have to complete this portion of the integration unless you are seeing low match rates.

If you are seeing low match rates in Facebook, you can set up a landing page where both the Facebook Pixel and Gamesight Web SDK are placed.

Here is an example of the completed integration code:

<script>
/* Including the Facebook Pixel snippet */
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window, document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
  
/* Including the Gamesight Web SDK snippet */
(function(G,m,s,g,h,t){G.gsght=G.gsght||function(){
(G.gsght.q=G.gsght.q||[]).push(arguments)},G.gsght.q=[],G.gsght.h=1*new Date();
h=m.createElement(s),t=m.getElementsByTagName(s)[0];h.async=1;h.src=g;t.parentNode.insertBefore(h,t)
})(window,document,'script','https://cdn.gsght.com/sdk.js');

/* Configuring both the Gamesight Web SDK and Facebook Pixel */
gsght('init', 'GS_WEB_SDK_ID_HERE', 'web');
gsght('set', 'fb_enabled', true);
gsght('send');

gsght('onload', function(){
  fbq('init', 'FB_PIXEL_ID_HERE', {'external_id': gsght('get', 'gsid')});
  fbq('track', "PageView");
});
</script>

In the integration code above, please be sure to replace the following two placeholders with actual data.

  1. Replace GS_WEB_SDK_ID_HERE with your Gamesight Web SDK ID.
  2. Replace FB_PIXEL_ID_HERE with your Facebook Pixel ID.

Once this code is placed on your landing or marketing page, ensure all of your Facebook ads drive traffic to this page. This should increase the match rates that you are seeing in Facebook.

📘

iOS 14 ATT Update

Starting with iOS 14's App Tracking Transparency (ATT) prompt, Facebook is making several changes to their ads platform. Fortunately, most of these changes won't directly impact campaigns for PC/Console games!

The one change that may have an impact is Aggregated Event Measurement (AEM). Put simply, if your campaign targets iOS 14 users, you will be limited to optimize your campaign to no more than 8 unique Events on your Facebook Pixel (or 4 if you enable Value Optimization). You can find settings related to configuring AEM through your Facebook Events Manager tools.

Additionally, iOS 14 users who opted out through ATT will have a maximum of a 1-day click through attribution window on the Facebook platform - this means that for opted out users you will only be able to optimize towards conversions that occur within 1 day of ad click. This has no impact on Gamesight's attribution windows or built-in reporting.

Note that in all cases, Gamesight's attribution will be unaffected by these changes and will continue to send all Goals and conversion events to your Facebook pixel. The only limitation will be restrictions on how those events are used for optimization in the Facebook Ads platform for certain types of campaigns.

Multiple Landing Pages

Since Gamesight uses a single tracking link for all of your Facebook campaigns, it isn't possible to use the normal tracker management tools to control the landing pages for your campaigns. If you want to direct users to different landing pages you will need to use the destination_url parameter on your tracking link to control the page.

For example, if you wanted to override the landing page for your ad to direct to Google, you would append the URL to the end of your link as shown in the example below.

https://gsght.com/c/XXXXXX?campaign={{campaign.id}}&campaign_name=
{{campaign.name}}&ad_group={{adset.id}}&ad_group_name={{adset.name}}
&ad={{ad.id}}&ad_name={{ad.name}}&destination_url=https://google.com

You can read more about using the 'destination_url' parameter in our URL Parameters & Macros guide.

Multiple Postbacks

If you would like to set up additional postbacks from Gamesight to Facebook Ads, you can complete the example template provided below. Once you have this template completed, please contact our support team and we can finalize/map the new postbacks for you!

Gamesight Goal Name

Gamesight Goal ID

Facebook Event Name

Account Created

1

Account Created

New Signup

2

New Signup

Trial Started

3

Trial Started

Troubleshooting

In the table below, we go over some common questions surrounding Facebook campaigns, performance, etc.

Issue

Resolution

Campaigns report showing discrepancies in install/click volume/performance.

Hovering over the "Clicks" number for each Facebook campaign will show you the number of clicks recorded by Gamesight versus the number reported by Facebook. The Gamesight number should be larger than Facebook (FB filters traffic that we do not).

Campaign shows few or 0 clicks from Gamesight.

Double check that the Gamesight tracking link is set up in the Facebook campaign as the Destination URL.

Campaign name in Gamesight reporting dashboard appears as "{{campaign.name}}".

This is a result of Facebook bots checking the link automatically. Once you begin trafficking your ads and real/legitimate traffic is generated, macros will be replaced with your actual campaign names.

Attribution testing triggered the Install goal, but there is no activity on the Facebook Pixel.

Postbacks to Facebook will only work for real/legitimate Facebook ads traffic. Once you begin trafficking your ads, installs will begin to post back to Facebook.


Did this page help you?