نوع گزارش: 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 | برچسب فعالیت نورافکن. | ویژگی | String | بله |
agency | نام آژانس | ویژگی | String | بله |
agencyId | شناسه نمایندگی DS. | ویژگی | ID | بله |
advertiser | نام تبلیغ کننده | ویژگی | String | بله |
advertiserId | شناسه تبلیغ کننده DS. | ویژگی | ID | بله |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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 |"]]