ফিল্ড ম্যাপিং

টেবিলগুলিতে থাকা ম্যাপিংগুলি ব্যবহার করে একটি মেজারমেন্ট প্রোটোকল ডেটা সংগ্রহের অনুরোধকে ( /mp/collect ) ডেটা ম্যানেজার এপিআই-তে থাকা এর সমতুল্য IngestEventsRequest এর সাথে ম্যাপ করুন।

অনুরোধ ক্ষেত্র

/mp/collect request (পরিমাপ প্রোটোকল)	IngestEventsRequest (ডেটা ম্যানেজার এপিআই)	নোট
measurement_id (কোয়েরি প্যারামিটার)	destinations	ওয়েব ইভেন্টগুলোর জন্য product_destination_id এর সাথে ম্যাপ করুন। বিস্তারিত জানতে Destination ফিল্ডগুলো দেখুন।
firebase_app_id (কোয়েরি প্যারামিটার)	destinations	অ্যাপ ইভেন্টগুলোর জন্য product_destination_id এর সাথে ম্যাপ করুন। বিস্তারিত জানতে Destination ফিল্ডগুলো দেখুন।
api_secret (কোয়েরি প্যারামিটার)	কোনো সমতুল্য নেই	ডেটা ম্যানেজার এপিআই-তে অনুরোধগুলি কীভাবে প্রমাণীকরণ করতে হয় তা জানতে 'এপিআই অ্যাক্সেস সেট আপ করুন' দেখুন।
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	মেজারমেন্ট প্রোটোকলে, এটি রিকোয়েস্ট লেভেলে অথবা কোনো স্বতন্ত্র ইভেন্টের জন্য প্রদান করা যেতে পারে। ডেটা ম্যানেজার এপিআই-তে রিকোয়েস্ট লেভেলের কোনো টাইমস্ট্যাম্প নেই। প্রতিটি ইভেন্টে ইভেন্ট ঘটার সময়ে event_timestamp সেট করুন। JSON ফরম্যাট ব্যবহার করলে, মানটি RFC 3339 ফরম্যাটে সেট করুন। প্রোটোকল বাফার ব্যবহার করলে, একটি Timestamp ব্যবহার করুন এবং seconds ও (ঐচ্ছিকভাবে) nanoseconds ফিল্ড সেট করুন। বিস্তারিত জানতে টাইমস্ট্যাম্প ফরম্যাট দেখুন।
user_properties	events.user_properties	একটি UserProperties অবজেক্টে সেট করা হয়। ডেটা ম্যানেজার এপিআই স্বতন্ত্র ইউজার প্রপার্টিজের জন্য টাইমস্ট্যাম্প সেট করা সমর্থন করে না। ইউজার প্রপার্টিজের পরিবর্তনের সাথে সম্পর্কিত টাইমস্ট্যাম্প ইভেন্টের টাইমস্ট্যাম্প ( event_timestamp ) থেকে অনুমান করা হয়।
user_data	events.user_data	একটি UserData অবজেক্টে সেট করা হয়। বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ফিল্ডগুলো দেখুন।
non_personalized_ads	events.consent.ad_personalization	যদি non_personalized_ads true হয়, তাহলে ad_personalization 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 ব্যর্থ হয় (উদাহরণস্বরূপ, প্রয়োজনীয় ফিল্ড অনুপস্থিত থাকার কারণে), তাহলে কোনো ইভেন্ট প্রক্রিয়া করা হবে না এবং আপনাকে ত্রুটিটি সমাধান করে অনুরোধটি পুনরায় চেষ্টা করতে হবে। আরও তথ্যের জন্য ‘এপিআই ত্রুটি বুঝুন’ দেখুন।
/debug/mp/collect	validate_only	মেজারমেন্ট প্রোটোকল ভ্যালিডেশন সার্ভারের মতো, কোনো ডেটা গ্রহণ না করেই ইভেন্টগুলো যাচাই করতে validate_only কে true তে সেট করুন।
কোনো সমতুল্য নেই	encoding	UserData আপলোডের জন্য আবশ্যক। UserIdentifier ​​মানগুলির জন্য ব্যবহৃত Encoding এ সেট করুন।

গন্তব্য ক্ষেত্র

মেজারমেন্ট প্রোটোকল measurement_id বা firebase_app_id কোয়েরি প্যারামিটার ব্যবহার করে সরাসরি একটি নির্দিষ্ট ডেটা স্ট্রিমে ইভেন্ট পাঠায়।

ডেটা ম্যানেজার এপিআই ডেটা কোথায় পাঠাতে হবে তা নির্দিষ্ট করার জন্য একটি Destination অবজেক্ট ব্যবহার করে। ডেস্টিনেশন সম্পর্কে আরও তথ্যের জন্য ‘কনফিগার ডেস্টিনেশন’ দেখুন।

মেজারমেন্ট প্রোটোকল ফিল্ডগুলিকে একটি Destination সমতুল্য ফিল্ডগুলির সাথে কীভাবে ম্যাপ করতে হয় তা এখানে দেওয়া হল:

পরিমাপ প্রোটোকল	Destination (ডেটা ম্যানেজার এপিআই)	নোট
measurement_id (কোয়েরি প্যারামিটার)	product_destination_id	গুগল অ্যানালিটিক্স ওয়েব ডেটা স্ট্রিমের মেজারমেন্ট আইডিতে সেট করুন।
firebase_app_id (কোয়েরি প্যারামিটার)	product_destination_id	Google Analytics অ্যাপ ডেটা স্ট্রিমের Firebase অ্যাপ আইডিতে সেট করুন।
কোনো সমতুল্য নেই	operating_account	account_id Google Analytics প্রপার্টি ID-তে সেট করুন। account_type GOOGLE_ANALYTICS_PROPERTY তে সেট করুন।
কোনো সমতুল্য নেই	login_account	account_id Google Analytics প্রপার্টি ID-তে সেট করুন। account_type GOOGLE_ANALYTICS_PROPERTY তে সেট করুন।

