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

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

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

طلب مقتطف

أرسِل نص طلب 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 نعم