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

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

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

طلب مقتطف

أرسِل محتوى طلب عاديًا 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	رقم تعريف المعلِن في "مساحة العرض والفيديو 360"	سمة	ID	نعم
dfaAdvertiserId	رقم تعريف المعلِن في "مدير الحملة" المرتبط بهذا المعلِن في "إعلانات شبكة البحث".	سمة	ID	نعم
dfaNetworkId	رقم تعريف شبكة "مدير الحملة" المرتبطة بهذا المعلِن على "إعلانات شبكة البحث".	سمة	ID	نعم
dfaNetworkTimeZone	المنطقة الزمنية لشبكة "مدير الحملة" المرتبطة بمعلِن "شبكة البحث" هذا بتنسيق قاعدة بيانات المناطق الزمنية IANA، مثل America/New_York.	سمة	String	نعم
advertiserCurrencyCode	رمز عملة المعلِن بتنسيق ISO 4217.	سمة	String	نعم
googleAnalyticsTimeZone	المنطقة الزمنية لملفّ الاطّلاع على "إحصاءات Google" المرتبط بهذا المعلِن على "شبكة البحث". تستخدِم تنسيق "قاعدة بيانات المناطق الزمنية (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 Ads فقط عدد مرّات الظهور التي تلقّيتها على "شبكة البحث" مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهّلاً للحصول عليها. يتم عرضها كعدد بين 0.1 و1 أو السلسلة < 10% إذا كانت النسبة أقل من 0.1.	المقياس	Impression share	نعم
searchBudgetLostImpressionShare	"إعلانات Google" و"إعلانات Bing" فقط النسبة المئوية للوقت الذي لم يتم عرض إعلاناتك فيه على "شبكة البحث" بسبب عدم كفاية الميزانية. يتم عرضها كرقم بين 0 و0.9 أو كسلسلة > 90% إذا كانت النسبة أكبر من 0.9.	المقياس	Impression share	نعم
searchRankLostImpressionShare	"إعلانات Google" و"إعلانات Bing" فقط النسبة المئوية للوقت الذي لم تظهر فيه إعلاناتك على "شبكة البحث" بسبب انخفاض ترتيب الإعلان. يتم عرضها كرقم بين 0 و0.9 أو كسلسلة > 90% إذا كانت النسبة أكبر من 0.9.	المقياس	Impression share	نعم
displayImpressionShare	"إعلانات Google" فقط يشير هذا المقياس إلى عدد مرّات الظهور التي سجَّلها إعلانك على "الشبكة الإعلانية" مقسومًا على العدد المقدَّر لمرّات الظهور التي كنت مؤهَّلاً للحصول عليها. يتم عرضها كعدد بين 0.1 و1 أو السلسلة < 10% إذا كانت النسبة أقل من 0.1.	المقياس	Impression share	نعم
displayBudgetLostImpressionShare	"إعلانات Google" فقط النسبة المئوية للوقت الذي لم تظهر فيه إعلاناتك على "الشبكة الإعلانية" بسبب عدم كفاية الميزانية. يتم عرضها كرقم بين 0 و0.9 أو كسلسلة > 90% إذا كانت النسبة أكبر من 0.9.	المقياس	Impression share	نعم
displayRankLostImpressionShare	"إعلانات Google" فقط النسبة المئوية للوقت الذي لم تظهر فيه إعلاناتك على "الشبكة الإعلانية" بسبب انخفاض ترتيب الإعلان. يتم عرضها كرقم بين 0 و0.9 أو كسلسلة > 90% إذا كانت النسبة أكبر من 0.9.	المقياس	Impression share	نعم
qualityScoreAvg	"إعلانات Google" وBing Ads فقط متوسّط مرجَّح لمرات الظهور لنقاط الجودة في المحرّك على مستوى جميع الأيام والكلمات الرئيسية في نطاق التقرير.	المقياس	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. يعرض هذا العمود رقم تعريف مجموعة 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	نعم