مقاييس الأداء وسمات الضبط لعناصر الخلاصة (مثل روابط أقسام الموقع أو الموقع الجغرافي أو إضافات المكالمات أو التطبيقات).
لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة 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 |
لعرض true إذا تم تتبع مكالمات إضافة مكالمة، أو تم تعيينها على "false". | سمة | Boolean |
نعم |
callCallOnly |
لعرض "صحيح" في حال ضبط إضافة مكالمة لعرض رقم هاتف فقط. لعرض false إذا تم عرض كل من المكالمة والرابط. | سمة | 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. يعرض هذا العمود رقم تعريف نشاط DS Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | ID |
نعم |
floodlightActivityTag |
يعمل التقرير على تقسيم التقرير حسب أنشطة Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل نشاط على Floodlight. يعرض هذا العمود علامة نشاط Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |