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

از «میانای برنامه‌سازی کاربردی مدیر داده» برای ارسال توصیه‌های Google Analytics و رویدادهای سفارشی استفاده کنید.

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

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

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

برای ارسال داده‌های رویداد با «میانای برنامه‌سازی کاربردی مدیر داده»، مراحل زیر را تکمیل کنید:

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

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

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

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

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

نکته کلیدی: هدف «میانای برنامه‌سازی کاربردی مدیر داده» این است که جمع‌آوری خودکار را ازطریق gtag،‏ Tag Manager، و Google Analytics برای Firebase تقویت کند، نه اینکه جایگزین آن شود.

در اینجا چند مورد استفاده برای ارسال رویدادهای سفارشی و توصیه‌شده با 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 رویدادهای «میانای برنامه‌سازی کاربردی مدیر داده» را با تعاملات آنلاین بااستفاده از clientId یا appInstanceId ترکیب می‌کند تا تنظیمات حریم خصوصی کاربر مثل «آگهی‌های غیرشخصی‌سازی‌شده» و «محدود کردن ردگیری آگهی» را اتخاذ کند.

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

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

‫Google Analytics به‌طور خودکار جدیدترین اطلاعات جغرافیایی و دستگاه را از برچسب‌گذاری با رویدادهای «میانای برنامه‌سازی کاربردی مدیر داده» بااستفاده از clientId یا appInstanceId اضافه می‌کند. این کار باعث می‌شود رویدادهای 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 UI.