نوع التقرير: استراتيجية عروض الأسعار

مقاييس الأداء وسمات الضبط لاستراتيجيات عروض الأسعار

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

طلب مقتطف

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

{
...
  "reportType": "bidStrategy",
  "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	نعم
bidStrategyId	رقم تعريف استراتيجية عروض الأسعار في DS.	سمة	ID	نعم
bidStrategy	اسم استراتيجية عروض الأسعار.	سمة	String	نعم
bidStrategyGoal	الهدف من استراتيجية عروض الأسعار: Position أو Conversions أو Revenue أو Clicks أو Advanced targeting.	سمة	Bid strategy goal	نعم
floodlightOptimizationEnabled	ما إذا كانت استراتيجية عروض الأسعار تستهدِف أنشطة معيّنة في Floodlight	سمة	Boolean	نعم
ersTarget	نسبة حصّة الأرباح الفعلية (ERS) المستهدَفة لاستراتيجية عروض الأسعار	سمة	Number	نعم
cpaTarget	التكلفة المستهدفة للإجراء (تكلفة الإجراء) لاستراتيجية عروض الأسعار.	سمة	Money	نعم
roasTarget	نسبة عائد الإنفاق الإعلاني المستهدف (ROAS) لاستراتيجية عروض الأسعار.	سمة	Number	نعم
lowPosition	أدنى موضع مرغوب فيه (أكبر رقميًا) لعرض الإعلانات. على سبيل المثال، في نطاق المواضع من 2 إلى 5، يكون الرقم 5 هو lowPosition.	سمة	Number	نعم
highPosition	أعلى موضع مرغوب فيه (أصغر رقميًا) لعرض الإعلانات. على سبيل المثال، في نطاق المواضع من 2 إلى 5، يكون الرقم 2 هو highPosition.	سمة	Number	نعم
bidStrategyMinBid	أقل عرض سعر ممكن للكلمات الرئيسية في استراتيجية عروض الأسعار هذه.	سمة	Money	نعم
bidStrategyMaxBid	أعلى عرض سعر ممكن للكلمات الرئيسية في استراتيجية عروض الأسعار هذه.	سمة	Money	نعم
monthlySpendTarget	الإنفاق الهدف لكل شهر من استراتيجية عروض الأسعار هذه. وإذا لزم الأمر، سيزيد DS من عروض الأسعار لضمان إنفاق هذا المبلغ.	سمة	Money	نعم
floodlightActivityTargetIds	قائمة مفصولة بفواصل لأرقام تعريف نشاط Floodlight التي تستهدِفها استراتيجية عروض الأسعار هذه	سمة	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	نعم
date	لتقسيم التقرير حسب الأيام؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل يوم. يعرض هذا العمود تاريخ كل صف.	قسم	Date	نعم
monthStart	تقسيم التقرير حسب الأشهر؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل شهر. يعرض هذا العمود اليوم الأول من الشهر لكل صف.	قسم	Date	نعم
monthEnd	تقسيم التقرير حسب الأشهر؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل شهر. يعرض هذا العمود آخر يوم من الشهر لكل صف.	قسم	Date	نعم
quarterStart	لتقسيم التقرير إلى أرباع؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل ربع سنة. يعرض هذا العمود اليوم الأول من ربع كل صف.	قسم	Date	نعم
quarterEnd	لتقسيم التقرير إلى أرباع؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل ربع سنة. يعرض هذا العمود اليوم الأخير من ربع كل صف.	قسم	Date	نعم
weekStart	يقسّم التقرير حسب الأسابيع (من الأحد إلى السبت) يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود اليوم الأول (الأحد) من كل صف.	قسم	Date	نعم
weekEnd	يقسّم التقرير حسب الأسابيع (من الأحد إلى السبت) يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل أسبوع. يعرض هذا العمود آخر يوم (السبت) من كل صف.	قسم	Date	نعم
yearStart	يقسّم التقرير حسب السنوات؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل عام. يعرض هذا العمود اليوم الأول من السنة لكل صف.	قسم	Date	نعم
yearEnd	يقسّم التقرير حسب السنوات؛ يتم تقسيم كل صف ومقاييسه المجمّعة إلى صفوف متعددة، صف واحد لكل عام. يعرض هذا العمود آخر يوم من السنة لكل صف.	قسم	Date	نعم