نوع التقرير: منتج تم الإعلان عنه

مقاييس الأداء وسمات الإعدادات وسمات المستودع للمنتجات التي تم تحديدها في خلاصة المستودع والإعلان عنها في حملة Shopping

لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر 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 تمثّل هذه السمة سمة MPN (MPN) لسلعة معيّنة. سمة 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 لإحدى السلع سمة String نعم
productCategoryLevel1 سمة المستوى 1 من فئة المنتجات من Google لإحدى السلع: سمة String نعم
productCategoryLevel2 سمة المستوى 2 من فئة المنتجات من Google لإحدى السلع: سمة String نعم
productCategoryLevel3 سمة المستوى 3 من فئة المنتجات من Google لإحدى السلع: سمة String نعم
productCategoryLevel4 سمة المستوى 4 من فئة المنتجات من Google لإحدى السلع: سمة String نعم
productCategoryLevel5 سمة المستوى 5 من فئة المنتجات من Google لإحدى السلع: سمة String نعم
productBrand سمة brand (العلامة التجارية) لسلعة معيّنة في المنتج. سمة String نعم
productGtin سمة GTIN (الرقم التجاري العالمي للسلعة) لسلعة معيّنة. سمة String نعم
productPrice سمة price لسلعة معيّنة في المنتج. سمة Money نعم
productSalePrice سمة price لسلعة معيّنة في المنتج. سمة Money نعم
productTypeLevel1 تمثّل هذه السمة سمة نوع المنتج 1 لسلعة معيّنة. سمة String نعم
productTypeLevel2 تمثّل هذه السمة سمة نوع المنتج 2 لسلعة معيّنة. سمة String نعم
productTypeLevel3 تمثّل هذه السمة سمة نوع المنتج 3 لسلعة معيّنة. سمة String نعم
productTypeLevel4 تمثّل هذه السمة سمة نوع المنتج 4 لسلعة معيّنة. سمة String نعم
productTypeLevel5 تمثّل هذه السمة سمة نوع المنتج 5 لسلعة معيّنة. سمة String نعم
productCondition سمة الحالة لسلعة منتج سمة 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. يعرض هذا العمود رقم تعريف نشاط Floodlight في DS لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات. قسم ID نعم
floodlightActivityTag تقسيم التقرير حسب أنشطة Floodlight يتمّ تقسيم كلّ صف ومقاييسه المجمَّعة إلى صفوف متعدّدة، على أن يكون صفّ واحد لكلّ نشاط Floodlight. يعرض هذا العمود علامة نشاط Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في Floodlight، مثل النقرات والزيارات. قسم String نعم
accountId رقم تعريف حساب محرك البحث في DS. قسم ID نعم
campaignId يعمل هذا الخيار على تقسيم التقرير حسب الحملة. يعرض هذا الصف رقم تعريف حملة DS المرتبط بالصف. قسم ID نعم
adGroupId يقسّم التقرير حسب المجموعة الإعلانية. يعرض هذا الصف رقم تعريف المجموعة الإعلانية المرتبط بالصف. قسم ID نعم