أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. يمكنك الانضمام إلى مجموعة Google searchads-api-announcements لتبقى على اطّلاع على التحسينات والإصدارات القادمة.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك متغيّرات Floodlight المخصّصة (CFV) جمع تفاصيل عن كلّ
إحالة ناجحة يتم تتبُّعها في نشاط Floodlight. ويمكن أن تتضمّن هذه المتغيّرات
معلومات مثل نوع المنتج الذي تم شراؤه أو حالة الولاء للعميل
أو مبلغ الخصم الذي تم تطبيقه.
تُجمِّع "إعلانات شبكة البحث 360" قيم المتغيّرات التي تمّ ضبطها كمقاييس. على سبيل المثال،
إذا كان المعلِن يتتبّع القيمة الدائمة للعميل (CLV) كمقياس متغيّر مخصّص في Floodlight، فإنّ تضمين ذلك في مورد المجموعة الإعلانية
سيعرض القيمة الدائمة للعميل المجمّعة لكل مجموعة إعلانية ضمن المورد.
يمكن استخدام ملفات CFV المعرّفة كأبعاد لتقسيم الموارد. على سبيل المثال، يمكن لصنّاع الإعلانات استخدام نموذج CFV لتتبُّع فئات المنتجات. وبعد إعداد هذه السمة كسمة، يسمح ذلك بتقسيم مورد المجموعة الإعلانية إلى شرائح لعرض عدد الإحالات الناجحة المنسوبة إلى كل فئة منتج ضمن المجموعة الإعلانية.
للحصول على جميع المتغيّرات المخصّصة المتاحة، نفِّذ ما يلي:
يمكن اختيار شريحة واحدة فقط من شرائح conversion_custom_dimensions لكل طلب بحث.
لا يمكن
اختيار conversion_custom_metrics وconversion_custom_dimensions في الطلب نفسه.
لا يمكن استخدام Conversion_custom_metrics وconversion_custom_dimensions
إلا مع ad_group وad_group_ad وad_group_criterion والحملة
وموارد العملاء.
المتغيّرات المخصّصة للإحالات الناجحة كسمات أحداث أولية في "مصدر الإحالات الناجحة"
في مورد الإحالات الناجحة، توفّر متغيّرات Floodlight المخصّصة بيانات تفصيلية غير مجمّعة عن الإحالات الناجحة الفردية. عند إضافة سمة مخصّصة إلى طلب البحث، تظهر قيمتها الخاصة لكل حدث. على سبيل المثال، إذا كنت تتتبّع أنواع المنتجات والعلامات التجارية كمنتجات قابلة للمقارنة، يمكنك
إنشاء تقرير يعرض البيانات التالية:
رقم تعريف الإحالة الناجحة
الطابع الزمني
نوع المنتج
العلامة التجارية
20001
202311101030
إلكترونيات
مثال على العلامة التجارية 1
20002
202311101045
ملابس
مثال على العلامة التجارية 2
20003
202311101215
إلكترونيات
مثال العلامة التجارية 3
من المهمّ ملاحظة أنّه في مرجع الإحالات الناجحة، يتمّ عرض مقاييس مثل Number
Sold كبيانات أحداث فردية، وليس كأرقام مجمّعة. ويتم تفصيل كل حدث إحالة ناجحة بشكل منفصل، مع التعامل مع مقاييس CFV وأبعاده كسمات أحداث محددة.
للحصول على جميع المتغيّرات المخصّصة المتاحة، نفِّذ ما يلي:
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCustom Floodlight variables (CFVs) allow you to gather specific details about each conversion, such as product type, customer loyalty, or discount applied, enhancing your understanding of customer interactions.\u003c/p\u003e\n"],["\u003cp\u003eCFVs can function as both metrics, providing aggregated data for analysis (e.g., total CLV per ad group), and dimensions, enabling segmentation for deeper insights (e.g., conversions by product category).\u003c/p\u003e\n"],["\u003cp\u003eWithin the Conversion resource, CFVs act as raw event attributes, revealing detailed information about each individual conversion, like product type and brand for each purchase.\u003c/p\u003e\n"],["\u003cp\u003eSearch Ads 360 offers flexibility in utilizing CFVs, but certain restrictions apply, such as limiting to one conversion_custom_dimensions segment per query and specific resource compatibility.\u003c/p\u003e\n"]]],["Custom Floodlight Variables (CFVs) track conversion details, such as product type or customer loyalty. CFVs defined as metrics aggregate values, like total customer lifetime value, within resources such as ad groups. CFVs set as dimensions segment resources, enabling breakdowns by categories like product type. To retrieve all available CFVs, the `conversion_custom_variable` resource must be queried. CFVs provide detailed, individual conversion data, showing each event's attributes. There are limitations in the queries, such as not being able to combine metrics and dimensions.\n"],null,["# Custom Floodlight metrics\n\nCustom Floodlight variables (CFVs) enable you to collect details about each\nconversion tracked in a Floodlight activity. These variables can include\ninformation like the type of product purchased, the loyalty status of the\ncustomer, or the amount of discount applied.\n\nFor more information, see [About custom Floodlight metrics and dimensions in the\nnew Search Ads 360](https://support.google.com/sa360/answer/13567857).\n\nCFVs as metrics and segments\n----------------------------\n\nSearch Ads 360 aggregates the values of variables set as metrics. For example,\nif an advertiser tracks customer lifetime value (CLV) as a custom Floodlight\nvariable metric, including this in the [ad group](/search-ads/reporting/api/reference/fields/v0/ad_group) resource\nwould show the aggregated CLV for each ad group within the resource.\n\nCFVs defined as dimensions can be used to segment resources. For example, an\nadvertiser could use a CFV to track product categories. Once set as a dimension,\nthis allows segmentation of an ad group resource to show the number of\nconversions attributed to each product category within the ad group.\n\nTo get all available custom variables, execute the following: \n\n SELECT conversion_custom_variable.id,\n conversion_custom_variable.name,\n conversion_custom_variable.tag,\n conversion_custom_variable.floodlight_conversion_custom_variable_info.floodlight_variable_type\n FROM conversion_custom_variable\n\n### CFV as metrics and segments examples\n\nAfter you have the conversion_custom_variable ID and variable type, you can\nbuild your own query similar to the following examples: \n\n SELECT conversion_custom_metrics.id[1234]\n FROM campaign\n WHERE segments.date=20240118\n\n SELECT conversion_custom_dimensions.id[1234]\n FROM campaign\n WHERE segments.date=20240118\n\n#### Restrictions\n\n- Only one conversion_custom_dimensions segment can be selected per query.\n\n- conversion_custom_metrics and conversion_custom_dimensions cannot be\n selected in the same query.\n\n- conversion_custom_metrics and conversion_custom_dimensions\n can only be used with ad_group, ad_group_ad, ad_group_criterion, campaign and\n customer resources.\n\nCFV as Raw Event Attributes in the Conversion Resource\n------------------------------------------------------\n\nIn the [Conversion](/search-ads/reporting/api/reference/fields/v0/conversion) resource, custom Floodlight variables\n(CFVs) provide detailed, unaggregated data about individual conversions. When a\ncustom dimension is added to the query, its specific value for each event is\nvisible. For example, if you track product types and brands as CFVs, you could\ncreate a report showing the following data:\n\n| Conversion ID | Timestamp | Product Type | Brand |\n|---------------|--------------|--------------|-----------------|\n| 20001 | 202311101030 | Electronics | Example Brand 1 |\n| 20002 | 202311101045 | Apparel | Example Brand 2 |\n| 20003 | 202311101215 | Electronics | Example Brand 3 |\n\nIt's important to note that in the conversion resource, metrics such as Number\nSold are presented as individual event data, not as aggregated figures. Each\nconversion event is detailed separately, treating both CFV metrics and\ndimensions as specific event attributes.\n\nTo get all available custom variables, execute the following: \n\n SELECT conversion_custom_variable.id,\n conversion_custom_variable.name,\n conversion_custom_variable.tag,\n conversion_custom_variable.floodlight_conversion_custom_variable_info.floodlight_variable_type\n FROM conversion_custom_variable\n\nAfter you have the conversion_custom_variable ID and variable type, you can\nbuild your own query similar to the following example\n\n### CFV as a raw event example\n\n SELECT raw_event_conversion_dimensions.id[1234],\n raw_event_conversion_metrics.id[5678]\n FROM conversion\n WHERE segments.date=20240118\n\n| **Note:** raw_event_conversion_dimensions and raw_event_conversion_metrics can only be used with the conversion resource."]]