معیارهای عملکرد و ویژگیهای پیکربندی برای گروههای محصول. گزارشهای گروه محصول با گزارشهای کلیدواژه از چندین جهت متفاوت است. بیشتر بدانید .
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
درخواست گزیده
یک بدنه درخواست عادی Reports.request() ارسال کنید، اما "reportType": "productGroup"
.
{ ... "reportType": "productGroup", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName
فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.
columnName | شرح | رفتار - اخلاق | تایپ کنید | قابل فیلتر کردن |
---|---|---|---|---|
status | وضعیت گروه محصول همیشه Active است. | صفت | 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 | آره |
productGroupId | شناسه گروه محصول DS. DS این شناسه ها را تولید می کند، که ممکن است تغییر کنند حتی اگر درخت گروه محصول حاصل بدون تغییر باشد. بیشتر بدانید . | صفت | ID | آره |
productGroup | معیارهایی که برای تعریف گروه محصول مورد استفاده قرار گرفتند، مانند AND(CATEGORY="Electronics", BRAND = "example"). | صفت | String | خیر |
productGroupPartitionType | نوع پارتیشن برای گروه محصول: Subdivided ، Excluded یا Biddable . | صفت | Product group partition type | آره |
productGroupLandingPage | صفحه فرود گروه محصول. به نشانیهای اینترنتی صفحه فرود و سرور کلیک مراجعه کنید. | صفت | String | آره |
productGroupClickserverUrl | URL که DS برای ردیابی فعالیت استفاده می کند. کاربری که روی یک تبلیغ کلیک می کند ابتدا از URL سرور کلیک بازدید می کند و سپس به صفحه فرود نهایی هدایت می شود. به نشانیهای اینترنتی صفحه فرود و سرور کلیک مراجعه کنید. | صفت | String | آره |
productGroupMaxCpc | حداکثر CPC را که برای این گروه محصول تنظیم شده است، در صورت وجود، برمیگرداند. اگر حداکثر CPC برای این گروه محصول تنظیم نشده باشد، این قسمت خالی است و گروه محصول حداکثر تنظیم CPC را از گروه تبلیغات به ارث می برد. | صفت | Money | آره |
effectiveProductGroupMaxCpc | حداکثر CPC (حداکثر هزینه به ازای هر کلیک) که برای این گروه محصول وجود دارد. این مقدار یا همان مقدار حداکثر CPC گروه تبلیغات خواهد بود یا اگر هدف محصول از تنظیم گروه تبلیغاتی خارج شود، حداکثر CPC هدف محصول خود. | صفت | Money | آره |
productGroupMaxBid | اگر این گروه محصول توسط یک استراتژی پیشنهادی DS مدیریت شود، استراتژی پیشنهادی هرگز قیمتها را بالاتر از این حد نخواهد کرد. به اعمال استراتژی پیشنهاد برای گروه محصول مراجعه کنید. | صفت | Money | آره |
productGroupMinBid | اگر این گروه محصول توسط یک استراتژی پیشنهادی 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 | آره |