Managing Tokens and Targeted Data

Along with the many other sources in Listen, you can use Listen to track conversations on Facebook and Instagram. In order to remain compliant with Facebook’s policies, it’s important that users provide Authentication Tokens for your own Facebook Pages and Instagram Business Accounts.

Using your Authentication Token, you can then pick and choose which Facebook and Instagram data you would like to track in Listen.

In this article, find out more about Authentication Tokens in Listen and how to target the right Facebook and Instagram sources.

Note:

All features in this article are only available to Falcon users with a user role of Team Leader or Admin.

What Targeted Data Sources Are Available in Listen?

In Listen, it’s possible to track several different sources for Facebook and Instagram content. You can manually choose which sources to include in your Listen searches. There are four Targeted Data Sources available:

Owned Facebook Page
A Facebook Page your organization owns. Tracking your own Facebook Page gives you access to the Page’s posts and ads along with all comments.
Owned Instagram Account
An Instagram Business Account your organization owns. Tracking your own Instagram Account gives you access to all media published by the account, all comments on the account’s media, and all tags and @mentions of the account.
Non-owned Facebook Page
A Facebook Page which is not owned by your organization, such as a competitor's Facebook Page. Tracking a non-owned Facebook Page gives you access to the Page’s posts and comments.
Instagram Hashtag
Any existing Instagram Hashtag. Selecting any Instagram Hashtag allows you to track all public posts and media shared using the hashtag.

Your organization can add up to 100 Targeted Data Sources in total. In order to begin tracking any of the above Facebook and Instagram data sources though, you will first need to create a Facebook Authentication Token.

What is an Authentication Token?

An Authentication Token may otherwise be known as an access token – It allows Listen to access data via Facebook’s API on your behalf. An Authentication Token is created by you signing into Facebook via Listen and agreeing to provide Listen with access to data relating to your Facebook Pages and Instagram Business Accounts. Unlike other sources in Listen, Authentication Tokens are required to allow Listen to successfully track Facebook and Instagram mentions.

There are two types of Authentication Tokens you can create in Listen: User tokens and Page tokens.

User tokens

If you don’t have access to any Facebook Pages or Instagram Accounts, or you decide not to provide access to those you do have access to, only a user token will be created.

Creating only a user token will only allow you to add and track non-owned Facebook Pages. You will not be able to track any other Targeted Data Sources.

Page tokens

If you agree to provide access to your owned Facebook Pages and associated Instagram Business Accounts, a Page token will be created for each.

Creating a Page token for only your Facebook Pages will allow you to track:

  • Your owned Facebook Pages
  • Non-owned Facebook Pages

Creating a Page token for Facebook Pages and associated Instagram Business Accounts will allow you to track all available Targeted Data Sources:

  • Your owned Facebook Pages
  • Your owned Instagram Business Accounts
  • Non-owned Facebook Pages
  • Instagram Hashtags

Creating Authentication Tokens

To get started creating a Facebook Authentication Token, please follow the steps below:

Note:

In order to successfully connect with a Facebook Page or Instagram Account, you will need to have an Admin user role natively on Facebook.

  1. In Listen, click the Settings (cog) icon form the top right.
  2. Click Manage tokens and targeted data.mceclip0.png
  3. Under the Authentication tokens tab, click Connect with Facebook.mceclip1.png
  4. On the Facebook popup, log in using your Facebook login credentials (or, if already logged in, click Continue as...).
  5. Select which Instagram Accounts you would like to use with Listen then click Next.
  6. Select which Facebook Pages you would like to use with Listen then click Next.
  7. When the list of permissions appears, please make sure that all permissions are toggled to YES.
  8. Click Done.

When the popup closes, you will see your user token along with any applicable page tokens listed under Facebook Tokens. You will see the page name, token type, any linked Instagram accounts, the status, and the token creation date. If the status shows as inactive, please create a new token by repeating the steps above.

mceclip3.png

Note:

Creating an Authentication Token does not contribute to your organization’s Targeted Data Source limits. You can create as many Authentication Tokens as you like, giving you the option to add and remove Targeted Data Sources later if needed.

Adding additional Authentication Tokens

Once you have already created Authentication Tokens and granted access to a select amount of Pages and Instagram Accounts, you can't add additional pages by following the same steps in Listen.

