معیارهای عملکرد، ویژگیهای پیکربندی، و ویژگیهای موجودی برای محصولاتی که در فید موجودی تعریف شدهاند و در نتیجه تبلیغات جستجوی پولی فروخته میشوند.
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
از آنجایی که رویدادها در تاریخهای خاصی رخ میدهند، درخواست این گزارش باید محدوده زمانی را مشخص کند. می توانید یکی از موارد زیر را مشخص کنید:
- startDate و endDate .
- changeMetricsSinceTimestamp ( chantedAttributesSinceTimestamp برای رویدادها معتبر نیست).
درخواست گزیده
یک بدنه درخواست عادی Reports.request() ارسال کنید، اما "reportType": "productLeadAndCrossSell" .
{
...
"reportType": "productLeadAndCrossSell",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
} برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.
columnName | توضیحات | رفتار | تایپ کنید | قابل فیلتر کردن |
|---|---|---|---|---|
agency | نام آژانس | ویژگی | String | بله |
agencyId | شناسه نمایندگی DS. | ویژگی | ID | بله |
advertiser | نام تبلیغ کننده | ویژگی | String | بله |
advertiserId | شناسه تبلیغ کننده DS. | ویژگی | ID | بله |
productId | شناسه کالای مورد نظر. | ویژگی | String | بله |
productCountry | کشوری که برای فید موجودی محصول ثبت شده است . | ویژگی | String | بله |
productLanguage | زبان ثبت شده برای فید موجودی محصول. | ویژگی | String | بله |
productMpn | ویژگی MPN (شماره قطعه سازنده) یک مورد محصول. | ویژگی | String | بله |
productColor | ویژگی رنگ یک آیتم محصول. | ویژگی | String | بله |
productSize | ویژگی اندازه یک مورد محصول. | ویژگی | String | بله |
productMaterial | ویژگی مادی یک آیتم محصول. | ویژگی | String | بله |
productPattern | ویژگی الگوی یک آیتم محصول. | ویژگی | String | بله |
productAvailability | ویژگی در دسترس بودن یک مورد محصول. | ویژگی | Product availability | بله |
productGender | ویژگی جنسیتی یک محصول. | ویژگی | String | بله |
productAgeGroup | ویژگی گروه سنی یک محصول. | ویژگی | String | بله |
productLandingPageUrl | ویژگی صفحه فرود یک مورد محصول. | ویژگی | String | بله |
productCategory | ویژگی دسته بندی محصولات گوگل از یک مورد محصول. | ویژگی | String | بله |
productCategoryLevel1 | ویژگی طبقه بندی محصولات گوگل سطح 1 یک مورد محصول. | ویژگی | String | بله |
productCategoryLevel2 | ویژگی طبقه بندی محصولات گوگل سطح 2 یک مورد محصول. | ویژگی | String | بله |
productCategoryLevel3 | ویژگی طبقه بندی محصولات گوگل سطح 3 یک مورد محصول. | ویژگی | String | بله |
productCategoryLevel4 | ویژگی طبقه بندی محصولات گوگل در سطح 4 یک مورد محصول. | ویژگی | String | بله |
productCategoryLevel5 | ویژگی طبقه بندی محصولات گوگل در سطح 5 یک مورد محصول. | ویژگی | String | بله |
productBrand | ویژگی برند یک کالای محصول. | ویژگی | String | بله |
productGtin | ویژگی GTIN (شماره کالای تجاری جهانی) یک کالا. | ویژگی | String | بله |
productPrice | ویژگی قیمت یک کالا. | ویژگی | Money | بله |
productSalePrice | ویژگی قیمت یک کالا. | ویژگی | Money | بله |
productTypeLevel1 | ویژگی سطح 1 نوع محصول از یک کالا. | ویژگی | String | بله |
productTypeLevel2 | ویژگی سطح 2 نوع محصول یک مورد محصول. | ویژگی | String | بله |
productTypeLevel3 | ویژگی سطح 3 نوع محصول از یک آیتم محصول. | ویژگی | String | بله |
productTypeLevel4 | ویژگی سطح 4 نوع محصول از یک آیتم محصول. | ویژگی | String | بله |
productTypeLevel5 | ویژگی سطح 5 نوع محصول از یک آیتم محصول. | ویژگی | String | بله |
productCondition | ویژگی شرط یک مورد محصول. | ویژگی | String | بله |
productCustomLabel0 | ویژگی برچسب سفارشی 0 یک مورد محصول. | ویژگی | String | بله |
productCustomLabel1 | ویژگی برچسب سفارشی 1 یک مورد محصول. | ویژگی | String | بله |
productCustomLabel2 | ویژگی برچسب سفارشی 2 یک مورد محصول. | ویژگی | String | بله |
productCustomLabel3 | ویژگی برچسب سفارشی 3 یک مورد محصول. | ویژگی | String | بله |
productCustomLabel4 | ویژگی برچسب سفارشی 4 یک مورد محصول. | ویژگی | String | بله |
productCostOfGoodsSold | کل هزینه فروش یک محصول همانطور که در خوراک موجودی مشخص شده است . | ویژگی | Money | بله |
productStoreId | فروشگاهی که محصولی برای آن در آگهی موجودی محلی تبلیغ شده است. این باید با شناسههای فروشگاه استفاده شده در فید محصولات محلی شما مطابقت داشته باشد. | ویژگی | String | بله |
productChannel | ویژگی کانال فروش یک مورد محصول: Online یا Local . | ویژگی | Product channel | بله |
productChannelExclusivity | ویژگی انحصاری کانال یک مورد محصول. | ویژگی | Product channel exclusivity | بله |
productItemGroupId | ویژگی شناسه گروه آیتم یک مورد محصول. | ویژگی | String | بله |
productTitle | ویژگی عنوان یک مورد محصول. | ویژگی | String | بله |
dfaActions | تعداد کل اقدامات مدیر کمپین. | متریک | Integer | بله |
dfaRevenue | مجموع درآمد حاصل از معاملات مدیر کمپین. | متریک | Money | بله |
dfaTransactions | تعداد کل تراکنش های مدیریت کمپین. | متریک | Integer | بله |
dfaWeightedActions | مجموع وزنی اقدامات مدیر کمپین. | متریک | Number | بله |
dfaActionsCrossEnv | تعداد کل اقدامات مدیر کمپین بین محیطی. | متریک | Number | بله |
dfaRevenueCrossEnv | مجموع درآمد حاصل از معاملات بین محیطی مدیر کمپین. | متریک | Money | بله |
dfaTransactionsCrossEnv | تعداد کل تراکنش های بین محیطی مدیر کمپین. | متریک | Number | بله |
dfaWeightedActionsCrossEnv | مجموع وزنی اقدامات بین محیطی مدیر کمپین. | متریک | Number | بله |
crossSellAverageUnitPrice | میانگین قیمت گزارش شده برای فروش یک محصول زمانی که در نتیجه تبلیغات یک محصول دیگر فروخته می شود | متریک | Money | بله |
crossSellCostOfGoodsSold | کل هزینه فروش یک محصول زمانی که در نتیجه تبلیغات یک محصول دیگر فروخته می شود. | متریک | Money | بله |
crossSellGrossFromUnitsSold | کل درآمد حاصل از فروش یک محصول در نتیجه تبلیغات یک محصول متفاوت. | متریک | Money | بله |
crossSellGrossProfitMargin | حاشیه سود ناخالص برای یک محصول خاص هنگامی که در نتیجه تبلیغات یک محصول متفاوت فروخته می شود. | متریک | Number | بله |
crossSellRevenueFromUnitsSold | کل درآمد حاصل از فروش متقابل (درآمد حاصل از تبلیغات یک محصول متفاوت). | متریک | Money | بله |
crossSellUnitsSold | تعداد واحدهای فروخته شده در نتیجه فروش متقابل. (تعداد واحدهای فروخته شده در نتیجه تبلیغات یک محصول متفاوت.) | متریک | Number | بله |
leadAverageUnitPrice | میانگین قیمت گزارش شده برای فروش یک محصول هنگام فروش محصول در نتیجه تبلیغات آن محصول. | متریک | Money | بله |
leadCostOfGoodsSold | کل هزینه فروش یک محصول در هنگام فروش در نتیجه تبلیغات آن محصول. | متریک | Money | بله |
leadGrossProfitFromUnitsSold | کل درآمد حاصل از فروش یک محصول در نتیجه تبلیغات آن محصول. | متریک | Money | بله |
leadGrossProfitMargin | حاشیه سود ناخالص برای یک محصول خاص در نتیجه مستقیم تبلیغات محصول. | متریک | Number | بله |
leadRevenueFromUnitsSold | کل درآمد حاصل از یک محصول در نتیجه تبلیغات آن محصول. | متریک | Money | بله |
leadUnitsSold | تعداد واحدهای فروخته شده در نتیجه تبلیغات محصول. | متریک | Number | بله |
productUnitsSold | تعداد کل واحدهای فروخته شده برای یک محصول خاص. | متریک | Number | بله |
productRevenueFromUnitsSold | کل درآمد حاصل از یک محصول (با استفاده از قیمت گزارش شده برای هر محصول). | متریک | Money | بله |
productAverageUnitPrice | میانگین قیمت گزارش شده برای فروش یک محصول (با استفاده از قیمت گزارش شده برای هر محصول). | متریک | Money | بله |
date | گزارش را بر اساس روز تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر روز. این ستون تاریخ هر سطر را برمی گرداند. | بخش | Date | بله |
monthStart | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون اولین روز ماه هر ردیف را برمی گرداند. | بخش | Date | بله |
monthEnd | گزارش را بر اساس ماه تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر ماه. این ستون آخرین روز ماه هر ردیف را برمی گرداند. | بخش | Date | بله |
quarterStart | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون اولین روز از یک چهارم هر ردیف را برمی گرداند. | بخش | Date | بله |
quarterEnd | گزارش را بر اساس سه ماهه تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یک ردیف برای هر چهارم. این ستون آخرین روز از یک چهارم هر سطر را برمی گرداند. | بخش | Date | بله |
weekStart | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون اولین روز (یکشنبه) هر ردیف را برمی گرداند. | بخش | Date | بله |
weekEnd | گزارش را بر اساس هفته ها (یکشنبه تا شنبه) تقسیم می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، یکی برای هر هفته. این ستون آخرین روز (شنبه) هر ردیف را برمی گرداند. | بخش | Date | بله |
yearStart | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون اولین روز سال هر سطر را برمی گرداند. | بخش | Date | بله |
yearEnd | گزارش را بر اساس سالها تقسیم می کند. هر ردیف و معیارهای کلی آن به چند ردیف تقسیم میشوند، یکی برای هر سال. این ستون آخرین روز سال هر سطر را برمی گرداند. | بخش | Date | بله |
deviceSegment | گزارش را بر اساس دستگاه تقسیم بندی می کند. هر ردیف و معیارهای مجموع آن به چند ردیف تقسیم میشوند، تا یک ردیف برای هر بخش دستگاه. این ستون قطعه دستگاه هر ردیف را برمی گرداند. | بخش | Device segment | بله |
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 | بله |
accountId | شناسه حساب موتور DS. | بخش | ID | بله |
campaignId | گزارش را بر اساس کمپین تقسیم بندی می کند. این ردیف شناسه کمپین DS مرتبط با ردیف را برمی گرداند. | بخش | ID | بله |
adGroupId | گزارش را بر اساس گروه تبلیغاتی تقسیم بندی می کند. این ردیف شناسه گروه تبلیغات مرتبط با ردیف را برمی گرداند. | بخش | ID | بله |