نوع التقرير: معلِن

إعداد تقارير البيانات للمعلِنين، بما في ذلك:

  • مقاييس الأداء على مستوى جميع حسابات محرك البحث للمعلِن وحملاته
  • سمات الإعداد للمعلِن.

طلب مقتطف

إرسال رسالة عادية 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 نعم