إعداد تقارير البيانات للمعلِنين، بما في ذلك:
- مقاييس الأداء على مستوى جميع حسابات محرك البحث للمعلِن وحملاته
- سمات الإعداد للمعلِن.
طلب مقتطف
إرسال رسالة عادية
Reports.request() أو
Reports.generate()
نص الطلب، ولكن حدد "reportType": "advertiser"
.
{ ... "reportType": "advertiser", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
لكلّ عمود تريد عرضه أو فلترته في التقرير
حدِّد columnName
المدرَجة في الجدول أدناه.
يمكنك أيضًا تحديد
headerText،
startDate,
وendDate.
وتجدر الإشارة إلى أنّه لا يمكن فلترة بعض الأعمدة. راجِع القسم "قابل للفلترة" في الجدول أدناه.
columnName | الوصف | السلوك | النوع | قابلة للفلترة |
---|---|---|---|---|
status |
حالة المعلِن: Active أو Paused أو Removed . |
سمة | Status |
نعم |
creationTimestamp |
طابع زمني لإنشاء المعلِن، بتنسيق ISO 8601 | سمة | Timestamp |
نعم |
lastModifiedTimestamp |
طابع زمني لأحدث تعديل أجراه المعلن، بتنسيق ISO 8601 | سمة | Timestamp |
نعم |
agency |
اسم الوكالة | سمة | String |
نعم |
agencyId |
رقم تعريف وكالة DS. | سمة | ID |
نعم |
advertiser |
اسم المعلِن | سمة | String |
نعم |
advertiserId |
الرقم التعريفي للمعلِن في DS. | سمة | ID |
نعم |
dfaAdvertiserId |
رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا المعلِن في DS. | سمة | ID |
نعم |
dfaNetworkId |
رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا المعلِن في DS. | سمة | ID |
نعم |
dfaNetworkTimeZone |
المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بمعلِن DS هذا بتنسيق قاعدة بيانات المنطقة الزمنية الصادر عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثل America/New_York . |
سمة | String |
نعم |
advertiserCurrencyCode |
رمز عملة المعلِن بتنسيق ISO 4217. | سمة | String |
نعم |
googleAnalyticsTimeZone |
المنطقة الزمنية لملف "إحصاءات Google" الشخصي المرتبط بالمعلن في DS. تستخدم تنسيق قاعدة بيانات المنطقة الزمنية الصادر عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثل America/New_York . |
سمة | 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 |
نعم |
searchImpressionShare |
"إعلانات Google" و"إعلانات Bing" فقط. عدد مرات الظهور التي تلقاها إعلانك في شبكة البحث مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. يتم عرضها كرقم بين 0.1 و1 أو إذا كانت المشاركة أقل من 0.1، تكون السلسلة < 10% . |
المقياس | Impression share |
نعم |
searchBudgetLostImpressionShare |
"إعلانات Google" و"إعلانات Bing" فقط. هي النسبة المئوية للمدة التي لم تظهر فيها إعلاناتك على شبكة البحث؛ نظرًا لعدم كفاية الميزانية. يتم عرضها كرقم بين 0 و0.9 أو إذا كانت المشاركة أكبر من 0.9، كسلسلة > 90% . |
المقياس | Impression share |
نعم |
searchRankLostImpressionShare |
"إعلانات Google" و"إعلانات Bing" فقط. النسبة المئوية للمرات التي لم تُعرض فيها إعلاناتك على شبكة البحث بسبب انخفاض ترتيب الإعلان. يتم عرضها كرقم بين 0 و0.9 أو إذا كانت المشاركة أكبر من 0.9، كسلسلة > 90% . |
المقياس | Impression share |
نعم |
displayImpressionShare |
"إعلانات Google" فقط. عدد مرات الظهور التي تلقاها إعلانك على الشبكة الإعلانية مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها. يتم عرضها كرقم بين 0.1 و1 أو إذا كانت المشاركة أقل من 0.1، تكون السلسلة < 10% . |
المقياس | Impression share |
نعم |
displayBudgetLostImpressionShare |
"إعلانات Google" فقط. النسبة المئوية للوقت الذي لم تظهر فيه إعلاناتك على "الشبكة الإعلانية" بسبب عدم كفاية الميزانية. يتم عرضها كرقم بين 0 و0.9 أو إذا كانت المشاركة أكبر من 0.9، كسلسلة > 90% . |
المقياس | Impression share |
نعم |
displayRankLostImpressionShare |
"إعلانات Google" فقط. النسبة المئوية للمرات التي لم تُعرض فيها إعلاناتك على الشبكة الإعلانية بسبب انخفاض ترتيب الإعلان. يتم عرضها كرقم بين 0 و0.9 أو إذا كانت المشاركة أكبر من 0.9، كسلسلة > 90% . |
المقياس | Impression share |
نعم |
qualityScoreAvg |
"إعلانات Google" و"إعلانات Bing" فقط. متوسّط نقاط الجودة حسب عدد مرّات الظهور لمحرّك البحث على مدار جميع الأيام والكلمات الرئيسية في نطاق التقرير. | المقياس | Number |
نعم |
topOfPageBidAvg |
"إعلانات Google" فقط. يقدّم تقريباً لمتوسط عرض سعر النقرة المطلوب خلال النطاق الزمني للتقرير لكي تظهر إعلاناتك بانتظام في المواضع العليا أعلى نتائج البحث. | المقياس | Money |
نعم |
absoluteTopImpressionPercentage |
النسبة المئوية لمرات ظهور إعلانك التي تظهر كأول إعلان أعلى نتائج البحث المجاني. | المقياس | Impression share |
نعم |
searchAbsoluteTopImpressionShare |
مرات الظهور التي تلقّيتها في صدارة الصفحة (الإعلان الأول أعلى نتائج البحث المجاني) مقسومًا على العدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها في موقع أعلى الصفحة. | المقياس | Impression share |
نعم |
topImpressionPercentage |
النسبة المئوية لمرات ظهور الإعلان التي تظهر في أي مكان أعلى نتائج البحث المجاني. | المقياس | Impression share |
نعم |
searchTopImpressionShare |
مرات الظهور التي تلقّيتها في أعلى الصفحة (في أي مكان أعلى نتائج البحث المجاني) مقارنةً بالعدد المقدَّر لمرات الظهور التي كنت مؤهَّلاً للحصول عليها في موقع أعلى الصفحة. | المقياس | Impression share |
نعم |
searchBudgetLostAbsoluteTopImpressionShare |
يقدِّر عدد المرات التي لم يظهر فيها إعلانك كأول إعلان أعلى نتائج البحث المجاني بسبب انخفاض الميزانية. | المقياس | Impression share |
نعم |
searchBudgetLostTopImpressionShare |
تساعدك في معرفة عدد المرات التي لم يظهر فيها إعلانك في أي مكان أعلى نتائج البحث المجاني بسبب انخفاض الميزانية. | المقياس | Impression share |
نعم |
searchRankLostAbsoluteTopImpressionShare |
يقدِّر عدد المرات التي لم يظهر فيها إعلانك كأول إعلان أعلى نتائج البحث المجاني بسبب انخفاض ترتيب الإعلان. | المقياس | Impression share |
نعم |
searchRankLostTopImpressionShare |
يقدِّر عدد المرات التي لم يظهر فيها إعلانك في أي مكان أعلى نتائج البحث المجاني بسبب انخفاض ترتيب الإعلان. | المقياس | Impression share |
نعم |
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 |
نعم |