عیب یابی
اگر هنگام استفاده از 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 مشخص کرده‌اید معتبر نیست. پس از انجام کارهای زیر، تبدیل‌ها را دوباره آپلود کنید: تأیید کرد که شناسه کلیک 6 ساعت قبل از آپلود تبدیل ایجاد شده است. سرویس تبدیل API را فعال کرد . اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید، قبل از آپلود تبدیل، حداقل 6 ساعت پس از بازدید منتظر بمانید. اگر زودتر از 6 ساعت پس از بازدید آپلود کنید، Search Ads 360 ممکن است شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا 24 ساعت صبر کنید تا 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 یا نامی که ارائه کرده‌اید با نوع تبدیلی که مشخص کرده‌اید مطابقت ندارد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2024-12-18 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-12-18 بهوقت ساعت هماهنگ جهانی."],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
