API قبلی Search Ads 360 Reporting حذف می‌شود و در 30 ژوئن 2024 از رده خارج می‌شود. توجه داشته باشید که Search Ads 360 Conversion API تحت تأثیر قرار نگرفته و همچنان پشتیبانی می‌شود. همه توسعه گزارش‌های جدید باید از Search Ads 360 Reporting API جدید استفاده کنند.

از آوریل 2024، هنگام درخواست گزارش، یک خطای پشتیبانی‌نشده ApiVersion برگردانده می‌شود. جزئیات را اینجا ببینید.

همچنین اکیداً توصیه می‌کنیم که پیاده‌سازی‌های موجود Search Ads 360 را به API جدید منتقل کنید. برای اطلاعات بیشتر به راهنمای جدید Search Ads 360 Reporting Getting Started and Migration مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

عیب یابی

اگر هنگام استفاده از Search Ads 360 API با مشکل مواجه شدید، به این بخش عیب‌یابی نگاهی بیندازید.

اگر مشکلی وجود دارد که پس از مطالعه منابع موجود در این سایت نمی توانید آن را حل کنید، با پشتیبانی تماس بگیرید و اطلاعات زیر را آماده کنید:

Search Ads 360 Agency ID و Advertiser ID که می‌خواهید به آن دسترسی پیدا کنید
شماره پروژه از Google API Console
نام کاربری حساب Google که برای دسترسی به API استفاده می‌کنید.
این حسابی است که به آن اجازه دسترسی به Search Ads 360 داده شده است، که همان حسابی است که برای تنظیم مجوز استفاده می‌کنید.
قطعه کد درخواست شما
پاسخ JSON
اگر پاسخ یک خطا است، حتماً پیام خطا را وارد کنید، نه فقط کد خطای عددی.

خطاهای مجوز

در اینجا برخی از خطاهای مجوز که معمولا با آن مواجه می شوند آورده شده است:

پیام	شرح
`Access Not Configured. Please use Google API Console to activate the API for your project.`	اگر Search Ads 360 API را برای حساب خود فعال نکرده باشید، این خطا رخ می دهد. مطمئن شوید که موارد زیر را انجام داده اید: به کنسول API Google بروید. پروژه خود را انتخاب کنید اگر هنوز پروژه ای ایجاد نکرده اید، به ایجاد پروژه برای مشتری خود مراجعه کنید. در نوار کناری سمت چپ، APIs & auth را گسترش دهید. در مرحله بعد، روی APIs کلیک کنید. در فهرست APIها، مطمئن شوید که وضعیت برای Search Ads 360 API روشن است.
`Invalid grant`	این خطا زمانی رخ می‌دهد که توکن تازه‌سازی شما معتبر نباشد. می‌توانید با فراخوانی اسکریپت ابزار Search Ads 360 به صورت زیر یک نشانه تازه‌سازی دریافت کنید: `sa360Api.py --login` درباره گردش کار توصیه شده برای مجوز بیشتر بدانید .
`Invalid client no application name`	این خطا در صورتی رخ می دهد که هنگام تنظیم پروژه خود در Google API Console نام محصول را مشخص نکرده باشید. برای رفع این خطا، نام محصول خود را در صفحه رضایت کنسول API Google وارد کنید .
انواع دیگر خطاهای مجوز	هنگام ورود به Google API Console برای بازیابی شناسه مشتری و راز سرویس گیرنده خود و هنگامی که یک نشانه رفرش دریافت می کنید، مطمئن شوید که از یک حساب Google استفاده کنید که به Search Ads 360 دسترسی داشته باشد .

خطاهای آپلود تبدیل

جدول زیر خطاهایی را که ممکن است هنگام آپلود تبدیل ها با آن مواجه شوید فهرست می کند. توجه داشته باشید که کدهای خطای هگزادسیمال تغییر ناپذیر هستند، بنابراین می توانید از آنها در اسکریپت های خود برای شناسایی خطاها استفاده کنید.

