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

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

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

UploadClickConversionRequest (গুগল অ্যাডস এপিআই)	IngestEventsRequest (ডেটা ম্যানেজার এপিআই)	নোট
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	কোনো সমতুল্য নেই	ডেটা ম্যানেজার এপিআই আংশিক ব্যর্থতা সমর্থন করে না। যদি কোনো IngestEventsRequest এর কোনো ফিল্ড ভ্যালিডেশনে ব্যর্থ হয়, তাহলে ডেটা ম্যানেজার এপিআই সম্পূর্ণ অনুরোধটি প্রত্যাখ্যান করে।
validate_only	validate_only
conversions	events	রূপান্তর বা ঘটনাগুলোর তালিকা। বিস্তারিত জানতে রূপান্তর ক্ষেত্র বিভাগটি দেখুন।

গ্রাহক এবং রূপান্তর কর্ম ক্ষেত্র

গুগল অ্যাডস এপিআই-এর জন্য developer-token রিকোয়েস্ট হেডার প্রয়োজন হয়, এবং বিভিন্ন অথেনটিকেশন সিনারিওর জন্য আপনি login-customer-id ও linked-customer-id রিকোয়েস্ট হেডার সেট করেন।

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

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

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

রূপান্তর ক্ষেত্র

ClickConversion (গুগল অ্যাডস এপিআই)	Event (ডেটা ম্যানেজার এপিআই)	নোট
cart_data	cart_data	বিস্তারিত জানতে কার্ট ডেটা ফিল্ডগুলো দেখুন।
consent	consent	উভয় API-ই একটি অনুরূপ Consent অবজেক্ট ( ad_user_data , ad_personalization ) ব্যবহার করে। ডেটা ম্যানেজার এপিআই-এর ক্ষেত্রে, আপনি রিকোয়েস্ট-লেভেল 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 রূপান্তর মানের জন্য, 5.23 মানটি ব্যবহার করুন।
currency_code	currency
custom_variables	custom_variables	বিস্তারিত জানতে কাস্টম ভেরিয়েবল ফিল্ডগুলো দেখুন।
customer_type
কোনো সমতুল্য নেই	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 (গুগল অ্যাডস এপিআই)	CartData (ডেটা ম্যানেজার এপিআই)	নোট
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 (গুগল অ্যাডস এপিআই)	Item (ডেটা ম্যানেজার এপিআই)	নোট
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
কোনো সমতুল্য নেই	item_id
কোনো সমতুল্য নেই	additional_item_parameters

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

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

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

পরামর্শ: ডেটা ম্যানেজার এপিআই-তে, একটি UserData অবজেক্টে ইউজার আইডেন্টিফায়ার যোগ করুন, তারপর Event এর user_data ফিল্ডটি সেট করুন। গুগল অ্যাডস এপিআই-তে, ইউজার আইডেন্টিফায়ারগুলো সরাসরি ClickConversion এর user_identifiers ফিল্ডে যোগ করা হয়।

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

প্রতিক্রিয়া ক্ষেত্র

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