معیارهای عملکرد و ویژگیهای پیکربندی برای استراتژیهای پیشنهاد.
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد 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 | CPA هدف (هزینه هر اقدام) استراتژی پیشنهاد. | صفت | 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 Ads Conversions گزارش شوند. وقتی یک کنش تبدیل Google Ads ایجاد میشود، تبلیغکننده میتواند انتخاب کند که آیا این تبدیلها را در ستون گزارش تبدیل شمارش کند یا خیر . | متریک | Number | آره |
adWordsConversionValue | ارزش کل تبدیلهای Google Ads. | متریک | Number | آره |
adWordsViewThroughConversions | تعداد کل تبدیلهای تبلیغاتی Google Ads از طریق بازدید. | متریک | Integer | آره |
visits | تعداد کل بازدیدهای DS. | متریک | Integer | آره |
date | گزارش را بر اساس روز تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر روز. این ستون تاریخ هر سطر را برمی گرداند. | بخش | Date | آره |
monthStart | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون اولین روز ماه هر ردیف را برمی گرداند. | بخش | Date | آره |
monthEnd | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون آخرین روز ماه هر ردیف را برمی گرداند. | بخش | Date | آره |
quarterStart | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون اولین روز از یک چهارم هر ردیف را برمی گرداند. | بخش | Date | آره |
quarterEnd | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون آخرین روز از یک چهارم هر سطر را برمی گرداند. | بخش | Date | آره |
weekStart | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون اولین روز (یکشنبه) هر ردیف را برمی گرداند. | بخش | Date | آره |
weekEnd | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون آخرین روز (شنبه) هر ردیف را برمی گرداند. | بخش | Date | آره |
yearStart | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون اولین روز سال هر سطر را برمی گرداند. | بخش | Date | آره |
yearEnd | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون آخرین روز سال هر سطر را برمی گرداند. | بخش | Date | آره |