Top Urls - v1

Strategy properties

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

Strategy usage

Overview

This strategy identifies the top pieces of 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 urls for your audience against a comparison audience you can see what content is uniquely engaging for the audience, as opposed to content that is popular in general across LinkedIn.

For each url identified the strategy tells you:

  • the number of members who have engaged with the url.
  • relatively how engaged your audience is with the url compared to your selected comparison audience.

Use cases

The strategy helps you answer questions such as:

  • For a defined audience, which are the pieces of content that are driving the most engagement?
  • For a defined topic, which are the pieces of content that are driving the most 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 pieces of content are seeing the most 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_urls",
        "version": 1,
        "parameters": {
            "keywords": {
                "any": ["cloud", "azure", "aws", "google cloud", "vmware"]
            },
            "audience": {
                "countries": ["united states"]
            },
            "comparison_audience": "global"
        }
    }
}

Which pieces of content are seeing the most 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_urls",
        "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,   
    "urls": [
        {
            "url": "http://example.com/content-1",
            "unique_authors": 10000,
            "interactions": 12000,
            "engagement_ratio": 1.4
        },
        {
            "url": "http://test.com/content-2",
            "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 url identified:

  • url - the url identified.
  • unique_authors - how many members engaged in with the url in the analyzed period.
  • interactions - how many engagements related to the url by members in the analyzed period.
  • engagement_ratio - relatively how engaged your audience is with the url 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 urls for the topic of 'cloud' for each of the two countries specified:

{
    "type": "strategy",
    "name": "example",
    "subscription_id": "cd99abbc812f646c77bfd8ddf767a134f0b91e84",
    "parameters": {
        "strategy": "top_urls",
        "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,
            "urls": [...]
        },
        "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)