سؤالات متداول

آیا محدودیتی برای آنچه می‌توانم بارگذاری کنم وجود دارد؟

چند محدودیت وجود دارد که باید از آن‌ها مطلع باشید:

  • درخواست‌های batchinsert و batchupdate تکی به ۱٬۰۰۰ تبدیل محدود است.
  • مُهر زمان تبدیل می‌تواند حداکثر ۲۸ روز از زمان ارسال قدیمی‌تر باشد.
  • فقط می‌توانید تبدیل‌ها را به پیکربندی Floodlight ارسال کنید که نمایه کاربر Campaign Manager 360 شما به آن دسترسی دارد.
آیا باید از Campaign Manager 360 یا Search Ads 360 برای بارگذاری تبدیل‌ها استفاده کنم؟

برای مقایسه دقیق ویژگی‌های ارائه‌شده توسط هر دو محصول، به مرکز راهنمایی Search Ads 360 مراجعه کنید.

اگر تبدیل یکسانی را هم در Campaign Manager 360 و هم در Search Ads 360 درج کنم چه اتفاقی می‌افتد؟

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

از کدام API باید برای بارگذاری تبدیل‌های آفلاین استفاده کنم؟

توصیه می‌کنیم از Data Manager API استفاده کنید تا تجربه توسعه‌دهنده بهبود یابد و به ویژگی‌های بیشتری دسترسی داشته باشید.

مقدار ترتیبی چیست و چگونه استفاده می‌شود؟

مقادیر ترتیبی نحوه پردازش تبدیل‌های تکراری را کنترل می‌کنند. اگر چندین تبدیل با فعالیت Floodlight، شناسه پیکربندی Floodlight، شناسه کاربر، و مُهر زمان تبدیل یکسان درج شود، از عدد ترتیبی برای تعیین اینکه آیا:

  • تبدیل‌ها تکرارزدایی می‌شوند و فقط یکی باقی می‌ماند. این اتفاق زمانی می‌افتد که همه تبدیل‌ها مقدار ترتیبی یکسان داشته باشند.
  • تبدیل‌ها به‌صورت جداگانه پردازش می‌شوند و همه آن‌ها باقی می‌مانند. این اتفاق زمانی می‌افتد که همه تبدیل‌ها مقدار ترتیبی متفاوتی داشته باشند.

لازم نیست خود مقادیر معنی‌دار باشند. به‌طور کلی، استفاده از مقدار ثابت (مثل 1) برای همه تبدیل‌ها، حذف موارد تکراری را فعال می‌کند. استفاده از مقدار تصادفی یا یکتا برای هر تبدیل آن را غیرفعال می‌کند.

چگونه باید خطاها را در پاسخ میانای برنامه‌سازی کاربردی مدیریت کنم و کدام خطاها را باید دوباره امتحان کنم؟

batchinsert و batchupdate تبدیل‌ها را براساس بهترین تلاش پردازش می‌کنند: درخواست دسته‌ای می‌تواند پاسخ HTTP 200 OK را برگرداند درحالی‌که تبدیل‌های تکی در دسته ناموفق باشند. همیشه hasFailures را در پاسخ بررسی کنید و فهرست errors[] را در هر شیء ConversionStatus بازرسی کنید:

  • INTERNAL (امتحان مجدد): خطای گذرا در سیستم‌های Google هنگام پردازش تبدیل رخ داده است. تبدیل درج یا به‌روزرسانی نشد. تبدیل‌های ناموفق را بااستفاده از عقب‌گرد نمایی دوباره امتحان کنید (برای مثال، شروع پس‌از چند دقیقه و امتحان مجدد درطول چند ساعت)، با حفظ دقیق همان ordinal، timestampMicros، floodlightActivityId، و شناسه کاربر یا کلیک.
  • NOT_FOUND (امتحان مجدد با تأخیر): شناسه (gclid،‏ dclid،‏ matchId، یا mobileDeviceId) یا تبدیل موجودی که درحال ویرایش است هنوز پیدا نشده است. چون پردازش و نمایه‌سازی کلیک‌های آنلاین، برچسب‌های Floodlight، و تبدیل‌ها ممکن است ۱ تا ۲ ساعت طول بکشد، تبدیل‌های NOT_FOUND را به‌صورت دوره‌ای (مثلاً هر ۱ تا ۳ ساعت، تا ۶ ساعت) دوباره امتحان کنید. اگر NOT_FOUND پس‌از ۶ ساعت همچنان وجود داشت، بخش‌های زیر را برای دلایل رایج براساس نوع شناسه ببینید.
  • INVALID_ARGUMENT و PERMISSION_DENIED (دوباره امتحان نکنید): داده‌های تبدیل نامعتبر است (برای مثال، مُهر زمان تبدیل قدیمی‌تر از ۲۸ روز است یا فیلد بدشکل است) یا نمایه کاربر شما برای پیکربندی Floodlight هدف اجازه ندارد. این تبدیل‌ها را بدون برطرف کردن مشکل اصلی دوباره امتحان نکنید.

اگر کل درخواست HTTP با خطای سرور 5xx یا 429 خطای سهمیه / محدودیت نرخ ناموفق بود، درخواست را بااستفاده از عقب‌نشینی نمایی دوباره امتحان کنید.

