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

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

این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد 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	آره