Top Company Mentions - v1

Try in the Media Strategies API Explorer

Strategy properties

Strategy id top_company_mentions
Version 1
Supports grouping? Yes
Learn more...
Cost #groups x 3
Learn more...

Strategy usage

Overview

This strategy identifies the companies most mentioned in content seeing engagement from an audience.

The strategy allows you to select an audience using demographic attributes, by a topic being engaged with, or both. The strategy also allows you to specify an audience to compare your audience against.

By comparing the companies mentioned in content seeing engagement by your audience against a comparison audience you can see which companies are uniquely engaging for the audience, as opposed to companies mentioned in content that is popular in general across LinkedIn.

For each company identified the strategy tells you:

  • the number of members who have engaged with content mentioning the company.
  • relatively how engaged your audience is with the company mentioned compared to your selected comparison audience.

Use cases

The strategy helps you answer questions such as:

  • For a defined audience, which companies are mentioned the most in content that is driving engagement?
  • For a defined topic, which companies are mentioned the most in content that is driving engagement?

Parameters

To execute this strategy without grouping you must provide specify at least one of the keywords, concepts, or audience parameters. To execute this strategy with grouping you must specify the groups parameter.

Parameter Type Required? Description
audience audience

At least one of 'keywords', 'concepts', and 'audience' must be given.

Selects the audience to analyze.

concepts concepts

At least one of 'keywords', 'concepts', and 'audience' must be given.

Concepts for the topic to analyze.

keywords keywords

At least one of 'keywords', 'concepts', and 'audience' must be given.

Keywords for the topic to analyze.

period period

No. Defaults to 28 days.

The time period to analyze.

sort_by sort_by

No. Defaults to engagement_ratio.

The output field to sort results by.

comparison_audience comparison_audience

Yes.

The audience to compare engagement with.

groups

No.

Groups to perform analysis for.

See Learn more...

Example requests

The following examples show which parameters should be submitted to the API to answer the stated questions.

Which companies are mentioned the most in content that is seeing engagement from members in the US for the topic of 'cloud', compared to the global audience?

{
    "type": "strategy",
    "name": "example",
    "subscription_id": "cd99abbc812f646c77bfd8ddf767a134f0b91e84",
    "parameters": {
        "strategy": "top_company_mentions",
        "version": 1,
        "parameters": {
            "keywords": {
                "any": ["cloud", "azure", "aws", "google cloud", "vmware"]
            },
            "audience": {
                "countries": ["united states"]
            },
            "comparison_audience": "global"
        }
    }
}

Which companies are mentioned the most in content that is seeing engagement from decision makers in the UK for the topic of 'cloud', compared to the general UK audience?

{
    "type": "strategy",
    "name": "example",
    "subscription_id": "cd99abbc812f646c77bfd8ddf767a134f0b91e84",
    "parameters": {
        "strategy": "top_company_mentions",
        "version": 1,
        "parameters": {
            "keywords": {
                "any": ["cloud", "azure", "aws", "google cloud", "vmware"]
            },
            "audience": {
                "countries": ["united kingdom"],
                "seniorities": ["manager", "director", "vp", "cxo", "partner", "owner"]

            },
            "comparison_audience": {
                "country": "united kingdom"
            }
        }
    }
}

Here the parameters request that only members in the UK in senior positions are analyzed and their engagement is compared to all members in the UK.

Output

If the strategy is successfully executed it will return output with the following structure:

{
    "redacted": false,
    "unique_authors": 92000,
    "interactions": 103000,   
    "company_mentions": [
        {
            "company": "IBM",
            "unique_authors": 10000,
            "interactions": 12000,
            "engagement_ratio": 1.4
        },
        {
            "company": "Trifacta",
            "unique_authors": 13000,
            "interactions": 11300,
            "engagement_ratio": 1.23
        }
    ]
}

If the redacted property is true then not enough data was found for the analysis. Consider widening your topic or audience for your analysis.

The following properties are returned for each company identified:

  • company - the name of the company identified.
  • unique_authors - how many members engaged with content that mentioned the company in the analyzed period.
  • interactions - how many engagements related to content mentioning the company by members in the analyzed period.
  • engagement_ratio - relatively how engaged your audience is with the company compared with your selected comparison audience.

Grouping

The strategy supports analysis by multiple groups. Learn how to run strategies with grouping by reading our Performing grouped analysis developer guide.

As an example the following parameters will analyze the top company mentions for the topic of 'cloud' for each of the two countries specified:

{
    "type": "strategy",
    "name": "example",
    "subscription_id": "cd99abbc812f646c77bfd8ddf767a134f0b91e84",
    "parameters": {
        "strategy": "top_company_mentions",
        "version": 1,
        "parameters": {
            "keywords": {
                "any": ["cloud", "azure", "aws", "google cloud", "vmware"]
            },
            "comparison_audience": "global",
            "groups": {
                "list": {
                    "countries": ["united kingdom", "france"]
                }
            }
        }
    }
}

When run with grouping the output of the strategy gives a set of results for each group within the 'groups' property. For example:

{
    "groups": {
        "united kingdom": {
            "redacted": false,
            "unique_authors": 92000,
            "interactions": 103000,
            "company_mentions": [...]
        },
        "france": {
            ...
        },
        ...
    }
}

Usage costs

The cost of running the strategy is based upon the number of groups you specify.

If you run the strategy without grouping then the cost is 3 analysis tasks.

If you run the strategy with grouping then the cost is:

Analysis tasks consumed = 3 x (number of groups)

note icon

Note that if you specify groups for your analysis using the 'top' parameter the strategy will run an extra analysis task to fetch the top segments to be used for the grouped analysis. As a result one additional analysis task will be consumed.