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

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

যাচাইকরণ

ডেটা ম্যানেজার API-এর জন্য api_secret-এর পরিবর্তে OAuth ক্রেডেনশিয়াল প্রয়োজন। ডেটা ম্যানেজার API স্কোপ অন্তর্ভুক্ত করে এমন নতুন ক্রেডেনশিয়াল তৈরি করতে API অ্যাক্সেস সেট-আপ করুন বিকল্পে গিয়ে ধাপগুলি অনুসরণ করুন।

অনুরোধের ফিল্ড

/mp/collect অনুরোধ (পরিমাপের প্রোটোকল) IngestEventsRequest (ডেটা ম্যানেজার API) নোট
measurement_id (কোয়েরি প্যারামিটার) destinations ওয়েব ইভেন্টের জন্য product_destination_id-এ ম্যাপ করুন। আরও বিবরণের জন্য গন্তব্য ফিল্ড দেখুন।
firebase_app_id (কোয়েরি প্যারামিটার) destinations অ্যাপ ইভেন্টের জন্য product_destination_id-এ ম্যাপ করুন। আরও বিবরণের জন্য গন্তব্য ফিল্ড দেখুন।
api_secret (কোয়েরি প্যারামিটার) সমতুল্য কিছু নেই ডেটা ম্যানেজার API-তে কীভাবে অনুরোধ যাচাই করতে হয় তা জানতে 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-এ, এটি অনুরোধ লেভেলে বা কোনও স্বতন্ত্র ইভেন্টের জন্য প্রদান করা যেতে পারে। Data Manager API-তে অনুরোধ লেভেল টাইমস্ট্যাম্প নেই। প্রতিটি ইভেন্টের জন্য event_timestamp-কে ইভেন্ট ঘটার সময় হিসেবে সেট করুন।
  • JSON ফর্ম্যাট ব্যবহার করলে, RFC 3339 ফর্ম্যাটে ভ্যালু সেট করুন।
  • প্রোটোকল বাফার ব্যবহার করলে, Timestamp ব্যবহার করুন এবং seconds এবং (ঐচ্ছিক) nanoseconds ফিল্ড সেট করুন।

আরও বিবরণের জন্য টাইমস্ট্যাম্প ফর্ম্যাট দেখুন।
user_properties events.user_properties

UserProperties অবজেক্টে সেট করুন। ব্যবহারকারীর ধরন বা ভ্যালু বাকেট পাঠালে, UserProperties-এর যথাক্রমে customer_type বা customer_value_bucket ফিল্ড ব্যবহার করুন। অন্যান্য ব্যবহারকারীর প্রপার্টির জন্য, একটি আলাদা UserProperty অবজেক্ট তৈরি করুন, এটির property_name এবং value ফিল্ড সেট করুন এবং এটি additional_user_properties তালিকায় যোগ করুন।

ডেটা ম্যানেজার API-তে প্রত্যেক ব্যবহারকারীর প্রপার্টির জন্য টাইমস্ট্যাম্প সেট করার সুবিধা নেই। ব্যবহারকারীর প্রপার্টিতে করা পরিবর্তনের সাথে যুক্ত টাইমস্ট্যাম্প ইভেন্টের (event_timestamp) টাইমস্ট্যাম্প থেকে অনুমান করা হয়।
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-এ সেট করুন।
সমতুল্য কিছু নেই encoding UserData আপলোডের জন্য প্রয়োজন। UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করুন।

ডেস্টিনেশন ফিল্ড

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

ডেটা ম্যানেজার API, ডেটা কোথায় পাঠাতে হবে তা নির্দিষ্ট করতে Destination অবজেক্ট ব্যবহার করে। গন্তব্য সম্পর্কে আরও তথ্যের জন্য গন্তব্য কনফিগার করুন বিকল্পটি চেক করুন।

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

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

ইভেন্টের ফিল্ড

Measurement Protocol events[] Event (ডেটা ম্যানেজার API) নোট
name event_name event_name যদি রিজার্ভ করা নাম ব্যবহার করে, তাহলে API INVALID_EVENT_NAME সমস্যার সাথে ইভেন্টটি বাতিল করে দেয়।
সমতুল্য কিছু নেই event_source ইভেন্টটি কোনও ওয়েব ব্রাউজার থেকে তৈরি করা হলে WEB-এ সেট করুন এবং ইভেন্টটি কোনও অ্যাপ থেকে তৈরি করা হলে APP-এ সেট করুন।
সমতুল্য কিছু নেই destination_references অনুরোধ-লেভেল destinations তালিকায় একাধিক Google Analytics 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 Measurement Protocol-এ, customer_type প্যারামিটারকে ইভেন্ট প্যারামিটার হিসেবে সেট করা হয়। ডেটা ম্যানেজার API-তে, ইভেন্টের UserProperties অবজেক্টের customer_type ফিল্ডে এটি সেট করুন।
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

parameter_name এবং value সহ অবজেক্টের তালিকা হিসেবে অন্যান্য প্যারামিটার ম্যাপ করুন।

মনে রাখবেন: এখানে transaction_id, currency বা value-এর জন্য এন্ট্রি যোগ করবেন না; পরিবর্তে Event-এর টপ-লেভেল ফিল্ড ব্যবহার করুন।

ইউজার আইডেন্টিফায়ার ফিল্ড

Measurement Protocol user_data UserIdentifier (ডেটা ম্যানেজার 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 (ডেটা ম্যানেজার API) নোট
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 (ডেটা ম্যানেজার 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 (ডেটা ম্যানেজার API) নোট
category category
language language_code
screen_resolution screen_height ও screen_width Measurement Protocol-এ, screen_resolution স্ট্রিং ("1280x720") হিসেবে প্রদান করা হয়। ডেটা ম্যানেজার 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
পূর্ববর্তী
আপগ্রেড করার ধাপ