نوع التقرير: productAds

مقاييس الأداء وسمات الضبط وسمات المستودع للمنتجات المحدّدة في خلاصة المستودع والتي يتم الإعلان عنها في حملة تسوّق.

لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة 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	نعم