مقاييس الأداء وسمات الضبط لعناصر الخلاصة (مثل رابط أقسام الموقع أو الموقع الجغرافي أو المكالمة أو إضافات التطبيقات).
لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر 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 |
نعم |