نام کاربری حساب 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 را برای حساب خود فعال نکرده باشید، این خطا رخ می دهد. مطمئن شوید که موارد زیر را انجام داده اید:
در نوار کناری سمت چپ، APIs & auth را گسترش دهید. در مرحله بعد، روی APIs کلیک کنید. در فهرست APIها، مطمئن شوید که وضعیت برای Search Ads 360 API روشن است.
Invalid grant
این خطا زمانی رخ می‌دهد که توکن تازه‌سازی شما معتبر نباشد. می‌توانید با فراخوانی اسکریپت ابزار Search Ads 360 به صورت زیر یک نشانه تازه‌سازی دریافت کنید:
sa360Api.py --login
درباره گردش کار توصیه شده برای مجوز بیشتر بدانید .
جدول زیر خطاهایی را که ممکن است هنگام آپلود تبدیل ها با آن مواجه شوید فهرست می کند. توجه داشته باشید که کدهای خطای هگزادسیمال تغییر ناپذیر هستند، بنابراین می توانید از آنها در اسکریپت های خود برای شناسایی خطاها استفاده کنید.
کد خطا
پیام
توضیحات
0x00000101
Click ID ' {ID} ' is not found
شناسه کلیکی که در درخواست update مشخص کرده‌اید معتبر نیست. پس از انجام کارهای زیر، تبدیل‌ها را دوباره آپلود کنید:
تأیید کرد که شناسه کلیک 4 ساعت قبل از آپلود تبدیل ایجاد شده است.
اگر تبدیل‌ها را به بازدیدهای خاصی نسبت می‌دهید، قبل از آپلود تبدیل، حداقل 30 دقیقه پس از بازدید منتظر بمانید. اگر زودتر از 30 دقیقه پس از بازدید آپلود کنید، Search Ads 360 ممکن است شناسه کلیک بازدید را تشخیص ندهد. در موارد نادر، ممکن است لازم باشد تا 4 ساعت صبر کنید تا Search Ads 360 بتواند شناسه کلیک را تشخیص دهد.
بررسی کنید که فعالیت 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 یا نامی که ارائه کرده‌اید با نوع تبدیلی که مشخص کرده‌اید مطابقت ندارد.
تاریخ آخرین به‌روزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی."],[[["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."]]],[]]
