مقاييس الأداء وسمات الضبط وسمات المستودع للمنتجات المحدّدة في خلاصة المستودع والتي يتم الإعلان عنها في حملة تسوّق.
لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة Reports.request()).
طلب مقتطف
أرسِل نص طلب Reports.request() عاديًا، ولكن حدِّد "reportType": "productAdvertised"
.
{ ... "reportType": "productAdvertised", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
لكل عمود تريد عرضه أو تصفيته في التقرير، حدِّد columnName
المُدرَج في الجدول أدناه.
ويمكنك أيضًا اختياريًا تحديد
headerText
وstartDate
وendDate.
تجدر الإشارة إلى أنه لا يمكن تصفية بعض الأعمدة؛ راجع "قابل للتصفية" في الجدول أدناه.
columnName | الوصف | السلوك | النوع | قابل للفلترة |
---|---|---|---|---|
status |
حالة المنتج على النحو المُشار إليه في حساب المستودع: Active أو Removed . |
سمة | Status |
نعم |
creationTimestamp |
الطابع الزمني لإنشاء المنتج كما هو موضّح في حساب المستودع، بتنسيق بتنسيق ISO 8601. | سمة | Timestamp |
نعم |
lastModifiedTimestamp |
أحدث طابع زمني للتعديلات للمنتج كما هو مُشار إليه في حساب المستودع، أي التعديل بتنسيق ISO 8601. | سمة | Timestamp |
نعم |
agency |
اسم الوكالة. | سمة | String |
نعم |
agencyId |
رقم تعريف وكالة DS. | سمة | ID |
نعم |
advertiser |
اسم المعلن. | سمة | String |
نعم |
advertiserId |
الرقم التعريفي لمعلن DS. | سمة | ID |
نعم |
productId |
رقم تعريف العنصر الخاص بالمنتج | سمة | String |
نعم |
productCountry |
البلد المسجَّل لخلاصة مستودع المنتجات | سمة | String |
نعم |
productLanguage |
اللغة المسجّلة لخلاصة مستودع المنتجات. | سمة | String |
نعم |
productMpn |
سمة رقم القطعة بحسب الشركة المصنّعة (رقم القطعة بحسب الشركة المصنّعة) لسلعة معيّنة | سمة | String |
نعم |
productColor |
السمة color (اللون) لسلعة منتج. | سمة | String |
نعم |
productSize |
السمة size (المقاس) لسلعة منتج. | سمة | String |
نعم |
productMaterial |
السمة material (المادّة) لسلعة منتج. | سمة | String |
نعم |
productPattern |
السمة pattern (النمط) لسلعة منتج. | سمة | String |
نعم |
productAvailability |
السمة availability (مدى التوفّر) لسلعة في المنتج. | سمة | Product availability |
نعم |
productGender |
السمة gender (الجنس) لسلعة منتج. | سمة | String |
نعم |
productAgeGroup |
السمة age group (الفئة العمريّة) لسلعة معيّنة. | سمة | String |
نعم |
productLandingPageUrl |
سمة الصفحة المقصودة لسلعة منتج. | سمة | String |
نعم |
productCategory |
السمة google product category (فئة المنتجات من Google) لسلعة معيّنة. | سمة | String |
نعم |
productCategoryLevel1 |
السمة فئة المنتجات من Google للمستوى 1 لسلعة. | سمة | String |
نعم |
productCategoryLevel2 |
سمة فئة المنتجات من Google للمستوى 2 لسلعة. | سمة | String |
نعم |
productCategoryLevel3 |
السمة فئة المنتجات من Google للمستوى 3 لسلعة. | سمة | String |
نعم |
productCategoryLevel4 |
السمة فئة المنتجات من Google للمستوى 4 لسلعة. | سمة | String |
نعم |
productCategoryLevel5 |
السمة فئة المنتجات من Google للمستوى 5 لسلعة. | سمة | String |
نعم |
productBrand |
السمة brand (العلامة التجارية) لسلعة منتج. | سمة | String |
نعم |
productGtin |
السمة رقم GTIN (رقم السلعة التجاري العالمي) لسلعة معيّنة | سمة | String |
نعم |
productPrice |
السمة price (السعر) لسلعة معيّنة. | سمة | Money |
نعم |
productSalePrice |
السمة price (السعر) لسلعة معيّنة. | سمة | Money |
نعم |
productTypeLevel1 |
السمة leve 1 (نوع المنتج) لسلعة معيّنة. | سمة | String |
نعم |
productTypeLevel2 |
السمة نوع المنتج 2 ليف ضمن سلعة معيّنة. | سمة | String |
نعم |
productTypeLevel3 |
السمة نوع المنتج 3 ليف ضمن سلعة معيّنة. | سمة | String |
نعم |
productTypeLevel4 |
السمة نوع المنتج leve 4 لسلعة. | سمة | String |
نعم |
productTypeLevel5 |
السمة نوع المنتج 5 ليف ضمن سلعة معيّنة. | سمة | String |
نعم |
productCondition |
السمة condition (الحالة) لسلعة منتج. | سمة | String |
نعم |
productCustomLabel0 |
سمة التصنيف المخصّص 0 لسلعة معيّنة. | سمة | String |
نعم |
productCustomLabel1 |
سمة التصنيف المخصّص 1 لسلعة معيّنة. | سمة | String |
نعم |
productCustomLabel2 |
سمة التصنيف المخصّص 2 لعنصر منتج | سمة | String |
نعم |
productCustomLabel3 |
سمة التصنيف المخصّص 3 لسلعة معيّنة. | سمة | String |
نعم |
productCustomLabel4 |
سمة التصنيف المخصّص 4 لسلعة معيّنة. | سمة | String |
نعم |
productCostOfGoodsSold |
التكلفة الإجمالية لبيع منتج كما هو محدّد في خلاصة المستودع. | سمة | Money |
نعم |
productStoreId |
المتجر الذي تمّ الإعلان عن منتج فيه في إعلان للمنتجات داخل المتجر ويجب أن يتطابق هذا المعرّف مع معرّفات المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. | سمة | String |
نعم |
productChannel |
سمة قناة المبيعات لسلعة منتج: Online أو Local . |
سمة | Product channel |
نعم |
productChannelExclusivity |
السمة الحصرية للقناة في منتج معيّن. | سمة | Product channel exclusivity |
نعم |
productItemGroupId |
سمة معرّف مجموعة السلع لسلعة معيّنة. | سمة | String |
نعم |
productTitle |
سمة العنوان لسلعة منتج. | سمة | String |
نعم |
dfaActions |
إجمالي عدد إجراءات مدير الحملة. | المقياس | Integer |
نعم |
dfaRevenue |
الأرباح المجمّعة الناتجة عن معاملات "مدير الحملة". | المقياس | Money |
نعم |
dfaTransactions |
إجمالي عدد معاملات مدير الحملة. | المقياس | Integer |
نعم |
dfaWeightedActions |
المجموع المقدّر لإجراءات "مدير الحملة". | المقياس | Number |
نعم |
dfaActionsCrossEnv |
إجمالي عدد إجراءات مدير الحملة عبر البيئات. | المقياس | Number |
نعم |
dfaRevenueCrossEnv |
الأرباح المجمّعة الناتجة عن معاملات مدير الحملة عبر البيئات المختلفة. | المقياس | Money |
نعم |
dfaTransactionsCrossEnv |
إجمالي عدد معاملات مدير الحملة عبر البيئات. | المقياس | Number |
نعم |
dfaWeightedActionsCrossEnv |
إجمالي ترجيح إجراءات "مدير الحملة" عبر البيئات المختلفة | المقياس | Number |
نعم |
avgCpc |
متوسط تكلفة النقرة. | المقياس | Money |
نعم |
avgCpm |
متوسط التكلفة لكل ألف ظهور. | المقياس | Money |
نعم |
avgPos |
متوسط موضع الإعلان. | المقياس | Number |
نعم |
clicks |
إجمالي النقرات. | المقياس | Integer |
نعم |
cost |
التكلفة المجمّعة المدفوعة لحسابات الحسابات | المقياس | Money |
نعم |
ctr |
متوسط نسبة النقر إلى الظهور. | المقياس | Number |
نعم |
impr |
إجمالي عدد مرات الظهور. | المقياس | Integer |
نعم |
adWordsConversions |
البيانات التي أعدّها المعلِن لإعداد تقارير عنها في عمود "الإحالات الناجحة" في "إعلانات Google". عند إنشاء إحالة ناجحة في "إعلانات Google"، يمكن للمعلن اختيار ما إذا كان سيتم احتساب تلك الإحالات الناجحة في عمود إعداد تقارير الإحالات الناجحة. | المقياس | Number |
نعم |
adWordsConversionValue |
القيمة المجمّعة للإحالات الناجحة في "إعلانات Google". | المقياس | Number |
نعم |
adWordsViewThroughConversions |
إجمالي عدد تحويلات نشاط العرض في إعلانات Google. | المقياس | Integer |
نعم |
visits |
إجمالي عدد زيارات DS. | المقياس | Integer |
نعم |
date |
يعمل التقرير على تقسيم التقرير حسب الأيام، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف؛ صف لكل يوم. يعرض هذا العمود تاريخ كل صف. | قسم | Date |
نعم |
monthStart |
يعمل التقرير على تقسيم التقرير حسب الأشهر، ويتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل شهر. يعرض هذا العمود اليوم الأول من الشهر لكل صف. | قسم | Date |
نعم |
monthEnd |
يعمل التقرير على تقسيم التقرير حسب الأشهر، ويتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل شهر. يعرض هذا العمود آخر يوم في الشهر من كل صف. | قسم | Date |
نعم |
quarterStart |
يعمل التقرير على تقسيم التقرير بحسب الفصول؛ بل يتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل ربع سنة. يعرض هذا العمود اليوم الأول من ربع كل صف. | قسم | Date |
نعم |
quarterEnd |
يعمل التقرير على تقسيم التقرير بحسب الفصول؛ بل يتم تقسيم كل صف ومقاييسه المجمعة إلى عدة صفوف؛ صف لكل ربع سنة. يعرض هذا العمود اليوم الأخير من ربع كل صف. | قسم | Date |
نعم |
weekStart |
قسّم التقرير حسب الأسابيع (من الأحد إلى السبت)؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود اليوم الأول (الأحد) من كل صف. | قسم | Date |
نعم |
weekEnd |
قسّم التقرير حسب الأسابيع (من الأحد إلى السبت)؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود اليوم الأخير (السبت) من كل صف. | قسم | Date |
نعم |
yearStart |
يعمل التقرير على تقسيم التقرير حسب السنوات، ويتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف؛ صف لكل عام. يعرض هذا العمود اليوم الأول من السنة في كل صف. | قسم | Date |
نعم |
yearEnd |
يعمل التقرير على تقسيم التقرير حسب السنوات، ويتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف؛ صف لكل عام. يعرض هذا العمود آخر يوم في السنة من كل صف. | قسم | Date |
نعم |
deviceSegment |
يعمل التقرير على تقسيم التقرير حسب الجهاز، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى عدة صفوف، بحيث يصل إلى صف واحد لكل شريحة من الأجهزة. يعرض هذا العمود شريحة الجهاز لكل صف. | قسم | Device segment |
نعم |
floodlightGroup |
يعمل التقرير على تقسيم التقرير حسب مجموعات Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل مجموعة Floodlight. يعرض هذا العمود اسم مجموعة Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |
floodlightGroupId |
يعمل التقرير على تقسيم التقرير حسب مجموعات Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل مجموعة Floodlight. يعرض هذا العمود رقم تعريف مجموعة Floodlight في DS لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | ID |
نعم |
floodlightGroupTag |
يعمل التقرير على تقسيم التقرير حسب مجموعات Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل مجموعة Floodlight. يعرض هذا العمود علامة مجموعة Floodlight في كل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |
floodlightActivity |
يعمل التقرير على تقسيم التقرير حسب أنشطة Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل نشاط على Floodlight. يعرض هذا العمود اسم نشاط Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |
floodlightActivityId |
يعمل التقرير على تقسيم التقرير حسب أنشطة Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل نشاط على Floodlight. يعرض هذا العمود رقم تعريف نشاط DS Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | ID |
نعم |
floodlightActivityTag |
يعمل التقرير على تقسيم التقرير حسب أنشطة Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل نشاط على Floodlight. يعرض هذا العمود علامة نشاط Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |
accountId |
رقم تعريف حساب محرك DS. | قسم | ID |
نعم |
campaignId |
تعمل على تقسيم التقرير حسب الحملة. يعرض هذا الصف رقم تعريف حملة DS المرتبطة بالصف. | قسم | ID |
نعم |
adGroupId |
تعمل على تقسيم التقرير حسب المجموعة الإعلانية. يعرض هذا الصف رقم تعريف المجموعة الإعلانية المرتبط بالصف. | قسم | ID |
نعم |