معیارهای عملکرد و ویژگیهای پیکربندی برای موارد فید (مثلاً پیوند سایت، مکان، تماس یا برنامههای افزودنی).
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
درخواست گزیده
یک بدنه درخواست عادی Reports.request() ارسال کنید، اما "reportType": "feedItem"
.
{ ... "reportType": "feedItem", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName
فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.
columnName | توضیحات | رفتار | تایپ کنید | قابل فیلتر کردن |
---|---|---|---|---|
status | وضعیت مورد فید: Active ، Paused ، یا Removed . | ویژگی | Status | بله |
engineStatus | وضعیت اضافی مورد خوراک در حساب موتور خارجی. وضعیتهای احتمالی (بسته به نوع حساب خارجی) شامل review ، active و غیره است. | ویژگی | String | بله |
creationTimestamp | مهر زمانی ایجاد آیتم فید، فرمت شده در ISO 8601. | ویژگی | Timestamp | بله |
lastModifiedTimestamp | مُهر زمان آخرین اصلاحات مورد فید، قالببندی شده در ISO 8601. | ویژگی | Timestamp | بله |
agency | نام آژانس | ویژگی | String | بله |
agencyId | شناسه نمایندگی DS. | ویژگی | ID | بله |
advertiser | نام تبلیغ کننده | ویژگی | String | بله |
advertiserId | شناسه تبلیغ کننده DS. | ویژگی | ID | بله |
account | نام حساب موتور | ویژگی | String | بله |
accountId | شناسه حساب موتور DS. | ویژگی | ID | بله |
accountEngineId | شناسه حساب در حساب موتور خارجی. | ویژگی | String | بله |
accountType | نوع حساب موتور: Google AdWords ، Bing Ads ، Yahoo Japan Listing Ads ، Yahoo Search Marketing ، Yahoo Gemini ، Baidu ، یا Comparison Shopping . | ویژگی | Engine type | بله |
sitelinkDisplayText | متن نمایش لینک سایت مورد فید. | ویژگی | String | بله |
sitelinkDescription1 | شرح پیوند سایت مورد فید 1. | ویژگی | String | بله |
sitelinkDescription2 | شرح پیوند سایت مورد فید 2. | ویژگی | String | بله |
sitelinkLandingPageUrl | URL صفحه فرود پیوند سایت مورد فید. | ویژگی | String | بله |
sitelinkClickserverUrl | نام URL سرور کلیک لینک سایت مورد خوراک. | ویژگی | String | بله |
locationBusinessName | نام کسب و کاری که در افزونه مکان ارتقا یافته تعریف شده است. | ویژگی | String | بله |
locationCategory | دسته ای که برای یک کسب و کار در یک پسوند مکان ارتقا یافته تعریف شده است. | ویژگی | String | بله |
locationDetails | جزئیات مربوط به یک کسب و کار که در یک برنامه افزودنی موقعیت مکانی ارتقا یافته تعریف شده است. | ویژگی | String | بله |
callPhoneNumber | شماره تلفن داخلی یک تماس. | ویژگی | String | بله |
callCountryCode | کد کشور داخلی یک تماس. | ویژگی | String | بله |
callIsTracked | اگر تماسهای یک برنامه افزودنی تماس ردیابی شود، درست است، در غیر این صورت نادرست است. | ویژگی | Boolean | بله |
callCallOnly | اگر برنامه افزودنی تماس طوری تنظیم شده باشد که فقط یک شماره تلفن را نشان دهد، درست است. اگر هم تماس و هم پیوندی نشان داده شود، false را برمیگرداند. | ویژگی | Boolean | بله |
callConversionTracker | نام ردیاب تبدیل مرتبط با این برنامه افزودنی تماس، در صورت وجود. | ویژگی | String | بله |
callConversionTrackerId | شناسه ردیاب تبدیل مرتبط با این مورد فید، در صورت وجود. | ویژگی | ID | بله |
appId | شناسه برنامه تعریف شده برای یک برنامه افزودنی. | ویژگی | String | بله |
appStore | نوع فروشگاه برنامه (Apple App Store، Google Play Store) که برای یک برنامه افزودنی تعریف شده است. | ویژگی | App store | بله |
feedItemId | شناسه ردیف مورد فید. | ویژگی | ID | بله |
feedId | شناسه جدول خوراک | ویژگی | ID | بله |
clicksWithFeedItemShowing | در حالی که مورد فید نمایش داده می شود، روی هر پیوند در آگهی کلیک می کند. این ستون فقط یک مقدار را در گزارش مورد فید یا در گزارشی که توسط ستون مورد خوراک تقسیم شده است، برمیگرداند. | متریک | Integer | بله |
costWithFeedItemShowing | هزینه همه تبلیغات در زمان نمایش آیتم فید. این ستون فقط یک مقدار را در گزارش مورد فید یا در گزارشی که توسط ستون مورد خوراک تقسیم شده است، برمیگرداند. | متریک | Money | بله |
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 | بله |
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 | بله |