تلاش مجدد ایمن و حذف موارد تکراری: هنگام تلاش مجدد برای تبدیلی که با INTERNAL یا NOT_FOUND ناموفق بوده است (یا پس‌از اتمام مهلت HTTP 5xx که نتیجه نامشخص است)، همیشه دقیقاً همان ordinal و timestampMicros را ارسال کنید. اگر تبدیلی ازقبل ثبت شده باشد، «مدیر پویش ۳۶۰» به‌طور خودکار آن را براساس ordinal، شناسه کاربر، فعالیت Floodlight، و تاریخ تبدیل حذف می‌کند.

وقتی بارگذاری mobileDeviceId به‌دلیل خطای NOT_FOUND ناموفق می‌شود، به چه معنا است؟

رایج‌ترین دلایل این خطا عبارت‌اند از:

  • mobileDeviceId نامعتبر است.
  • ‫mobileDeviceId برای Search Ads 360 ناشناخته است. این یعنی دستگاه هنوز آگهی‌ای از Campaign Manager 360 دریافت نکرده است.
وقتی بارگذاری gclid به‌دلیل خطای NOT_FOUND ناموفق می‌شود، به چه معنا است؟

رایج‌ترین دلایل این خطا عبارت‌اند از:

  • gclid نامعتبر است.
  • ‫gclid با پویش Search Ads 360 یا ردیف YouTube در Display & Video 360 مرتبط نیست. این ممکن است زمانی رخ دهد که gclid از یک تغییر مسیر کلیک Google Ads جمع‌آوری شده باشد که از Search Ads 360 عبور نکرده است (مثلاً کلیک روی افزونه‌های مکان) یا از یک تغییر مسیر کلیک آگهی YouTube جمع‌آوری شده باشد که با یک ردیف YouTube در Display & Video 360 مرتبط نیست.
  • کلیک مرتبط با gclid خیلی وقت پیش اتفاق افتاده است. تبدیل‌ها فقط برای کلیک‌هایی که حداکثر ۶۰ روز از آن‌ها گذشته باشد درج می‌شود.
  • کلیک مرتبط با gclid خیلی به‌تازگی اتفاق افتاده است. توصیه می‌کنیم بارگذاری‌های تبدیل مبتنی بر gclid را ۱ ساعت به‌تأخیر بیندازید تا مطمئن شوید که gclid پردازش شده و برای مطابقت دردسترس است.
وقتی بارگذاری dclid به‌دلیل خطای NOT_FOUND ناموفق می‌شود، به چه معنا است؟

رایج‌ترین دلایل این خطا عبارت‌اند از:

  • dclid نامعتبر است.
  • کلیک مرتبط با dclid خیلی وقت پیش اتفاق افتاده است. تبدیل‌ها فقط برای کلیک‌هایی که حداکثر ۶۰ روز از آن‌ها گذشته باشد درج می‌شود.
  • کلیک مرتبط با dclid خیلی به‌تازگی اتفاق افتاده است. توصیه می‌کنیم بارگذاری‌های تبدیل مبتنی بر dclid را ۱ ساعت به‌تأخیر بیندازید تا مطمئن شوید که dclid پردازش شده و برای مطابقت دردسترس است.
وقتی بارگذاری matchId به‌دلیل خطای NOT_FOUND ناموفق می‌شود، به چه معنا است؟

رایج‌ترین دلایل این خطا عبارت‌اند از:

  • matchId برای Campaign Manager 360 ناشناخته است. این ممکن است زمانی رخ دهد که matchId از تماس Floodlight جمع‌آوری شده باشد که به‌درستی از Campaign Manager 360 عبور نکرده است (مطمئن شوید تماس‌های Floodlight شما به‌درستی کار می‌کنند، ازجمله پارامتر برچسب matchId).
  • فراخوانی Floodlight مرتبط با matchId حاوی کوکی نبود. فراخوانی Floodlight باید حاوی کوکی / شناسه باشد تا Campaign Manager 360 بتواند matchId را به‌درستی ذخیره کند (مثلاً ممکن است کاربر کوکی‌ها را مسدود کرده باشد یا انصراف داده باشد).
  • تماس Floodlight مرتبط با matchId خیلی وقت پیش اتفاق افتاده است. بارگذاری‌های «تبدیل آفلاین» باید ظرف ۶۰ روز از تماس Floodlight حاوی matchId انجام شود.
  • تماس Floodlight مرتبط با matchId خیلی اخیراً رخ داده است. توصیه می‌کنیم بارگذاری‌های تبدیل مبتنی بر matchId را ۲ ساعت به‌تأخیر بیندازید تا مطمئن شوید که matchId پردازش شده و برای مطابقت دردسترس است.
آیا تبدیل‌های آفلاین با مُهر زمان قبل‌از ایجاد «فعالیت Floodlight» در گزارش‌ها گنجانده می‌شوند؟

بارگذاری تبدیل‌های آفلاین با مُهر زمان قبل‌از ایجاد «فعالیت Floodlight» می‌تواند به‌عنوان ظهورهای Floodlight و تبدیل‌های انتساب‌یافته/انتساب‌نیافته تا ۲۸ روز قبل‌از زمان ارسال گزارش شود. بااین‌حال، این رفتار تضمین‌شده نیست و نباید به آن اتکا کرد. روال مطلوب این است که «فعالیت‌های Floodlight» را قبل‌از اولین مُهر زمان تبدیل آفلاین ایجاد کنید.

برای استفاده از «درج تبدیل آفلاین» جهت ایجاد فهرست مخاطبان، چه رضایتی لازم است؟

علاوه‌بر رضایت کاربر برای داده‌های آگهی، فیلد nonPersonalizedAd باید به‌طور صریح روی false تنظیم شود تا ایجاد فهرست مخاطب فعال شود.