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

گزارش داده‌ها برای تبلیغ‌کنندگان، از جمله:

• معیارهای عملکرد در تمام حساب‌ها و کمپین‌های موتور تبلیغ‌کننده.
• ویژگی‌های پیکربندی برای یک تبلیغ‌کننده.

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

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

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

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

columnName	توضیحات	رفتار	تایپ کنید	قابل فیلتر کردن
status	وضعیت آگهی‌دهنده: Active ، Paused یا Removed .	ویژگی	Status	بله
creationTimestamp	مُهر زمانی ایجاد آگهی‌دهنده، قالب‌بندی شده در ISO 8601.	ویژگی	Timestamp	بله
lastModifiedTimestamp	مُهر زمانی آخرین اصلاحات تبلیغ‌کننده، قالب‌بندی شده در ISO 8601.	ویژگی	Timestamp	بله
agency	نام آژانس	ویژگی	String	بله
agencyId	شناسه نمایندگی DS.	ویژگی	ID	بله
advertiser	نام تبلیغ کننده	ویژگی	String	بله
advertiserId	شناسه تبلیغ کننده DS.	ویژگی	ID	بله
dfaAdvertiserId	شناسه تبلیغ‌کننده Campaign Manager مرتبط با این تبلیغ‌کننده DS.	ویژگی	ID	بله
dfaNetworkId	شناسه شبکه مدیریت کمپین مرتبط با این تبلیغ‌کننده DS.	ویژگی	ID	بله
dfaNetworkTimeZone	منطقه زمانی شبکه مدیریت کمپین مرتبط با این تبلیغ‌کننده DS در قالب پایگاه داده منطقه زمانی IANA، مانند America/New_York .	ویژگی	String	بله
advertiserCurrencyCode	کد ارز آگهی دهنده در قالب ISO 4217.	ویژگی	String	بله
googleAnalyticsTimeZone	منطقه زمانی نمای Google Analytics مرتبط با این تبلیغ‌کننده DS. از قالب پایگاه داده منطقه زمانی IANA، مانند America/New_York استفاده می کند.	ویژگی	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	بله
searchImpressionShare	فقط تبلیغات گوگل و تبلیغات بینگ. نمایش‌هایی که در شبکه جستجو دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آن بودید. به عنوان عددی بین 0.1 و 1 یا اگر سهم کمتر از 0.1 باشد، رشته < 10% برگردانده می شود.	متریک	Impression share	بله
searchBudgetLostImpressionShare	فقط تبلیغات گوگل و تبلیغات بینگ. درصد زمانی که تبلیغات شما به دلیل بودجه ناکافی در شبکه جستجو نمایش داده نمی شود. به عنوان عددی بین 0 و 0.9 یا، اگر سهم بزرگتر از 0.9 باشد، به عنوان یک رشته > 90% برگردانده می شود.	متریک	Impression share	بله
searchRankLostImpressionShare	فقط تبلیغات گوگل و تبلیغات بینگ. درصد زمانی که تبلیغات شما به دلیل رتبه پایین آگهی در شبکه جستجو نمایش داده نمی شود. به عنوان عددی بین 0 و 0.9 یا، اگر سهم بزرگتر از 0.9 باشد، به عنوان یک رشته > 90% برگردانده می شود.	متریک	Impression share	بله
displayImpressionShare	فقط تبلیغات گوگل نمایش‌هایی که در Display Network دریافت کرده‌اید تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت آن بودید. به عنوان عددی بین 0.1 و 1 یا اگر سهم کمتر از 0.1 باشد، رشته < 10% برگردانده می شود.	متریک	Impression share	بله
displayBudgetLostImpressionShare	فقط تبلیغات گوگل درصد زمانی که تبلیغات شما به دلیل بودجه ناکافی در شبکه نمایش نمایش داده نمی شود. به عنوان عددی بین 0 و 0.9 یا، اگر سهم بزرگتر از 0.9 باشد، به عنوان یک رشته > 90% برگردانده می شود.	متریک	Impression share	بله
displayRankLostImpressionShare	فقط تبلیغات گوگل درصد زمانی که تبلیغات شما به دلیل رتبه پایین تبلیغات در شبکه نمایش نمایش داده نمی شود. به عنوان عددی بین 0 و 0.9 یا، اگر سهم بزرگتر از 0.9 باشد، به عنوان یک رشته > 90% برگردانده می شود.	متریک	Impression share	بله
qualityScoreAvg	فقط تبلیغات گوگل و تبلیغات بینگ. میانگین وزنی نمایش نمره کیفیت موتور (QS) در تمام روزها و کلمات کلیدی در محدوده گزارش.	متریک	Number	بله
topOfPageBidAvg	فقط تبلیغات گوگل میانگین پیشنهاد CPC مورد نیاز در طول بازه زمانی گزارش برای نمایش منظم تبلیغات شما در موقعیت‌های بالای نتایج جستجو را تقریبی می‌کند.	متریک	Money	بله
absoluteTopImpressionPercentage	درصد تبلیغات شما که به عنوان اولین تبلیغ بالای نتایج جستجوی ارگانیک نشان داده می شود.	متریک	Impression share	بله
searchAbsoluteTopImpressionShare	نمایش‌هایی که در مکان برتر مطلق دریافت کرده‌اید (اولین تبلیغ بالای نتایج جستجوی ارگانیک) تقسیم بر تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت در مکان برتر بودید.	متریک	Impression share	بله
topImpressionPercentage	درصد تبلیغات شما که در بالای نتایج جستجوی ارگانیک نشان داده می شود.	متریک	Impression share	بله
searchTopImpressionShare	نمایش‌هایی که در مکان برتر دریافت کرده‌اید (در هر نقطه بالاتر از نتایج جستجوی ارگانیک) در مقایسه با تعداد تخمینی نمایش‌هایی که واجد شرایط دریافت در مکان برتر بودید.	متریک	Impression share	بله
searchBudgetLostAbsoluteTopImpressionShare	تخمین می‌زند که چقدر تبلیغ شما به دلیل بودجه کم، اولین آگهی بالای نتایج جستجوی ارگانیک نبوده است.	متریک	Impression share	بله
searchBudgetLostTopImpressionShare	به شما کمک می‌کند بفهمید که چقدر تبلیغ شما به دلیل بودجه کم در جایی بالاتر از نتایج جستجوی ارگانیک نمایش داده نمی‌شود.	متریک	Impression share	بله
searchRankLostAbsoluteTopImpressionShare	تخمین می‌زند که تبلیغ شما به دلیل رتبه پایین آگهی، چند بار اولین تبلیغ بالای نتایج جستجوی ارگانیک نبوده است.	متریک	Impression share	بله
searchRankLostTopImpressionShare	تخمین می‌زند که تبلیغ شما به دلیل رتبه پایین آگهی، در جایی بالاتر از نتایج جستجوی ارگانیک نشان داده نمی‌شود.	متریک	Impression share	بله
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	بله