1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="dfareporting_v3_3.html">Campaign Manager 360 API</a> . <a href="dfareporting_v3_3.reports.html">reports</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="dfareporting_v3_3.reports.compatibleFields.html">compatibleFields()</a></code> 79</p> 80<p class="firstline">Returns the compatibleFields Resource.</p> 81 82<p class="toc_element"> 83 <code><a href="dfareporting_v3_3.reports.files.html">files()</a></code> 84</p> 85<p class="firstline">Returns the files Resource.</p> 86 87<p class="toc_element"> 88 <code><a href="#close">close()</a></code></p> 89<p class="firstline">Close httplib2 connections.</p> 90<p class="toc_element"> 91 <code><a href="#delete">delete(profileId, reportId, x__xgafv=None)</a></code></p> 92<p class="firstline">Deletes a report by its ID.</p> 93<p class="toc_element"> 94 <code><a href="#get">get(profileId, reportId, x__xgafv=None)</a></code></p> 95<p class="firstline">Retrieves a report by its ID.</p> 96<p class="toc_element"> 97 <code><a href="#insert">insert(profileId, body=None, x__xgafv=None)</a></code></p> 98<p class="firstline">Creates a report.</p> 99<p class="toc_element"> 100 <code><a href="#list">list(profileId, maxResults=None, pageToken=None, scope=None, sortField=None, sortOrder=None, x__xgafv=None)</a></code></p> 101<p class="firstline">Retrieves list of reports.</p> 102<p class="toc_element"> 103 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 104<p class="firstline">Retrieves the next page of results.</p> 105<p class="toc_element"> 106 <code><a href="#patch">patch(profileId, reportId, body=None, x__xgafv=None)</a></code></p> 107<p class="firstline">Updates an existing report. This method supports patch semantics.</p> 108<p class="toc_element"> 109 <code><a href="#run">run(profileId, reportId, synchronous=None, x__xgafv=None)</a></code></p> 110<p class="firstline">Runs a report.</p> 111<p class="toc_element"> 112 <code><a href="#update">update(profileId, reportId, body=None, x__xgafv=None)</a></code></p> 113<p class="firstline">Updates a report.</p> 114<h3>Method Details</h3> 115<div class="method"> 116 <code class="details" id="close">close()</code> 117 <pre>Close httplib2 connections.</pre> 118</div> 119 120<div class="method"> 121 <code class="details" id="delete">delete(profileId, reportId, x__xgafv=None)</code> 122 <pre>Deletes a report by its ID. 123 124Args: 125 profileId: string, The Campaign Manager 360 user profile ID. (required) 126 reportId: string, The ID of the report. (required) 127 x__xgafv: string, V1 error format. 128 Allowed values 129 1 - v1 error format 130 2 - v2 error format 131</pre> 132</div> 133 134<div class="method"> 135 <code class="details" id="get">get(profileId, reportId, x__xgafv=None)</code> 136 <pre>Retrieves a report by its ID. 137 138Args: 139 profileId: string, The Campaign Manager 360 user profile ID. (required) 140 reportId: string, The ID of the report. (required) 141 x__xgafv: string, V1 error format. 142 Allowed values 143 1 - v1 error format 144 2 - v2 error format 145 146Returns: 147 An object of the form: 148 149 { # Represents a Report resource. 150 "accountId": "A String", # The account ID to which this report belongs. 151 "criteria": { # The report criteria for a report of type "STANDARD". 152 "activities": { # Represents an activity group. # Activity group. 153 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 154 { # Represents a DimensionValue resource. 155 "dimensionName": "A String", # The name of the dimension. 156 "etag": "A String", # The eTag of this response for caching purposes. 157 "id": "A String", # The ID associated with the value if available. 158 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 159 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 160 "value": "A String", # The value of the dimension. 161 }, 162 ], 163 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 164 "metricNames": [ # List of names of floodlight activity metrics. 165 "A String", 166 ], 167 }, 168 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 169 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 170 { # Represents a DimensionValue resource. 171 "dimensionName": "A String", # The name of the dimension. 172 "etag": "A String", # The eTag of this response for caching purposes. 173 "id": "A String", # The ID associated with the value if available. 174 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 175 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 176 "value": "A String", # The value of the dimension. 177 }, 178 ], 179 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 180 }, 181 "dateRange": { # Represents a date range. # The date range for which this report should be run. 182 "endDate": "A String", 183 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 184 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 185 "startDate": "A String", 186 }, 187 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 188 { # Represents a DimensionValue resource. 189 "dimensionName": "A String", # The name of the dimension. 190 "etag": "A String", # The eTag of this response for caching purposes. 191 "id": "A String", # The ID associated with the value if available. 192 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 193 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 194 "value": "A String", # The value of the dimension. 195 }, 196 ], 197 "dimensions": [ # The list of standard dimensions the report should include. 198 { # Represents a sorted dimension. 199 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 200 "name": "A String", # The name of the dimension. 201 "sortOrder": "A String", # An optional sort order for the dimension column. 202 }, 203 ], 204 "metricNames": [ # The list of names of metrics the report should include. 205 "A String", 206 ], 207 }, 208 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 209 "breakdown": [ # The list of dimensions the report should include. 210 { # Represents a sorted dimension. 211 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 212 "name": "A String", # The name of the dimension. 213 "sortOrder": "A String", # An optional sort order for the dimension column. 214 }, 215 ], 216 "dateRange": { # Represents a date range. # The date range this report should be run for. 217 "endDate": "A String", 218 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 219 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 220 "startDate": "A String", 221 }, 222 "dimension": "A String", # The dimension option. 223 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 224 { # Represents a DimensionValue resource. 225 "dimensionName": "A String", # The name of the dimension. 226 "etag": "A String", # The eTag of this response for caching purposes. 227 "id": "A String", # The ID associated with the value if available. 228 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 229 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 230 "value": "A String", # The value of the dimension. 231 }, 232 ], 233 "metricNames": [ # The list of names of metrics the report should include. 234 "A String", 235 ], 236 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 237 "A String", 238 ], 239 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 240 }, 241 "delivery": { # The report's email delivery settings. 242 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 243 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 244 "message": "A String", # The message to be sent with each email. 245 "recipients": [ # The list of recipients to which to email the report. 246 { # Represents a recipient. 247 "deliveryType": "A String", # The delivery type for the recipient. 248 "email": "A String", # The email address of the recipient. 249 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 250 }, 251 ], 252 }, 253 "etag": "A String", # The eTag of this response for caching purposes. 254 "fileName": "A String", # The filename used when generating report files for this report. 255 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 256 "customRichMediaEvents": [ # The list of custom rich media events to include. 257 { # Represents a DimensionValue resource. 258 "dimensionName": "A String", # The name of the dimension. 259 "etag": "A String", # The eTag of this response for caching purposes. 260 "id": "A String", # The ID associated with the value if available. 261 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 262 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 263 "value": "A String", # The value of the dimension. 264 }, 265 ], 266 "dateRange": { # Represents a date range. # The date range this report should be run for. 267 "endDate": "A String", 268 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 269 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 270 "startDate": "A String", 271 }, 272 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 273 { # Represents a DimensionValue resource. 274 "dimensionName": "A String", # The name of the dimension. 275 "etag": "A String", # The eTag of this response for caching purposes. 276 "id": "A String", # The ID associated with the value if available. 277 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 278 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 279 "value": "A String", # The value of the dimension. 280 }, 281 ], 282 "dimensions": [ # The list of dimensions the report should include. 283 { # Represents a sorted dimension. 284 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 285 "name": "A String", # The name of the dimension. 286 "sortOrder": "A String", # An optional sort order for the dimension column. 287 }, 288 ], 289 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 290 "dimensionName": "A String", # The name of the dimension. 291 "etag": "A String", # The eTag of this response for caching purposes. 292 "id": "A String", # The ID associated with the value if available. 293 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 294 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 295 "value": "A String", # The value of the dimension. 296 }, 297 "metricNames": [ # The list of names of metrics the report should include. 298 "A String", 299 ], 300 "reportProperties": { # The properties of the report. 301 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 302 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 303 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 304 }, 305 }, 306 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 307 "id": "A String", # The unique ID identifying this report resource. 308 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 309 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 310 "name": "A String", # The name of the report. 311 "ownerProfileId": "A String", # The user profile id of the owner of this report. 312 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 313 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 314 { # Represents a DimensionValue resource. 315 "dimensionName": "A String", # The name of the dimension. 316 "etag": "A String", # The eTag of this response for caching purposes. 317 "id": "A String", # The ID associated with the value if available. 318 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 319 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 320 "value": "A String", # The value of the dimension. 321 }, 322 ], 323 "conversionDimensions": [ # The list of conversion dimensions the report should include. 324 { # Represents a sorted dimension. 325 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 326 "name": "A String", # The name of the dimension. 327 "sortOrder": "A String", # An optional sort order for the dimension column. 328 }, 329 ], 330 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 331 { # Represents a sorted dimension. 332 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 333 "name": "A String", # The name of the dimension. 334 "sortOrder": "A String", # An optional sort order for the dimension column. 335 }, 336 ], 337 "customRichMediaEvents": [ # The list of custom rich media events to include. 338 { # Represents a DimensionValue resource. 339 "dimensionName": "A String", # The name of the dimension. 340 "etag": "A String", # The eTag of this response for caching purposes. 341 "id": "A String", # The ID associated with the value if available. 342 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 343 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 344 "value": "A String", # The value of the dimension. 345 }, 346 ], 347 "dateRange": { # Represents a date range. # The date range this report should be run for. 348 "endDate": "A String", 349 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 350 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 351 "startDate": "A String", 352 }, 353 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 354 "dimensionName": "A String", # The name of the dimension. 355 "etag": "A String", # The eTag of this response for caching purposes. 356 "id": "A String", # The ID associated with the value if available. 357 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 358 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 359 "value": "A String", # The value of the dimension. 360 }, 361 "metricNames": [ # The list of names of metrics the report should include. 362 "A String", 363 ], 364 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 365 { # Represents a sorted dimension. 366 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 367 "name": "A String", # The name of the dimension. 368 "sortOrder": "A String", # An optional sort order for the dimension column. 369 }, 370 ], 371 "reportProperties": { # The properties of the report. 372 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 373 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 374 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 375 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 376 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 377 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 378 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 379 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 380 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 381 }, 382 }, 383 "reachCriteria": { # The report criteria for a report of type "REACH". 384 "activities": { # Represents an activity group. # Activity group. 385 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 386 { # Represents a DimensionValue resource. 387 "dimensionName": "A String", # The name of the dimension. 388 "etag": "A String", # The eTag of this response for caching purposes. 389 "id": "A String", # The ID associated with the value if available. 390 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 391 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 392 "value": "A String", # The value of the dimension. 393 }, 394 ], 395 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 396 "metricNames": [ # List of names of floodlight activity metrics. 397 "A String", 398 ], 399 }, 400 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 401 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 402 { # Represents a DimensionValue resource. 403 "dimensionName": "A String", # The name of the dimension. 404 "etag": "A String", # The eTag of this response for caching purposes. 405 "id": "A String", # The ID associated with the value if available. 406 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 407 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 408 "value": "A String", # The value of the dimension. 409 }, 410 ], 411 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 412 }, 413 "dateRange": { # Represents a date range. # The date range this report should be run for. 414 "endDate": "A String", 415 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 416 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 417 "startDate": "A String", 418 }, 419 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 420 { # Represents a DimensionValue resource. 421 "dimensionName": "A String", # The name of the dimension. 422 "etag": "A String", # The eTag of this response for caching purposes. 423 "id": "A String", # The ID associated with the value if available. 424 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 425 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 426 "value": "A String", # The value of the dimension. 427 }, 428 ], 429 "dimensions": [ # The list of dimensions the report should include. 430 { # Represents a sorted dimension. 431 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 432 "name": "A String", # The name of the dimension. 433 "sortOrder": "A String", # An optional sort order for the dimension column. 434 }, 435 ], 436 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 437 "metricNames": [ # The list of names of metrics the report should include. 438 "A String", 439 ], 440 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 441 "A String", 442 ], 443 }, 444 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 445 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 446 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 447 "expirationDate": "A String", 448 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 449 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 450 "A String", 451 ], 452 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 453 "startDate": "A String", 454 }, 455 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 456 "type": "A String", # The type of the report. 457}</pre> 458</div> 459 460<div class="method"> 461 <code class="details" id="insert">insert(profileId, body=None, x__xgafv=None)</code> 462 <pre>Creates a report. 463 464Args: 465 profileId: string, The Campaign Manager 360 user profile ID. (required) 466 body: object, The request body. 467 The object takes the form of: 468 469{ # Represents a Report resource. 470 "accountId": "A String", # The account ID to which this report belongs. 471 "criteria": { # The report criteria for a report of type "STANDARD". 472 "activities": { # Represents an activity group. # Activity group. 473 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 474 { # Represents a DimensionValue resource. 475 "dimensionName": "A String", # The name of the dimension. 476 "etag": "A String", # The eTag of this response for caching purposes. 477 "id": "A String", # The ID associated with the value if available. 478 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 479 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 480 "value": "A String", # The value of the dimension. 481 }, 482 ], 483 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 484 "metricNames": [ # List of names of floodlight activity metrics. 485 "A String", 486 ], 487 }, 488 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 489 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 490 { # Represents a DimensionValue resource. 491 "dimensionName": "A String", # The name of the dimension. 492 "etag": "A String", # The eTag of this response for caching purposes. 493 "id": "A String", # The ID associated with the value if available. 494 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 495 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 496 "value": "A String", # The value of the dimension. 497 }, 498 ], 499 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 500 }, 501 "dateRange": { # Represents a date range. # The date range for which this report should be run. 502 "endDate": "A String", 503 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 504 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 505 "startDate": "A String", 506 }, 507 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 508 { # Represents a DimensionValue resource. 509 "dimensionName": "A String", # The name of the dimension. 510 "etag": "A String", # The eTag of this response for caching purposes. 511 "id": "A String", # The ID associated with the value if available. 512 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 513 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 514 "value": "A String", # The value of the dimension. 515 }, 516 ], 517 "dimensions": [ # The list of standard dimensions the report should include. 518 { # Represents a sorted dimension. 519 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 520 "name": "A String", # The name of the dimension. 521 "sortOrder": "A String", # An optional sort order for the dimension column. 522 }, 523 ], 524 "metricNames": [ # The list of names of metrics the report should include. 525 "A String", 526 ], 527 }, 528 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 529 "breakdown": [ # The list of dimensions the report should include. 530 { # Represents a sorted dimension. 531 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 532 "name": "A String", # The name of the dimension. 533 "sortOrder": "A String", # An optional sort order for the dimension column. 534 }, 535 ], 536 "dateRange": { # Represents a date range. # The date range this report should be run for. 537 "endDate": "A String", 538 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 539 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 540 "startDate": "A String", 541 }, 542 "dimension": "A String", # The dimension option. 543 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 544 { # Represents a DimensionValue resource. 545 "dimensionName": "A String", # The name of the dimension. 546 "etag": "A String", # The eTag of this response for caching purposes. 547 "id": "A String", # The ID associated with the value if available. 548 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 549 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 550 "value": "A String", # The value of the dimension. 551 }, 552 ], 553 "metricNames": [ # The list of names of metrics the report should include. 554 "A String", 555 ], 556 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 557 "A String", 558 ], 559 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 560 }, 561 "delivery": { # The report's email delivery settings. 562 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 563 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 564 "message": "A String", # The message to be sent with each email. 565 "recipients": [ # The list of recipients to which to email the report. 566 { # Represents a recipient. 567 "deliveryType": "A String", # The delivery type for the recipient. 568 "email": "A String", # The email address of the recipient. 569 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 570 }, 571 ], 572 }, 573 "etag": "A String", # The eTag of this response for caching purposes. 574 "fileName": "A String", # The filename used when generating report files for this report. 575 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 576 "customRichMediaEvents": [ # The list of custom rich media events to include. 577 { # Represents a DimensionValue resource. 578 "dimensionName": "A String", # The name of the dimension. 579 "etag": "A String", # The eTag of this response for caching purposes. 580 "id": "A String", # The ID associated with the value if available. 581 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 582 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 583 "value": "A String", # The value of the dimension. 584 }, 585 ], 586 "dateRange": { # Represents a date range. # The date range this report should be run for. 587 "endDate": "A String", 588 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 589 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 590 "startDate": "A String", 591 }, 592 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 593 { # Represents a DimensionValue resource. 594 "dimensionName": "A String", # The name of the dimension. 595 "etag": "A String", # The eTag of this response for caching purposes. 596 "id": "A String", # The ID associated with the value if available. 597 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 598 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 599 "value": "A String", # The value of the dimension. 600 }, 601 ], 602 "dimensions": [ # The list of dimensions the report should include. 603 { # Represents a sorted dimension. 604 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 605 "name": "A String", # The name of the dimension. 606 "sortOrder": "A String", # An optional sort order for the dimension column. 607 }, 608 ], 609 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 610 "dimensionName": "A String", # The name of the dimension. 611 "etag": "A String", # The eTag of this response for caching purposes. 612 "id": "A String", # The ID associated with the value if available. 613 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 614 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 615 "value": "A String", # The value of the dimension. 616 }, 617 "metricNames": [ # The list of names of metrics the report should include. 618 "A String", 619 ], 620 "reportProperties": { # The properties of the report. 621 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 622 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 623 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 624 }, 625 }, 626 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 627 "id": "A String", # The unique ID identifying this report resource. 628 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 629 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 630 "name": "A String", # The name of the report. 631 "ownerProfileId": "A String", # The user profile id of the owner of this report. 632 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 633 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 634 { # Represents a DimensionValue resource. 635 "dimensionName": "A String", # The name of the dimension. 636 "etag": "A String", # The eTag of this response for caching purposes. 637 "id": "A String", # The ID associated with the value if available. 638 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 639 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 640 "value": "A String", # The value of the dimension. 641 }, 642 ], 643 "conversionDimensions": [ # The list of conversion dimensions the report should include. 644 { # Represents a sorted dimension. 645 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 646 "name": "A String", # The name of the dimension. 647 "sortOrder": "A String", # An optional sort order for the dimension column. 648 }, 649 ], 650 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 651 { # Represents a sorted dimension. 652 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 653 "name": "A String", # The name of the dimension. 654 "sortOrder": "A String", # An optional sort order for the dimension column. 655 }, 656 ], 657 "customRichMediaEvents": [ # The list of custom rich media events to include. 658 { # Represents a DimensionValue resource. 659 "dimensionName": "A String", # The name of the dimension. 660 "etag": "A String", # The eTag of this response for caching purposes. 661 "id": "A String", # The ID associated with the value if available. 662 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 663 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 664 "value": "A String", # The value of the dimension. 665 }, 666 ], 667 "dateRange": { # Represents a date range. # The date range this report should be run for. 668 "endDate": "A String", 669 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 670 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 671 "startDate": "A String", 672 }, 673 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 674 "dimensionName": "A String", # The name of the dimension. 675 "etag": "A String", # The eTag of this response for caching purposes. 676 "id": "A String", # The ID associated with the value if available. 677 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 678 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 679 "value": "A String", # The value of the dimension. 680 }, 681 "metricNames": [ # The list of names of metrics the report should include. 682 "A String", 683 ], 684 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 685 { # Represents a sorted dimension. 686 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 687 "name": "A String", # The name of the dimension. 688 "sortOrder": "A String", # An optional sort order for the dimension column. 689 }, 690 ], 691 "reportProperties": { # The properties of the report. 692 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 693 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 694 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 695 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 696 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 697 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 698 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 699 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 700 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 701 }, 702 }, 703 "reachCriteria": { # The report criteria for a report of type "REACH". 704 "activities": { # Represents an activity group. # Activity group. 705 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 706 { # Represents a DimensionValue resource. 707 "dimensionName": "A String", # The name of the dimension. 708 "etag": "A String", # The eTag of this response for caching purposes. 709 "id": "A String", # The ID associated with the value if available. 710 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 711 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 712 "value": "A String", # The value of the dimension. 713 }, 714 ], 715 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 716 "metricNames": [ # List of names of floodlight activity metrics. 717 "A String", 718 ], 719 }, 720 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 721 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 722 { # Represents a DimensionValue resource. 723 "dimensionName": "A String", # The name of the dimension. 724 "etag": "A String", # The eTag of this response for caching purposes. 725 "id": "A String", # The ID associated with the value if available. 726 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 727 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 728 "value": "A String", # The value of the dimension. 729 }, 730 ], 731 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 732 }, 733 "dateRange": { # Represents a date range. # The date range this report should be run for. 734 "endDate": "A String", 735 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 736 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 737 "startDate": "A String", 738 }, 739 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 740 { # Represents a DimensionValue resource. 741 "dimensionName": "A String", # The name of the dimension. 742 "etag": "A String", # The eTag of this response for caching purposes. 743 "id": "A String", # The ID associated with the value if available. 744 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 745 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 746 "value": "A String", # The value of the dimension. 747 }, 748 ], 749 "dimensions": [ # The list of dimensions the report should include. 750 { # Represents a sorted dimension. 751 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 752 "name": "A String", # The name of the dimension. 753 "sortOrder": "A String", # An optional sort order for the dimension column. 754 }, 755 ], 756 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 757 "metricNames": [ # The list of names of metrics the report should include. 758 "A String", 759 ], 760 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 761 "A String", 762 ], 763 }, 764 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 765 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 766 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 767 "expirationDate": "A String", 768 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 769 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 770 "A String", 771 ], 772 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 773 "startDate": "A String", 774 }, 775 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 776 "type": "A String", # The type of the report. 777} 778 779 x__xgafv: string, V1 error format. 780 Allowed values 781 1 - v1 error format 782 2 - v2 error format 783 784Returns: 785 An object of the form: 786 787 { # Represents a Report resource. 788 "accountId": "A String", # The account ID to which this report belongs. 789 "criteria": { # The report criteria for a report of type "STANDARD". 790 "activities": { # Represents an activity group. # Activity group. 791 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 792 { # Represents a DimensionValue resource. 793 "dimensionName": "A String", # The name of the dimension. 794 "etag": "A String", # The eTag of this response for caching purposes. 795 "id": "A String", # The ID associated with the value if available. 796 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 797 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 798 "value": "A String", # The value of the dimension. 799 }, 800 ], 801 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 802 "metricNames": [ # List of names of floodlight activity metrics. 803 "A String", 804 ], 805 }, 806 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 807 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 808 { # Represents a DimensionValue resource. 809 "dimensionName": "A String", # The name of the dimension. 810 "etag": "A String", # The eTag of this response for caching purposes. 811 "id": "A String", # The ID associated with the value if available. 812 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 813 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 814 "value": "A String", # The value of the dimension. 815 }, 816 ], 817 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 818 }, 819 "dateRange": { # Represents a date range. # The date range for which this report should be run. 820 "endDate": "A String", 821 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 822 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 823 "startDate": "A String", 824 }, 825 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 826 { # Represents a DimensionValue resource. 827 "dimensionName": "A String", # The name of the dimension. 828 "etag": "A String", # The eTag of this response for caching purposes. 829 "id": "A String", # The ID associated with the value if available. 830 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 831 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 832 "value": "A String", # The value of the dimension. 833 }, 834 ], 835 "dimensions": [ # The list of standard dimensions the report should include. 836 { # Represents a sorted dimension. 837 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 838 "name": "A String", # The name of the dimension. 839 "sortOrder": "A String", # An optional sort order for the dimension column. 840 }, 841 ], 842 "metricNames": [ # The list of names of metrics the report should include. 843 "A String", 844 ], 845 }, 846 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 847 "breakdown": [ # The list of dimensions the report should include. 848 { # Represents a sorted dimension. 849 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 850 "name": "A String", # The name of the dimension. 851 "sortOrder": "A String", # An optional sort order for the dimension column. 852 }, 853 ], 854 "dateRange": { # Represents a date range. # The date range this report should be run for. 855 "endDate": "A String", 856 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 857 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 858 "startDate": "A String", 859 }, 860 "dimension": "A String", # The dimension option. 861 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 862 { # Represents a DimensionValue resource. 863 "dimensionName": "A String", # The name of the dimension. 864 "etag": "A String", # The eTag of this response for caching purposes. 865 "id": "A String", # The ID associated with the value if available. 866 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 867 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 868 "value": "A String", # The value of the dimension. 869 }, 870 ], 871 "metricNames": [ # The list of names of metrics the report should include. 872 "A String", 873 ], 874 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 875 "A String", 876 ], 877 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 878 }, 879 "delivery": { # The report's email delivery settings. 880 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 881 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 882 "message": "A String", # The message to be sent with each email. 883 "recipients": [ # The list of recipients to which to email the report. 884 { # Represents a recipient. 885 "deliveryType": "A String", # The delivery type for the recipient. 886 "email": "A String", # The email address of the recipient. 887 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 888 }, 889 ], 890 }, 891 "etag": "A String", # The eTag of this response for caching purposes. 892 "fileName": "A String", # The filename used when generating report files for this report. 893 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 894 "customRichMediaEvents": [ # The list of custom rich media events to include. 895 { # Represents a DimensionValue resource. 896 "dimensionName": "A String", # The name of the dimension. 897 "etag": "A String", # The eTag of this response for caching purposes. 898 "id": "A String", # The ID associated with the value if available. 899 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 900 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 901 "value": "A String", # The value of the dimension. 902 }, 903 ], 904 "dateRange": { # Represents a date range. # The date range this report should be run for. 905 "endDate": "A String", 906 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 907 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 908 "startDate": "A String", 909 }, 910 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 911 { # Represents a DimensionValue resource. 912 "dimensionName": "A String", # The name of the dimension. 913 "etag": "A String", # The eTag of this response for caching purposes. 914 "id": "A String", # The ID associated with the value if available. 915 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 916 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 917 "value": "A String", # The value of the dimension. 918 }, 919 ], 920 "dimensions": [ # The list of dimensions the report should include. 921 { # Represents a sorted dimension. 922 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 923 "name": "A String", # The name of the dimension. 924 "sortOrder": "A String", # An optional sort order for the dimension column. 925 }, 926 ], 927 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 928 "dimensionName": "A String", # The name of the dimension. 929 "etag": "A String", # The eTag of this response for caching purposes. 930 "id": "A String", # The ID associated with the value if available. 931 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 932 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 933 "value": "A String", # The value of the dimension. 934 }, 935 "metricNames": [ # The list of names of metrics the report should include. 936 "A String", 937 ], 938 "reportProperties": { # The properties of the report. 939 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 940 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 941 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 942 }, 943 }, 944 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 945 "id": "A String", # The unique ID identifying this report resource. 946 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 947 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 948 "name": "A String", # The name of the report. 949 "ownerProfileId": "A String", # The user profile id of the owner of this report. 950 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 951 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 952 { # Represents a DimensionValue resource. 953 "dimensionName": "A String", # The name of the dimension. 954 "etag": "A String", # The eTag of this response for caching purposes. 955 "id": "A String", # The ID associated with the value if available. 956 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 957 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 958 "value": "A String", # The value of the dimension. 959 }, 960 ], 961 "conversionDimensions": [ # The list of conversion dimensions the report should include. 962 { # Represents a sorted dimension. 963 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 964 "name": "A String", # The name of the dimension. 965 "sortOrder": "A String", # An optional sort order for the dimension column. 966 }, 967 ], 968 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 969 { # Represents a sorted dimension. 970 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 971 "name": "A String", # The name of the dimension. 972 "sortOrder": "A String", # An optional sort order for the dimension column. 973 }, 974 ], 975 "customRichMediaEvents": [ # The list of custom rich media events to include. 976 { # Represents a DimensionValue resource. 977 "dimensionName": "A String", # The name of the dimension. 978 "etag": "A String", # The eTag of this response for caching purposes. 979 "id": "A String", # The ID associated with the value if available. 980 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 981 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 982 "value": "A String", # The value of the dimension. 983 }, 984 ], 985 "dateRange": { # Represents a date range. # The date range this report should be run for. 986 "endDate": "A String", 987 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 988 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 989 "startDate": "A String", 990 }, 991 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 992 "dimensionName": "A String", # The name of the dimension. 993 "etag": "A String", # The eTag of this response for caching purposes. 994 "id": "A String", # The ID associated with the value if available. 995 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 996 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 997 "value": "A String", # The value of the dimension. 998 }, 999 "metricNames": [ # The list of names of metrics the report should include. 1000 "A String", 1001 ], 1002 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 1003 { # Represents a sorted dimension. 1004 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1005 "name": "A String", # The name of the dimension. 1006 "sortOrder": "A String", # An optional sort order for the dimension column. 1007 }, 1008 ], 1009 "reportProperties": { # The properties of the report. 1010 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 1011 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 1012 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 1013 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 1014 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 1015 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 1016 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 1017 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 1018 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 1019 }, 1020 }, 1021 "reachCriteria": { # The report criteria for a report of type "REACH". 1022 "activities": { # Represents an activity group. # Activity group. 1023 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 1024 { # Represents a DimensionValue resource. 1025 "dimensionName": "A String", # The name of the dimension. 1026 "etag": "A String", # The eTag of this response for caching purposes. 1027 "id": "A String", # The ID associated with the value if available. 1028 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1029 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1030 "value": "A String", # The value of the dimension. 1031 }, 1032 ], 1033 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 1034 "metricNames": [ # List of names of floodlight activity metrics. 1035 "A String", 1036 ], 1037 }, 1038 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 1039 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 1040 { # Represents a DimensionValue resource. 1041 "dimensionName": "A String", # The name of the dimension. 1042 "etag": "A String", # The eTag of this response for caching purposes. 1043 "id": "A String", # The ID associated with the value if available. 1044 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1045 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1046 "value": "A String", # The value of the dimension. 1047 }, 1048 ], 1049 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 1050 }, 1051 "dateRange": { # Represents a date range. # The date range this report should be run for. 1052 "endDate": "A String", 1053 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1054 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1055 "startDate": "A String", 1056 }, 1057 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1058 { # Represents a DimensionValue resource. 1059 "dimensionName": "A String", # The name of the dimension. 1060 "etag": "A String", # The eTag of this response for caching purposes. 1061 "id": "A String", # The ID associated with the value if available. 1062 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1063 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1064 "value": "A String", # The value of the dimension. 1065 }, 1066 ], 1067 "dimensions": [ # The list of dimensions the report should include. 1068 { # Represents a sorted dimension. 1069 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1070 "name": "A String", # The name of the dimension. 1071 "sortOrder": "A String", # An optional sort order for the dimension column. 1072 }, 1073 ], 1074 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 1075 "metricNames": [ # The list of names of metrics the report should include. 1076 "A String", 1077 ], 1078 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 1079 "A String", 1080 ], 1081 }, 1082 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 1083 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 1084 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 1085 "expirationDate": "A String", 1086 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 1087 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 1088 "A String", 1089 ], 1090 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 1091 "startDate": "A String", 1092 }, 1093 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 1094 "type": "A String", # The type of the report. 1095}</pre> 1096</div> 1097 1098<div class="method"> 1099 <code class="details" id="list">list(profileId, maxResults=None, pageToken=None, scope=None, sortField=None, sortOrder=None, x__xgafv=None)</code> 1100 <pre>Retrieves list of reports. 1101 1102Args: 1103 profileId: string, The Campaign Manager 360 user profile ID. (required) 1104 maxResults: integer, Maximum number of results to return. 1105 pageToken: string, The value of the nextToken from the previous result page. 1106 scope: string, The scope that defines which results are returned. 1107 Allowed values 1108 ALL - All reports in account. 1109 MINE - My reports. 1110 sortField: string, The field by which to sort the list. 1111 Allowed values 1112 ID - Sort by report ID. 1113 LAST_MODIFIED_TIME - Sort by 'lastModifiedTime' field. 1114 NAME - Sort by name of reports. 1115 sortOrder: string, Order of sorted results. 1116 Allowed values 1117 ASCENDING - Ascending order. 1118 DESCENDING - Descending order. 1119 x__xgafv: string, V1 error format. 1120 Allowed values 1121 1 - v1 error format 1122 2 - v2 error format 1123 1124Returns: 1125 An object of the form: 1126 1127 { # Represents the list of reports. 1128 "etag": "A String", # The eTag of this response for caching purposes. 1129 "items": [ # The reports returned in this response. 1130 { # Represents a Report resource. 1131 "accountId": "A String", # The account ID to which this report belongs. 1132 "criteria": { # The report criteria for a report of type "STANDARD". 1133 "activities": { # Represents an activity group. # Activity group. 1134 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 1135 { # Represents a DimensionValue resource. 1136 "dimensionName": "A String", # The name of the dimension. 1137 "etag": "A String", # The eTag of this response for caching purposes. 1138 "id": "A String", # The ID associated with the value if available. 1139 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1140 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1141 "value": "A String", # The value of the dimension. 1142 }, 1143 ], 1144 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 1145 "metricNames": [ # List of names of floodlight activity metrics. 1146 "A String", 1147 ], 1148 }, 1149 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 1150 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 1151 { # Represents a DimensionValue resource. 1152 "dimensionName": "A String", # The name of the dimension. 1153 "etag": "A String", # The eTag of this response for caching purposes. 1154 "id": "A String", # The ID associated with the value if available. 1155 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1156 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1157 "value": "A String", # The value of the dimension. 1158 }, 1159 ], 1160 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 1161 }, 1162 "dateRange": { # Represents a date range. # The date range for which this report should be run. 1163 "endDate": "A String", 1164 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1165 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1166 "startDate": "A String", 1167 }, 1168 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1169 { # Represents a DimensionValue resource. 1170 "dimensionName": "A String", # The name of the dimension. 1171 "etag": "A String", # The eTag of this response for caching purposes. 1172 "id": "A String", # The ID associated with the value if available. 1173 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1174 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1175 "value": "A String", # The value of the dimension. 1176 }, 1177 ], 1178 "dimensions": [ # The list of standard dimensions the report should include. 1179 { # Represents a sorted dimension. 1180 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1181 "name": "A String", # The name of the dimension. 1182 "sortOrder": "A String", # An optional sort order for the dimension column. 1183 }, 1184 ], 1185 "metricNames": [ # The list of names of metrics the report should include. 1186 "A String", 1187 ], 1188 }, 1189 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 1190 "breakdown": [ # The list of dimensions the report should include. 1191 { # Represents a sorted dimension. 1192 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1193 "name": "A String", # The name of the dimension. 1194 "sortOrder": "A String", # An optional sort order for the dimension column. 1195 }, 1196 ], 1197 "dateRange": { # Represents a date range. # The date range this report should be run for. 1198 "endDate": "A String", 1199 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1200 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1201 "startDate": "A String", 1202 }, 1203 "dimension": "A String", # The dimension option. 1204 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 1205 { # Represents a DimensionValue resource. 1206 "dimensionName": "A String", # The name of the dimension. 1207 "etag": "A String", # The eTag of this response for caching purposes. 1208 "id": "A String", # The ID associated with the value if available. 1209 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1210 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1211 "value": "A String", # The value of the dimension. 1212 }, 1213 ], 1214 "metricNames": [ # The list of names of metrics the report should include. 1215 "A String", 1216 ], 1217 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 1218 "A String", 1219 ], 1220 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 1221 }, 1222 "delivery": { # The report's email delivery settings. 1223 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 1224 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 1225 "message": "A String", # The message to be sent with each email. 1226 "recipients": [ # The list of recipients to which to email the report. 1227 { # Represents a recipient. 1228 "deliveryType": "A String", # The delivery type for the recipient. 1229 "email": "A String", # The email address of the recipient. 1230 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 1231 }, 1232 ], 1233 }, 1234 "etag": "A String", # The eTag of this response for caching purposes. 1235 "fileName": "A String", # The filename used when generating report files for this report. 1236 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 1237 "customRichMediaEvents": [ # The list of custom rich media events to include. 1238 { # Represents a DimensionValue resource. 1239 "dimensionName": "A String", # The name of the dimension. 1240 "etag": "A String", # The eTag of this response for caching purposes. 1241 "id": "A String", # The ID associated with the value if available. 1242 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1243 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1244 "value": "A String", # The value of the dimension. 1245 }, 1246 ], 1247 "dateRange": { # Represents a date range. # The date range this report should be run for. 1248 "endDate": "A String", 1249 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1250 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1251 "startDate": "A String", 1252 }, 1253 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1254 { # Represents a DimensionValue resource. 1255 "dimensionName": "A String", # The name of the dimension. 1256 "etag": "A String", # The eTag of this response for caching purposes. 1257 "id": "A String", # The ID associated with the value if available. 1258 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1259 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1260 "value": "A String", # The value of the dimension. 1261 }, 1262 ], 1263 "dimensions": [ # The list of dimensions the report should include. 1264 { # Represents a sorted dimension. 1265 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1266 "name": "A String", # The name of the dimension. 1267 "sortOrder": "A String", # An optional sort order for the dimension column. 1268 }, 1269 ], 1270 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 1271 "dimensionName": "A String", # The name of the dimension. 1272 "etag": "A String", # The eTag of this response for caching purposes. 1273 "id": "A String", # The ID associated with the value if available. 1274 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1275 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1276 "value": "A String", # The value of the dimension. 1277 }, 1278 "metricNames": [ # The list of names of metrics the report should include. 1279 "A String", 1280 ], 1281 "reportProperties": { # The properties of the report. 1282 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 1283 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 1284 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 1285 }, 1286 }, 1287 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 1288 "id": "A String", # The unique ID identifying this report resource. 1289 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 1290 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 1291 "name": "A String", # The name of the report. 1292 "ownerProfileId": "A String", # The user profile id of the owner of this report. 1293 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 1294 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 1295 { # Represents a DimensionValue resource. 1296 "dimensionName": "A String", # The name of the dimension. 1297 "etag": "A String", # The eTag of this response for caching purposes. 1298 "id": "A String", # The ID associated with the value if available. 1299 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1300 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1301 "value": "A String", # The value of the dimension. 1302 }, 1303 ], 1304 "conversionDimensions": [ # The list of conversion dimensions the report should include. 1305 { # Represents a sorted dimension. 1306 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1307 "name": "A String", # The name of the dimension. 1308 "sortOrder": "A String", # An optional sort order for the dimension column. 1309 }, 1310 ], 1311 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 1312 { # Represents a sorted dimension. 1313 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1314 "name": "A String", # The name of the dimension. 1315 "sortOrder": "A String", # An optional sort order for the dimension column. 1316 }, 1317 ], 1318 "customRichMediaEvents": [ # The list of custom rich media events to include. 1319 { # Represents a DimensionValue resource. 1320 "dimensionName": "A String", # The name of the dimension. 1321 "etag": "A String", # The eTag of this response for caching purposes. 1322 "id": "A String", # The ID associated with the value if available. 1323 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1324 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1325 "value": "A String", # The value of the dimension. 1326 }, 1327 ], 1328 "dateRange": { # Represents a date range. # The date range this report should be run for. 1329 "endDate": "A String", 1330 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1331 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1332 "startDate": "A String", 1333 }, 1334 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 1335 "dimensionName": "A String", # The name of the dimension. 1336 "etag": "A String", # The eTag of this response for caching purposes. 1337 "id": "A String", # The ID associated with the value if available. 1338 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1339 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1340 "value": "A String", # The value of the dimension. 1341 }, 1342 "metricNames": [ # The list of names of metrics the report should include. 1343 "A String", 1344 ], 1345 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 1346 { # Represents a sorted dimension. 1347 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1348 "name": "A String", # The name of the dimension. 1349 "sortOrder": "A String", # An optional sort order for the dimension column. 1350 }, 1351 ], 1352 "reportProperties": { # The properties of the report. 1353 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 1354 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 1355 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 1356 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 1357 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 1358 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 1359 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 1360 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 1361 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 1362 }, 1363 }, 1364 "reachCriteria": { # The report criteria for a report of type "REACH". 1365 "activities": { # Represents an activity group. # Activity group. 1366 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 1367 { # Represents a DimensionValue resource. 1368 "dimensionName": "A String", # The name of the dimension. 1369 "etag": "A String", # The eTag of this response for caching purposes. 1370 "id": "A String", # The ID associated with the value if available. 1371 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1372 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1373 "value": "A String", # The value of the dimension. 1374 }, 1375 ], 1376 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 1377 "metricNames": [ # List of names of floodlight activity metrics. 1378 "A String", 1379 ], 1380 }, 1381 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 1382 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 1383 { # Represents a DimensionValue resource. 1384 "dimensionName": "A String", # The name of the dimension. 1385 "etag": "A String", # The eTag of this response for caching purposes. 1386 "id": "A String", # The ID associated with the value if available. 1387 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1388 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1389 "value": "A String", # The value of the dimension. 1390 }, 1391 ], 1392 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 1393 }, 1394 "dateRange": { # Represents a date range. # The date range this report should be run for. 1395 "endDate": "A String", 1396 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1397 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1398 "startDate": "A String", 1399 }, 1400 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1401 { # Represents a DimensionValue resource. 1402 "dimensionName": "A String", # The name of the dimension. 1403 "etag": "A String", # The eTag of this response for caching purposes. 1404 "id": "A String", # The ID associated with the value if available. 1405 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1406 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1407 "value": "A String", # The value of the dimension. 1408 }, 1409 ], 1410 "dimensions": [ # The list of dimensions the report should include. 1411 { # Represents a sorted dimension. 1412 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1413 "name": "A String", # The name of the dimension. 1414 "sortOrder": "A String", # An optional sort order for the dimension column. 1415 }, 1416 ], 1417 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 1418 "metricNames": [ # The list of names of metrics the report should include. 1419 "A String", 1420 ], 1421 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 1422 "A String", 1423 ], 1424 }, 1425 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 1426 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 1427 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 1428 "expirationDate": "A String", 1429 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 1430 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 1431 "A String", 1432 ], 1433 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 1434 "startDate": "A String", 1435 }, 1436 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 1437 "type": "A String", # The type of the report. 1438 }, 1439 ], 1440 "kind": "A String", # The kind of list this is, in this case dfareporting#reportList. 1441 "nextPageToken": "A String", # Continuation token used to page through reports. To retrieve the next page of results, set the next request's "pageToken" to the value of this field. The page token is only valid for a limited amount of time and should not be persisted. 1442}</pre> 1443</div> 1444 1445<div class="method"> 1446 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 1447 <pre>Retrieves the next page of results. 1448 1449Args: 1450 previous_request: The request for the previous page. (required) 1451 previous_response: The response from the request for the previous page. (required) 1452 1453Returns: 1454 A request object that you can call 'execute()' on to request the next 1455 page. Returns None if there are no more items in the collection. 1456 </pre> 1457</div> 1458 1459<div class="method"> 1460 <code class="details" id="patch">patch(profileId, reportId, body=None, x__xgafv=None)</code> 1461 <pre>Updates an existing report. This method supports patch semantics. 1462 1463Args: 1464 profileId: string, The DFA user profile ID. (required) 1465 reportId: string, The ID of the report. (required) 1466 body: object, The request body. 1467 The object takes the form of: 1468 1469{ # Represents a Report resource. 1470 "accountId": "A String", # The account ID to which this report belongs. 1471 "criteria": { # The report criteria for a report of type "STANDARD". 1472 "activities": { # Represents an activity group. # Activity group. 1473 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 1474 { # Represents a DimensionValue resource. 1475 "dimensionName": "A String", # The name of the dimension. 1476 "etag": "A String", # The eTag of this response for caching purposes. 1477 "id": "A String", # The ID associated with the value if available. 1478 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1479 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1480 "value": "A String", # The value of the dimension. 1481 }, 1482 ], 1483 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 1484 "metricNames": [ # List of names of floodlight activity metrics. 1485 "A String", 1486 ], 1487 }, 1488 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 1489 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 1490 { # Represents a DimensionValue resource. 1491 "dimensionName": "A String", # The name of the dimension. 1492 "etag": "A String", # The eTag of this response for caching purposes. 1493 "id": "A String", # The ID associated with the value if available. 1494 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1495 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1496 "value": "A String", # The value of the dimension. 1497 }, 1498 ], 1499 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 1500 }, 1501 "dateRange": { # Represents a date range. # The date range for which this report should be run. 1502 "endDate": "A String", 1503 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1504 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1505 "startDate": "A String", 1506 }, 1507 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1508 { # Represents a DimensionValue resource. 1509 "dimensionName": "A String", # The name of the dimension. 1510 "etag": "A String", # The eTag of this response for caching purposes. 1511 "id": "A String", # The ID associated with the value if available. 1512 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1513 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1514 "value": "A String", # The value of the dimension. 1515 }, 1516 ], 1517 "dimensions": [ # The list of standard dimensions the report should include. 1518 { # Represents a sorted dimension. 1519 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1520 "name": "A String", # The name of the dimension. 1521 "sortOrder": "A String", # An optional sort order for the dimension column. 1522 }, 1523 ], 1524 "metricNames": [ # The list of names of metrics the report should include. 1525 "A String", 1526 ], 1527 }, 1528 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 1529 "breakdown": [ # The list of dimensions the report should include. 1530 { # Represents a sorted dimension. 1531 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1532 "name": "A String", # The name of the dimension. 1533 "sortOrder": "A String", # An optional sort order for the dimension column. 1534 }, 1535 ], 1536 "dateRange": { # Represents a date range. # The date range this report should be run for. 1537 "endDate": "A String", 1538 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1539 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1540 "startDate": "A String", 1541 }, 1542 "dimension": "A String", # The dimension option. 1543 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 1544 { # Represents a DimensionValue resource. 1545 "dimensionName": "A String", # The name of the dimension. 1546 "etag": "A String", # The eTag of this response for caching purposes. 1547 "id": "A String", # The ID associated with the value if available. 1548 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1549 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1550 "value": "A String", # The value of the dimension. 1551 }, 1552 ], 1553 "metricNames": [ # The list of names of metrics the report should include. 1554 "A String", 1555 ], 1556 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 1557 "A String", 1558 ], 1559 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 1560 }, 1561 "delivery": { # The report's email delivery settings. 1562 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 1563 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 1564 "message": "A String", # The message to be sent with each email. 1565 "recipients": [ # The list of recipients to which to email the report. 1566 { # Represents a recipient. 1567 "deliveryType": "A String", # The delivery type for the recipient. 1568 "email": "A String", # The email address of the recipient. 1569 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 1570 }, 1571 ], 1572 }, 1573 "etag": "A String", # The eTag of this response for caching purposes. 1574 "fileName": "A String", # The filename used when generating report files for this report. 1575 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 1576 "customRichMediaEvents": [ # The list of custom rich media events to include. 1577 { # Represents a DimensionValue resource. 1578 "dimensionName": "A String", # The name of the dimension. 1579 "etag": "A String", # The eTag of this response for caching purposes. 1580 "id": "A String", # The ID associated with the value if available. 1581 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1582 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1583 "value": "A String", # The value of the dimension. 1584 }, 1585 ], 1586 "dateRange": { # Represents a date range. # The date range this report should be run for. 1587 "endDate": "A String", 1588 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1589 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1590 "startDate": "A String", 1591 }, 1592 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1593 { # Represents a DimensionValue resource. 1594 "dimensionName": "A String", # The name of the dimension. 1595 "etag": "A String", # The eTag of this response for caching purposes. 1596 "id": "A String", # The ID associated with the value if available. 1597 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1598 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1599 "value": "A String", # The value of the dimension. 1600 }, 1601 ], 1602 "dimensions": [ # The list of dimensions the report should include. 1603 { # Represents a sorted dimension. 1604 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1605 "name": "A String", # The name of the dimension. 1606 "sortOrder": "A String", # An optional sort order for the dimension column. 1607 }, 1608 ], 1609 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 1610 "dimensionName": "A String", # The name of the dimension. 1611 "etag": "A String", # The eTag of this response for caching purposes. 1612 "id": "A String", # The ID associated with the value if available. 1613 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1614 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1615 "value": "A String", # The value of the dimension. 1616 }, 1617 "metricNames": [ # The list of names of metrics the report should include. 1618 "A String", 1619 ], 1620 "reportProperties": { # The properties of the report. 1621 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 1622 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 1623 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 1624 }, 1625 }, 1626 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 1627 "id": "A String", # The unique ID identifying this report resource. 1628 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 1629 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 1630 "name": "A String", # The name of the report. 1631 "ownerProfileId": "A String", # The user profile id of the owner of this report. 1632 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 1633 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 1634 { # Represents a DimensionValue resource. 1635 "dimensionName": "A String", # The name of the dimension. 1636 "etag": "A String", # The eTag of this response for caching purposes. 1637 "id": "A String", # The ID associated with the value if available. 1638 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1639 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1640 "value": "A String", # The value of the dimension. 1641 }, 1642 ], 1643 "conversionDimensions": [ # The list of conversion dimensions the report should include. 1644 { # Represents a sorted dimension. 1645 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1646 "name": "A String", # The name of the dimension. 1647 "sortOrder": "A String", # An optional sort order for the dimension column. 1648 }, 1649 ], 1650 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 1651 { # Represents a sorted dimension. 1652 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1653 "name": "A String", # The name of the dimension. 1654 "sortOrder": "A String", # An optional sort order for the dimension column. 1655 }, 1656 ], 1657 "customRichMediaEvents": [ # The list of custom rich media events to include. 1658 { # Represents a DimensionValue resource. 1659 "dimensionName": "A String", # The name of the dimension. 1660 "etag": "A String", # The eTag of this response for caching purposes. 1661 "id": "A String", # The ID associated with the value if available. 1662 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1663 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1664 "value": "A String", # The value of the dimension. 1665 }, 1666 ], 1667 "dateRange": { # Represents a date range. # The date range this report should be run for. 1668 "endDate": "A String", 1669 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1670 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1671 "startDate": "A String", 1672 }, 1673 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 1674 "dimensionName": "A String", # The name of the dimension. 1675 "etag": "A String", # The eTag of this response for caching purposes. 1676 "id": "A String", # The ID associated with the value if available. 1677 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1678 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1679 "value": "A String", # The value of the dimension. 1680 }, 1681 "metricNames": [ # The list of names of metrics the report should include. 1682 "A String", 1683 ], 1684 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 1685 { # Represents a sorted dimension. 1686 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1687 "name": "A String", # The name of the dimension. 1688 "sortOrder": "A String", # An optional sort order for the dimension column. 1689 }, 1690 ], 1691 "reportProperties": { # The properties of the report. 1692 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 1693 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 1694 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 1695 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 1696 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 1697 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 1698 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 1699 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 1700 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 1701 }, 1702 }, 1703 "reachCriteria": { # The report criteria for a report of type "REACH". 1704 "activities": { # Represents an activity group. # Activity group. 1705 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 1706 { # Represents a DimensionValue resource. 1707 "dimensionName": "A String", # The name of the dimension. 1708 "etag": "A String", # The eTag of this response for caching purposes. 1709 "id": "A String", # The ID associated with the value if available. 1710 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1711 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1712 "value": "A String", # The value of the dimension. 1713 }, 1714 ], 1715 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 1716 "metricNames": [ # List of names of floodlight activity metrics. 1717 "A String", 1718 ], 1719 }, 1720 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 1721 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 1722 { # Represents a DimensionValue resource. 1723 "dimensionName": "A String", # The name of the dimension. 1724 "etag": "A String", # The eTag of this response for caching purposes. 1725 "id": "A String", # The ID associated with the value if available. 1726 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1727 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1728 "value": "A String", # The value of the dimension. 1729 }, 1730 ], 1731 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 1732 }, 1733 "dateRange": { # Represents a date range. # The date range this report should be run for. 1734 "endDate": "A String", 1735 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1736 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1737 "startDate": "A String", 1738 }, 1739 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1740 { # Represents a DimensionValue resource. 1741 "dimensionName": "A String", # The name of the dimension. 1742 "etag": "A String", # The eTag of this response for caching purposes. 1743 "id": "A String", # The ID associated with the value if available. 1744 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1745 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1746 "value": "A String", # The value of the dimension. 1747 }, 1748 ], 1749 "dimensions": [ # The list of dimensions the report should include. 1750 { # Represents a sorted dimension. 1751 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1752 "name": "A String", # The name of the dimension. 1753 "sortOrder": "A String", # An optional sort order for the dimension column. 1754 }, 1755 ], 1756 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 1757 "metricNames": [ # The list of names of metrics the report should include. 1758 "A String", 1759 ], 1760 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 1761 "A String", 1762 ], 1763 }, 1764 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 1765 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 1766 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 1767 "expirationDate": "A String", 1768 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 1769 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 1770 "A String", 1771 ], 1772 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 1773 "startDate": "A String", 1774 }, 1775 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 1776 "type": "A String", # The type of the report. 1777} 1778 1779 x__xgafv: string, V1 error format. 1780 Allowed values 1781 1 - v1 error format 1782 2 - v2 error format 1783 1784Returns: 1785 An object of the form: 1786 1787 { # Represents a Report resource. 1788 "accountId": "A String", # The account ID to which this report belongs. 1789 "criteria": { # The report criteria for a report of type "STANDARD". 1790 "activities": { # Represents an activity group. # Activity group. 1791 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 1792 { # Represents a DimensionValue resource. 1793 "dimensionName": "A String", # The name of the dimension. 1794 "etag": "A String", # The eTag of this response for caching purposes. 1795 "id": "A String", # The ID associated with the value if available. 1796 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1797 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1798 "value": "A String", # The value of the dimension. 1799 }, 1800 ], 1801 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 1802 "metricNames": [ # List of names of floodlight activity metrics. 1803 "A String", 1804 ], 1805 }, 1806 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 1807 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 1808 { # Represents a DimensionValue resource. 1809 "dimensionName": "A String", # The name of the dimension. 1810 "etag": "A String", # The eTag of this response for caching purposes. 1811 "id": "A String", # The ID associated with the value if available. 1812 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1813 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1814 "value": "A String", # The value of the dimension. 1815 }, 1816 ], 1817 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 1818 }, 1819 "dateRange": { # Represents a date range. # The date range for which this report should be run. 1820 "endDate": "A String", 1821 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1822 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1823 "startDate": "A String", 1824 }, 1825 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1826 { # Represents a DimensionValue resource. 1827 "dimensionName": "A String", # The name of the dimension. 1828 "etag": "A String", # The eTag of this response for caching purposes. 1829 "id": "A String", # The ID associated with the value if available. 1830 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1831 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1832 "value": "A String", # The value of the dimension. 1833 }, 1834 ], 1835 "dimensions": [ # The list of standard dimensions the report should include. 1836 { # Represents a sorted dimension. 1837 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1838 "name": "A String", # The name of the dimension. 1839 "sortOrder": "A String", # An optional sort order for the dimension column. 1840 }, 1841 ], 1842 "metricNames": [ # The list of names of metrics the report should include. 1843 "A String", 1844 ], 1845 }, 1846 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 1847 "breakdown": [ # The list of dimensions the report should include. 1848 { # Represents a sorted dimension. 1849 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1850 "name": "A String", # The name of the dimension. 1851 "sortOrder": "A String", # An optional sort order for the dimension column. 1852 }, 1853 ], 1854 "dateRange": { # Represents a date range. # The date range this report should be run for. 1855 "endDate": "A String", 1856 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1857 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1858 "startDate": "A String", 1859 }, 1860 "dimension": "A String", # The dimension option. 1861 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 1862 { # Represents a DimensionValue resource. 1863 "dimensionName": "A String", # The name of the dimension. 1864 "etag": "A String", # The eTag of this response for caching purposes. 1865 "id": "A String", # The ID associated with the value if available. 1866 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1867 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1868 "value": "A String", # The value of the dimension. 1869 }, 1870 ], 1871 "metricNames": [ # The list of names of metrics the report should include. 1872 "A String", 1873 ], 1874 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 1875 "A String", 1876 ], 1877 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 1878 }, 1879 "delivery": { # The report's email delivery settings. 1880 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 1881 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 1882 "message": "A String", # The message to be sent with each email. 1883 "recipients": [ # The list of recipients to which to email the report. 1884 { # Represents a recipient. 1885 "deliveryType": "A String", # The delivery type for the recipient. 1886 "email": "A String", # The email address of the recipient. 1887 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 1888 }, 1889 ], 1890 }, 1891 "etag": "A String", # The eTag of this response for caching purposes. 1892 "fileName": "A String", # The filename used when generating report files for this report. 1893 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 1894 "customRichMediaEvents": [ # The list of custom rich media events to include. 1895 { # Represents a DimensionValue resource. 1896 "dimensionName": "A String", # The name of the dimension. 1897 "etag": "A String", # The eTag of this response for caching purposes. 1898 "id": "A String", # The ID associated with the value if available. 1899 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1900 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1901 "value": "A String", # The value of the dimension. 1902 }, 1903 ], 1904 "dateRange": { # Represents a date range. # The date range this report should be run for. 1905 "endDate": "A String", 1906 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1907 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1908 "startDate": "A String", 1909 }, 1910 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 1911 { # Represents a DimensionValue resource. 1912 "dimensionName": "A String", # The name of the dimension. 1913 "etag": "A String", # The eTag of this response for caching purposes. 1914 "id": "A String", # The ID associated with the value if available. 1915 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1916 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1917 "value": "A String", # The value of the dimension. 1918 }, 1919 ], 1920 "dimensions": [ # The list of dimensions the report should include. 1921 { # Represents a sorted dimension. 1922 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1923 "name": "A String", # The name of the dimension. 1924 "sortOrder": "A String", # An optional sort order for the dimension column. 1925 }, 1926 ], 1927 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 1928 "dimensionName": "A String", # The name of the dimension. 1929 "etag": "A String", # The eTag of this response for caching purposes. 1930 "id": "A String", # The ID associated with the value if available. 1931 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1932 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1933 "value": "A String", # The value of the dimension. 1934 }, 1935 "metricNames": [ # The list of names of metrics the report should include. 1936 "A String", 1937 ], 1938 "reportProperties": { # The properties of the report. 1939 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 1940 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 1941 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 1942 }, 1943 }, 1944 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 1945 "id": "A String", # The unique ID identifying this report resource. 1946 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 1947 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 1948 "name": "A String", # The name of the report. 1949 "ownerProfileId": "A String", # The user profile id of the owner of this report. 1950 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 1951 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 1952 { # Represents a DimensionValue resource. 1953 "dimensionName": "A String", # The name of the dimension. 1954 "etag": "A String", # The eTag of this response for caching purposes. 1955 "id": "A String", # The ID associated with the value if available. 1956 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1957 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1958 "value": "A String", # The value of the dimension. 1959 }, 1960 ], 1961 "conversionDimensions": [ # The list of conversion dimensions the report should include. 1962 { # Represents a sorted dimension. 1963 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1964 "name": "A String", # The name of the dimension. 1965 "sortOrder": "A String", # An optional sort order for the dimension column. 1966 }, 1967 ], 1968 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 1969 { # Represents a sorted dimension. 1970 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 1971 "name": "A String", # The name of the dimension. 1972 "sortOrder": "A String", # An optional sort order for the dimension column. 1973 }, 1974 ], 1975 "customRichMediaEvents": [ # The list of custom rich media events to include. 1976 { # Represents a DimensionValue resource. 1977 "dimensionName": "A String", # The name of the dimension. 1978 "etag": "A String", # The eTag of this response for caching purposes. 1979 "id": "A String", # The ID associated with the value if available. 1980 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1981 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1982 "value": "A String", # The value of the dimension. 1983 }, 1984 ], 1985 "dateRange": { # Represents a date range. # The date range this report should be run for. 1986 "endDate": "A String", 1987 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 1988 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 1989 "startDate": "A String", 1990 }, 1991 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 1992 "dimensionName": "A String", # The name of the dimension. 1993 "etag": "A String", # The eTag of this response for caching purposes. 1994 "id": "A String", # The ID associated with the value if available. 1995 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 1996 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 1997 "value": "A String", # The value of the dimension. 1998 }, 1999 "metricNames": [ # The list of names of metrics the report should include. 2000 "A String", 2001 ], 2002 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 2003 { # Represents a sorted dimension. 2004 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2005 "name": "A String", # The name of the dimension. 2006 "sortOrder": "A String", # An optional sort order for the dimension column. 2007 }, 2008 ], 2009 "reportProperties": { # The properties of the report. 2010 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 2011 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 2012 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 2013 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 2014 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 2015 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 2016 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 2017 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 2018 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 2019 }, 2020 }, 2021 "reachCriteria": { # The report criteria for a report of type "REACH". 2022 "activities": { # Represents an activity group. # Activity group. 2023 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 2024 { # Represents a DimensionValue resource. 2025 "dimensionName": "A String", # The name of the dimension. 2026 "etag": "A String", # The eTag of this response for caching purposes. 2027 "id": "A String", # The ID associated with the value if available. 2028 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2029 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2030 "value": "A String", # The value of the dimension. 2031 }, 2032 ], 2033 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 2034 "metricNames": [ # List of names of floodlight activity metrics. 2035 "A String", 2036 ], 2037 }, 2038 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 2039 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 2040 { # Represents a DimensionValue resource. 2041 "dimensionName": "A String", # The name of the dimension. 2042 "etag": "A String", # The eTag of this response for caching purposes. 2043 "id": "A String", # The ID associated with the value if available. 2044 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2045 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2046 "value": "A String", # The value of the dimension. 2047 }, 2048 ], 2049 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 2050 }, 2051 "dateRange": { # Represents a date range. # The date range this report should be run for. 2052 "endDate": "A String", 2053 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2054 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2055 "startDate": "A String", 2056 }, 2057 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2058 { # Represents a DimensionValue resource. 2059 "dimensionName": "A String", # The name of the dimension. 2060 "etag": "A String", # The eTag of this response for caching purposes. 2061 "id": "A String", # The ID associated with the value if available. 2062 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2063 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2064 "value": "A String", # The value of the dimension. 2065 }, 2066 ], 2067 "dimensions": [ # The list of dimensions the report should include. 2068 { # Represents a sorted dimension. 2069 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2070 "name": "A String", # The name of the dimension. 2071 "sortOrder": "A String", # An optional sort order for the dimension column. 2072 }, 2073 ], 2074 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 2075 "metricNames": [ # The list of names of metrics the report should include. 2076 "A String", 2077 ], 2078 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 2079 "A String", 2080 ], 2081 }, 2082 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 2083 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 2084 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 2085 "expirationDate": "A String", 2086 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 2087 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 2088 "A String", 2089 ], 2090 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 2091 "startDate": "A String", 2092 }, 2093 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 2094 "type": "A String", # The type of the report. 2095}</pre> 2096</div> 2097 2098<div class="method"> 2099 <code class="details" id="run">run(profileId, reportId, synchronous=None, x__xgafv=None)</code> 2100 <pre>Runs a report. 2101 2102Args: 2103 profileId: string, The Campaign Manager 360 user profile ID. (required) 2104 reportId: string, The ID of the report. (required) 2105 synchronous: boolean, If set and true, tries to run the report synchronously. 2106 x__xgafv: string, V1 error format. 2107 Allowed values 2108 1 - v1 error format 2109 2 - v2 error format 2110 2111Returns: 2112 An object of the form: 2113 2114 { # Represents a File resource. A file contains the metadata for a report run. It shows the status of the run and holds the URLs to the generated report data if the run is finished and the status is "REPORT_AVAILABLE". 2115 "dateRange": { # Represents a date range. # The date range for which the file has report data. The date range will always be the absolute date range for which the report is run. 2116 "endDate": "A String", 2117 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2118 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2119 "startDate": "A String", 2120 }, 2121 "etag": "A String", # Etag of this resource. 2122 "fileName": "A String", # The filename of the file. 2123 "format": "A String", # The output format of the report. Only available once the file is available. 2124 "id": "A String", # The unique ID of this report file. 2125 "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#file". 2126 "lastModifiedTime": "A String", # The timestamp in milliseconds since epoch when this file was last modified. 2127 "reportId": "A String", # The ID of the report this file was generated from. 2128 "status": "A String", # The status of the report file. 2129 "urls": { # The URLs where the completed report file can be downloaded. 2130 "apiUrl": "A String", # The URL for downloading the report data through the API. 2131 "browserUrl": "A String", # The URL for downloading the report data through a browser. 2132 }, 2133}</pre> 2134</div> 2135 2136<div class="method"> 2137 <code class="details" id="update">update(profileId, reportId, body=None, x__xgafv=None)</code> 2138 <pre>Updates a report. 2139 2140Args: 2141 profileId: string, The Campaign Manager 360 user profile ID. (required) 2142 reportId: string, The ID of the report. (required) 2143 body: object, The request body. 2144 The object takes the form of: 2145 2146{ # Represents a Report resource. 2147 "accountId": "A String", # The account ID to which this report belongs. 2148 "criteria": { # The report criteria for a report of type "STANDARD". 2149 "activities": { # Represents an activity group. # Activity group. 2150 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 2151 { # Represents a DimensionValue resource. 2152 "dimensionName": "A String", # The name of the dimension. 2153 "etag": "A String", # The eTag of this response for caching purposes. 2154 "id": "A String", # The ID associated with the value if available. 2155 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2156 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2157 "value": "A String", # The value of the dimension. 2158 }, 2159 ], 2160 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 2161 "metricNames": [ # List of names of floodlight activity metrics. 2162 "A String", 2163 ], 2164 }, 2165 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 2166 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 2167 { # Represents a DimensionValue resource. 2168 "dimensionName": "A String", # The name of the dimension. 2169 "etag": "A String", # The eTag of this response for caching purposes. 2170 "id": "A String", # The ID associated with the value if available. 2171 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2172 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2173 "value": "A String", # The value of the dimension. 2174 }, 2175 ], 2176 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 2177 }, 2178 "dateRange": { # Represents a date range. # The date range for which this report should be run. 2179 "endDate": "A String", 2180 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2181 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2182 "startDate": "A String", 2183 }, 2184 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2185 { # Represents a DimensionValue resource. 2186 "dimensionName": "A String", # The name of the dimension. 2187 "etag": "A String", # The eTag of this response for caching purposes. 2188 "id": "A String", # The ID associated with the value if available. 2189 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2190 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2191 "value": "A String", # The value of the dimension. 2192 }, 2193 ], 2194 "dimensions": [ # The list of standard dimensions the report should include. 2195 { # Represents a sorted dimension. 2196 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2197 "name": "A String", # The name of the dimension. 2198 "sortOrder": "A String", # An optional sort order for the dimension column. 2199 }, 2200 ], 2201 "metricNames": [ # The list of names of metrics the report should include. 2202 "A String", 2203 ], 2204 }, 2205 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 2206 "breakdown": [ # The list of dimensions the report should include. 2207 { # Represents a sorted dimension. 2208 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2209 "name": "A String", # The name of the dimension. 2210 "sortOrder": "A String", # An optional sort order for the dimension column. 2211 }, 2212 ], 2213 "dateRange": { # Represents a date range. # The date range this report should be run for. 2214 "endDate": "A String", 2215 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2216 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2217 "startDate": "A String", 2218 }, 2219 "dimension": "A String", # The dimension option. 2220 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 2221 { # Represents a DimensionValue resource. 2222 "dimensionName": "A String", # The name of the dimension. 2223 "etag": "A String", # The eTag of this response for caching purposes. 2224 "id": "A String", # The ID associated with the value if available. 2225 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2226 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2227 "value": "A String", # The value of the dimension. 2228 }, 2229 ], 2230 "metricNames": [ # The list of names of metrics the report should include. 2231 "A String", 2232 ], 2233 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 2234 "A String", 2235 ], 2236 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 2237 }, 2238 "delivery": { # The report's email delivery settings. 2239 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 2240 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 2241 "message": "A String", # The message to be sent with each email. 2242 "recipients": [ # The list of recipients to which to email the report. 2243 { # Represents a recipient. 2244 "deliveryType": "A String", # The delivery type for the recipient. 2245 "email": "A String", # The email address of the recipient. 2246 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 2247 }, 2248 ], 2249 }, 2250 "etag": "A String", # The eTag of this response for caching purposes. 2251 "fileName": "A String", # The filename used when generating report files for this report. 2252 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 2253 "customRichMediaEvents": [ # The list of custom rich media events to include. 2254 { # Represents a DimensionValue resource. 2255 "dimensionName": "A String", # The name of the dimension. 2256 "etag": "A String", # The eTag of this response for caching purposes. 2257 "id": "A String", # The ID associated with the value if available. 2258 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2259 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2260 "value": "A String", # The value of the dimension. 2261 }, 2262 ], 2263 "dateRange": { # Represents a date range. # The date range this report should be run for. 2264 "endDate": "A String", 2265 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2266 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2267 "startDate": "A String", 2268 }, 2269 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2270 { # Represents a DimensionValue resource. 2271 "dimensionName": "A String", # The name of the dimension. 2272 "etag": "A String", # The eTag of this response for caching purposes. 2273 "id": "A String", # The ID associated with the value if available. 2274 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2275 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2276 "value": "A String", # The value of the dimension. 2277 }, 2278 ], 2279 "dimensions": [ # The list of dimensions the report should include. 2280 { # Represents a sorted dimension. 2281 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2282 "name": "A String", # The name of the dimension. 2283 "sortOrder": "A String", # An optional sort order for the dimension column. 2284 }, 2285 ], 2286 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 2287 "dimensionName": "A String", # The name of the dimension. 2288 "etag": "A String", # The eTag of this response for caching purposes. 2289 "id": "A String", # The ID associated with the value if available. 2290 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2291 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2292 "value": "A String", # The value of the dimension. 2293 }, 2294 "metricNames": [ # The list of names of metrics the report should include. 2295 "A String", 2296 ], 2297 "reportProperties": { # The properties of the report. 2298 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 2299 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 2300 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 2301 }, 2302 }, 2303 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 2304 "id": "A String", # The unique ID identifying this report resource. 2305 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 2306 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 2307 "name": "A String", # The name of the report. 2308 "ownerProfileId": "A String", # The user profile id of the owner of this report. 2309 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 2310 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 2311 { # Represents a DimensionValue resource. 2312 "dimensionName": "A String", # The name of the dimension. 2313 "etag": "A String", # The eTag of this response for caching purposes. 2314 "id": "A String", # The ID associated with the value if available. 2315 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2316 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2317 "value": "A String", # The value of the dimension. 2318 }, 2319 ], 2320 "conversionDimensions": [ # The list of conversion dimensions the report should include. 2321 { # Represents a sorted dimension. 2322 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2323 "name": "A String", # The name of the dimension. 2324 "sortOrder": "A String", # An optional sort order for the dimension column. 2325 }, 2326 ], 2327 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 2328 { # Represents a sorted dimension. 2329 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2330 "name": "A String", # The name of the dimension. 2331 "sortOrder": "A String", # An optional sort order for the dimension column. 2332 }, 2333 ], 2334 "customRichMediaEvents": [ # The list of custom rich media events to include. 2335 { # Represents a DimensionValue resource. 2336 "dimensionName": "A String", # The name of the dimension. 2337 "etag": "A String", # The eTag of this response for caching purposes. 2338 "id": "A String", # The ID associated with the value if available. 2339 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2340 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2341 "value": "A String", # The value of the dimension. 2342 }, 2343 ], 2344 "dateRange": { # Represents a date range. # The date range this report should be run for. 2345 "endDate": "A String", 2346 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2347 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2348 "startDate": "A String", 2349 }, 2350 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 2351 "dimensionName": "A String", # The name of the dimension. 2352 "etag": "A String", # The eTag of this response for caching purposes. 2353 "id": "A String", # The ID associated with the value if available. 2354 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2355 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2356 "value": "A String", # The value of the dimension. 2357 }, 2358 "metricNames": [ # The list of names of metrics the report should include. 2359 "A String", 2360 ], 2361 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 2362 { # Represents a sorted dimension. 2363 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2364 "name": "A String", # The name of the dimension. 2365 "sortOrder": "A String", # An optional sort order for the dimension column. 2366 }, 2367 ], 2368 "reportProperties": { # The properties of the report. 2369 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 2370 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 2371 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 2372 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 2373 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 2374 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 2375 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 2376 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 2377 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 2378 }, 2379 }, 2380 "reachCriteria": { # The report criteria for a report of type "REACH". 2381 "activities": { # Represents an activity group. # Activity group. 2382 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 2383 { # Represents a DimensionValue resource. 2384 "dimensionName": "A String", # The name of the dimension. 2385 "etag": "A String", # The eTag of this response for caching purposes. 2386 "id": "A String", # The ID associated with the value if available. 2387 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2388 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2389 "value": "A String", # The value of the dimension. 2390 }, 2391 ], 2392 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 2393 "metricNames": [ # List of names of floodlight activity metrics. 2394 "A String", 2395 ], 2396 }, 2397 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 2398 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 2399 { # Represents a DimensionValue resource. 2400 "dimensionName": "A String", # The name of the dimension. 2401 "etag": "A String", # The eTag of this response for caching purposes. 2402 "id": "A String", # The ID associated with the value if available. 2403 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2404 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2405 "value": "A String", # The value of the dimension. 2406 }, 2407 ], 2408 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 2409 }, 2410 "dateRange": { # Represents a date range. # The date range this report should be run for. 2411 "endDate": "A String", 2412 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2413 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2414 "startDate": "A String", 2415 }, 2416 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2417 { # Represents a DimensionValue resource. 2418 "dimensionName": "A String", # The name of the dimension. 2419 "etag": "A String", # The eTag of this response for caching purposes. 2420 "id": "A String", # The ID associated with the value if available. 2421 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2422 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2423 "value": "A String", # The value of the dimension. 2424 }, 2425 ], 2426 "dimensions": [ # The list of dimensions the report should include. 2427 { # Represents a sorted dimension. 2428 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2429 "name": "A String", # The name of the dimension. 2430 "sortOrder": "A String", # An optional sort order for the dimension column. 2431 }, 2432 ], 2433 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 2434 "metricNames": [ # The list of names of metrics the report should include. 2435 "A String", 2436 ], 2437 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 2438 "A String", 2439 ], 2440 }, 2441 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 2442 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 2443 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 2444 "expirationDate": "A String", 2445 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 2446 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 2447 "A String", 2448 ], 2449 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 2450 "startDate": "A String", 2451 }, 2452 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 2453 "type": "A String", # The type of the report. 2454} 2455 2456 x__xgafv: string, V1 error format. 2457 Allowed values 2458 1 - v1 error format 2459 2 - v2 error format 2460 2461Returns: 2462 An object of the form: 2463 2464 { # Represents a Report resource. 2465 "accountId": "A String", # The account ID to which this report belongs. 2466 "criteria": { # The report criteria for a report of type "STANDARD". 2467 "activities": { # Represents an activity group. # Activity group. 2468 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 2469 { # Represents a DimensionValue resource. 2470 "dimensionName": "A String", # The name of the dimension. 2471 "etag": "A String", # The eTag of this response for caching purposes. 2472 "id": "A String", # The ID associated with the value if available. 2473 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2474 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2475 "value": "A String", # The value of the dimension. 2476 }, 2477 ], 2478 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 2479 "metricNames": [ # List of names of floodlight activity metrics. 2480 "A String", 2481 ], 2482 }, 2483 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 2484 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 2485 { # Represents a DimensionValue resource. 2486 "dimensionName": "A String", # The name of the dimension. 2487 "etag": "A String", # The eTag of this response for caching purposes. 2488 "id": "A String", # The ID associated with the value if available. 2489 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2490 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2491 "value": "A String", # The value of the dimension. 2492 }, 2493 ], 2494 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 2495 }, 2496 "dateRange": { # Represents a date range. # The date range for which this report should be run. 2497 "endDate": "A String", 2498 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2499 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2500 "startDate": "A String", 2501 }, 2502 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2503 { # Represents a DimensionValue resource. 2504 "dimensionName": "A String", # The name of the dimension. 2505 "etag": "A String", # The eTag of this response for caching purposes. 2506 "id": "A String", # The ID associated with the value if available. 2507 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2508 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2509 "value": "A String", # The value of the dimension. 2510 }, 2511 ], 2512 "dimensions": [ # The list of standard dimensions the report should include. 2513 { # Represents a sorted dimension. 2514 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2515 "name": "A String", # The name of the dimension. 2516 "sortOrder": "A String", # An optional sort order for the dimension column. 2517 }, 2518 ], 2519 "metricNames": [ # The list of names of metrics the report should include. 2520 "A String", 2521 ], 2522 }, 2523 "crossDimensionReachCriteria": { # The report criteria for a report of type "CROSS_DIMENSION_REACH". 2524 "breakdown": [ # The list of dimensions the report should include. 2525 { # Represents a sorted dimension. 2526 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2527 "name": "A String", # The name of the dimension. 2528 "sortOrder": "A String", # An optional sort order for the dimension column. 2529 }, 2530 ], 2531 "dateRange": { # Represents a date range. # The date range this report should be run for. 2532 "endDate": "A String", 2533 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2534 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2535 "startDate": "A String", 2536 }, 2537 "dimension": "A String", # The dimension option. 2538 "dimensionFilters": [ # The list of filters on which dimensions are filtered. 2539 { # Represents a DimensionValue resource. 2540 "dimensionName": "A String", # The name of the dimension. 2541 "etag": "A String", # The eTag of this response for caching purposes. 2542 "id": "A String", # The ID associated with the value if available. 2543 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2544 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2545 "value": "A String", # The value of the dimension. 2546 }, 2547 ], 2548 "metricNames": [ # The list of names of metrics the report should include. 2549 "A String", 2550 ], 2551 "overlapMetricNames": [ # The list of names of overlap metrics the report should include. 2552 "A String", 2553 ], 2554 "pivoted": True or False, # Whether the report is pivoted or not. Defaults to true. 2555 }, 2556 "delivery": { # The report's email delivery settings. 2557 "emailOwner": True or False, # Whether the report should be emailed to the report owner. 2558 "emailOwnerDeliveryType": "A String", # The type of delivery for the owner to receive, if enabled. 2559 "message": "A String", # The message to be sent with each email. 2560 "recipients": [ # The list of recipients to which to email the report. 2561 { # Represents a recipient. 2562 "deliveryType": "A String", # The delivery type for the recipient. 2563 "email": "A String", # The email address of the recipient. 2564 "kind": "A String", # The kind of resource this is, in this case dfareporting#recipient. 2565 }, 2566 ], 2567 }, 2568 "etag": "A String", # The eTag of this response for caching purposes. 2569 "fileName": "A String", # The filename used when generating report files for this report. 2570 "floodlightCriteria": { # The report criteria for a report of type "FLOODLIGHT". 2571 "customRichMediaEvents": [ # The list of custom rich media events to include. 2572 { # Represents a DimensionValue resource. 2573 "dimensionName": "A String", # The name of the dimension. 2574 "etag": "A String", # The eTag of this response for caching purposes. 2575 "id": "A String", # The ID associated with the value if available. 2576 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2577 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2578 "value": "A String", # The value of the dimension. 2579 }, 2580 ], 2581 "dateRange": { # Represents a date range. # The date range this report should be run for. 2582 "endDate": "A String", 2583 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2584 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2585 "startDate": "A String", 2586 }, 2587 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2588 { # Represents a DimensionValue resource. 2589 "dimensionName": "A String", # The name of the dimension. 2590 "etag": "A String", # The eTag of this response for caching purposes. 2591 "id": "A String", # The ID associated with the value if available. 2592 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2593 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2594 "value": "A String", # The value of the dimension. 2595 }, 2596 ], 2597 "dimensions": [ # The list of dimensions the report should include. 2598 { # Represents a sorted dimension. 2599 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2600 "name": "A String", # The name of the dimension. 2601 "sortOrder": "A String", # An optional sort order for the dimension column. 2602 }, 2603 ], 2604 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 2605 "dimensionName": "A String", # The name of the dimension. 2606 "etag": "A String", # The eTag of this response for caching purposes. 2607 "id": "A String", # The ID associated with the value if available. 2608 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2609 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2610 "value": "A String", # The value of the dimension. 2611 }, 2612 "metricNames": [ # The list of names of metrics the report should include. 2613 "A String", 2614 ], 2615 "reportProperties": { # The properties of the report. 2616 "includeAttributedIPConversions": True or False, # Include conversions that have no cookie, but do have an exposure path. 2617 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 2618 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 2619 }, 2620 }, 2621 "format": "A String", # The output format of the report. If not specified, default format is "CSV". Note that the actual format in the completed report file might differ if for instance the report's size exceeds the format's capabilities. "CSV" will then be the fallback format. 2622 "id": "A String", # The unique ID identifying this report resource. 2623 "kind": "A String", # The kind of resource this is, in this case dfareporting#report. 2624 "lastModifiedTime": "A String", # The timestamp (in milliseconds since epoch) of when this report was last modified. 2625 "name": "A String", # The name of the report. 2626 "ownerProfileId": "A String", # The user profile id of the owner of this report. 2627 "pathToConversionCriteria": { # The report criteria for a report of type "PATH_TO_CONVERSION". 2628 "activityFilters": [ # The list of 'dfa:activity' values to filter on. 2629 { # Represents a DimensionValue resource. 2630 "dimensionName": "A String", # The name of the dimension. 2631 "etag": "A String", # The eTag of this response for caching purposes. 2632 "id": "A String", # The ID associated with the value if available. 2633 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2634 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2635 "value": "A String", # The value of the dimension. 2636 }, 2637 ], 2638 "conversionDimensions": [ # The list of conversion dimensions the report should include. 2639 { # Represents a sorted dimension. 2640 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2641 "name": "A String", # The name of the dimension. 2642 "sortOrder": "A String", # An optional sort order for the dimension column. 2643 }, 2644 ], 2645 "customFloodlightVariables": [ # The list of custom floodlight variables the report should include. 2646 { # Represents a sorted dimension. 2647 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2648 "name": "A String", # The name of the dimension. 2649 "sortOrder": "A String", # An optional sort order for the dimension column. 2650 }, 2651 ], 2652 "customRichMediaEvents": [ # The list of custom rich media events to include. 2653 { # Represents a DimensionValue resource. 2654 "dimensionName": "A String", # The name of the dimension. 2655 "etag": "A String", # The eTag of this response for caching purposes. 2656 "id": "A String", # The ID associated with the value if available. 2657 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2658 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2659 "value": "A String", # The value of the dimension. 2660 }, 2661 ], 2662 "dateRange": { # Represents a date range. # The date range this report should be run for. 2663 "endDate": "A String", 2664 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2665 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2666 "startDate": "A String", 2667 }, 2668 "floodlightConfigId": { # Represents a DimensionValue resource. # The floodlight ID for which to show data in this report. All advertisers associated with that ID will automatically be added. The dimension of the value needs to be 'dfa:floodlightConfigId'. 2669 "dimensionName": "A String", # The name of the dimension. 2670 "etag": "A String", # The eTag of this response for caching purposes. 2671 "id": "A String", # The ID associated with the value if available. 2672 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2673 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2674 "value": "A String", # The value of the dimension. 2675 }, 2676 "metricNames": [ # The list of names of metrics the report should include. 2677 "A String", 2678 ], 2679 "perInteractionDimensions": [ # The list of per interaction dimensions the report should include. 2680 { # Represents a sorted dimension. 2681 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2682 "name": "A String", # The name of the dimension. 2683 "sortOrder": "A String", # An optional sort order for the dimension column. 2684 }, 2685 ], 2686 "reportProperties": { # The properties of the report. 2687 "clicksLookbackWindow": 42, # CM360 checks to see if a click interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 2688 "impressionsLookbackWindow": 42, # CM360 checks to see if an impression interaction occurred within the specified period of time before a conversion. By default the value is pulled from Floodlight or you can manually enter a custom value. Valid values: 1-90. 2689 "includeAttributedIPConversions": True or False, # Deprecated: has no effect. 2690 "includeUnattributedCookieConversions": True or False, # Include conversions of users with a DoubleClick cookie but without an exposure. That means the user did not click or see an ad from the advertiser within the Floodlight group, or that the interaction happened outside the lookback window. 2691 "includeUnattributedIPConversions": True or False, # Include conversions that have no associated cookies and no exposures. It’s therefore impossible to know how the user was exposed to your ads during the lookback window prior to a conversion. 2692 "maximumClickInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 2693 "maximumImpressionInteractions": 42, # The maximum number of click interactions to include in the report. Advertisers currently paying for E2C reports get up to 200 (100 clicks, 100 impressions). If another advertiser in your network is paying for E2C, you can have up to 5 total exposures per report. 2694 "maximumInteractionGap": 42, # The maximum amount of time that can take place between interactions (clicks or impressions) by the same user. Valid values: 1-90. 2695 "pivotOnInteractionPath": True or False, # Enable pivoting on interaction path. 2696 }, 2697 }, 2698 "reachCriteria": { # The report criteria for a report of type "REACH". 2699 "activities": { # Represents an activity group. # Activity group. 2700 "filters": [ # List of activity filters. The dimension values need to be all either of type "dfa:activity" or "dfa:activityGroup". 2701 { # Represents a DimensionValue resource. 2702 "dimensionName": "A String", # The name of the dimension. 2703 "etag": "A String", # The eTag of this response for caching purposes. 2704 "id": "A String", # The ID associated with the value if available. 2705 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2706 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2707 "value": "A String", # The value of the dimension. 2708 }, 2709 ], 2710 "kind": "A String", # The kind of resource this is, in this case dfareporting#activities. 2711 "metricNames": [ # List of names of floodlight activity metrics. 2712 "A String", 2713 ], 2714 }, 2715 "customRichMediaEvents": { # Represents a Custom Rich Media Events group. # Custom Rich Media Events group. 2716 "filteredEventIds": [ # List of custom rich media event IDs. Dimension values must be all of type dfa:richMediaEventTypeIdAndName. 2717 { # Represents a DimensionValue resource. 2718 "dimensionName": "A String", # The name of the dimension. 2719 "etag": "A String", # The eTag of this response for caching purposes. 2720 "id": "A String", # The ID associated with the value if available. 2721 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2722 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2723 "value": "A String", # The value of the dimension. 2724 }, 2725 ], 2726 "kind": "A String", # The kind of resource this is, in this case dfareporting#customRichMediaEvents. 2727 }, 2728 "dateRange": { # Represents a date range. # The date range this report should be run for. 2729 "endDate": "A String", 2730 "kind": "A String", # The kind of resource this is, in this case dfareporting#dateRange. 2731 "relativeDateRange": "A String", # The date range relative to the date of when the report is run. 2732 "startDate": "A String", 2733 }, 2734 "dimensionFilters": [ # The list of filters on which dimensions are filtered. Filters for different dimensions are ANDed, filters for the same dimension are grouped together and ORed. 2735 { # Represents a DimensionValue resource. 2736 "dimensionName": "A String", # The name of the dimension. 2737 "etag": "A String", # The eTag of this response for caching purposes. 2738 "id": "A String", # The ID associated with the value if available. 2739 "kind": "A String", # The kind of resource this is, in this case dfareporting#dimensionValue. 2740 "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT. 2741 "value": "A String", # The value of the dimension. 2742 }, 2743 ], 2744 "dimensions": [ # The list of dimensions the report should include. 2745 { # Represents a sorted dimension. 2746 "kind": "A String", # The kind of resource this is, in this case dfareporting#sortedDimension. 2747 "name": "A String", # The name of the dimension. 2748 "sortOrder": "A String", # An optional sort order for the dimension column. 2749 }, 2750 ], 2751 "enableAllDimensionCombinations": True or False, # Whether to enable all reach dimension combinations in the report. Defaults to false. If enabled, the date range of the report should be within the last 42 days. 2752 "metricNames": [ # The list of names of metrics the report should include. 2753 "A String", 2754 ], 2755 "reachByFrequencyMetricNames": [ # The list of names of Reach By Frequency metrics the report should include. 2756 "A String", 2757 ], 2758 }, 2759 "schedule": { # The report's schedule. Can only be set if the report's 'dateRange' is a relative date range and the relative date range is not "TODAY". 2760 "active": True or False, # Whether the schedule is active or not. Must be set to either true or false. 2761 "every": 42, # Defines every how many days, weeks or months the report should be run. Needs to be set when "repeats" is either "DAILY", "WEEKLY" or "MONTHLY". 2762 "expirationDate": "A String", 2763 "repeats": "A String", # The interval for which the report is repeated. Note: - "DAILY" also requires field "every" to be set. - "WEEKLY" also requires fields "every" and "repeatsOnWeekDays" to be set. - "MONTHLY" also requires fields "every" and "runsOnDayOfMonth" to be set. 2764 "repeatsOnWeekDays": [ # List of week days "WEEKLY" on which scheduled reports should run. 2765 "A String", 2766 ], 2767 "runsOnDayOfMonth": "A String", # Enum to define for "MONTHLY" scheduled reports whether reports should be repeated on the same day of the month as "startDate" or the same day of the week of the month. Example: If 'startDate' is Monday, April 2nd 2012 (2012-04-02), "DAY_OF_MONTH" would run subsequent reports on the 2nd of every Month, and "WEEK_OF_MONTH" would run subsequent reports on the first Monday of the month. 2768 "startDate": "A String", 2769 }, 2770 "subAccountId": "A String", # The subaccount ID to which this report belongs if applicable. 2771 "type": "A String", # The type of the report. 2772}</pre> 2773</div> 2774 2775</body></html>