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

مقاييس الأداء وسمات التهيئة لإستراتيجيات عروض الأسعار.

لا يمكن عرض هذا التقرير إلا من خلال طلب غير متزامن (أي من خلال طريقة 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	نسبة عائد الإنفاق الإعلاني المستهدف لاستراتيجية عروض الأسعار.	سمة	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	نعم