Performance Queries

An overview of the available site performance queries

There are two types of performance queries:

• Company performance Queries focused on the company and its related content (such as Inquiry Submissions and Leaders Metrics)

• Content performance Queries focused on a single content item (such as Website Metrics)

Company Performance

There are three queries related to company performance:

1. Company Content Performance

2. Inquiry Submissions

3. Leaders Performance

Much like the queries outlined in Appearance Queries all three make use of the company hash and a month range in the format of { start: "YYYY-MM", end: "YYYY-MM" } for query input. We'll overview the information that can be returned from each query and provide an example query code example for each.

Company Content Performance

This query returns results that can containing the following:

• Summary which contains the number of content items, number of unique users who interacted with the companies content or profile and the total number of actions taken regarding the company and its content.

• By Type which contains a breakdown into rows containing the content type, the number of content items of that type, views of the content of that type (not unique) and the unique user count for that content type, alongside an overall content count, number of views and unique users to have viewed the company and/or it's content. This is rolled up from the values found in the rows breakdown.

• Company Clicks which contains a breakdown into rows containing the type of item clicked (examples include: Company Website links, Promotional items, Social Media Links, etc.) the number of clicks it received and a unique user count, alongside an overall click count and users to have clicked on company related items. This is rolled up from the values found in the rows breakdown, and therefore the rolled up user count here may not be unique.

• Action Detail which contains a breakdown into rows containing the type of action taken (examples include content views, company profile page clicks and inquiry submissions) and the number of actions taken for each, alongside an overall actions count. This is rolled up from the values found in the rows breakdown.

Example query

GraphQL query

query { 
  contentPerformance(input: {
    companyHash: "COMPANY_HASH_GOES_HERE",
    monthRange: { start: "2022-01", end: "2022-12" }
  }) { 
    summary { contentItems uniqueUsers totalActions } 
    byType { 
      rows { 
        type 
        count 
        views 
        uniqueUsers 
      } 
    } 
    companyClicks { 
      rows { type clicks uniqueUsers } 
    } 
    actionDetail { 
      rows { type actions } 
    } 
  } 
}

JSON response

