نمای کلی
اگر رویدادها نمایش داده نمی‌شوند، درخواست‌ها ناموفق‌اند یا سامانهٔ مدیریت تبلیغات با سوابق کسب‌وکارتان مطابقت ندارد، از این راهنما استفاده کنید. با یک خرید تکمیل‌شده، یک سرنخ فروش ثبت‌شده یا اقدامی دیگر شروع کنید. آنچه اتفاق افتاده و زمان آن را یادداشت کنید، سپس پرسش متناسب با وضعیت خود را از موارد زیر انتخاب کنید.
رویداد، اقدامی مانند خرید را ثبت می‌کند. پیکسل رویدادها را از مرورگر بازدیدکننده ارسال می‌کند؛ API تبدیل‌ها (CAPI) آن‌ها را از سرور شما می‌فرستد. سامانهٔ مدیریت تبلیغات این رویدادها را در یک منبع داده جمع‌آوری می‌کند. انتساب مشخص می‌کند اقدام به کدام تبلیغ نسبت داده شود. بازهٔ انتساب مشخص می‌کند تا چه مدت پس از تعامل با تبلیغ، یک اقدام می‌تواند واجد شرایط انتساب باشد.
پرسش‌های متداول
۱. از کجا شروع کنم؟
اقدامی را که می‌خواهید اندازه‌گیری کنید، سازوکاری که آن را ارسال می‌کند، و حساب تبلیغاتی و شناسهٔ پیکسل مورد استفاده را مشخص کنید. ممکن است در راه‌اندازی خود از پیکسل، CAPI، اتصال به سرویس شریک یا ترکیبی از این‌ها استفاده کنید. CAPI حتی اگر پیکسل مرورگر را نصب نکرده باشید، به شناسهٔ پیکسل نیاز دارد.
برای راه‌اندازی اولیه، به اندازه‌گیری تبدیل‌ها و ردیابی تبدیل‌ها مراجعه کنید. توسعه‌دهندهٔ شما می‌تواند از راهنماهای پیکسل، CAPI و رویدادهای پشتیبانی‌شده استفاده کند. درخواست‌ها و کلیدهای CAPI را در سرور خود نگه دارید.
اگر اتصال شما را یک شریک مدیریت می‌کند، از راهنمای راه‌اندازی شریک اندازه‌گیری یا راهنمای راه‌اندازی شریک اندازه‌گیری موبایل استفاده کنید. برای اتصال به HubSpot، به راه‌اندازی تبلیغات ChatGPT در HubSpot مراجعه کنید.
اگر قبلاً راه‌اندازی را انجام داده‌اید، هر مرحله را بررسی کنید:
آیا با انجام اقدام، درخواست رویداد ارسال شد؟
آیا درخواست با خطا مواجه شد یا پذیرفته شد؟
آیا می‌توانید تأیید کنید که منبع دادهٔ درست، رویداد را دریافت کرده است؟
آیا رویداد در گزارش کمپین به یک تبلیغ نسبت داده شد؟
۲. پیکسل من نصب شده است. چرا خریدها یا سرنخ‌های فروش را نمی‌بینم؟
پیکسل ممکن است بارگذاری شود، اما رویداد خرید یا سرنخ فروش مورد نیاز شما را ارسال نکند. از توسعه‌دهندهٔ خود بخواهید یک اقدام تکمیل‌شده را بررسی کند:
نام رویداد، شناسهٔ پیکسل و صفحه یا تابع بازگشتی ارسال‌کنندهٔ آن را بررسی کنید. بازدید از صفحه، خرید تکمیل‌شده نیست.
مطمئن شوید پیکسل پیش از ارسال رویداد مقداردهی اولیه می‌شود، حتی زمانی که ابزار مدیریت تگ آن را بارگذاری می‌کند.
کنسول مرورگر و درخواست شبکه را بررسی کنید. پیام «اجرا شد» در ابزار مدیریت تگ، به‌تنهایی ارسال رویداد را تأیید نمی‌کند. حالت اشکال‌زدایی پیکسل می‌تواند کمک کند.
بررسی کنید آیا انتخاب‌های کاربر دربارهٔ رضایت، مسدودسازی مرورگر یا سیاست امنیتی سایت شما مانع درخواست شده‌اند.
صفحات پس از ورود به حساب، فرایند پرداخت، سایت‌های رزرو، تغییرمسیرها و فرم‌های تعبیه‌شده را بررسی کنید. کارکرد درست پیکسل در صفحهٔ فرود، ردیابی در بخش‌های دیگر را تأیید نمی‌کند.
اگر درخواستی ارسال نشده است، ابتدا همان مرحله را اصلاح کنید. منتظر گزارش ماندن کمکی نمی‌کند. پیش از افزودن اتصال دیگری، از راهنمای عیب‌یابی پیکسل استفاده کنید.
۳. اگر رویدادی رد شد، مهلت درخواستش پایان یافت یا خطای سرور دریافت کرد، چه کار کنم؟
کد پاسخ، متن دقیق خطا، زمان درخواست و شناسهٔ رویداد را ذخیره کنید. از توسعه‌دهندهٔ خود بخواهید قالب رویداد، شناسهٔ پیکسل و کلید را بررسی کند. درخواست‌های رویداد CAPI از کلید API تبدیل‌های همان حساب تبلیغاتی استفاده می‌کنند. درخواست‌های راه‌اندازی، مدیریت و گزارش‌گیری از کلید جداگانهٔ API تبلیغ‌دهنده استفاده می‌کنند. کلیدهای API را برای پشتیبانی ارسال نکنید.
در ارسال دسته‌ای CAPI، یک رویداد نامعتبر می‌تواند باعث شکست کل دسته شود.
CAPI به زمان اصلی انجام اقدام، برحسب میلی‌ثانیهٔ یونیکس نیاز دارد. زمان رویداد نباید قدیمی‌تر از ۷ روز گذشته یا بیش از ۱۰ دقیقه جلوتر از زمان فعلی باشد. این محدودیت ارسال، از بازهٔ انتساب جداست. زمان یک رویداد قدیمی را برای پذیرفته شدن آن تغییر ندهید.
پایان مهلت درخواست یا خطای سرور ممکن است باعث شود از دریافت شدن رویداد مطمئن نباشید. درخواست اصلی و هرگونه سابقهٔ دریافت را بررسی کنید. اگر ارسال همان اقدام را دوباره امتحان می‌کنید، شناسهٔ رویداد و برچسب زمانی اصلی آن را حفظ کنید. شناسهٔ جدید ممکن است باعث شود رویداد به‌عنوان اقدامی دیگر تلقی شود.
رد شدن رویداد یا شکست مداوم درخواست را بی‌درنگ بررسی کنید. زمان تقریبی ۲۴ تا ۴۸ ساعتهٔ گزارش‌گیری شامل این خطاها نمی‌شود. برای الزامات درخواست، به API تبدیل‌ها مراجعه کنید.
۴. می‌بینم که رویداد پذیرفته شده است. چرا در گزارش نیست؟
پذیرش رویداد به این معنی نیست که به یک تبلیغ نسبت داده شده است. بررسی کنید پاسخ چه چیزی را تأیید می‌کند و آیا درخواست از منبع دادهٔ درست استفاده کرده است. در CAPI، تنظیم validate_only روی true رویدادها را بدون ذخیره کردن بررسی می‌کند.
برای رویدادی جدید، توسعه‌دهندهٔ شما می‌تواند در صورت دسترسی، رویدادهای اخیر را بررسی کند. این بخش نمونه‌ای از رویدادهای اخیر را نشان می‌دهد، نه سابقهٔ کامل یا نتیجهٔ انتساب را.
اگر نمی‌توانید دریافت را بررسی کنید، با ارائهٔ پاسخ اصلی و یک نمونه رویداد با پشتیبانی تماس بگیرید. به ما بگویید کدام بررسی‌ها را انجام داده‌اید؛ لازم نیست ابتدا علت را پیدا کنید.
اگر دریافت تأیید شده است، به پرسش ۵ بروید. صرفاً به این دلیل که گزارش کمپین تغییر نکرده، رویداد را با شناسه‌های جدید دوباره ارسال نکنید.
نمایش تبدیل‌های منتسب ممکن است حدود ۲۴ تا ۴۸ ساعت طول بکشد و مجموع‌های اخیر ممکن است در طول پردازش تغییر کنند. این بازه نه نمایش همهٔ رویدادهای پذیرفته‌شده را تضمین می‌کند و نه دریافت آن‌ها را تأیید می‌کند. به اندازه‌گیری نتایج مراجعه کنید.
۵. رویدادها در حال دریافت هستند. چرا کمپین هنوز تعداد تبدیل‌ها را صفر نشان می‌دهد؟
پیش از تغییر اتصال، این موارد را بررسی کنید:
آیا منبع دادهٔ مورد نظر به حساب درست متصل است؟
آیا رویدادی که ارسال می‌کنید با تنظیم تبدیل کمپین مطابقت دارد؟ برای رویدادهای سفارشی، نوع سفارشی و نام دقیق رویداد را بررسی کنید. یکسان بودن برچسب نمایشی کافی نیست.
آیا تبدیل درست، پیش از فعالیتی که بررسی می‌کنید به کمپین متصل شده بود؟
آیا اقدام پس از کلیک یا مشاهدهٔ تبلیغی انجام شده که طبق تنظیمات انتساب واجد شرایط است؟
آیا کمپین، ستون رویداد، تاریخ‌ها و مبنای زمانی گزارش‌گیری درست را مشاهده می‌کنید؟
اطلاعات تطبیق به مرتبط کردن رویداد با تبلیغ کمک می‌کند، اما انتساب را تضمین نمی‌کند. شناسهٔ ارجاع واقعی کلیک OpenAI، یعنی oppref، را در طول بازدید حفظ کنید و در صورت وجود، آن را در رویدادهای سرور بگنجانید. هرگز شناسهٔ ارجاع ساختگی ایجاد نکنید و از شناسهٔ بازدیدکننده‌ای دیگر استفاده نکنید.
رویدادهای مرورگر و سرور را جداگانه بررسی کنید. ممکن است شناسهٔ ارجاع یا فیلد مشتری که در دسترس پیکسل است، در رویداد سرور وجود نداشته باشد.
هدف انتخاب‌شدهٔ کمپینی که برای تبدیل بهینه‌سازی شده است، پس از ایجاد قابل تغییر نیست. برای استفاده از هدفی دیگر، کمپین جدیدی ایجاد کنید. رویدادهای سفارشی نمی‌توانند هدف بهینه‌سازی باشند. به کمپین‌های بهینه‌سازی‌شده برای تبدیل مراجعه کنید.
پس از رفع ناهماهنگی پیکربندی، فعالیت‌های جدید واجد شرایط را بررسی کنید. فرض نکنید این تغییر گزارش‌های قبلی را اصلاح می‌کند. برای قواعد تطبیق، به اندازه‌گیری تبدیل‌ها مراجعه کنید.
۶. چرا سامانهٔ مدیریت تبلیغات، ابزار تحلیل و CRM ما با هم مطابقت ندارند؟
اقدام‌های یکسان را با قواعد گزارش‌گیری یکسان مقایسه کنید. ممکن است CRM شما همهٔ خریدها را بشمارد؛ اما گزارش تبلیغات، خریدهای منتسب به همان پلتفرم را می‌شمارد. پلتفرم‌های مختلف ممکن است یک خرید واحد را به شکل‌های متفاوتی نسبت دهند.
در سامانهٔ مدیریت تبلیغات، وقتی بازهٔ گزارش‌گیری تبدیل‌های پس از مشاهده ۱ روز باشد، تبدیل‌ها مجموع تبدیل‌های پس از کلیک و تبدیل‌های واجد شرایط پس از مشاهده را نشان می‌دهد. با بازهٔ مشاهدهٔ ۰ روزه، فقط تبدیل‌های پس از کلیک شمرده می‌شوند. هنگام مقایسهٔ گزارش‌ها، از تنظیم یکسان استفاده کنید.
برای مثال، فردی روی تبلیغ کلیک می‌کند، بعداً مستقیماً بازمی‌گردد و خرید می‌کند. ممکن است یک ابزار بازدید را «مستقیم» برچسب بزند، درحالی‌که ابزار دیگر خرید را به تبلیغ قبلی نسبت دهد. این تفاوت به‌تنهایی به معنی دوبار شمرده شدن خرید نیست.
اگر برچسب‌های منبع ترافیک متفاوت‌اند، نشانی صفحهٔ فرود و پارامترهای ردیابی استفاده‌شده در آن بازدید را بررسی کنید. ممکن است تنظیمات فعلی کمپین با تنظیماتی که قبلاً استفاده شده‌اند متفاوت باشند.
این موارد را مقایسه کنید:
حساب، کمپین، نوع رویداد، فیلترها و سطح گزارش‌گیری.
محدودهٔ تاریخ، منطقهٔ زمانی و اینکه تاریخ‌ها مربوط به تعامل با تبلیغ هستند یا خود تبدیل.
تنظیمات تبدیل پس از کلیک و پس از مشاهده، و شاخص یا ستون دقیق انتخاب‌شده.
تأخیرهای اخیر در پردازش، نحوهٔ رسیدگی به موارد تکراری، رضایت کاربر و اطلاعات تطبیق موجود.
تبدیل‌های مدل‌سازی‌شده، در صورت وجود، که ممکن است با تراکنش‌های ثبت‌شدهٔ مستقیم متفاوت باشند.
برای مقادیر: ارز، واحدها و اینکه مبنای مقایسه کل سفارش است یا اقلام جداگانه.
برای درآمد، مالیات، هزینهٔ ارسال، تخفیف‌ها و کارمزدها را مقایسه کنید. بررسی کنید که نسخه‌های مرورگر و سرور، مبلغ سفارش یکسانی ارسال کنند. فروش سفارش‌های ایجادشده و بازده هزینهٔ تبلیغات سفارش‌های ایجادشده فقط رویدادهای order_created منتسب به تبلیغات را محاسبه می‌کنند.
داده‌های فعالیت واردشده از GA4 شامل رویدادهای همهٔ منابع ترافیک در دارایی انتخاب‌شده است. این مجموع‌ها، تبدیل‌های منتسب به کمپین نیستند. به اتصال Google Analytics 4 به سامانهٔ مدیریت تبلیغات OpenAI مراجعه کنید.
برای مقایسه‌های API، نقطه پایان را ثبت کنید و گزینه‌های گزارش‌گیری را به‌صراحت تعیین کنید. تنظیمی که تعیین نشده باشد، ممکن است با سامانهٔ مدیریت تبلیغات مطابقت نداشته باشد. همچنین ممکن است گزارش‌ها رویدادهای متفاوتی را پوشش دهند: برخی شامل اهداف کمپین هستند، اما اقدام‌های ردیابی‌شدهٔ دیگر را شامل نمی‌شوند. نبودن یک رویداد در یک گزارش ثابت نمی‌کند که هرگز دریافت نشده است.
برای مقایسهٔ CSV از تنظیمات یکسان استفاده کنید و فایل‌های خروجی را بدون ویرایش نگه دارید. برای نماهای سامانهٔ مدیریت تبلیغات، به اندازه‌گیری نتایج و برای گزینه‌های API، به گزارش‌گیری مراجعه کنید.
۷. آیا استفاده از پیکسل و CAPI باعث می‌شود یک خرید دو بار شمرده شود؟
برای جلوگیری از دوبار شمرده شدن یک اقدام، در نسخه‌های مرورگر و سرور آن از شناسهٔ پیکسل، نام رویداد و شناسهٔ رویداد یکسان استفاده کنید. فیلد شناسهٔ رویداد در CAPI برابر با id و در پیکسل برابر با event_id است. نام رویداد سفارشی را نیز در هر دو طرف یکسان وارد کنید.
هنگام تلاش دوباره برای ارسال یک اقدام، همان شناسه را حفظ کنید؛ برای هر اقدام متفاوت، از شناسه‌ای جدید استفاده کنید. وجود تگ‌های تکراری، بارگذاری‌های مکرر صفحه یا فراخوانی‌های بازگشتی تکراری و اتصال‌های سرویس‌های شریک را که ممکن است از قبل رویداد را ارسال کنند، بررسی کنید.
برای تغییر مقدار یا اطلاعات تطبیق رویداد اصلی، نسخه‌ای تکراری از آن ارسال نکنید. پیش از اقدام به اصلاح، رفتار سیستم را در مستندات بررسی کنید. به حذف رویدادهای تکراری مرورگر و سرور مراجعه کنید.
۸. ما از Shopify استفاده می‌کنیم. آیا به اتصال دیگری نیاز داریم؟
پیش از افزودن اتصال دیگری، اتصال Shopify خود را بررسی کنید. حساب تبلیغاتی و پیکسل متصل را تأیید کنید، سپس بررسی کنید که برنامه کدام رویدادها را برای فروشگاه شما ارسال می‌کند.
اگر از تگ‌های سفارشی، کد پرداخت یا فرستندهٔ سمت سرور نیز استفاده می‌کنید، بررسی کنید که آیا آن‌ها هم همان رویدادها را ارسال می‌کنند. پیکربندی‌های Shopify می‌توانند از ترکیب‌های متفاوتی از ردیابی مرورگر و سرور استفاده کنند. به راه‌اندازی تبلیغات ChatGPT برای Shopify مراجعه کنید.
۹. رضایت کاربران و آزمایش‌ها را چگونه مدیریت کنیم؟
فقط داده‌هایی را ارسال کنید که مجاز به اشتراک‌گذاری آن‌ها هستید و به انتخاب‌های بازدیدکنندگان دربارهٔ رضایت احترام بگذارید. توسعه‌دهندهٔ شما باید راهنمای اتصال دربارهٔ رضایت و داده‌های تطبیق پشتیبانی‌شده را رعایت کند، از جمله هرگونه نرمال‌سازی و هش‌گذاری لازم. برای افزایش تبدیل‌های گزارش‌شده یا بهبود امتیاز، کنترل‌های رضایت را حذف نکنید.
رضایت برای اندازه‌گیری و opt_out کاربردهای متفاوتی دارند. گزینهٔ opt_out مربوط به شخصی‌سازی است؛ این گزینه همهٔ درخواست‌های اندازه‌گیری را متوقف نمی‌کند. از توسعه‌دهندهٔ خود بخواهید نحوهٔ اعمال رضایت را در اتصال‌های مرورگر و سرور بررسی کند.
زمان، نام و شناسهٔ یک اقدام آزمایشی را ثبت کنید. بررسی کنید آیا ارسال، اعتبارسنجی و دریافت شده است. موفقیت آزمایش پیاده‌سازی نشان نمی‌دهد که تبلیغ واجد شرایط انتساب است.
گزینهٔ validate_only در CAPI رویدادها را بدون ذخیره کردن بررسی می‌کند. حالت اشکال‌زدایی پیکسل فعالیت‌ها را در لاگ ثبت می‌کند، اما مانع ورود رویدادهای آزمایشی به گزارش‌ها نمی‌شود. آزمایش‌ها را در سوابق خود برچسب‌گذاری کنید و برای رسیدن به نتیجهٔ دلخواه، خرید ساختگی ثبت نکنید یا زمان رویدادها را تغییر ندهید.
۱۰. آیا پایین بودن یا در دسترس نبودن امتیاز کیفیت رویداد به معنی خرابی ردیابی است؟
به‌تنهایی خیر. کیفیت رویداد، اطلاعات دریافتی از یک منبع داده را ارزیابی می‌کند. این شاخص نشان نمی‌دهد چند تبدیل به تبلیغات نسبت داده شده‌اند. امتیاز پایین یا در دسترس نبودن آن به‌تنهایی مشخص نمی‌کند که ردیابی کار می‌کند یا نه.
بررسی کنید که اقدام‌های واقعی اخیر به‌درستی ثبت می‌شوند، سپس هشدار را بررسی کنید. برای بالا بردن امتیاز، رویدادهای اضافی یا شناسه‌های ساختگی ارسال نکنید. برای بررسی‌ها و زمان‌بندی به‌روزرسانی، به درک و بهبود کیفیت رویداد مراجعه کنید.
۱۱. هنگام تماس با پشتیبانی چه اطلاعاتی ارائه کنم؟
به ما بگویید چه انتظاری داشتید، چه اتفاقی افتاد، مشکل از چه زمانی شروع شد و چه مواردی را بررسی کردید. از فهرست زیر، هر اطلاعاتی را که در اختیار دارید ارائه کنید:
شناسهٔ حساب تبلیغاتی، شناسهٔ پیکسل یا منبع داده، و شناسه‌های کمپین و تبلیغی که دچار مشکل شده‌اند.
نوع اتصال و نام دقیق رویداد، از جمله نام هر رویداد سفارشی.
شناسهٔ یک یا دو رویداد موجود به‌عنوان نمونه و برچسب زمانی اقدام‌های مربوط، همراه با منطقهٔ زمانی.
برای شکست درخواست یا نامشخص بودن دریافت: کد پاسخ، متن دقیق خطا، زمان درخواست، هر شناسهٔ درخواست یا CF-Ray برگشتی، و داده‌های ارسالی یا بخشی از لاگ که اطلاعات حساس آن حذف شده باشد.
برای اختلاف گزارش‌ها: محدودهٔ تاریخ، مبنای زمانی گزارش‌گیری، تنظیمات انتساب، ستون‌های انتخاب‌شده، خروجی CSV و مقایسه‌ای با دامنهٔ یکسان.
تصاویر مرتبط از صفحه و هر تغییر اخیر در تنظیمات، از جمله فرایند پرداخت جداگانه یا اتصال به سرویس شریک.
به ما بگویید آیا ارسال، پذیرش یا دریافت رویداد را تأیید کرده‌اید یا فقط گزارش را بررسی کرده‌اید. حتی اگر نتوانید این بررسی‌ها را کامل کنید، می‌توانید درخواست کمک کنید.
کلیدهای API، هدرهای مجوزدهی، گذرواژه‌ها، کوکی‌ها و اطلاعات غیرضروری مشتریان را از پیوست‌ها حذف کنید. خطاها یا توقف ناگهانی اتصالی را که قبلاً کار می‌کرد، بی‌درنگ گزارش دهید. منتظر نمانید تا بازهٔ گزارش‌گیری سپری شود.