Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Тип отчета: FloodlightActivity
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Атрибуты конфигурации для действий Floodlight.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "floodlightActivity"
.
{
...
"reportType": "floodlightActivity",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
}
Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName
, указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
---|
status | Статус действия Floodlight: Active или Removed . | атрибут | Status | Да |
creationTimestamp | Временная метка создания действия Floodlight в формате ISO 8601. | атрибут | Timestamp | Да |
lastModifiedTimestamp | Временная метка последней модификации действия Floodlight, отформатированная в формате ISO 8601. | атрибут | Timestamp | Да |
floodlightGroup | Название группы Floodlight. | атрибут | String | Да |
floodlightGroupConversionType | Тип конверсий, генерируемых действиями Floodlight в этой группе: Action или Transaction . | атрибут | Conversion type | Да |
floodlightGroupId | Идентификатор группы DS Floodlight. | атрибут | ID | Да |
floodlightGroupTag | Тег группы Floodlight. | атрибут | String | Да |
floodlightConfigurationId | Идентификатор конфигурации Floodlight менеджера кампаний. | атрибут | ID | Да |
floodlightActivity | Название действия Floodlight. | атрибут | String | Да |
floodlightActivityId | Идентификатор действия DS Floodlight. | атрибут | ID | Да |
floodlightActivityTag | Тег активности Floodlight. | атрибут | String | Да |
agency | Название агентства. | атрибут | String | Да |
agencyId | Идентификатор агентства DS. | атрибут | ID | Да |
advertiser | Имя рекламодателя. | атрибут | String | Да |
advertiserId | Идентификатор рекламодателя DS. | атрибут | ID | Да |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 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 |"]]