نوع گزارش: محصول تبلیغ شده

معیارهای عملکرد، ویژگی‌های پیکربندی، و ویژگی‌های موجودی برای محصولاتی که در فید موجودی تعریف شده و در کمپین خرید تبلیغ می‌شوند.

این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.

درخواست گزیده

یک بدنه درخواستی معمولی Reports.request() ارسال کنید، اما "reportType": "productAdvertised" .

{
...
  "reportType": "productAdvertised",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.

columnName توضیحات رفتار تایپ کنید قابل فیلتر کردن
status وضعیت محصول همانطور که در حساب موجودی نشان داده شده است: Active یا Removed . ویژگی Status بله
creationTimestamp مهر زمانی ایجاد محصول همانطور که در حساب موجودی مشخص شده است، با فرمت ISO 8601. ویژگی Timestamp بله
lastModifiedTimestamp آخرین مُهر زمان اصلاح محصول همانطور که در حساب موجودی نشان داده شده است، اصلاح، با فرمت ISO 8601. ویژگی Timestamp بله
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 بله
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 بله
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 بله