Facebook Ads

This guide helps you connect Gamesight with Facebook Ads so you can see which Facebook campaigns are driving conversions and optimize your ad spend.

Attribution Features

As a Gamesight attribution customer, linking your Facebook Ads account to your Gamesight Tracker will enable you to:

• See Facebook campaign performance alongside your other marketing channels in Gamesight
• Track which Facebook ads are driving actual game installs (not just clicks)
• Send conversion data back to Facebook so their algorithm can find more players like yours (automated, install-based optimization)
• Compare cost-per-install (CPI) and return on ad-spend (ROAS) across all your marketing channels

Cost Aggregation Features

Simply linking your Facebook Ads account to Gamesight will enable Cost Aggregation, which includes:

• Syncing Facebook's reported Clicks, Impressions, and Cost data (alongside your other marketing channels) into your Gamesight reporting

Integration Steps

1. Link your Facebook Ads Account

🚧

Facebook Ads Account & Gamesight Data Syncing

Before proceeding with the account linking steps outlined below, please be sure that you are linking a game-specific Facebook Ads Account.

This Facebook integration enables all active campaigns running in your Facebook Ads Account to sync back into Gamesight's reporting (including network reported Impressions, Clicks and Cost data).

To link your Facebook Ads account to Gamesight:

1. Click your name at the top right-hand side of Gamesight Console.
2. Click Settings.

1. Scroll down to "Facebook Linked Accounts" and click "Link Facebook Account":

4. Allow/Confirm Gamesight's access:

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 above, but don't worry—Gamesight only pulls data from the accounts that you specifically enable/choose in the next steps.

2. Share Partner Access with Gamesight

Facebook requires you to add Gamesight as a "Partner" in order to access your campaign data:

1. From your Facebook Ads/Business Manager dashboard, go to Ad Accounts
2. Select your Ad Account.
3. Click Assign Partner.

4. Enter Gamesight's Business ID 500711843669397 and assign View Performance permissions:

After a few minutes, return to your Gamesight Settings page and your account status should show as "Approved."

3. Share Gamesight Team Access

1. From your Gamesight Settings page, press the "Manage" button next to your linked Facebook account.
2. Check the Allow Access box next to the Gamesight Teams that will be using this 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.

If it is not, you can select your Facebook Ads Account and Dataset manually, followed by clicking "Next".

📘

Integration Complete!

Your integration enabling Cost Aggregation is complete!

The remainder of this documentation will only be helpful to Gamesight Attribution customers

Attribution - Campaign Setup

For each Facebook campaign that you want to enable attribution for, you need to:

1. Open your campaign in Facebook Ads Manager.
2. In the Ad level, find the Destination URL field.
3. Add the Gamesight Click URL from your Facebook tracker (created in Step 4 above) into the Destination URL field:

Gamesight Click URL

Your Click Tracker for Facebook will look something like this:

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 can use this same tracking link for all of your Facebook campaigns. Gamesight automatically separates the data by Campaign, Ad Set/Group, and individual Ad.

Multiple Landing Pages

If you want to direct users to different landing pages, you can simply use the destination_url parameter on your tracking link to control the page.

In the example below, we're sending users to google.com instead of our default destination URL. Note the &destination_url=https://google.com/ parameter appended to the end of the tracking link:

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.

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. Report syncing between Gamesight and Facebook can be delayed by several hours (while Gamesight measurement/reporting is near real-time).

Postback Conversions to Facebook

Gamesight, in partnership with Facebook, has created an integration for sending conversion data from Gamesight back to Facebook, which enables Facebook to:

• Show your ads to people more likely to install, purchase DLC, etc.
• Create lookalike audiences based on your actual players, while excluding existing players from seeing install ads

Dataset - Share Partner Access

To share Dataset access with Gamesight, you will need to:

1. Go to the Partners page in Facebook Business Manager.
2. Click on "Gamesight" in the Partner listing or enter our Business Manager ID 500711843669397.
3. Click the "Share Assets" button.
4. Enable the Full Control - Manage Events Dataset permission.
5. Click "Assign".

