رویدادهای سفارشی و توصیه‌شده Google Analytics

از Data Manager API برای ارسال رویدادهای توصیه‌شده و رویدادهای سفارشی Google Analytics استفاده کنید.

ارسال رویدادهای توصیه‌شده و سفارشی

اگر از Google Analytics Measurement Protocol ارتقا می‌دهید، برای دریافت دستورالعمل‌ها، ارتقا دادن از Measurement Protocol به Data Manager API را بررسی کنید.

نمای کلی گردش کار

برای ارسال داده‌های رویداد با Data Manager API، مراحل زیر را تکمیل کنید:

  1. آماده‌سازی مقصدها: اشیای Destination را برای فیلد destinations درخواست جذب تعریف کنید تا حساب هدف و مقصد تبدیل یا رویداد را مشخص کنید. برای جزئیات، آماده‌سازی مقصدها را ببینید.

  2. آماده‌سازی داده‌های رویداد و شناسه‌ها: فیلدهای Event را با جزئیات رویداد و شناسه‌های لازم (مثل کلیک آگهی، کارخواه، یا شناسه‌های نمونه برنامه) پر کنید. اگر اطلاعات تماس کاربر را در userData اضافه می‌کنید، شناسه‌ها را طبق دستورالعمل‌های قالب‌بندی نرمال‌سازی و درهم‌سازی SHA-256 کنید، و به‌صورت اختیاری آن‌ها را رمزگذاری کنید. برای جزئیات، آماده‌سازی داده‌های رویداد را ببینید.

  3. ساختن و ارسال درخواست جذب: درخواست events.ingest حاوی destinations، سوابق Event، و encryptionInfo (اگر userData را رمزگذاری کرده‌اید) ارسال کنید. از validateOnly: true برای آزمایش کردن بار داده‌تان برای خطاهای رد سریع پیش‌از ارسال داده‌های تولید استفاده کنید. برای اطلاع از الزامات فیلد و نمونه کدها، ارسال رویداد را ببینید.

  4. بررسی عیب‌یابی: عیب‌یابی پردازش ناهمگام را بازیابی کنید و وضعیت دریافت را با requestStatus.retrieve درستی‌سنجی کنید.

موارد استفاده

در اینجا چند مورد استفاده برای ارسال رویدادهای توصیه‌شده و سفارشی با Data Manager API آورده شده است:

  • رفتار آنلاین را به رفتار آفلاین مرتبط کنید.

  • تعاملات سمت کارخواه و سمت سرور را اندازه‌گیری کنید.

  • رویدادهایی را که خارج از تعامل استاندارد کاربر اتفاق می‌افتند، مانند تبدیل‌های آفلاین، ارسال کنید.

  • رویدادها را از دستگاه‌ها و برنامه‌هایی که جمع‌آوری خودکار در آن‌ها دردسترس نیست، مانند کیوسک‌ها و ساعت‌ها، ارسال کنید.

داده‌های ارائه‌شده توسط کاربر

می‌توانید داده‌های مشتری طرف اول، مانند نشانی‌های ایمیل درهم‌سازی‌شده، شماره تلفن، و نشانی‌های فیزیکی را در فیلد userData از Event ارسال کنید. این کار به بهبود سنجش تبدیل، ارجاع، و ساختن مخاطب در Google Analytics کمک می‌کند.

هنگام ارسال داده‌های ارائه‌شده توسط کاربر، موارد زیر را به‌خاطر داشته باشید:

  • ارسال‌شده با رویدادها: در Data Manager API، داده‌های ارائه‌شده توسط کاربر باید به‌عنوان بخشی از Event ارسال شود. بارگذاری‌های مستقل بدون رویداد پشتیبانی نمی‌شوند.

  • قالب‌بندی و درهم‌سازی: شناسه‌های شخصی (مانند نشانی ایمیل، شماره تلفن، نام، و نشانی خیابان) باید قبل‌از بارگذاری بااستفاده از SHA-256 نرمال‌سازی و درهم‌سازی شوند. فیلدهای دیگر (مانند شهر، ایالت یا استان، کد پستی، و کد کشور) نرمال‌سازی می‌شوند اما درهم نمی‌شوند. برای الزامات خاص، راهنمای قالب‌بندی داده‌های کاربر را دنبال کنید.

  • رمزگذاری: می‌توانید به‌صورت اختیاری داده‌های درهم‌سازی‌شده کاربر را رمزگذاری کنید.

  • شناسه کاربر: توصیه می‌کنیم هرگاه شناسه کاربر ثابتی دردسترس بود، userId را در کنار userData ارائه دهید.

  • پیاده‌سازی: برای دستورالعمل‌های ساخت درخواست، افزودن داده‌های ارائه‌شده توسط کاربر را ببینید.

