reportScope Object – API Help Center

reportScope Object Definition

Note

Note: The Required column includes the following values:

Required: The field must be included in the POST call.
Read-only: The field is received in the GET call and required in the PUT call. It is not required in the POST call. You cannot edit this field.
Optional: If the field was received in the GET call, include it in the PUT call. This field is editable.
Internal: (For Amazon Ad Server (AAS) internal use) If the field was received in the GET call, include it in the PUT call.

Parameter	Description	Type	Required	Notes
entitiesHierarchy	Entities included in the report.	entitiesHierarchy Object	Required
attributionModelID	Conversion metric settings	Integer	Required	View attributionModelID values -1: Primary 0: None 1: Last event (impression or click) 2: Click over impression 3: Last click (disregard impressions) 4: Last event (filter out non-viewable) 5: Last event (prefer viewable impressions over non-viewable impressions) 6: Click over impression (filter out non-viewable) 7: Click over impression (prefer viewable impressions over non-viewable impressions) Note Notes: Set to 0 if not using conversion metrics. These values are omitted if you are not using any conversion metric in your report. -1 (Primary) must be set when choosing an account level, multiple advertisers, or campaigns from multiple advertisers (any level that might include more than one advertiser).
impressionCookieWindow	Window of time (in days) that includes the user actions (impressions or clicks) relevant to the path to conversion.	Integer	Required	Possible values: 0-90 Set to 0 if not using conversion metrics. These values are omitted if you are not using any conversion metric in your report.
clickCookieWindow		Integer	Required
filters	Name of filter for the report.	String	Optional	View filter values Site Conversion Tag Name Ad Placement Panel Video Asset Custom Interactions Category Note Note: The Video Asset filter and Custom Interactions filter are available when you select the Video/Audio Asset dimension or Custom Interaction dimension respectively.
timeRange	Includes the mode of time range, time zone, and start/end timestamps.	timeRange Object	Required
currencyOptions	Currency settings for the report.	currencyOptions Object	Required
presetId	Corresponds to the AAS Templates.	Integer	Optional	Set to null if not using this parameter.

Object JSON Example

"reportScope": {
        "entitiesHierarchy": {
          "entitiesHierarchyLevelType": "ACCOUNT",
          "accounts": [
            1234567890
          ],
          "advertisers": [
            1234567891,
            1234567892,
            1235467893
          ],
          "campaigns": [],
          "sites": []
        },
        "attributionModelID": 1,
        "impressionCookieWindow": 30,
        "clickCookieWindow": 30,
        "filters": {
          "placementIds": [
            1234567894
          ],
          "sites": [
            1234567895
          ],
          "conversionTagIDs": [
            1234567896,
            1234567897,
            1234567898
          ],
          "adIds": [
            1234567899,
            1234567880,
            1234567881
          ],
          "customInteractionIds": [
            1234567891234567,
            2345678902345678
          ]
        },
        "currencyOptions": {
          "type": "Custom",
          "defaultCurrency": 4,
          "targetCurrency": 4,
          "currencyExchangeDate": "2019-12-19"
        },
        "timeRange": {
          "type": "Yesterday",
          "timeZone": "US/Eastern"
        },
        "presetId": null
      },

Child Objects

Parent Objects

Report Object

reportScope Object Definition

Note

Note

Note

Object JSON Example

Child Objects

Parent Objects

Comments