نوع التقرير: 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 |
رقم تعريف مجموعة Floodlight في DS. |
سمة |
ID |
نعم |
floodlightGroupTag |
علامة مجموعة Floodlight. |
سمة |
String |
نعم |
floodlightConfigurationId |
رقم تعريف إعدادات Floodlight في "مدير الحملة". |
سمة |
ID |
نعم |
floodlightActivity |
اسم نشاط Floodlight. |
سمة |
String |
نعم |
floodlightActivityId |
رقم تعريف نشاط Floodlight في DS. |
سمة |
ID |
نعم |
floodlightActivityTag |
علامة نشاط Floodlight. |
سمة |
String |
نعم |
agency |
اسم الوكالة |
سمة |
String |
نعم |
agencyId |
رقم تعريف وكالة DS. |
سمة |
ID |
نعم |
advertiser |
اسم المعلِن |
سمة |
String |
نعم |
advertiserId |
الرقم التعريفي للمعلِن في DS. |
سمة |
ID |
نعم |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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 |"]]