{
  "data": {
    "contentPerformance": {
      "summary": {
        "contentItems": 6,
        "uniqueUsers": 235,
        "totalActions": 323
      },
      "byType": {
        "rows": [
          {
            "type": "Article",
            "count": 3,
            "views": 194,
            "uniqueUsers": 125
          },
          {
            "type": "Company Profile",
            "count": 1,
            "views": 10,
            "uniqueUsers": 7
          },
          {
            "type": "News",
            "count": 1,
            "views": 55,
            "uniqueUsers": 49
          },
          {
            "type": "Product",
            "count": 1,
            "views": 64,
            "uniqueUsers": 54
          }
        ]
      },
      "companyClicks": {
        "rows": []
      },
      "actionDetail": {
        "rows": [
          {
            "type": "Content > View",
            "actions": 323
          }
        ]
      }
    },

Inquiry Submissions

This query returns results that can contain the following:

• Submission ID

• Content information related to the content item the inquiry was submitted on including content ID, name, type, the primary site it was published to as well as when it was published.

• Company, job title, first and last name, email, phone and postal code of person who submitted the inquiry.

• Comments made in regards as to what or why they inquired.

• When the inquiry was submitted. (created)

Example query

GraphQL query

query { 
  inquirySubmissions(input: {
    companyHash: "COMPANY_HASH_GOES_HERE",
    monthRange: { start: "2022-01", end: "2022-12" }
  }) { 
    id 
    content { 
      id 
      name
      type 
      published 
      primarySite { 
        id 
        name 
        title 
        shortName 
        host
      } 
    } 
    company 
    jobTitle 
    country 
    firstName 
    lastName 
    email 
    phone 
    postalCode
    comments 
    created
  } 
}

JSON response

{
  "data": {
    "inquirySubmissions": [
      {
        "id": "6229d83da8529a55bd46278c",
        "content": {
          "id": 21126599,
          "name": "Compostable Meat and Produce Trays",
          "type": "Product",
          "published": "2020-04-03T15:30:57.000Z",
          "primarySite": {
            "id": "5d88cedef175132c008b456b",
            "name": "Website Name",
            "title": "Website Name (WSN)",
            "shortName": "WSN",
            "host": "www.website.com"
          }
        },
        "company": "<redacted_company_name>",
        "jobTitle": "International Sales Director",
        "country": "India",
        "firstName": "<redacted_first_name>",
        "lastName": "<redacted_last_name>",
        "email": "<redacted_email>",
        "phone": "<redacted_phone>",
        "postalCode": "400054",
        "comments": "We are manufacturers of Meat Soaker PPads used for packaging meat in trays.\nWe supply globally at competitive prices. \nPlease contact us with your requirements for us to provide you with the best quote.",
        "created": "2022-03-10T10:51:41.578Z"
      }
    ]
  }
}

Leaders Performance

This query returns results that can contain the following:

• Overview containing overall values for impressions, unique users, data card opens (fly-out cards found in the Leaders block(s) found on site) and company profile page views.

• Category Detail containing rows that include Leaders website section information including ID, alias, name, full name and site information for the section, alongside impressions and unique users for each. This also includes rolled up impressions and users as well for all categories. Due to the nature of this roll up the user count here may not be unique.

Example query

GraphQL query

query { 
  leadersPerformance(input: {
    companyHash: "COMPANY_HASH_GOES_HERE",
    monthRange: { start: "2022-01", end: "2022-12" }
  }) { 
    overview { 
      impressions 
      uniqueUsers 
      dataCardOpens 
      companyProfileViews
    } 
    categoryDetail { 
      rows { 
        websiteSection { 
          id 
          name 
          alias 
          fullName 
          site { 
            id 
            name 
            title 
            shortName 
            host
          } 
        } 
        impressions 
        uniqueUsers
      } 
      impressions
      users
    }
  }
}

JSON response

{
  "data": {
    "leadersPerformance": {
      "overview": {
        "impressions": 160760,
        "uniqueUsers": 103245,
        "dataCardOpens": 2760,
        "companyProfileViews": 186
      },
      "categoryDetail": {
        "rows": [
          {
            "websiteSection": {
              "id": 81062,
              "name": "Material Handling",
              "alias": "leaders-2022/machinery/material-handling",
              "fullName": "Leaders 2022 > Machinery > Material Handling",
              "site": {
                "id": "5d88cedef175132c008b456b",
                "name": "Website Name",
                "title": "Website Name (WSN)",
                "shortName": "WSN",
                "host": "www.website.com"
              }
            },
            "impressions": 52918,
            "uniqueUsers": 40252
          },
          {
            "websiteSection": {
              "id": 81022,
              "name": "Motion control",
              "alias": "leaders-2022/motion-control",
              "fullName": "Leaders 2022 > Motion control",
              "site": {
                "id": "5d88cecaf175132c008b4567",
                "name": "Website Name",
                "title": "Website Name (WSN)",
                "shortName": "WSN",
                "host": "www.website.com"
              }
            },
            "impressions": 75088,
            "uniqueUsers": 59912
          },
          {
            "websiteSection": {
              "id": 81287,
              "name": "Conveying",
              "alias": "leaders-2022/integrated-equipment/conveying",
              "fullName": "Leaders 2022 > Integrated Equipment > Conveying",
              "site": {
                "id": "5d88cf05f175132c008b4573",
                "name": "Website Name",
                "title": "Website Name (WSN)",
                "shortName": "WSN",
                "host": "www.website.com"
              }
            },
            "impressions": 2237,
            "uniqueUsers": 1427
          },
          {
            "websiteSection": {
              "id": 81052,
              "name": "Conveying & Accumulation",
              "alias": "leaders-2022/machinery/conveying-accumulation",
              "fullName": "Leaders 2022 > Machinery > Conveying & Accumulation",
              "site": {
                "id": "5d88cedef175132c008b456b",
                "name": "Website Name",
                "title": "Website Name (WSN)",
                "shortName": "WSN",
                "host": "www.website.com"
              }
            },
            "impressions": 30517,
            "uniqueUsers": 23041
          }
        ],
        "impressions": 160760,
        "users": 124632
      }
    }
  }
}

Content Performance

There is one query related to content performance:

1. Content Website Metrics

Content Website Metrics

This query allows for querying as to how many views and unique users viewed a piece of content and is queried for using the content ID and a month range using the format of { start: "YYYY-MM", end: "YYYY-MM" } returns results that can contain the following:

• Views, the number of views the content item received during the specified range.

• Unique Users, the number of unique users that viewed the content item during the specified range.

• Average views per user, the average number of times an individual user would have viewed the article. (Views divided by unique users should yield this value)

Example query

GraphQL query

query { 
  contentWebsiteMetrics(input: {
    contentId: CONTENT_ID_GOES_HERE,
    monthRange: { start: "2022-01", end: "2022-12" }
  }) { 
    views 
    uniqueUsers 
    avgViewsPerUser 
  } 
}

JSON response

{
  "data": {
    "contentWebsiteMetrics": {
      "views": 186,
      "uniqueUsers": 173,
      "avgViewsPerUser": 1.0751445086705202
    }
  }
}