ملاحظات یکپارچه‌سازی

هنگام استفاده از Data Manager API، ملاحظات زیر را درنظر داشته باشید.

بازاریابی مجدد

وقتی سیگنال‌های Google را روشن کنید، Google Analytics از بازاریابی مجدد در همان دستگاه پشتیبانی می‌کند. برای بازاریابی مجدد بین‌دستگاهی، userId لازم است.

علاوه‌براین، می‌توانید داده‌های ارائه‌شده توسط کاربر را ارسال کنید تا مطابقت مخاطب شخص اول را فعال کنید.

شناسه‌های تبلیغاتی

Google Analytics به‌طور خودکار شناسه‌های تبلیغاتی (مانند GBRAID یا WBRAID) جمع‌آوری‌شده درطول تعاملات آنلاین را بااستفاده از clientId یا appInstanceId به رویدادهای Data Manager API می‌پیوندد.

تنظیمات حریم خصوصی

‫Google Analytics رویدادهای Data Manager API را بااستفاده از clientId یا appInstanceId به تعاملات آنلاین ملحق می‌کند تا تنظیمات حریم خصوصی کاربر مانند «آگهی‌های شخصی‌سازی‌نشده» و «محدود کردن ردگیری آگهی» را اتخاذ کند.

همچنین می‌توانید تنظیمات رضایت کاربر را مستقیماً در هر رویداد بااستفاده از شیء consent مشخص کنید.

اطلاعات جغرافیایی و دستگاه

Google Analytics به‌طور خودکار جدیدترین اطلاعات جغرافیایی و دستگاه را از برچسب‌گذاری با رویدادهای Data Manager API بااستفاده از clientId یا appInstanceId می‌پیوندد. این کار باعث می‌شود رویدادهای Data Manager API شما در گزارش‌هایی که شامل ابعاد جغرافیایی و دستگاه هستند منعکس شوند.

اگر می‌خواهید رویداد Data Manager API اطلاعات جغرافیایی و دستگاه را از یک جلسه خاص به‌جای جدیدترین اطلاعات برای clientId یا appInstanceId منعکس کند، ورودی‌ای را در additionalEventParameters با parameterName تنظیم‌شده روی session_id و value تنظیم‌شده روی شناسه جلسه خاص اضافه کنید و رویداد را ظرف ۲۴ ساعت از شروع جلسه ارسال کنید.

می‌توانید بااستفاده از Data Manager API، اطلاعات جغرافیایی و اطلاعات دستگاه را برای رویدادها ارائه دهید.

سروربه‌سرور کامل

هرچند امکان ارسال رویدادها به Google Analytics صرفاً با Data Manager API وجود دارد، اما ممکن است فقط گزارش‌دهی جزئی دردسترس باشد. هدف Data Manager API تقویت رویدادهای موجود است که بااستفاده از gtag،‏ Tag Manager، یا Firebase جمع‌آوری شده‌اند. برخی‌از نام‌های رویداد و پارامتر برای استفاده ازطریق جمع‌آوری خودکار رزرو شده‌اند و نمی‌توان آن‌ها را ازطریق Data Manager API ارسال کرد.

تولید یا تغییر نام رویدادها

رویدادهای ارسال‌شده با Data Manager API قوانین مربوط به تولید یا تغییر نام رویدادها را فعال نمی‌کنند. برنامه شما باید منطق ارسال رویدادهای سفارشی را ازطریق Data Manager API پیاده‌سازی کند، مشابه قوانینی که در واسط کاربری Google Analytics پیکربندی شده‌اند.

بعدی
ارسال رویدادها