Stay organized with collections
Save and categorize content based on your preferences.
Several dimensions include _ID, _CODE, and _NAME, such as
AD_UNIT_ID, AD_PLACEMENT_CODE, or PLATFORM_TYPE_NAME. These
all have slightly different meanings and uses, so it's important to be aware of them when selecting
dimensions for your report.
_ID dimensions
Dimensions that end in _ID display a guaranteed unique ID for the value,
within that dimension, which refers to a specific entity in an AdSense account.
If you need to ensure uniqueness in the dimension values, use an _ID dimension.
_CODE dimensions
Dimensions that end in _CODE normally use a unique, language-independent code for
the value. There are, however, some exceptions where the value may only be unique to an account or
ad client, if the value refers to an AdSense account entity.
If you need to do any sort of special handling of dimension values and can’t use an
_ID dimension, use a _CODE dimension.
_NAME dimensions
Dimensions that end in _NAME display a human-readable name for the value. This name
gets translated according to the locale in the report request, where appropriate. If the dimension
refers to an entity in an AdSense account, it will use the user-defined name for that
entity.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-17 UTC."],[[["\u003cp\u003eAdSense reporting dimensions like \u003ccode\u003eAD_UNIT_ID\u003c/code\u003e, \u003ccode\u003eAD_PLACEMENT_CODE\u003c/code\u003e, and \u003ccode\u003ePLATFORM_TYPE_NAME\u003c/code\u003e categorize report data by specific attributes.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003e_ID\u003c/code\u003e dimensions provide unique identifiers for specific entities within your AdSense account, ensuring value uniqueness.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003e_CODE\u003c/code\u003e dimensions use language-independent codes, offering a standardized way to categorize data when uniqueness isn't critical.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003e_NAME\u003c/code\u003e dimensions present human-readable, locale-specific names, enhancing report readability and understanding.\u003c/p\u003e\n"],["\u003cp\u003eChoose the appropriate dimension type (\u003ccode\u003e_ID\u003c/code\u003e, \u003ccode\u003e_CODE\u003c/code\u003e, or \u003ccode\u003e_NAME\u003c/code\u003e) based on your reporting requirements and desired level of detail.\u003c/p\u003e\n"]]],["The document outlines three types of dimensions: `_ID`, `_CODE`, and `_NAME`. `_ID` dimensions provide guaranteed unique identifiers for AdSense account entities. `_CODE` dimensions use unique, language-independent codes, though exceptions exist for account-specific entities. `_NAME` dimensions offer human-readable, localized names for values, often reflecting user-defined names in AdSense. Selecting the right dimension depends on whether uniqueness, specific codes, or user-facing names are required.\n"],null,["# Use the Right Dimension\n\nSeveral dimensions include `_ID`, `_CODE`, and `_NAME`, such as\n`AD_UNIT_ID`, `AD_PLACEMENT_CODE`, or `PLATFORM_TYPE_NAME`. These\nall have slightly different meanings and uses, so it's important to be aware of them when selecting\ndimensions for your report.\n\n_ID dimensions\n--------------\n\nDimensions that end in `_ID` display a **guaranteed unique ID** for the value,\nwithin that dimension, which refers to a specific entity in an AdSense account.\n\nIf you need to ensure uniqueness in the dimension values, use an `_ID` dimension.\n| **Some examples:**\n|\n| Dimension: `AD_UNIT_ID` \n|\n| Value format: `\"ca-pub-1234567890123456:1234567890\"`\n|\n| Dimension: `CUSTOM_CHANNEL_ID` \n|\n| Value format: `\"ca-pub-1234567890123456:9876543210\"`\n\n_CODE dimensions\n----------------\n\nDimensions that end in `_CODE` normally use a unique, language-independent code for\nthe value. There are, however, some exceptions where the value may only be unique to an account or\nad client, if the value refers to an AdSense account entity.\n\nIf you need to do any sort of special handling of dimension values and can't use an\n`_ID` dimension, use a `_CODE` dimension.\n| **Some examples:**\n|\n| Dimension: `PLATFORM_TYPE_CODE` \n|\n| Value format: `\"Desktop\"`, `\"HighEndMobile\"`,\n| `\"Tablet\"`, `\"unknown\"`, etc.\n|\n| Dimension: `AD_PLACEMENT_CODE` \n|\n| Value format: `\"AD_UNIT\"`, `\"ca-pub-123456:78910\"`,\n| `\"OTHER\"`, etc.\n\n_NAME dimensions\n----------------\n\nDimensions that end in `_NAME` display a human-readable name for the value. This name\ngets translated according to the locale in the report request, where appropriate. If the dimension\nrefers to an entity in an AdSense account, it will use the user-defined name for that\nentity.\n| **Some examples:**\n|\n| Dimension: `PLATFORM_TYPE_NAME` \n|\n| Locale: `en_US` \n|\n| Value format: `\"Desktop\"`, `\"High-end mobile devices\"`,\n| `\"Tablets\"`, `\"Other devices\"`, etc.\n|\n| Dimension: `PLATFORM_TYPE_NAME` \n|\n| Locale: `es` \n|\n| Value format: `\"Ordenador\"`, `\"Teléfonos móviles de gama alta\"`,\n| `\"Tabletas\"`, `\"Otros dispositivos\"`, etc.\n|\n| Dimension: `CUSTOM_CHANNEL_NAME` \n|\n| Locale: can be any locale \n|\n| Value format: user-defined channel names in the AdSense account\n\nNext steps\n----------\n\n- [Running Large Reports](/adsense/management/reporting/large_reports)\n- [List of Metrics and Dimensions](/adsense/management/metrics-dimensions)"]]