کد خطا	پیام	شرح
`0x00000101`	`Click ID ' {ID} ' is not found`	شناسه کلیکی که در درخواست `update` مشخص کرده‌اید معتبر نیست. پس از انجام کارهای زیر، تبدیل‌ها را دوباره آپلود کنید: تأیید کرد که شناسه کلیک 4 ساعت قبل از آپلود تبدیل ایجاد شده است. سرویس تبدیل API را فعال کرد . اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید ، قبل از آپلود تبدیل، حداقل 30 دقیقه پس از بازدید منتظر بمانید. اگر زودتر از 30 دقیقه پس از بازدید آپلود کنید، Search Ads 360 ممکن است شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا 4 ساعت صبر کنید تا Search Ads 360 بتواند شناسه کلیک را تشخیص دهد. تأیید کرد که کلیک از منبع معتبری است که توسط پارامتر `gclsrc` نشان داده شده است . تأیید شد که تبلیغ‌کننده صحیح را در ستون advertiserId مشخص کرده‌اید. تأیید کرد که شناسه کلیک شما در 90 روز گذشته ایجاد شده است.
`0x0000010E`	`Floodlight activity name ' {name} ' is not found`	نام فعالیت Floodlight مشخص شده در ستون `segmentationName` نادرست است یا هنوز در دسترس نیست. اگر این خطا را مشاهده کردید، مشکلات رایج زیر را بررسی کنید: نام‌ها به حروف بزرگ و کوچک حساس هستند، بنابراین مطمئن شوید که درخواست شما دقیقاً با حروف بزرگ مطابقت دارد. مطمئن شوید که در نام فعالیت Floodlight هیچ نویسه Unicode غیرقابل چاپ یا فاصله دوتایی وارد نکرده اید. مطمئن شوید که نام یک فعالیت Floodlight را مشخص کرده اید، نه یک ستون Floodlight . بررسی کنید که فعالیت Floodlight برای تبلیغ‌کننده‌ای که در ستون `advertiserId` مشخص کرده‌اید وجود داشته باشد. (ممکن است تبلیغ کننده اشتباهی را مشخص کرده باشید.) پس از ایجاد یا ویرایش یک فعالیت Floodlight، قبل از آپلود تبدیل برای فعالیت، چند ساعت صبر کنید.
`0x00000115`	`Custom dimension ' {name} ' is not found`	مطمئن شوید که متغیر Floodlight سفارشی که مشخص کرده‌اید به‌عنوان یک بعد (نه معیار) برای تبلیغ‌کننده مرتبط با `clickId` ، `criterionId` ، یا `productGroupId` که برای تبدیل نسبت می‌دهید تنظیم شده باشد.
`0x00000116`	`Custom metric ' {name} ' is not found`	مطمئن شوید که متغیر Floodlight سفارشی که مشخص کرده‌اید به‌عنوان یک معیار (نه بعد) برای تبلیغ‌کننده مرتبط با `clickId` ، `criterionId` ، یا `productGroupId` که برای تبدیل نسبت می‌دهید، تنظیم شده باشد.
`0x0000011A`	`The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}`	شخصی قبلاً تبدیلی را برای همان محدوده و شناسه تبدیل تبلیغ‌کننده مشخص شده در ستون `conversionId` بارگذاری کرده است. «شناسه تبدیل تبلیغ‌کننده» شناسه‌ای است که شما ایجاد می‌کنید. Search Ads 360 نیاز دارد که این شناسه برای یک محدوده مشخص منحصر به فرد باشد. شناسه تبدیل Search Ads 360 توسط Search Ads 360 ایجاد شده و منحصر به فرد بودن آن تضمین شده است.
`0x0000011B`	`Advertiser conversion ID ' {ID} ' is not found`	درخواست `update` شما سعی کرد شناسه تبدیل تبلیغ‌کننده‌ای را به‌روزرسانی کند که وجود ندارد. مطمئن شوید که شناسه درست را مشخص کرده اید.
`0x0000011D`	`User does not have permission to view advertiser {advertiser ID}`	حساب Google که مشتری شما از آن استفاده می‌کند، مجوز مشاهده تبلیغ‌کننده مشخص‌شده در درخواست را ندارد. هنگامی که برای بازیابی شناسه مشتری و رمز سرویس گیرنده خود وارد Google API Console می‌شوید، و هنگامی که یک نشانه به‌روزرسانی دریافت می‌کنید، مطمئن شوید که از یک حساب Google استفاده می‌کنید که به تبلیغ‌کننده‌ای که مشخص کرده‌اید دسترسی داشته باشد.
`0x0000011F`	`Advertiser conversion ID is already specified in this request`	دو یا چند تبدیل در درخواست، محدوده و شناسه تبدیل تبلیغ‌کننده یکسانی را مشخص می‌کنند. شناسه تبدیل تبلیغ‌کننده، شناسه‌ای است که شما ایجاد کرده و در ستون `conversionId` مشخص می‌کنید. Search Ads 360 نیاز دارد که این شناسه برای یک محدوده مشخص منحصر به فرد باشد.
`0x0000011E`	`The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)`	شناسه فعالیت Floodlight یا نامی که ارائه کرده‌اید با نوع تبدیلی که مشخص کرده‌اید مطابقت ندارد.

کدهای پاسخ و پیام های خطا را گزارش دهید

اگر گزارشی درخواست می‌کنید و پاسخ یک پیام خطا است، برای اطلاعات بیشتر درباره خطا ، کدهای پاسخ را در Search Ads 360 API و پاسخ‌های خطای استاندارد ببینید.

داده‌های موجود در Search Ads 360 UI با گزارش ارائه‌شده توسط API مطابقت ندارد

داده‌های موجود در رابط کاربری Search Ads 360 باید به طور پیش‌فرض با داده‌های بازگردانده شده توسط API مطابقت داشته باشد. اگر در یک درخواست گزارش، includeRemovedEntities را روی true تنظیم کنید، مطمئن شوید که چک باکس نمایش حذف شده نیز در رابط کاربری انتخاب شده باشد .