از نگاشت‌های موجود در جدول‌ها برای نگاشت کردن درخواست (/mp/collect) جمع‌آوری داده‌های Measurement Protocol به معادل آن در Data Manager API (IngestEventsRequest) استفاده کنید.
اصالت‌سنجی
«میانای برنامه‌سازی کاربردی مدیر داده» به‌جای api_secret به اعتبارنامه‌های OAuth نیاز دارد. مراحل راه‌اندازی دسترسی به میانای برنامه‌سازی کاربردی را دنبال کنید تا
اعتبارنامه جدیدی تولید کنید که شامل حوزه Data Manager API باشد.
فیلدهای درخواست
/mp/collect درخواست (پروتکل اندازه‌گیری) |
IngestEventsRequest (Data Manager API) |
یادداشت‌ها |
|---|---|---|
measurement_id (پارامتر پُرسمان) |
destinations |
نقشه product_destination_id برای رویدادهای وب. برای جزئیات، فیلدهای مقصد را ببینید. |
firebase_app_id (پارامتر پُرسمان) |
destinations |
برای رویدادهای برنامه، به product_destination_id نگاشت کنید. برای جزئیات، فیلدهای مقصد را ببینید. |
api_secret (پارامتر پُرسمان) |
بدون معادل | برای آشنایی با نحوه اصالت‌سنجی کردن درخواست‌ها در Data Manager API، به راه‌اندازی کردن دسترسی به میانای برنامه‌سازی کاربردی مراجعه کنید |
consent |
consent |
روی شیء Consent تنظیم کنید. |
events |
events |
به فهرستی از منابع Event تنظیم شده است. برای جزئیات، بخش فیلدهای رویداد را ببینید. |
client_id |
events.client_id |
برای رویدادهای وب الزامی است. |
app_instance_id |
events.app_instance_id |
برای رویدادهای برنامه الزامی است. |
user_id |
events.user_id |
اختیاری. شناسه یکتا برای کاربر. |
timestamp_micros |
events.event_timestamp |
در Measurement Protocol، این اطلاعات را می‌توان در سطح درخواست یا برای یک رویداد خاص ارائه کرد. در «میانای برنامه‌سازی کاربردی مدیر داده»، مُهر زمان سطح درخواست وجود ندارد. event_timestamp را در هر رویداد روی زمانی که رویداد رخ داده است تنظیم کنید.
برای جزئیات، قالب مُهر زمان را ببینید. |
user_properties |
events.user_properties |
روی شیء «میانای برنامه‌سازی کاربردی مدیر داده» از تنظیم مُهر زمان برای دارایی‌های کاربر فردی پشتیبانی نمی‌کند. مُهرهای زمان مرتبط با تغییرات ویژگی‌های کاربر از مُهر زمان رویداد ( |
user_data |
events.user_data |
روی شیء UserData تنظیم شده است. برای جزئیات، فیلدهای شناسه کاربر را ببینید. |
non_personalized_ads |
events.consent.ad_personalization |
اگر non_personalized_ads برابر با true است، ad_personalization را روی CONSENT_DENIED تنظیم کن. |
user_location |
events.event_location |
برای جزئیات بیشتر، فیلدهای مکان کاربر را ببینید. |
ip_override |
events.event_device_info.ip_address |
|
device |
events.event_device_info |
برای جزئیات، فیلدهای دستگاه را ببینید. |
user_agent |
events.event_device_info.user_agent |
|
validation_behavior |
بدون معادل | از تشخیص خرابی برای بازیابی وضعیت بارگذاری و همچنین خطاها و هشدارهای مربوط به رویدادهای فردی درطول پردازش پایین‌دستی استفاده کنید. اگر IngestEventsRequest ناموفق باشد (برای مثال، به‌دلیل نبود فیلدهای الزامی)، هیچ رویدادی پردازش نمی‌شود و باید خطا را برطرف کنید و درخواست را دوباره امتحان کنید. برای اطلاعات بیشتر، به درک خطاهای API مراجعه کنید. |
/debug/mp/collect |
validate_only |
validate_only را روی true تنظیم کنید تا رویدادها را بدون دریافت هیچ داده‌ای اعتبارسنجی کنید، مشابه سرور اعتبارسنجی Measurement Protocol. |
| معادل ندارد | encoding |
برای بارگذاری UserData الزامی است. روی Encoding استفاده‌شده برای مقادیر UserIdentifier تنظیم کنید. |
فیلدهای مقصد
Measurement Protocol رویدادها را مستقیماً بااستفاده از پارامتر پُرسمان
measurement_id یا firebase_app_id به یک جریان داده خاص ارسال می‌کند.
Data Manager API از شیء Destination برای مشخص کردن مقصد ارسال داده‌ها استفاده می‌کند.
برای اطلاعات بیشتر درباره مقصدها،
پیکربندی مقصدها را بررسی کنید.
در اینجا نحوه نگاشت فیلدهای Measurement Protocol به فیلدهای معادل در Destination آورده شده است:
| Measurement Protocol | Destination (Data Manager API) |
یادداشت‌ها |
|---|---|---|
measurement_id (پارامتر پُرسمان) |
product_destination_id |
روی شناسه سنجش جریان داده‌های وب Google Analytics تنظیم شده است |
firebase_app_id (پارامتر پُرسمان) |
product_destination_id |
روی «شناسه برنامه Firebase» مربوط به جریان داده‌های برنامه Google Analytics تنظیم شده است |
| معادل ندارد | operating_account |
account_id را روی شناسه دارایی Google Analytics تنظیم کنید. account_type را روی GOOGLE_ANALYTICS_PROPERTY تنظیم کنید. |
| بدون معادل | login_account |
account_id را روی شناسه دارایی Google Analytics تنظیم کنید. account_type را روی GOOGLE_ANALYTICS_PROPERTY تنظیم کنید. |
فیلدهای رویداد
Measurement Protocol events[] |
Event (Data Manager API) |
یادداشت‌ها |
|---|---|---|
name |
event_name |
اگر event_name از نام رزروشده استفاده کند، API رویداد را با خطای INVALID_EVENT_NAME رد می‌کند. |
| بدون معادل | event_source |
اگر رویداد از مرورگر وب تولید شده است، روی WEB تنظیم کنید و اگر رویداد از برنامه تولید شده است، روی APP تنظیم کنید. |
| بدون معادل | destination_references |
اگر فهرست destinations سطح درخواست حاوی بیش‌از یک Google Analytics Destination باشد، الزامی است. ورودی‌ای اضافه کنید تا مشخص شود کدام مقصد باید رویداد را دریافت کند. |
timestamp_micros |
event_timestamp |
برای جزئیات، قالب مُهر زمان را ببینید. |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
در Measurement Protocol، پارامتر customer_type به‌عنوان پارامتر رویداد تنظیم شده است. در Data Manager API، آن را در فیلد customer_type در شیء UserProperties در رویداد تنظیم کنید. |
params.transaction_id |
transaction_id |
برای برخی‌از رویدادها و موارد استفاده الزامی است. برای جزئیات بیشتر، به تبدیل داده‌ها به اشیاء Event مراجعه کنید. |
params.items |
cart_data.items |
برای جزئیات، فیلدهای مورد برای داده‌های سبد خرید را ببینید. |
params.coupon |
cart_data.coupon_codes |
از فیلد coupon_codes برای ارائه کوپن‌هایی که روی سبد خرید اعمال شده‌اند استفاده کنید. فقط یک کوپن برای Google Analytics ارائه دهید. این مستقل از کوپن‌های سطح Item است که می‌توان آن‌ها را بااستفاده از cart_data.items.additional_item_parameters برای محصولات تکی تنظیم کرد. |
params.session_id |
additional_event_parameters |
به ورودی‌ای با parameter_name تنظیم‌شده روی session_id نگاشت کنید. |
params.engagement_time_msec |
additional_event_parameters |
نگاشت به ورودی‌ای که parameter_name آن روی engagement_time_msec تنظیم شده است. |
params دیگر |
additional_event_parameters |
پارامترهای دیگر را به‌عنوان فهرستی از اشیاء با |
فیلدهای شناسه کاربر
Measurement Protocol user_data |
UserIdentifier (Data Manager API) |
یادداشت‌ها |
|---|---|---|
sha256_email_address[] |
email_address |
روی نشانی ایمیل قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم شود. همچنین می‌توانید نشانی ایمیل درهم‌سازی‌شده را رمزگذاری کنید. |
sha256_phone_number[] |
phone_number |
روی شماره تلفن قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم کنید. همچنین می‌توانید شماره تلفن درهم‌سازی‌شده را رمزگذاری کنید. |
address[] |
address |
روی شیء AddressInfo تنظیم شده است. دستورالعمل‌های قالب‌بندی و درهم‌سازی را دنبال کنید. |
address[].sha256_first_name |
address.given_name |
روی نام قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم شده است. همچنین می‌توانید نام داده‌شده درهم‌سازی‌شده را رمزگذاری کنید. |
address[].sha256_last_name |
address.family_name |
روی نام خانوادگی قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم شده است. همچنین می‌توانید نام خانوادگی درهم‌سازی‌شده را رمزگذاری کنید. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
address.city |
روی شهر استاندارد تنظیم شده است. این فیلد درهم‌سازی نشود. |
address[].region |
address.administrative_area |
روی تقسیمات کشوری (ایالت یا استان) نرمال‌شده تنظیم شده است. این فیلد را درهم‌سازی نکنید. |
address[].sha256_street |
address.address_line |
روی نشانی خیابان قالب‌بندی‌شده و درهم‌سازی‌شده تنظیم شود. همچنین می‌توانید نشانی خیابان درهم‌سازی‌شده را رمزگذاری کنید. |
فیلدهای مورد برای داده‌های سبد خرید
Measurement Protocol items[] |
Item (Data Manager API) |
یادداشت‌ها |
|---|---|---|
item_id |
item_id |
الزامی. |
item_name |
additional_item_parameters |
نگاشت به ورودی‌ای که parameter_name آن روی item_name تنظیم شده است. |
quantity |
quantity |
الزامی. |
price |
unit_price |
الزامی. |
| فیلدهای دیگر مورد | additional_item_parameters |
سایر پارامترهای مورد (مانند |
فیلدهای مکان کاربر
Measurement Protocol user_location |
EventLocation (Data Manager API) |
یادداشت‌ها |
|---|---|---|
city |
city |
نام شهری که رویداد در آن رخ داده است. |
country_id |
region_code |
روی کد منطقه CLDR دوحرفی تنظیم کنید. |
region_id |
subdivision_code |
روی کد بخش ISO 3166-2 تنظیم کنید. |
continent_id |
continent_code |
روی کد قاره در قالب UN M49 تنظیم کنید. |
subcontinent_id |
subcontinent_code |
روی کد شبه‌قاره در قالب UN M49 تنظیم شده است. |
فیلدهای دستگاه
Measurement Protocol device |
DeviceInfo (Data Manager API) |
یادداشت‌ها |
|---|---|---|
category |
category |
|
language |
language_code |
|
screen_resolution |
screen_height و screen_width |
در Measurement Protocol، screen_resolution به‌صورت رشته ("1280x720") ارائه می‌شود. در Data Manager API، screen_height و screen_width را به‌عنوان مقادیر عدد صحیح جداگانه ارسال کنید. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |