محدوده گزارش من چقدر باید باشد؟
برای اکثر گزارش‌ها، توصیه می‌کنیم Reports.reportScope روی یک حساب موتور یا تبلیغ‌کننده خاص تنظیم کنید. برای گزارش‌های بسیار بزرگ - مانند گزارش‌های کلیدواژه، گزارش‌های تبدیل، یا گزارش‌های تقسیم‌بندی دقیق - توصیه می‌کنیم دامنه را به یک حساب موتور خاص محدود کنید. API ممکن است برای گزارش های بزرگتر از 10 میلیون ردیف، خطاها را برگرداند.
چرا یک خطای Forbidden (403) دریافت می کنم؟
به احتمال زیاد، باید یک نشانه OAuth به‌روزرسانی دریافت کنید .
چگونه شناسه آژانس ها و آگهی دهندگان را پیدا کنم؟
اگر از قبل شناسه آژانس‌ها و آگهی‌دهندگانی را که اجازه مشاهده آنها را دارید ندارید، با ستون‌های agencyId و advertiserId گزارش advertiser درخواست کنید، اما reportScope را مشخص نکنید. Search Ads 360 فهرستی از تمام شناسه‌های آژانس و تبلیغ‌کننده‌ای را که حساب Google شما اجازه مشاهده آنها را دارد، برمی‌گرداند.
در اینجا یک نمونه درخواست وجود دارد:
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"reportType": "advertiser",
"columns": [
{ "columnName": "agency" },
{ "columnName": "agencyId" },
{ "columnName": "advertiser" },
{ "columnName": "advertiserId" }
],
"statisticsCurrency": "usd"
}
داده های گزارش چقدر تازه هستند؟
برخی از معیارها جدیدتر از سایر معیارها هستند. برای جزئیات، ببینید اطلاعات گزارش در Search Ads 360 چقدر تازه است؟
برای اطمینان از اینکه گزارش‌های شما حاوی تمام معیارهای موجود است، توصیه می‌کنیم قبل از درخواست گزارش‌های معیارهای دیروز، حدود 4 ساعت پس از نیمه‌شب (منطقه زمانی حساب موتور) منتظر بمانید. برای گزارش conversion ، توصیه می‌کنیم 12 ساعت بعد از نیمه‌شب منتظر بمانید (منطقه زمانی تبلیغ‌کننده Campaign Manager). اگر از API برای آپلود داده‌های تبدیل استفاده می‌کنید، برای جزئیات در مورد در دسترس بودن داده‌های آپلود شده، به insert.operation مراجعه کنید.
حتی پس از گذشت چندین روز، به دلیل فیلترهای اسپم موتور یا تبدیل‌های آفلاین که از طریق API آپلود می‌شوند، یک سنجه همچنان می‌تواند تغییر کند. برای دانلود تدریجی این تغییرات، گزارش هایی را در مورد داده هایی که از آخرین بارگیری شما تغییر کرده است درخواست کنید. اگر تغییرات تدریجی را دانلود می کنید، توصیه می کنیم هر چند وقت یک بار گزارش کامل را درخواست کنید. به عنوان مثال، ممکن است هر چند روز یکبار تغییرات افزایشی را دانلود کنید و سپس یک بار در ماه درخواست گزارش کامل کنید.
چه زمانی تغییرات ویژگی در گزارش ها ظاهر می شود؟
حدود یک دقیقه طول می‌کشد تا تغییرات مشخصه‌ای که شخصی در Search Ads 360 ایجاد می‌کند در گزارش‌هایی که از طریق API دانلود می‌کنید ظاهر شود. تغییرات ایجاد شده مستقیماً در موتور خارجی (نه از طریق Search Ads 360) باید ابتدا با استفاده از همگام سازی ورودی به Search Ads 360 وارد شوند.
توصیه می‌کنیم فقط داده‌هایی را که تغییر کرده‌اند برگردانید تا مشخص شود کدام موجودیت‌ها دارای تغییرات ویژگی هستند.
تبلیغات و کلمات کلیدی بدون نسبت چیست؟
گاهی اوقات Search Ads 360 نمی تواند معیارهایی را به یک تبلیغ خاص نسبت دهد. برای مثال، تبلیغی با قالب پشتیبانی‌نشده یا URL سرور کلیک با خطا می‌تواند از انتساب معیارهای Search Ads 360 به یک آگهی جلوگیری کند. برای هر گروه تبلیغاتی، Search Ads 360 هر سنجه‌ای که نسبت داده نشده است را به‌عنوان یک «آگهی منتسب‌نشده» گزارش می‌کند. برای درخواست این معیارها در گزارش، includeRemovedEntities را روی true تنظیم کنید. برای سهولت دیدن اینکه کدام تبلیغات فاقد انتساب هستند، ستون isUnattributedAd را در درخواست اضافه کنید.
به طور مشابه، گاهی اوقات Search Ads 360 نمی تواند معیارهایی را به یک کلمه کلیدی خاص نسبت دهد. این زمانی اتفاق می‌افتد که اختلاف در گزارش‌ها به وجود می‌آید. در چنین مواردی، ستون keywordId برای کلمات کلیدی منتسب به 0 تنظیم می شود.
آیا گزارش ها شامل تبدیل های مقیاس شده هستند؟
در برخی موارد، اندازه‌گیری تبدیل‌ها دشوار است، مانند زمانی که کوکی‌های وب‌سایتی که اطلاعات مربوط به کلیک‌های تبلیغاتی شما را ذخیره می‌کنند به دلیل عواملی از جمله تنظیمات مرورگر در دسترس نیستند. در این موارد، Floodlight از مقیاس‌بندی برای محاسبه داده‌های تبدیلی که نمی‌توان مستقیماً اندازه‌گیری کرد، استفاده می‌کند. یعنی، Floodlight یادگیری ماشینی را بر روی داده‌های تاریخی اعمال می‌کند تا تعداد تبدیل‌ها و میزان درآمد تبدیل را که نمی‌توان اندازه‌گیری کرد، مدل‌سازی کرد. سپس Floodlight می‌تواند تخمین حاصل را به معیارهای تبدیل خود اضافه کند تا تصویر کامل‌تری از اینکه چگونه تبلیغات شما باعث ایجاد تبدیل می‌شود، ارائه دهد.
Floodlight همیشه مقیاس بندی را برای ستون های گزارش زیر اعمال می کند:
- dfaActions
- dfaدرآمد
- dfaTransactions
- dfaWeightedActions
- ستون های ذخیره شده که فعالیت های Floodlight را گزارش می دهند
گزارش conversion شامل تبدیل های مقیاس شده نمی شود. فقط تبدیل هایی را نشان می دهد که مستقیماً اندازه گیری شده اند. انتظار نمی‌رود تعداد تبدیل‌ها و میزان درآمد در گزارش conversion با تبدیل‌ها و درآمد گزارش‌شده در ستون‌های فهرست‌شده در بالا مطابقت داشته باشد.
چرا تبدیل‌های خام به متریک X خلاصه نمی‌شوند؟
در موارد نادری که سنجه‌های انبوه با رویدادهای خام در Search Ads 360 مخالف است، به معیار انبوه اعتماد کنید. هنگام محاسبه انبوه‌های متریک، Search Ads 360 سعی می‌کند منابع داده را با حذف تبدیل‌هایی که گمان می‌کند تکراری هستند، پاکسازی کند.
اگر سوال من در اینجا پاسخ داده نشود چه؟
اگر مشکلی وجود دارد که پس از مطالعه منابع موجود در این سایت نمی توانید آن را حل کنید، با پشتیبانی تماس بگیرید و اطلاعات زیر را آماده کنید:
Search Ads 360 Agency ID و Advertiser ID که می‌خواهید به آن دسترسی پیدا کنید
شماره پروژه از Google API Console
نام کاربری حساب Google که برای دسترسی به API استفاده می‌کنید.
این حسابی است که به آن اجازه دسترسی به Search Ads 360 داده شده است، که همان حسابی است که برای تنظیم مجوز استفاده می‌کنید.قطعه کد درخواست شما
پاسخ JSON
اگر پاسخ یک خطا است، حتماً پیام خطا را وارد کنید، نه فقط کد خطای عددی.