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

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

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

اگر از پروتکل اندازه‌گیری Google Analytics ارتقا می‌دهید، برای دریافت دستورالعمل‌ها، ارتقا از پروتکل اندازه‌گیری به 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 تقویت جمع‌آوری خودکار ازطریق gtag،‏ Tag Manager، و Google Analytics for 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 رویدادهای 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 پیکربندی شده است.