Instead, you can grant Listen access to more Pages and Instagram Accounts directly on Facebook. Please see the steps below:

  1. Log into Facebook and visit Settings > Business Integrations (Follow this link)
  2. Locate the Brandwatch Integration and click View and edit.mceclip2.png
  3. Locate and select the check box beside any additional Pages or Instagram Accounts you would like to add to Listen.mceclip3.png
  4. Click Save.
  5. Follow the steps above to find and create an Authentication Token for the new Page or Instagram Account.

Inviting another user to create Authentication Tokens

If you’d like to create a Page token for a Page or Account you don’t have access to, consider sharing the link with someone who does.

Under the Authentication Tokens tab, look for the invite link in the middle of the page. Select Copy to copy the link to your clipboard. You can share the link with anyone inside or outside of Falcon.

mceclip4.png

When the user clicks the link, they will be invited to authenticate with Facebook and follow the steps shown below.

blobid2.png

Adding Targeted Data Sources to Listen

When you have successfully added Authentication Tokens to Listen, you can begin adding Targeted Data Sources by following the steps below:

  1. In Listen, click the Settings (cog) icon form the top right.
  2. Click Manage tokens and targeted data.
  3. Click the Targeted Data Sources tab.
  4. From the right-hand side, click Add.

Next, you can choose which data source you would like to add. Please see below for more information on adding each type of data source.

mceclip5.png
Adding an owned Facebook Page or Instagram Business Account
When you choose to add an owned Facebook Page or Instagram Business Account, all available Pages and Accounts for which we have an Authentication Token will be listed. Use the search bar to locate and select the Page or Account then click Add Page(s).
Adding a non-owned Facebook Page
Find and enter the complete URL for the non-owned Facebook Page you would like to add (including https://www.). Next, click Add Page.
Adding an Instagram Hashtag

Each Authentication Token for an Instagram Account gives you access to a maximum of 30 Instagram Hashtags you may include in your Listen searches. When you add a Hashtag, it can only be deleted after seven days.

When you’re adding Hashtags, choose which token you would like to use, or else click Add New Authentication Token if applicable.

mceclip6.png

Next, enter your Hashtags, check the box to acknowledge the above limitations and click Add Hashtags.

Deleting Targeted Data Sources

To remove any existing Targeted Data Sources, please follow the steps below:

  1. In Listen, click the Settings (cog) icon form the top right.
  2. Click Manage tokens and targeted data.
  3. Click the Targeted Data Sources tab.
  4. In the list of Targeted Data Sources, locate the source you would like to delete.
  5. On the right-hand side, under Actions, click select the context menu (three dots).
  6. Click Delete.
mceclip7.png

Targeted Data Source Limits

In Listen, your organization will have the option to include up to 100 Targeted Data Sources.

This means each time you choose to add a new Targeted Data Source, such as one of your owned Facebook Page, an owned Instagram Account, a non-owned Facebook Page, or an Instagram Hashtag, you will contribute to the total.

You can see an overview of your Targeted Data Source usage by following the steps below:

  1. In Listen, click the Settings (cog) icon form the top right.
  2. Click Manage tokens and targeted data.
  3. Click the Targeted Data Sources tab.
  4. Look for your total and number of sources left at the top of the page.
mceclip8.png

Please be aware that adding Authentication Tokens will not contribute to your total. Adding Authentication Tokens simply provides you with a greater number of Targeted Data Sources to add/delete. Your organization can add as many Authentication Tokens as you like following the steps above.

FAQs

Can I add a non-owned Instagram Account as a Targeted Data Source?
No – Providing an Authentication Token for an Instagram Account will only give you the option to add up to 30 Hashtags or add your own Instagram Account as a source.
Is there a cap on the amount of Authentication Tokens I can create?
No – You can create as many Authentication Tokens as you like. Creating Authentication Tokens will not add sources to your Listen searches, but simply give you the option to add Targeted Data Sources.
Can I add a personal Instagram Account as a Targeted Data Source?
No – Authentication Tokens can only be created for Facebook Pages and any associated Instagram Business Accounts. It’s not possible to create an Authentication Token for an Instagram Personal Account
When I add a new Targeted Data Source, will they be considered historically as I create new searches?
Mentions and insights from newly added Targeted Data Sources can only be guaranteed going forward in time from the moment they is added to Listen. However, some historical data may be visible.
Was this article helpful?
0 out of 0 found this helpful