ইভেন্ট ক্ষেত্র

পরিমাপ প্রোটোকল events[]	Event (ডেটা ম্যানেজার এপিআই)	নোট
name	event_name	যদি event_name কোনো সংরক্ষিত নাম ব্যবহার করে, তাহলে API একটি INVALID_EVENT_NAME ত্রুটি দেখিয়ে ইভেন্টটি প্রত্যাখ্যান করে।
কোনো সমতুল্য নেই	event_source	ইভেন্টটি ওয়েব ব্রাউজার থেকে তৈরি হলে WEB এ সেট করুন, এবং কোনো অ্যাপ থেকে তৈরি হলে APP সেট করুন।
কোনো সমতুল্য নেই	destination_references	অনুরোধ-স্তরের destinations তালিকায় একাধিক গুগল অ্যানালিটিক্স Destination থাকলে এটি আবশ্যক। কোন গন্তব্যটি ইভেন্টটি পাবে তা নির্দিষ্ট করতে একটি এন্ট্রি যোগ করুন।
timestamp_micros	event_timestamp	JSON ফরম্যাট ব্যবহার করলে, মানটি RFC 3339 ফরম্যাটে সেট করুন। প্রোটোকল বাফার ব্যবহার করলে, একটি Timestamp ব্যবহার করুন এবং seconds ও (ঐচ্ছিকভাবে) nanoseconds ফিল্ড সেট করুন। বিস্তারিত জানতে টাইমস্ট্যাম্প ফরম্যাট দেখুন।
params.currency	currency
params.value	conversion_value
params.customer_type	user_properties.customer_type	মেজারমেন্ট প্রোটোকল-এ, ` customer_type প্যারামিটারটি একটি ইভেন্ট প্যারামিটার হিসেবে সেট করা হয়। ডেটা ম্যানেজার এপিআই-তে, ইভেন্টের UserProperties অবজেক্টের customer_type ফিল্ডে এটি সেট করুন।
params.transaction_id	transaction_id	কিছু ইভেন্ট এবং ব্যবহারের ক্ষেত্রে এটি প্রয়োজন । আরও বিস্তারিত জানতে ‘ডেটা Event অবজেক্টে রূপান্তর করুন’ দেখুন।
params.items	cart_data.items	বিস্তারিত জানতে কার্টের তথ্যের জন্য আইটেম ফিল্ডগুলো দেখুন।
params.coupon	cart_data.coupon_codes	কার্টে প্রয়োগ করা কুপনগুলো প্রদান করতে coupon_codes ফিল্ডটি ব্যবহার করুন। গুগল অ্যানালিটিক্সের জন্য শুধুমাত্র একটি কুপন প্রদান করুন। এটি 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	অন্যান্য প্যারামিটারগুলোকে parameter_name এবং value সহ অবজেক্টের একটি তালিকা হিসাবে ম্যাপ করুন। দ্রষ্টব্য: এখানে transaction_id , currency , বা value এর জন্য এন্ট্রি যোগ করবেন না; এর পরিবর্তে Event এর শীর্ষ-স্তরের ফিল্ডগুলো ব্যবহার করুন।

ব্যবহারকারী শনাক্তকারী ক্ষেত্র

Measurement Protocol user_data	UserIdentifier (ডেটা ম্যানেজার এপিআই)	নোট
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[].region	কোনো সমতুল্য নেই	ডেটা ম্যানেজার এপিআই-এর বর্তমান সংস্করণে এটি সমর্থিত নয়।
address[].sha256_street	কোনো সমতুল্য নেই	ডেটা ম্যানেজার এপিআই-এর বর্তমান সংস্করণে এটি সমর্থিত নয়।

কার্ট ডেটার জন্য আইটেম ক্ষেত্র

পরিমাপ প্রোটোকল items[]	Item (ডেটা ম্যানেজার এপিআই)	নোট
item_id	item_id	প্রয়োজনীয়।
item_name	additional_item_parameters	এমন একটি এন্ট্রিতে ম্যাপ করুন যেখানে parameter_name item_name এ সেট করা হয়েছে।
quantity	quantity	প্রয়োজনীয়।
price	unit_price	প্রয়োজনীয়।
অন্যান্য আইটেম ক্ষেত্র	additional_item_parameters	অন্যান্য আইটেম প্যারামিটারগুলোকে (যেমন discount , affiliation , item_brand , ইত্যাদি) parameter_name এবং value সহ অবজেক্টের একটি তালিকা হিসাবে ম্যাপ করুন। দ্রষ্টব্য: এখানে quantity , price , বা item_id জন্য এন্ট্রি যোগ করবেন না; এর পরিবর্তে Item এর টপ-লেভেল ফিল্ডগুলো ব্যবহার করুন।

ব্যবহারকারীর অবস্থান ক্ষেত্রগুলি

Measurement Protocol user_location	EventLocation (ডেটা ম্যানেজার এপিআই)	নোট
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 (ডেটা ম্যানেজার এপিআই)	নোট
category	category
language	language_code
screen_resolution	screen_height এবং screen_width	মেজারমেন্ট প্রোটোকলে, screen_resolution একটি স্ট্রিং হিসেবে ( "1280x720" ) প্রদান করা হয়। ডেটা ম্যানেজার এপিআই-তে, screen_height এবং screen_width আলাদা পূর্ণসংখ্যা হিসেবে পাঠান।
operating_system	operating_system
operating_system_version	operating_system_version
model	model
brand	brand
browser	browser
browser_version	browser_version