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