بيانات إعداد التقارير للمعلنين، بما في ذلك:
- مقاييس الأداء عبر جميع حسابات محرك البحث للمعلن وحملاته.
- سمات التهيئة للمعلن.
طلب مقتطف
أرسِل نص طلب 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 فقط. المتوسط المُرجَّح لمرات الظهور في نقاط جودة المحرك (QS) في جميع الأيام والكلمات الرئيسية في نطاق التقرير. | المقياس | 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. يعرض هذا العمود رقم تعريف نشاط DS Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | ID |
نعم |
floodlightActivityTag |
يعمل التقرير على تقسيم التقرير حسب أنشطة Floodlight، حيث يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، بحيث يتم تخصيص صف واحد لكل نشاط على Floodlight. يعرض هذا العمود علامة نشاط Floodlight لكل صف. تجدر الإشارة إلى أن بعض المقاييس لا تحتوي على قيم مجزّأة في Floodlight، مثل النقرات والزيارات. | قسم | String |
نعم |