Grouping Parameters

The following parameters specify grouped analysis for those strategies which support this feature.

note icon


Learn get started with grouped analysis read our developer guide.

For strategies that support grouping you can specify one of the following parameters under the groups parameter to perform grouped analysis:

  • top - group by the top n values for a demographic dimension.
  • list - group by a set of values for a demographic dimension.
  • custom - group by arbitrary content and audience definitions.

The strategy will be repeat the analysis for each of the groups specified.

Grouping by 'top' demographic segments

The top parameter performs grouping by the largest demographic segments in an audience.

For example, if the 5 countries are specified, then the analysis will be performed for the 5 countries with the largest active audiences on LinkedIn.

The following demographic dimensions are supported:

  • countries - countries of members.
  • seniorities - seniority levels of members.
  • functions - job functions of members.
  • sectors - industry sectors of members.
  • industries - industry names of members.
  • company_sizes - company sizes of members.
  • custom_segments - custom segments that members belong to.

You can specify any one of the dimensions. The number of groups must be between 1 and 10.

For example, the following parameters will repeat analysis for the top 5 countries:

{
    "groups": {
        "top": {
            "countries": 5
        }   
    }
}

Grouping by explicit demographic segments

The list parameter performs grouping by a specific set of demographic segments. You must use valid demographic segments when specifying segments to analyze.

For example, if 3 countries are specified then the analysis will be performed for each of the 3 countries separately.

The following demographic dimensions are supported:

  • countries - countries of members.
  • seniorities - seniority levels of members.
  • functions - job functions of members.
  • sectors - industry sectors of members.
  • industries - industry names of members.
  • company_sizes - company sizes of members.
  • custom_segments - custom segments that members belong to.

You can specify any one of the dimensions. The number of groups must be between 1 and 10.

For example, the following parameters will repeat analysis for the 3 countries supplied:

{
    "groups": {
        "list": {
            "countries": ["germany", "france", "united kingdom"]
        }   
    }
}

Specifying custom groups

The custom parameter allows you to specify up to 10 custom groups to perform analysis for.

For each group you must specify at least one of the keywords, concepts, or audience parameters. These parameters are the same types as you use elsewhere for strategies.

Parameter Type Required Description
keywords keywords At least one of 'keywords', 'concepts' and 'audience' must be given. Content (based on keywords) to analyze for the group.
concepts concepts At least one of 'keywords', 'concepts' and 'audience' must be given. Content (based on mentioned concepts) to analyze for the group.
audience audience At least one of 'keywords', 'concepts' and 'audience' must be given. Audience to analyze for the group, based upon demographic segments.

To specify a custom group for analysis you specify a key under the groups parameter, which will be treated as the group label, and then the parameters for the group underneath.

For example, the following parameters will repeat analysis for 2 topics ('cloud' and 'machine learning'):

{
    "groups": {
        "custom": {
            "cloud": {
                "keywords": {
                    "any": ["cloud", "azure", "aws", "google cloud", "vmware"]
                }
            },
            "machine learning": {
                "keywords": {
                    "any": ["machine learning", "ml", "deep learning", "autonomous car"]
                }
            }
        }   
    }
}