نوع گزارش: حساب کاربری

گزارش داده ها برای حساب های موتور، از جمله:

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

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

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

{
...
  "reportType": "account",
  "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 آره
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 آره
accountCurrencyCode کد ارز حساب موتور با فرمت ISO 4217. صفت String آره
accountTimeZone منطقه زمانی حساب موتور در قالب پایگاه داده منطقه زمانی 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 آره