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

Google Ads API-তে একটি UploadClickConversionRequest-কে ডেটা ম্যানেজার API-তে এর IngestEventsRequest সমতুল্য ম্যাপ করতে টেবিলে ম্যাপিং ব্যবহার করুন।

যাচাইকরণ

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

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

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (ডেটা ম্যানেজার API)	নোট
customer_id developer-token রিকোয়েস্ট হেডার login-customer_id রিকোয়েস্ট হেডার linked-customer-id রিকোয়েস্ট হেডার conversion_action	destinations	গ্রাহক ও কনভার্সন অ্যাকশন ফিল্ড দেখুন।
সমতুল্য কিছু নেই	consent	অনুরোধে ইভেন্টের জন্য ঐচ্ছিক ডিফল্ট সম্মতি সেটিংস। আপনি Event-এর consent ফিল্ড সেট করে কোনও নির্দিষ্ট ইভেন্টের জন্য এই ভ্যালু ওভাররাইড করতে পারবেন।
সমতুল্য কিছু নেই	encoding	প্রয়োজনীয়: UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করুন।
সমতুল্য কিছু নেই	encryption_info	অনুরোধে এনক্রিপ্ট করা ভ্যালু থাকলে সেট করুন। আরও বিবরণের জন্য এনক্রিপশন দেখুন।
job_id	সমতুল্য কিছু নেই	ডায়াগনস্টিক ফিরিয়ে আনতে উত্তরে পাওয়া request_id ব্যবহার করুন।
partial_failure	সমতুল্য কিছু নেই	ডেটা ম্যানেজার API ফাস্ট-ফেল এরর মডেল ব্যবহার করে। IngestEventsRequest-এর কোনও ফিল্ড যাচাইকরণে ব্যর্থ হলে, ডেটা ম্যানেজার API সম্পূর্ণ অনুরোধ বাতিল করে দেয়।
validate_only	validate_only
conversions	events	কনভার্সন বা ইভেন্টের তালিকা। বিস্তারিত জানতে কনভার্সন ফিল্ড বিভাগ দেখুন।

গ্রাহক এবং কনভার্সন অ্যাকশন ফিল্ড

Google Ads API-এর জন্য developer-token রিকোয়েস্ট হেডার প্রয়োজন এবং আপনি বিভিন্ন যাচাইকরণ পরিস্থিতির জন্য login-customer-id এবং linked-customer-id রিকোয়েস্ট হেডার সেট করেন।

ডেটা ম্যানেজার API-এর জন্য কোনও ডেভেলপার টোকেনের প্রয়োজন হয় না এবং আপনি রিকোয়েস্ট হেডারের পরিবর্তে Destination-এর ফিল্ড ব্যবহার করে লগইন এবং লিঙ্ক করা গ্রাহকের তথ্য উল্লেখ করেন। গন্তব্য সম্পর্কে আরও তথ্য পেতে গন্তব্য কনফিগার করুন বিকল্পটি চেক করুন।

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

