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

مقاييس الأداء وسمات الضبط للإعلانات.

لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر Reports.request()).

طلب مقتطف

إرسال رسالة عادية Reports.request() نص الطلب، ولكن يجب تحديد "reportType": "ad". 

{
...
  "reportType": "ad",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

لكلّ عمود تريد عرضه أو فلترته في التقرير حدِّد columnName المدرَجة في الجدول أدناه. يمكنك أيضًا تحديد headerText، startDate, وendDate. وتجدر الإشارة إلى أنّه لا يمكن فلترة بعض الأعمدة. راجِع القسم "قابل للفلترة" في الجدول أدناه.

columnNameالوصفالسلوكالنوعقابلة للفلترة
status حالة الإعلان: Active أو Paused أو Removed. يُرجى العلم بأنّ لكل حملة والمجموعات الإعلانية والكلمات الرئيسية والإعلانات حالتها الخاصة. راجِع الحالة. سمة Status نعم
engineStatus الحالة الإضافية للإعلان في حساب محرّك البحث الخارجي. تشمل الحالات المحتملة (استنادًا إلى نوع الحساب الخارجي) active وeligible وcreative deleted وcreative approved family safe وما إلى ذلك. سمة 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 نعم
campaign اسم الحملة. سمة String نعم
campaignId رقم تعريف الحملة في DS. سمة ID نعم
campaignStatus حالة الحملة التي تحتوي على هذا العنصر. سمة Status نعم
adGroup اسم المجموعة الإعلانية. سمة String نعم
adGroupId رقم تعريف المجموعة الإعلانية في DS. سمة ID نعم
adGroupStatus حالة المجموعة الإعلانية التي تحتوي على هذا العنصر. سمة Status نعم
ad اسم الإعلان. سمة String نعم
adId رقم تعريف الإعلان في DS. وتشير القيمة 0 إلى أنّ الإعلان لم يتمّ تحديد مصدره. سمة ID نعم
adEngineId رقم تعريف الإعلان في حساب محرّك البحث الخارجي. سمة ID نعم
isUnattributedAd يشير إلى ما إذا كانت المقاييس في هذا الصف لا يمكن نسبها إلى إعلان معيّن. على سبيل المثال، يمكن أن يمنع إعلان ذو شكل غير متوافق أو عنوان URL لخادم النقرات خطأ DS من إسناد المقاييس إلى أحد الإعلانات. سمة Boolean نعم
adHeadline عنوان الإعلان: سمة String نعم
adHeadline2 عنوان الإعلان 2، غير متوفّرة لبعض المحرّكات. سمة String نعم
adHeadline3 عنوان الإعلان 3؛ غير متوفّرة لبعض المحرّكات. سمة String نعم
adDescription1 سطر الوصف 1 للإعلان. سمة String نعم
adDescription2 سطر الوصف 2 للإعلان؛ غير متوفّرة لبعض المحرّكات. سمة String نعم
adDisplayUrl عنوان URL المعروض للإعلان. سمة String نعم
adLandingPage الصفحة المقصودة للإعلان. اطّلِع على عناوين URL الخاصة بالصفحات المقصودة وخادم النقرات. سمة String نعم
adType نوع الإعلان: Text أو Product أو Dynamic search أو Mobile app install أو Call-Only أو Expanded text أو Expanded dynamic search. سمة Ad type نعم
adPromotionLine سطر الترويج للإعلان. رسالة ترويجية قصيرة لإعلان منتج. سمة String نعم
adLabels أسماء التصنيفات المعيَّنة مباشرةً لهذا الإعلان لا يتم تضمين التصنيفات المكتسَبة. سمة String list نعم
adPathField1 حقل مسار الإعلان 1. يتم دمج حقلَي المسار 1 و2 مع adDisplayUrl لتكوين عنوان URL الذي يظهر على الإعلان. سمة String نعم
adPathField2 حقل مسار الإعلان 2. يتم دمج حقلَي المسار 1 و2 مع adDisplayUrl لتكوين عنوان URL الذي يظهر على الإعلان. سمة String نعم
effectiveLabels أسماء جميع التصنيفات المكتسَبة أو التي تم تخصيصها لهذا الإعلان مباشرةً سمة String list نعم
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 نعم
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 نعم