نوع گزارش: productTarget

معیارهای عملکرد و ویژگی های پیکربندی برای اهداف محصول. هدف‌های محصول توسط کمپین‌های Google Ads PLA برای تعیین اینکه کدام محصولات در حساب Google Merchant Center باید آگهی‌های فهرست محصول (تبلیغات خرید) را فعال کنند تا در جستجوهای مرتبط در Google ظاهر شوند، استفاده می‌شوند. هدف های محصول و کمپین های PLA با کمپین های خرید تبلیغات گوگل جایگزین شده اند. از DS، همچنان می‌توانید گزارش‌هایی را برای معیارهای تاریخی درخواست کنید که قبل از ارتقا به کمپین‌های خرید به کمپین‌های PLA شما نسبت داده شده‌اند.

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

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

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

{
...
  "reportType": "productTarget",
  "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 ، campaign paused و غیره است.	صفت	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	آره
campaign	نام کمپین.	صفت	String	آره
campaignId	شناسه کمپین DS.	صفت	ID	آره
campaignStatus	وضعیت کمپین حاوی این مورد.	صفت	Status	آره
adGroup	نام گروه تبلیغاتی	صفت	String	آره
adGroupId	شناسه گروه تبلیغات DS.	صفت	ID	آره
adGroupStatus	وضعیت گروه تبلیغاتی حاوی این مورد.	صفت	Status	آره
productTargetId	شناسه هدف محصول DS.	صفت	ID	آره
productTargetFilter	محصولات موجود در حساب Google Merchant Center را با این هدف محصول فیلتر می کند. می توانید معیارهای تطبیق را با استفاده از ویژگی هایی مانند شناسه محصول، نام تجاری و غیره مشخص کنید.	صفت	String	خیر
productTargetEngineId	شناسه هدف محصول در حساب موتور خارجی.	صفت	ID	آره
productTargetLandingPage	مقداری که نشان دهنده URL نهایی است که کاربر پس از کلیک بر روی تبلیغ خرید شما از آن بازدید می کند. به صفحات فرود تبلیغات خرید مراجعه کنید.	صفت	String	آره
productTargetClickserverUrl	URL که DS برای ردیابی فعالیت استفاده می کند. کاربری که روی یک تبلیغ خرید کلیک می کند ابتدا از URL سرور کلیک بازدید می کند و سپس به صفحه فرود نهایی هدایت می شود. به صفحات فرود تبلیغات خرید مراجعه کنید.	صفت	String	آره
productTargetLabels	نام برچسب هایی که مستقیماً به این هدف محصول اختصاص داده شده است. برچسب های ارثی شامل نمی شوند.	صفت	String list	آره
productTargetMaxCpc	حداکثر CPC گروه تبلیغات را لغو می کند و حداکثر مبلغی را تعیین می کند که اگر شخصی روی تبلیغ محصول برای این هدف محصول خاص کلیک کند، مایل به پرداخت آن هستید. اگر این فیلد خالی باشد، هدف محصول از حداکثر CPC گروه تبلیغاتی استفاده خواهد کرد.	صفت	Money	آره
effectiveProductTargetMaxCpc	حداکثر CPC (حداکثر هزینه به ازای هر کلیک) که برای این هدف محصول اعمال می شود. این مقدار یا همان مقدار حداکثر CPC گروه تبلیغات خواهد بود یا اگر هدف محصول بر تنظیم گروه تبلیغاتی غلبه کند، حداکثر CPC هدف محصول خود.	صفت	Money	آره
productTargetMaxBid	اگر این هدف محصول توسط یک استراتژی پیشنهادی DS مدیریت شود، استراتژی پیشنهادی هرگز قیمت‌ها را بالاتر از این حد نخواهد کرد. به اعمال استراتژی پیشنهاد برای اهداف محصول مراجعه کنید.	صفت	Money	آره
productTargetMinBid	اگر این هدف محصول توسط یک استراتژی پیشنهادی DS مدیریت شود، استراتژی پیشنهاد قیمت هرگز قیمت‌ها را کمتر از این حد نخواهد کرد. به اعمال استراتژی پیشنهاد برای اهداف محصول مراجعه کنید.	صفت	Money	آره
effectiveBidStrategyId	شناسه DS استراتژی پیشنهادی که به این نهاد اختصاص داده شده است یا توسط این نهاد به ارث رسیده است.	صفت	ID	آره
effectiveBidStrategy	نام استراتژی پیشنهادی که به این نهاد اختصاص داده شده است، یا توسط این نهاد به ارث رسیده است.	صفت	String	آره
bidStrategyInherited	نشان می دهد که آیا استراتژی پیشنهادی این نهاد به ارث رسیده است یا خیر.	صفت	Boolean	آره
effectiveLabels	نام تمام برچسب‌های به ارث رسیده یا مستقیماً به این هدف محصول اختصاص داده شده است.	صفت	String list	آره
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	آره