Google Ads API	Destination (ডেটা ম্যানেজার API)	নোট
অনুরোধের customer_id	operating_account	account_id-কে Google Ads কনভার্সন অ্যাকাউন্ট-এর কাস্টমার আইডি হিসেবে সেট করুন। এটি আপনার Google Ads API অনুরোধে customer_id থেকে আলাদা হতে পারে। operating_account-এর account_type GOOGLE_ADS-এ সেট করুন।
developer-token রিকোয়েস্ট হেডার	সমতুল্য কিছু নেই	ডেটা ম্যানেজার API-এর জন্য ডেভেলপার টোকেনের প্রয়োজন নেই।
login-customer-id রিকোয়েস্ট হেডার	login_account	লগ-ইন অ্যাকাউন্টের কাস্টমার আইডিতে account_id সেট করুন। লগ-ইন অ্যাকাউন্টটি Google Ads অ্যাকাউন্ট হলে account_type-কে GOOGLE_ADS-এ সেট করুন অথবা লগ-ইন অ্যাকাউন্টটি ডেটা পার্টনার অ্যাকাউন্ট হলে DATA_PARTNER-এ সেট করুন।
linked-customer-id রিকোয়েস্ট হেডার	linked_account	আপনি যদি পার্টনার লিঙ্ক ব্যবহার করে operating_account অ্যাক্সেস করেন, তাহলে লিঙ্ক করা অ্যাকাউন্টের কাস্টমার আইডিতে account_id সেট করুন এবং account_type-কে DATA_PARTNER-এ সেট করুন। অন্যথায়, linked_account ফিল্ড সেট করবেন না।
ClickConversion-এর conversion_action	product_destination_id	কনভার্সন অ্যাকশনের সংখ্যাসূচক আইডিতে সেট করুন। ConversionAction-এর রিসোর্স নাম ব্যবহার করবেন না।
সমতুল্য কিছু নেই	reference	Destination-এর জন্য ব্যবহারকারীর দ্বারা নির্ধারিত শনাক্তকারী। আপনি একটি অনুরোধে একাধিক কনভার্সন অ্যাকশনের জন্য কনভার্সন পাঠালে এই ফিল্ড সেট করুন।

কনভার্সন ফিল্ড

ClickConversion (Google Ads API)	Event (ডেটা ম্যানেজার API)	নোট
cart_data	cart_data	আরও বিবরণের জন্য কার্ট ডেটা ফিল্ড দেখুন।
consent	consent	দুটি API-ই একই ধরনের Consent অবজেক্ট (ad_user_data, ad_personalization) ব্যবহার করে। ডেটা ম্যানেজার API-এর জন্য, আপনি অনুরোধ-লেভেল consent ফিল্ড সেট করে একটি অনুরোধে সব ইভেন্টের জন্য সম্মতি সেট করতে পারেন।
conversion_action	destination_references	একটি অনুরোধে একাধিক কনভার্সন অ্যাকশনের জন্য কনভার্সন পাঠালে, এই ফিল্ডটি গন্তব্যের সংশ্লিষ্ট reference-এ সেট করুন।
conversion_date_time	event_timestamp	JSON ফর্ম্যাট ব্যবহার করলে, RFC 3339 ফর্ম্যাটে একটি ভ্যালু সেট করুন, যা Google Ads API তারিখ ও সময় ফর্ম্যাট থেকে সামান্য আলাদা। প্রোটোকল বাফার ব্যবহার করলে, Timestamp ব্যবহার করুন এবং seconds ও (ঐচ্ছিক) nanoseconds ফিল্ড সেট করুন। আরও বিবরণের জন্য টাইমস্ট্যাম্প ফর্ম্যাট দেখুন।
conversion_environment	সমতুল্য কিছু নেই
conversion_value	conversion_value	কারেন্সি ভ্যালুতে সেট করুন, মাইক্রো ভ্যালুতে নয়। যেমন, $৫.২৩ কনভার্সন ভ্যালুর জন্য 5.23 ভ্যালু ব্যবহার করুন।
currency_code	currency
custom_variables	custom_variables	আরও বিবরণের জন্য কাস্টম ভেরিয়েবল ফিল্ড দেখুন।
customer_type	user_properties.customer_type	CustomerType enum-এ একটি ভ্যালুতে সেট করুন।
সমতুল্য কিছু নেই	event_source
সমতুল্য কিছু নেই	event_device_info
external_attribution_data	সমতুল্য কিছু নেই
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
সমতুল্য কিছু নেই	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	আরও বিবরণের জন্য সেশন অ্যাট্রিবিউট যোগ করুন দেখুন।
session_attributes_key_value_pairs	experimental_fields	আরও বিবরণের জন্য সেশন অ্যাট্রিবিউট যোগ করুন দেখুন।
user_identifiers	user_data.user_identifiers	বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ফিল্ড দেখুন।
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

কার্ট ডেটা ফিল্ড

CartData (Google Ads API)	CartData (ডেটা ম্যানেজার API)	নোট
feed_country_code	merchant_feed_label	ফিড লেবেল-এ সেট করুন।
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

