How to promote other games on facebook

Cross-promoting Your Games to Your Players

Overview

When new players first login to an instance of your game which uses Graph API 2.0 or above, or has been upgraded to use Graph API 2.0, Facebook will issue you an app-scoped user ID. This means the ID for a person will be different between each game they play.

When promoting a new game, many developers rely on cross-promoting to players of their other existing titles. To do this effectively, you need to be able to correlate a given person’s ID across the multiple apps your business operates, or surface a person’s friends who play your other games.

This guide introduces tools to help with cross-promotion, and shows you how to use them effectively so that players can discover your titles across the Facebook platform.

Cross-promoting a new title, Friends Match, to a player in Friend Smash

The Benefits of Cross-Promotion

Successful game developers usually have several titles available to play at one time. Acquiring sufficient players for these titles individually can be a challenge. When launching a new game, it will often be beneficial to promote that game to players of your existing products, since this is an already-engaged audience who trusts your developer brand.

It is therefore useful to get to know your players across the multiple games you operate, so that you can make informed predictions about whether they’ll enjoy any new products you launch. To achieve this, it is important that you can maintain a shared view of your players across all of your apps.

Depending on the style of your game, you may want to identify highly engaged players and promote a new title to them when they reach a certain level or have played for a certain duration. Alternatively, you might want to identify players who have become stuck on a level, or who are struggling to make progress within the game, and suggest one of your other titles to retain their interest.

When recommending a game, it’s worth checking whether the player already plays that title, or if they’ve played it and chosen not to return to it regularly. It’s also useful to show information on a user’s friends who play a title when cross-promoting it.

King cross-promoting their additional titles in Candy Crush Saga

Facebook provides several tools and APIs that can help you implement an effective cross-promotion campaign between your products on the Facebook platform.

Correlating a Player’s IDs Across Applications

When you use Login 2.0 to authenticate a new player in your game, the user ID issued will be an app-scoped ID. This means that the same person’s ID will not be usable within the context of another app.

Let’s take an example. If you’re a developer with two popular games Friend Smash and Friends Match, and a person plays both games, their user IDs will be different in both apps.

Since the IDs issued for a given person can differ between apps, developers need to correlate IDs between the apps they operate, to determine whether the same person is playing their other titles.

Developers can use the Business Mapping API for this purpose. The Business Mapping API returns an array of a person’s IDs for each application operated by the developer, which the person has logged into.

To use the Business Mapping API, you need to tell Facebook about the multiple titles you operate. This is done via the Business Manager tool. To get started, follow our Business Manager setup guide. Once you’ve setup your business in Business Manager, you can call the Business Mapping API to correlate a person’s IDs across the multiple games you operate.

To use the API, you make a call to /v2.0/me/ids_for_business using a user access token for one of the apps associated your business. The response will contain an array of user IDs for the given user in each of the other games, associated with your business, which the player has installed. You can use this array of IDs to establish if the person has installed any of the other apps operated by your business, and form a cross-promotion strategy as appropriate.

Below is an example query:

Graph API Explorer
GET /v2.0/me/ids_for_business HTTP/1.1
Host: graph.facebook.com

and an example response:

{
  "data": [
    {
      "id": "10150002139440507", 
      "app": {
        "name": "Friend Smash", 
        "namespace": "fs_simp_testing", 
        "id": "771769079514414"
      }
    }, 
    {
      "id": "10150002152773845", 
      "app": {
        "name": "Friends Match", 
        "namespace": "ctfsmapping_iv", 
        "id": "229453687244469"
      }
    }, 
    {
      "id": "10150002126915072", 
      "app": {
        "name": "Other App", 
        "namespace": "ctfsmapping_iii", 
        "id": "725533150800292"
      }
    }, 
    {
      "id": "10150002126916017", 
      "app": {
        "name": "FS Mapping Test 2", 
        "namespace": "ctfsmapping_ii", 
        "id": "658304984206017"
      }
    }, 
    {
      "id": "10150002126915792", 
      "app": {
        "name": "FS Mapping Test 1", 
        "namespace": "ctfsmapping_i", 
        "id": "1416533201941607"
      }
    }, 
    {
      "id": "499871421", 
      "app": {
        "name": "Friend Smash!", 
        "namespace": "friendsmashsample", 
        "id": "480369938658210"
      }
    }
  ], 
  "paging": {
    "cursors": {
      "before": "NzcxNzY5MDc5NTE0NDE0", 
      "after": "NDgwMzY5OTM4NjU4MjEw"
    }
  }
}

You can also use the user IDs returned by the Business Mapping API along with your own game state data to match a player’s profile across multiple titles. This allows you to establish, for example, how far a given person has progressed across your titles, or to check how many of your players play additional games you operate.

You can use this information as you desire, for examples, by rewarding players in one app for progress in another, or to build loyalty programs for players across multiple titles. With this approach, you can also provide unified CRM support for a player across the spectrum of your product lineup, or improve your fraud detection for in-game purchases.

Using the Social Context API to Show Friends Playing Your Other Titles

Once you have setup your apps in Business Manager, you are also able to use the Social Context APIto show a person a list of their friends who are already playing one of your other titles.

To call the Social Context API, you request the context field on an application object, where that app is also owned by your business. By default, this will return the friends_using_app context edge, which lists the user’s friends who play this game.

Below is an example query:

Graph API Explorer
GET /v2.0/647733625268125?fields=context HTTP/1.1
Host: graph.facebook.com

and an example response:

{
  "context": {
    "friends_using_app": {
      "data": [
        {
          "id": "7696", 
          "name": "Steve Davis"
        }, 
        {
          "id": "9074", 
          "name": "Mike Vernal"
        }, 
        {
          "id": "19094", 
          "name": "Nick Grudin"
        },
        {
          "id": "213358", 
          "name": "Bear Douglas"
        },
        {
          "id": "403902", 
          "name": "James Yu"
        }
      ], 
      "paging": {
        "next": "https://graph.facebook.com/v2.0/163114453728333?fields=context.fields(friends_using_app.limit(5).pretty(1).after(MTkwOTQ=))", 
        "cursors": {
          "before": "NTk0Mw==", 
          "after": "MTkwOTQ="
        }
      }, 
      "summary": {
        "total_count": 259
      }
    }
  }, 
  "id": "647733625268125"
}

The Social Context API returns context data in two formats:

  • An array, data comprising the current player’s friends who play the app being queried against.
  • A summary field containing a total count of the current player’s friends who play the app being queried against.

Be aware that the data array will only contain friends who have granted the user_friends permission to the app being queried against, so the total_count may be larger than the length of the data array.

Note: The id field returned for users from a friends_using_app query is scoped to thecalling app rather than the subject app.

You can then use this data to add some context when showing players a new title, by displaying names and pictures of a player’s friends who play that game.

Social context used to cross-promote between two games.

Source taken from facebook.com