❗️

Contact Support to Enable Postbacks

In order to enable postbacks to your Dataset (formerly Meta Pixel), you will need to contact us once you have shared Dataset access with Gamesight. Please open alive chat or email us at [email protected] so that we can finalize the setup for postbacks on our end.

Postback Configuration

Postbacks will need to be configured on the Integration tab of your Facebook tracker in Gamesight. Please check out our Postbacks documentation for a walk-through!

Postback Event Names

Facebook provides a set of Standard Event Names that you can utilize to name your Postbacks in Gamesight. Using a Standard Event Name will require no additional work in Facebook to see and utilize your postback data in your Facebook campaigns.

🚧

Non-Standard Event Names

Using an Event Name that is not in Facebook's list ofStandard Event Names will require you to set up a Custom Conversion Event in Facebook Ads.

Custom Conversion Events

If you are using a non-standard Event Name for your postback from Gamesight to Facebook, you will need to set up a Custom Conversion Event in Facebook in order to see and utilize the postback data in your campaigns. To do this:

1. Open your Meta Dataset (formerly "Meta Pixel") in Events Manager
2. Click "Create > Create Custom Conversion". In the image below, you will see an example of a Custom Conversion Event.

Once you have received at least one postback with a non-standard name in your Dataset, you should be able to find the postback under the list of "Custom events" as shown in the image below.

A Custom Conversion Event requires at least 1 "Rule". The Rule can be filled out at your discretion, however you can make the Rule something simple such as: URL > Contains > .

By entering a period in the text field below "URL > Contains" you can click the "+" button on the right to add the period as a rule. The logic behind this simplified rule helps to avoid any potential issues as we know that every URL has to have a "." in it.

Additional Match IDs for Postbacks (Optional)

📘

Additional Match ID Use Cases

The following steps are only necessary if you are seeing low match rates in Facebook Ads Manager or if you would like to send unattributed conversions to your Meta Dataset (formerly "Meta Pixel").

Gamesight's default configuration will include a Facebook Click ID value on all Postbacks .

Gamesight supports multiple additional matching methods into the Meta Dataset. These can be helpful for increasing match rate, or to send unattributed/organic installs back to your Meta Dataset.

External ID Sync (Optional)

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

Here is an example of the completed integration code:

<script>
/* Including the Meta 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 Meta 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 Meta 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 utilizing our mapped external ID as well as automatically pulling in the fbp browser ID value.

Email Matching (Optional)

You can pass hashed email data as an external ID with your event integration to enable email matching on conversion uploads into Facebook. Below is an example making this association in the Measurement API.

curl https://api.ingest.marketing.gamesight.io/events \
    -X POST \
    -H 'Authorization: SOMEAPIKEYHERE' \
    -H 'X-Api-Version: 1.1.0' \
    -H 'Content-Type: application/json' \
    -d "$(cat <<-EOF
  {
    "user_id": "b91f8k5r",
    "type": "game_launch",
    "ip": "172.123.245.14",
    "external_ids": [
         {
              "external_id_type": "email",
              "external_id": "f1904cf1a9d73a55fa5de0ac823c4403ded71afd4c3248d00bdcd0866552bb79",
              "sha256": "client"
         }
    ]
  }
EOF
)"

• Note that the external ID association only needs to be made once - it is not a requirement that you pass the email with every event.
• The email format must be SHA256 hash of the email, lowercase, trimming whitespace as outlined in Facebook's Documentation
• If you would prefer to send unhashed emails you can use "sha256": "server" to request email hashing

IP and User-Agent (Optional)

Gamesight can be set up to transfer your users' IP addresses and User-Agent values to your Dataset, enhancing match rates. This integration involves sending an un-hashed IP address to Facebook, which Gamesight typically doesn't store (we usually hash IPs upon receipt).

🚧

Contact support!

Once you have implemented one of the above strategies, please contact Gamesight Support so that we can validate the implementation and enable the data flow to your Facebook Dataset. The additional IDs will not be utilized until Gamesight confirms the implementation.

Troubleshooting

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