Report Type: floodlightActivity
Stay organized with collections
Save and categorize content based on your preferences.
Configuration attributes for Floodlight activities.
This report can only be returned by an asynchronous request (that is, via the
Reports.request() method).
Request excerpt
Send a regular
Reports.request()
request body, but specify "reportType": "floodlightActivity".
{
...
"reportType": "floodlightActivity",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
For each column that you want returned or filtered in the report,
specify the columnName listed in the table below.
You can also optionally specify
headerText,
startDate,
and endDate.
Note that some columns cannot be filtered; refer to "Filterable" in the table below.
columnName | Description | Behavior | Type | Filterable |
|---|
status |
The status of the Floodlight activity: Active or Removed. |
attribute |
Status |
Yes |
creationTimestamp |
Timestamp of the Floodlight activity's creation, formatted in ISO 8601. |
attribute |
Timestamp |
Yes |
lastModifiedTimestamp |
Timestamp of the Floodlight activity's most recent modification, formatted in ISO 8601. |
attribute |
Timestamp |
Yes |
floodlightGroup |
Floodlight group name. |
attribute |
String |
Yes |
floodlightGroupConversionType |
The type of conversions generated by Floodlight activities in this group: Action or Transaction. |
attribute |
Conversion type |
Yes |
floodlightGroupId |
DS Floodlight group ID. |
attribute |
ID |
Yes |
floodlightGroupTag |
Floodlight group tag. |
attribute |
String |
Yes |
floodlightConfigurationId |
Campaign manager Floodlight configuration ID. |
attribute |
ID |
Yes |
floodlightActivity |
Floodlight activity name. |
attribute |
String |
Yes |
floodlightActivityId |
DS Floodlight activity ID. |
attribute |
ID |
Yes |
floodlightActivityTag |
Floodlight activity tag. |
attribute |
String |
Yes |
agency |
Agency name. |
attribute |
String |
Yes |
agencyId |
DS agency ID. |
attribute |
ID |
Yes |
advertiser |
Advertiser name. |
attribute |
String |
Yes |
advertiserId |
DS advertiser ID. |
attribute |
ID |
Yes |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eFloodlight activity configuration attributes can be retrieved through an asynchronous report using the \u003ccode\u003eReports.request()\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe report type must be specified as \u003ccode\u003e"reportType": "floodlightActivity"\u003c/code\u003e in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe report allows you to request and filter data using attributes like \u003ccode\u003estatus\u003c/code\u003e, \u003ccode\u003ecreationTimestamp\u003c/code\u003e, \u003ccode\u003efloodlightActivity\u003c/code\u003e, and more.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table outlines all available column names, their descriptions, data types, and whether they can be used for filtering.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize the report by specifying \u003ccode\u003eheaderText\u003c/code\u003e, \u003ccode\u003estartDate\u003c/code\u003e, and \u003ccode\u003eendDate\u003c/code\u003e for each column.\u003c/p\u003e\n"]]],["To generate a report on Floodlight activity attributes, use an asynchronous `Reports.request()` method and specify `\"reportType\": \"floodlightActivity\"`. Define the report's structure using `\"columns\"` and `\"filters\"`, listing `columnName` for each desired attribute. Additional `headerText`, `startDate`, and `endDate` fields can also be specified in the column. The report details Floodlight attributes such as `status`, `creationTimestamp`, `floodlightGroup`, and associated IDs, and if they are `filterable`.\n"],null,["# Report Type: floodlightActivity\n\nConfiguration attributes for Floodlight activities.\n\n\nThis report can only be returned by an asynchronous request (that is, via the\n[Reports.request()](/search-ads/v2/reference/reports/request) method).\n\n### Request excerpt\n\n\nSend a regular\n[Reports.request()](/search-ads/v2/reference/reports/request)\nrequest body, but specify `\"reportType\": \"floodlightActivity\"`.\n\n```text\n{\n...\n \"reportType\": \"floodlightActivity\",\n \"columns\": [\n {\n \"columnName\": string,\n \"headerText\": string,\n \"startDate\": string,\n \"endDate\": string\n }\n ],\n \"filters\": [\n {\n \"column\": {\n \"columnName\": string,\n },\n ...\n },\n ...\n ],\n...\n}\n```\n\n\nFor each column that you want returned or filtered in the report,\nspecify the `columnName` listed in the table below.\nYou can also optionally specify\n[headerText](/search-ads/v2/reference/reports#request.columns.headerText),\n[startDate](/search-ads/v2/reference/reports#request.columns.startDate),\nand [endDate](/search-ads/v2/reference/reports#request.columns.endDate).\nNote that some columns cannot be filtered; refer to \"Filterable\" in the table below.\n\n| `columnName` | Description | Behavior | Type | Filterable |\n|---------------------------------|------------------------------------------------------------------------------------------------------|-----------|-------------------|------------|\n| `status` | The status of the Floodlight activity: `Active` or `Removed`. | attribute | `Status` | Yes |\n| `creationTimestamp` | Timestamp of the Floodlight activity's creation, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `lastModifiedTimestamp` | Timestamp of the Floodlight activity's most recent modification, formatted in ISO 8601. | attribute | `Timestamp` | Yes |\n| `floodlightGroup` | Floodlight group name. | attribute | `String` | Yes |\n| `floodlightGroupConversionType` | The type of conversions generated by Floodlight activities in this group: `Action` or `Transaction`. | attribute | `Conversion type` | Yes |\n| `floodlightGroupId` | DS Floodlight group ID. | attribute | `ID` | Yes |\n| `floodlightGroupTag` | Floodlight group tag. | attribute | `String` | Yes |\n| `floodlightConfigurationId` | Campaign manager Floodlight configuration ID. | attribute | `ID` | Yes |\n| `floodlightActivity` | Floodlight activity name. | attribute | `String` | Yes |\n| `floodlightActivityId` | DS Floodlight activity ID. | attribute | `ID` | Yes |\n| `floodlightActivityTag` | Floodlight activity tag. | attribute | `String` | Yes |\n| `agency` | Agency name. | attribute | `String` | Yes |\n| `agencyId` | DS agency ID. | attribute | `ID` | Yes |\n| `advertiser` | Advertiser name. | attribute | `String` | Yes |\n| `advertiserId` | DS advertiser ID. | attribute | `ID` | Yes |"]]
