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

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

لا يمكن عرض هذا التقرير إلّا من خلال طلب غير متزامن (أي من خلال الأسلوب 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	رقم تعريف المعلِن في "مساحة العرض والفيديو 360"	سمة	ID	نعم
account	اسم حساب محرّك البحث	سمة	String	نعم
accountId	رقم تعريف حساب محرّك "إعلانات شبكة البحث"	سمة	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	رقم تعريف حملة "إعلانات شبكة البحث".	سمة	ID	نعم
campaignStatus	حالة الحملة التي تحتوي على هذا العنصر.	سمة	Status	نعم
adGroup	اسم المجموعة الإعلانية.	سمة	String	نعم
adGroupId	رقم تعريف المجموعة الإعلانية في "شبكة البحث"	سمة	ID	نعم
adGroupStatus	حالة المجموعة الإعلانية التي تحتوي على هذا العنصر.	سمة	Status	نعم
ad	اسم الإعلان	سمة	String	نعم
adId	رقم تعريف الإعلان في DS. تشير القيمة 0 إلى أنّ الإعلان غير مصدره.	سمة	ID	نعم
adEngineId	رقم تعريف الإعلان في حساب محرّك البحث الخارجي.	سمة	ID	نعم
isUnattributedAd	يشير إلى ما إذا كان لا يمكن تحديد مصدر المقاييس في هذا الصف إلى إعلان معيّن. على سبيل المثال، يمكن أن يمنع الإعلان الذي يتضمّن تنسيقًا غير متوافق أو عنوان URL غير صحيح لخدمة تتبُّع النقرات (CTS) من إسناد المقاييس إلى إعلان.	سمة	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. يعرض هذا العمود رقم تعريف مجموعة DS Floodlight لكل صف. تجدر الإشارة إلى أنّ بعض المقاييس لا تحتوي على قيم مقسّمة في 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	نعم