কার্ট ডেটার জন্য আইটেম ফিল্ড

Item (Google Ads API)	Item (ডেটা ম্যানেজার API)	নোট
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
সমতুল্য কিছু নেই	item_id
সমতুল্য কিছু নেই	additional_item_parameters

কাস্টম ভেরিয়েবল ফিল্ড

CustomVariable (Google Ads API)	CustomVariable (ডেটা ম্যানেজার API)	নোট
সমতুল্য কিছু নেই	destination_references	Google Ads API-এর জন্য প্রতিটি কনভার্সন অ্যাকশনে আলাদা অনুরোধের প্রয়োজন হয়। ডেটা ম্যানেজার API একটি অনুরোধে একাধিক কনভার্সন অ্যাকশনের জন্য কনভার্সন পাঠানো এবং কোন ডেস্টিনেশনে নির্দিষ্ট কাস্টম ভেরিয়েবল পাঠানো উচিত তা নির্দেশ করতে এই destination_references ফিল্ড ব্যবহার করার সুবিধা প্রদান করে।
conversion_custom_variable	variable	রিসোর্সের নামের পরিবর্তে ভেরিয়েবলের নাম সেট করুন।
value	value

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

UserIdentifier (Google Ads API)	UserIdentifier (ডেটা ম্যানেজার API)
address_info	address	ফর্ম্যাটিং ও হ্যাশিং সংক্রান্ত নির্দেশিকা অনুসরণ করুন। এছাড়াও, আপনি কোনও ঠিকানার হ্যাশ করা অ্যাট্রিবিউট এনক্রিপ্ট করতে পারবেন।
hashed_email	email_address	ফর্ম্যাট করা ও হ্যাশ করা ইমেল আইডিতে সেট করুন। এছাড়াও, আপনি হ্যাশ করা ইমেল আইডি এনক্রিপ্ট করতে পারবেন।
hashed_phone_number	phone_number	ফর্ম্যাট ও হ্যাশ করা ফোন নম্বরে সেট করুন। এছাড়াও, আপনি হ্যাশ করা ফোন নম্বর এনক্রিপ্ট করতে পারবেন।
অন্যান্য ফিল্ড: mobile_id third_party_user_id user_identifier_source	প্রাসঙ্গিক নয়	কোনও API-ই অফলাইন কনভার্সন বা লিডের জন্য উন্নত কনভার্সনের ক্ষেত্রে এইসব শনাক্তকারীকে সাপোর্ট করে না, এবং অতিরিক্ত ডেটা সোর্স হিসেবে কনভার্সন ইভেন্ট পাঠানোর সময় ডেটা ম্যানেজার API এইসব শনাক্তকারীকে সাপোর্ট করে না।

উত্তর যোগ করার ফিল্ড

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (ডেটা ম্যানেজার API)	নোট
job_id	সমতুল্য কিছু নেই	ডায়াগনস্টিক ফিরিয়ে আনতে উত্তরে পাওয়া request_id ব্যবহার করুন।
partial_failure_error	সমতুল্য কিছু নেই	ডেটা ম্যানেজার API ফাস্ট-ফেল এরর মডেল ব্যবহার করে। IngestEventsRequest-এর কোনও ফিল্ড যাচাইকরণে ব্যর্থ হলে, ডেটা ম্যানেজার API সম্পূর্ণ অনুরোধ বাতিল করে দেয়।
request-id রেসপন্স হেডার	request_id	অনুরোধ আইডি, রেসপন্স হেডারের পরিবর্তে ডেটা ম্যানেজার API-তে রেসপন্স ফিল্ড হিসেবে ফেরত পাঠানো হয়।
results	সমতুল্য কিছু নেই	ডেটা ম্যানেজার API অ্যাসিঙ্ক্রোনাসভাবে ইভেন্ট প্রসেস করে। ডায়াগনস্টিক ব্যবহার করে প্রসেসিং ফলাফল চেক করুন।