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

مقاييس الأداء وسمات الضبط لعناصر الخلاصة (مثل رابط أقسام الموقع أو الموقع الجغرافي أو المكالمة أو إضافات التطبيقات).

لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر Reports.request()).

طلب مقتطف

إرسال رسالة عادية Reports.request() نص الطلب، ولكن حدد "reportType": "feedItem".

{
...
  "reportType": "feedItem",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

لكلّ عمود تريد عرضه أو فلترته في التقرير حدِّد columnName المدرَجة في الجدول أدناه. يمكنك أيضًا تحديد headerText، startDate, وendDate. وتجدر الإشارة إلى أنّه لا يمكن فلترة بعض الأعمدة. راجِع القسم "قابل للفلترة" في الجدول أدناه.

columnNameالوصفالسلوكالنوعقابلة للفلترة
status حالة العنصر في الخلاصة: Active أو Paused أو Removed. سمة Status نعم
engineStatus حالة إضافية لعنصر الخلاصة في حساب محرّك البحث الخارجي. تشمل الحالات المحتملة (استنادًا إلى نوع الحساب الخارجي) review وactive وما إلى ذلك. سمة String نعم
creationTimestamp طابع زمني لإنشاء عنصر الخلاصة، بتنسيق ISO 8601 سمة Timestamp نعم
lastModifiedTimestamp طابع زمني لأحدث تعديل للعنصر في الخلاصة، بتنسيق ISO 8601 سمة Timestamp نعم
agency اسم الوكالة سمة String نعم
agencyId رقم تعريف وكالة DS. سمة ID نعم
advertiser اسم المعلِن سمة String نعم
advertiserId الرقم التعريفي للمعلِن في DS. سمة ID نعم
account اسم حساب محرّك البحث سمة String نعم
accountId رقم تعريف حساب محرك البحث في DS. سمة ID نعم
accountEngineId رقم تعريف الحساب في حساب محرّك البحث الخارجي. سمة String نعم
accountType نوع حساب محرّك البحث: Google AdWords أو Bing Ads أو Yahoo Japan Listing Ads أو Yahoo Search Marketing أو Yahoo Gemini أو Baidu أو Comparison Shopping سمة Engine type نعم
sitelinkDisplayText النص المعروض لرابط أقسام الموقع لعنصر الخلاصة. سمة String نعم
sitelinkDescription1 وصف رابط أقسام الموقع لعنصر الخلاصة 1. سمة String نعم
sitelinkDescription2 وصف رابط أقسام الموقع لعنصر الخلاصة 2. سمة String نعم
sitelinkLandingPageUrl هو عنوان URL للصفحة المقصودة لرابط أقسام الموقع لعنصر الخلاصة. سمة String نعم
sitelinkClickserverUrl اسم عنوان URL لخادم النقرات على رابط أقسام الموقع للعنصر في الخلاصة. سمة String نعم
locationBusinessName اسم النشاط التجاري المحدد في إضافة موقع تمت ترقيتها. سمة String نعم
locationCategory الفئة المحددة لنشاط تجاري في إضافة موقع تمت ترقيتها. سمة String نعم
locationDetails تفاصيل عن نشاط تجاري محدّد في إضافة موقع جغرافي تمت ترقيتها. سمة String نعم
callPhoneNumber رقم هاتف إضافة مكالمة. سمة String نعم
callCountryCode رمز البلد لإضافة مكالمة. سمة String نعم
callIsTracked تعرض القيمة "صحيح" في حال تتبُّع استدعاءات إضافة المكالمة، وتعرض "خطأ" في الحالات الأخرى. سمة Boolean نعم
callCallOnly تعرض القيمة "صحيح" إذا تم ضبط إضافة مكالمة لعرض رقم هاتف فقط. تعرض القيمة "خطأ" في حال ظهور كل من المكالمة والرابط. سمة Boolean نعم
callConversionTracker اسم متتبع الإحالات الناجحة المرتبط بإضافة المكالمة هذه، إن وجد. سمة String نعم
callConversionTrackerId رقم تعريف أداة تتبُّع الإحالات الناجحة المرتبطة بهذا العنصر في الخلاصة، إن توفّر. سمة ID نعم
appId رقم تعريف التطبيق المحدّد لإضافة تطبيق. سمة String نعم
appStore نوع متجر التطبيقات (Apple App Store أو متجر Google Play) المحدّد لإضافة التطبيق. سمة App store نعم
feedItemId رقم تعريف صف عنصر الخلاصة سمة ID نعم
feedId رقم تعريف جدول الخلاصة سمة ID نعم
clicksWithFeedItemShowing النقرات على أي رابط في الإعلان أثناء عرض عنصر الخلاصة. لا يعرض هذا العمود إلا قيمة في تقرير عنصر في الخلاصة أو في تقرير مقسّم حسب عمود لعنصر الخلاصة. المقياس Integer نعم
costWithFeedItemShowing تكلفة جميع الإعلانات عند عرض عنصر الخلاصة. لا يعرض هذا العمود إلا قيمة في تقرير عنصر في الخلاصة أو في تقرير مقسّم حسب عمود لعنصر الخلاصة. المقياس Money نعم
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 نعم
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 نعم