Reporting dimensions (AMD)

Here you'll find a list of the dimensions available for use with the various reports dashboards and APIs for Adaptive Media Delivery (AMD).

Use of these dimensions in the Media Delivery Reports UI

All of the widgets revealed in a report's tab use one or more of these dimensions by default. However, some of the widgets let you view custom data via the Analyze data (IMAGE_STUB) functionality, where you can add or remove dimensions. See Analyze data shown in a report for full details.

Use of these dimensions in the Media Delivery Reports API

A dimension's name can differ slightly between the Media Delivery Reports UI and the Media Delivery Reports API v1. When applicable, both values are listed here. You can also run the List Adaptive Media Delivery data stores operation from the API, and do the following:

  1. Review the response output and locate the data store that represents the type of report data you want.

  2. From that data store, store the idvalues for the dimensions (and metrics) you want to use.

  3. Use these idvalues in the applicable Get Adaptive Media Delivery data operation to view filtered report data.

📘

Some dimensions use the same name and are similar in their application, but are tied to specific functionality. Review the description for each and make sure you're using the proper API ID for the dimension you want.

The dimensions

Available dimensions are listed alphabetically in this table.

Dimension NameAPI Dimension NameAPI IDDescriptionLimitations of Use

ASN

Same

17

The Autonomous System Number of the Internet Service Provider.

Only the top 200 ASNs globally are reported. The rest are categorized as "Others."

Action

Same

524

This is the action taken when a request comes from a known proxy.

Applies to the Enhanced Proxy Detection functionality with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Proxy Protection reports.

City

Same

14

The download was performed by an end user in this city. This is gathered from the client's IP address.

Only the top 250 cities globally, based on population are reported. The rest are categorized as "Others."

Client State

Same

28

The download was performed by an end user in this state, territory, or region (if applicable). This is gathered from the client's IP address.

N/A

Client State Code

Same

504

The download was performed by an end user in this state, territory, or region (if applicable). This is gathered from the client's IP address. This is the unique number that represents the state, territory, or region.

There is a .txt format file of these codes available for download via the Download Center application on Control Center.

Content Type

Same

18

The value of the HTTP content type header served to the client.

  • The reports reveal this dimension as "Others" if the content type is unknown or it's not set.
  • Delivery Format, Delivery Type, IP Version and Delivery Option filters are not available for this dimension.

Country

Same

24

The download was performed by an end user in this country. This is gathered from the client's IP address.

N/A

Country Code

Same

15

The download was performed by an end user in this country. This is gathered from the client's IP address. This is the unique number that represents that country.

There is a .csv format list of these codes available for download via the Download Center application on Control Center.

CPCode

Same

2

This is the Content Provider (CP) code assigned to the property used to deliver requested content. A CP code is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served.

N/A

CPCode

Same

501

This is the Content Provider (CP) code assigned to a media stream that's been configured to use Token-based Revocation. A CP code is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served.

This applies to the Token-based Access Revocation functionality offered with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Content Protection report.

CP Code

Same

601

This is the Content Provider (CP) code assigned to a media stream that incorporates the Akamai Cloud Wrapper service. A CP code is an identifier assigned to a contract and used for reporting, billing and monitoring traffic served.

This only applies if you've incorporated the Cloud Wrapper service with your AMD configuration.

Device

Same

7

Indicates the browser, application, or device used to download the object. This information is derived from the user-agent information in the request.

This includes Browsers/Applications and devices, everything else is categorized as "Others." No version information available. The following devices are reported:

  • ANDROID
  • CHROME
  • FIREFOX
  • GALAXY TAB
  • IPAD
  • IPHONE
  • NETSCAPE
  • SAFARI
  • IE APPLETV
  • OPERA
  • SEAMONKEY
  • ITUNESITUNES-APPLETV
  • ITUNES-IPOD
  • ITUNES-IPHONEITUNES-IPAD
  • GECKO
  • JAVA
  • MOZILLACOREMEDIA
  • SAMSUNG
  • LG
  • CURL
  • SONYBLACKBERRY
  • ROKU
  • INTERNET_EXPLORER
  • EDGE

📘

If all devices are reported as "Others," check to see if the following tag is present in your metadata configuration:

<match:request.type value="CLIENT_REQ">
<reporting:lds.user-agent>on</reporting:lds.user-agent>
</match:request.type>

Device

Same

57

Indicates the browser, application, or device used to download a stream that's been set up to use Manifest Personalization for AMD. This information is derived from the user-agent information in the request.

The same values described in Device, above apply here.

Applies to the Manifest Personalization for HLS or DASH functionality offered with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Manifest Personalization reports.

Domain

Same

60

End-user facing host names of customer's applications. For example, www.example.com, travel.example.com, my.travel.example.com.

Delivery Format, Delivery Type, IP Version and Delivery Option filters are not available for this dimension.

File Extension

Same

19

This is the file extension of the requested object. This is extracted from the object's URL.

Delivery Format, Delivery Type, IP Version and Delivery Option filters are not available for this dimension.

Manifest URL

Same

59

The URL that points to the manifest file for download.

N/A

Match Category

Same

523

​Akamai​ works with a third party provider, GeoComply to identify proxies via their GeoGuard product. This is the GeoGuard category of proxy that was identified in a request.

Applies to the Enhanced Proxy Detection functionality with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Proxy Protection reports.

Match Type

Same

522

​Akamai​ works with a third party provider, GeoComply to identify proxies via their GeoGuard product. This is the flag used to mark a request from a known proxy.

Applies to the Enhanced Proxy Detection functionality with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Proxy Protection reports.

Network Type

Same

9

The network connection type used by end-users to download the object.

N/A

Network Type

Same

525

​Akamai​ works with a third party provider, GeoComply to identify proxies via their GeoGuard product. This is the network connection type used by an end user when consuming content via a request from a known proxy.

Applies to the Enhanced Proxy Detection functionality with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Proxy Protection reports.

OS

Same

8

Indicates the operating system on the system that downloaded the stream or object.

The top 10 Operating Systems (OS) are reported. The rest are categorized as "Others." OS version information is not available. The following OS are reported:

  • WINDOWS
  • ANDROID
  • MACOS
  • IPHONEOS
  • IPHONEOS(IPAD)
  • BLACKBERRY
  • WEBOS
  • SYMBIAN
  • PLAYSTATION
  • X11

📘

If all operating systems are reported as "Others," you may need to check if the following tag is present in your metadata configuration:

<match:request.type value="CLIENT_REQ">
<reporting:lds.user-agent>on</reporting:lds.user-agent>
</match:request.type>

OS

Same

58

Indicates the operating system on the system downloading a stream that's been set up to use Manifest Personalization for AMD. This information is derived from the user-agent information in the request.

The same values described in OS, above apply here.

Applies to the Manifest Personalization for HLS or DASH functionality offered with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Manifest Personalization reports.

Response Bucket

Same

602

A "bucket" represents a counter of observations meeting a certain criteria. This bucket applies to the responses returned for upload and download requests for content in environments that also use the Akamai Cloud Wrapper service.

This only applies if you've incorporated the Cloud Wrapper service with your AMD configuration.

Response Code

Same

38

The HTTP status code that's sent after a request.

N/A

Response Code

Same

603

The HTTP status code sent after a requests for content in environments that also use the Akamai Cloud Wrapper service.

This only applies if you've incorporated the Cloud Wrapper service with your AMD configuration.

Stream ID/URL

Same

5

The path of the downloaded object.

  • URL sizes lower than 100 KB are not reported.

  • URLs receiving less than 50 Edge hits per day are bucketed in the category "URLs lesser than 50 Hits Per Day"

  • URLs are only reported for the following file extensions.

    • zip ; m3u ; exe ; jpeg ; html ; asset ;
    • m3u8 ; flv ; pdf ; mp3 ; rar ; apk ;
    • f4m ; isma ; gz ; mov ; swf ; pak ;
    • ismv ; m4a ; msi ; gif ; css ; rpm ;
    • m4s ; m4v ; bin ; wmv ; php ; deb ;
    • mp4 ; mp4a ; dmg ; aac ; dat ; f4v ;
    • mp4v ; csmil ; jpg ; svg ; tar ;
    • drm ; mpd" ; png ; js ; pkg ; bz2 ; msp ;
    • ism ; isml ; aum

    For file extensions other than the above, the following message is displayed on the UI:

    FILTERED_DUE_TO_EXTENSION
    

Time

Same

1

Indicates the time at which content was consumed. This dimension is set automatically.

N/A

Time

Same

510

Indicates the time at which content controlled by Manifest Personalization was consumed.

Applies to the Manifest Personalization for HLS or DASH functionality offered with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Manifest Personalization reports.

Time

Same

513

Indicates the time at which prefetched content was consumed. This dimension is set automatically.

This is only available if you've added the Prefetching functionality to your AMD property. It applies to the prefetching-related widgets in the Traffic tab and the Availability tab) reports.

Time

Same

520

Indicates the time that content protected by Token-based Revocation was consumed. This dimension is set automatically.

This applies to the Token-based Access Revocation functionality offered with AMD. Only for use with the widgets in the Adaptive Media Delivery > Historical > Content Protection report.

Time

Same

600

Indicates the time that content was consumed for AMD instances that also incorporate the Akamai Cloud Wrapper service.

This only applies if you've incorporated the Cloud Wrapper service with your AMD configuration.

URL

Same

503

This is the URL to a media stream that's been configured to use Token-based Revocation.

The same values described in Stream ID/URL, above apply here.

Applies to the Token-based Access Revocation functionality offered with AMD. Only for use with the widgets in Adaptive Media Delivery > Historical > Content Protection report.