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

Google Ads API পদ্ধতি ও ফিল্ডকে ডেটা ম্যানেজার API-তে সেগুলির IngestEventsRequest সমতুল্য পদ্ধতি ও ফিল্ডের সাথে ম্যাপ করতে, টেবিলে দেওয়া ম্যাপিং ব্যবহার করুন।

যাচাইকরণ

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

API পদ্ধতি

ডেটা ম্যানেজার API আপনাকে একটি IngestEventsRequest-এ স্টোর সেলস ইভেন্টের প্রতিটি ব্যাচ আপলোড করতে দেয়।

এর বিপরীতে, Google Ads API-এর জন্য OfflineUserDataJobService ব্যবহার করে তিন-ধাপের প্রসেস প্রয়োজন:

1. CreateOfflineUserDataJob ব্যবহার করে একটি কাজ তৈরি করুন
2. AddOfflineUserDataJobOperations ব্যবহার করে কাজে অপারেশন যোগ করুন
3. RunOfflineUserDataJob ব্যবহার করে জব রান করুন

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

প্রতিটি IngestEventsRequest-এর ক্ষেত্রে অনুরোধের সীমা প্রযোজ্য। আপনার AddOfflineUserDataJobOperations অনুরোধে অপারেশনের সংখ্যা এই সীমা অতিক্রম করলে, আপনাকে অবশ্যই এটি একাধিক ডেটা ম্যানেজার API ইনজেশন অনুরোধে বিভক্ত করতে হবে।

Google Ads API অনুরোধের ফিল্ড কীভাবে ডেটা ম্যানেজার API-তে ম্যাপ করা হয় তা এখানে দেওয়া হল।

CreateOfflineUserDataJobRequest

নিচের সারণীতে দেখানো হয়েছে যে কীভাবে CreateOfflineUserDataJobRequest-এর ফিল্ড IngestEventsRequest-এ ম্যাপ করা হয়।

CreateOfflineUserDataJobRequest (Google Ads API)	IngestEventsRequest (ডেটা ম্যানেজার API)	নোট
customer_id	destinations.operating_account	গ্রাহক ও কনভার্সন অ্যাকশন ফিল্ড দেখুন।
developer-token রিকোয়েস্ট হেডার login-customer_id রিকোয়েস্ট হেডার linked-customer-id রিকোয়েস্ট হেডার	destinations	গ্রাহক ও কনভার্সন অ্যাকশন ফিল্ড দেখুন।
job.status job.failure_reason	ডায়াগনস্টিকস	আপনার কনভার্সন আপলোড সম্পর্কে ডায়াগনস্টিক সংক্রান্ত তথ্য পেতে IngestEventsResponse-এ ফেরত আসা request_id ব্যবহার করুন।
job.id	request_id	আপনার কনভার্সন আপলোড সম্পর্কে ডায়াগনস্টিক সংক্রান্ত তথ্য পেতে IngestEventsResponse-এ ফেরত আসা request_id ব্যবহার করুন।
job.external_id	সমতুল্য কিছু নেই
job.type	সমতুল্য কিছু নেই
job.store_sales_metadata.third_party_metadata.partner_id	destinations.login_account	স্টোর সেলস কনভার্সন আপলোড করা ডেটা পার্টনারকে ডেস্টিনেশনের login_account দ্বারা শনাক্ত করা হবে। আরও বিবরণের জন্য ডেস্টিনেশন কনফিগার করুন দেখুন।
job.store_sales_metadata.third_party_metadata.advertiser_upload_date_time	সমতুল্য কিছু নেই
job.store_sales_metadata.third_party_metadata.valid_transaction_fraction	সমতুল্য কিছু নেই
job.store_sales_metadata.third_party_metadata.partner_match_fraction	সমতুল্য কিছু নেই
job.store_sales_metadata.third_party_metadata.partner_upload_fraction	সমতুল্য কিছু নেই
job.store_sales_metadata.third_party_metadata.bridge_map_version_id	সমতুল্য কিছু নেই
job.store_sales_metadata.loyalty_fraction	সমতুল্য কিছু নেই
job.store_sales_metadata.transaction_upload_fraction	সমতুল্য কিছু নেই
job.store_sales_metadata.custom_key	events[].custom_variables[].variable events[].cart_data.items[].custom_variables[].variable	ইভেন্ট লেভেলে CustomVariable-এর variable ফিল্ডে অথবা আইটেম লেভেলে ItemCustomVariable-এ ম্যাপ করুন।
enable_match_rate_range_preview	সমতুল্য কিছু নেই
validate_only	validate_only
সমতুল্য কিছু নেই	consent	Google Ads API শুধুমাত্র UserData-এ ইভেন্ট লেভেলে consent নির্দিষ্ট করার সুবিধা দেয়। ডেটা ম্যানেজার API-এর জন্য, আপনি IngestEventsRequest-এ consent ফিল্ড সেট করে অনুরোধে সব ইভেন্টের জন্য সম্মতি নির্দিষ্ট করতে পারেন। আপনি Event-এর consent ফিল্ড সেট করে কোনও একটি ইভেন্টের জন্য এই ভ্যালু ওভাররাইড করতে পারবেন।
সমতুল্য কিছু নেই	encoding	UserData আপলোডের জন্য প্রয়োজন। UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করুন।
সমতুল্য কিছু নেই	encryption_info	অনুরোধে এনক্রিপ্ট করা UserData ব্যবহারকারী শনাক্তকারী থাকলে সেট করুন। আরও বিবরণের জন্য এনক্রিপশন দেখুন।

AddOfflineUserDataJobOperationsRequest

নিচের সারণীতে দেখানো হয়েছে যে কীভাবে AddOfflineUserDataJobOperationsRequest-এর ফিল্ড IngestEventsRequest-এ ম্যাপ করা হয়।

AddOfflineUserDataJobOperationsRequest (Google Ads API)	IngestEventsRequest (ডেটা ম্যানেজার API)	নোট
developer-token রিকোয়েস্ট হেডার login-customer_id রিকোয়েস্ট হেডার linked-customer-id রিকোয়েস্ট হেডার	destinations	গ্রাহক ও কনভার্সন অ্যাকশন ফিল্ড দেখুন।
resource_name	সমতুল্য কিছু নেই	Data Manager API-এর জন্য কোনও জব রিসোর্স আপডেট করার প্রয়োজন নেই।
enable_partial_failure	সমতুল্য কিছু নেই	IngestEventsRequest সফল হলে, ডাউনস্ট্রিম প্রসেসিংয়ের সময় কোনও ব্যর্থতা ঘটলে তা ইভেন্ট লেভেলে ম্যানেজ করা হয়, যার ফলে আংশিক সাফল্য পাওয়া যেতে পারে। আপনার আপলোডের স্ট্যাটাস এবং প্রতিটি ইভেন্টের জন্য ত্রুটি ও সতর্কতা সংক্রান্ত তথ্য পেতে Diagnostics ব্যবহার করুন। IngestEventsRequest ব্যর্থ হলে (যেমন, BadRequest-এর কারণে), কোনও ইভেন্ট প্রসেস করা হয় না এবং আপনাকে সমস্যার সমাধান করে আবার অনুরোধ করতে হবে। আরও তথ্যের জন্য API সংক্রান্ত সমস্যা বোঝা নিবন্ধটি দেখুন।
enable_warnings	সমতুল্য কিছু নেই	আপনার ডেটা ম্যানেজার API অনুরোধ সম্পর্কে সতর্কতা পেতে ডায়াগনস্টিক ব্যবহার করুন। আপনাকে এটি চালু করতে হবে না।
operations	events	OfflineUserDataJobOperation.create অপারেশনটি IngestEventsRequest পাঠানোর সমতুল্য। Data Manager API-তে ইভেন্ট সরানোর সুবিধা নেই।
validate_only	validate_only
সমতুল্য কিছু নেই	consent	Google Ads API শুধুমাত্র UserData-এ ইভেন্ট লেভেলে consent নির্দিষ্ট করার সুবিধা দেয়। ডেটা ম্যানেজার API-এর জন্য, আপনি IngestEventsRequest-এ consent ফিল্ড সেট করে অনুরোধে সব ইভেন্টের জন্য সম্মতি নির্দিষ্ট করতে পারেন। আপনি Event-এর consent ফিল্ড সেট করে কোনও একটি ইভেন্টের জন্য এই ভ্যালু ওভাররাইড করতে পারবেন।
সমতুল্য কিছু নেই	encoding	UserData আপলোডের জন্য প্রয়োজন। UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করুন।
সমতুল্য কিছু নেই	encryption_info	অনুরোধে এনক্রিপ্ট করা UserData ব্যবহারকারী শনাক্তকারী থাকলে সেট করুন। আরও বিবরণের জন্য এনক্রিপশন দেখুন।

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

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

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

Google Ads API	Destination (ডেটা ম্যানেজার API)	নোট
অনুরোধের customer_id	operating_account	Google Ads কনভার্সন অ্যাকাউন্ট-এর কাস্টমার আইডিতে account_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 ফিল্ড সেট করবেন না।
conversion_action	product_destination_id	কনভার্সন অ্যাকশনের সংখ্যাসূচক আইডিতে সেট করুন। রিসোর্সের নাম ব্যবহার করবেন না।

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

নিচের সারণিতে দেখানো হয়েছে যে কীভাবে স্টোরে বিক্রি সংক্রান্ত কনভার্সনের ফিল্ড দুটি API-এর মধ্যে ম্যাপ করা হয়।

Google Ads API-এর মতো নয়, যা ItemAttribute ব্যবহার করে ট্রানজ্যাকশন প্রতি শুধুমাত্র একটি আইটেম অন্তর্ভুক্ত করার সুবিধা দেয়, Data Manager API CartData-এ ইভেন্ট প্রতি একাধিক আইটেম অন্তর্ভুক্ত করার সুবিধা দেয়।

OfflineUserDataJobOperation.create (Google Ads API)	Event (ডেটা ম্যানেজার API)	নোট
সমতুল্য কিছু নেই	event_source	প্রয়োজনীয় স্টোরে বিক্রি সংক্রান্ত কনভার্সনের জন্য IN_STORE-এ সেট করা হয়েছে।
transaction_attribute.conversion_action	destinations.product_destination_id	গ্রাহক ও কনভার্সন অ্যাকশন ফিল্ড দেখুন। রিসোর্সের নামের পরিবর্তে কনভার্সন অ্যাকশনের সংখ্যাসূচক আইডি ব্যবহার করুন।
transaction_attribute.transaction_date_time	event_timestamp	JSON ফর্ম্যাট ব্যবহার করলে, RFC 3339 ফর্ম্যাটে একটি ভ্যালু সেট করুন, যা Google Ads API তারিখ ও সময় ফর্ম্যাট থেকে সামান্য আলাদা। প্রোটোকল বাফার ব্যবহার করলে, Timestamp ব্যবহার করুন এবং seconds এবং (ঐচ্ছিক) nanoseconds ফিল্ড সেট করুন। আরও বিবরণের জন্য টাইমস্ট্যাম্প ফর্ম্যাট দেখুন।
transaction_attribute.transaction_amount_micros	conversion_value (প্রয়োজনীয়) cart_data.items[].conversion_value	কারেন্সি ভ্যালুতে সেট করুন, মাইক্রো ভ্যালুতে নয়। যেমন, $৫.২৩ কনভার্সন ভ্যালুর জন্য 5.23 ভ্যালু ব্যবহার করুন।
transaction_attribute.currency_code	currency	প্রয়োজনীয়।
transaction_attribute.order_id	transaction_id	প্রয়োজনীয়।
transaction_attribute.store_attribute.store_code	event_location.store_id	প্রয়োজনীয় EventLocation অবজেক্টের store_id ফিল্ডে স্টোর কোড সেট করুন।
transaction_attribute.custom_value	custom_variables[].value cart_data.items[].custom_variables[].value	ইভেন্ট লেভেলে CustomVariable-এর value ফিল্ডে অথবা আইটেম লেভেলে ItemCustomVariable-এ ম্যাপ করুন।
transaction_attribute.item_attribute.item_id	cart_data.items[].merchant_product_id
transaction_attribute.item_attribute.merchant_id	cart_data.merchant_id cart_data.items[].merchant_id	আপনি cart_data.merchant_id সেট করলে, এটি সব আইটেমের জন্য ডিফল্ট হিসেবে কাজ করে, তবে আপনি আলাদা আলাদা আইটেমের জন্য এটি ওভাররাইড করতে পারবেন।
transaction_attribute.item_attribute.country_code	cart_data.merchant_feed_label cart_data.items[].merchant_feed_label	আপনি cart_data.merchant_feed_label সেট করলে, এটি সব আইটেমের জন্য ডিফল্ট হিসেবে কাজ করে, তবে আপনি প্রতিটি আইটেমের জন্য এটি ওভাররাইড করতে পারেন।
transaction_attribute.item_attribute.language_code	cart_data.merchant_feed_language_code cart_data.items[].merchant_feed_language_code	আপনি cart_data.merchant_feed_language_code সেট করলে, এটি সব আইটেমের জন্য ডিফল্ট হিসেবে কাজ করে, তবে আপনি আলাদা আলাদা আইটেমের জন্য এটি ওভাররাইড করতে পারবেন।
transaction_attribute.item_attribute.quantity	cart_data.items[].quantity
সমতুল্য কিছু নেই	cart_data.items[].unit_price	এই আইটেমের জন্য ট্যাক্স, শিপিং এবং ইভেন্ট স্কোপড (ট্রানজ্যাকশন-লেভেল) ছাড় বাদ দিয়ে ইউনিট মূল্য সেট করুন।
user_identifiers	user_data.user_identifiers third_party_user_data.user_identifiers	প্রয়োজনীয়। third_party_user_data, user_data-এর মতো একই স্ট্রাকচার ব্যবহার করে, তবে এটি ইঙ্গিত করে যে ইউজার আইডেন্টিফায়ার ফার্স্ট-পার্টি বিজ্ঞাপনদাতার ডেটা হওয়ার পরিবর্তে থার্ড-পার্টি সোর্স থেকে আসে। লগ-ইন অ্যাকাউন্ট ডেটা পার্টনার (login_account.account_type হল DATA_PARTNER) হলে তবেই third_party_user_data পপুলেট করার অনুমতি দেওয়া হয়। বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ফিল্ড দেখুন।
consent	consent	দুটি API-ই একই ধরনের Consent অবজেক্ট (ad_user_data, ad_personalization) ব্যবহার করে। ডেটা ম্যানেজার API-এর জন্য, আপনি IngestEventsRequest-এ consent ফিল্ড সেট করে কোনও অনুরোধের সব ইভেন্টের জন্য সম্মতি সেট করতে পারেন।

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

UserIdentifier (Google Ads API)	UserIdentifier (ডেটা ম্যানেজার API)	নোট
user_identifier_source	ডেটা ম্যানেজার API Event-এ কোন ফিল্ড পপুলেট করতে হবে তা সোর্স নির্ধারণ করে: user_data third_party_user_data	third_party_user_data, user_data-এর মতো একই স্ট্রাকচার ব্যবহার করে, তবে এটি ইঙ্গিত করে যে ইউজার আইডেন্টিফায়ার ফার্স্ট-পার্টি বিজ্ঞাপনদাতার ডেটা হওয়ার পরিবর্তে থার্ড-পার্টি সোর্স থেকে আসে। লগ-ইন অ্যাকাউন্ট ডেটা পার্টনার (login_account.account_type হল DATA_PARTNER) হলে তবেই third_party_user_data পপুলেট করার অনুমতি দেওয়া হয়। বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ফিল্ড দেখুন।
hashed_email	email_address	ফর্ম্যাট করা ও হ্যাশ করা ইমেল আইডিতে সেট করুন। এছাড়াও, আপনি হ্যাশ করা ইমেল আইডি এনক্রিপ্ট করতে পারবেন।
hashed_phone_number	phone_number	ফর্ম্যাট করা ও হ্যাশ করা ফোন নম্বরে সেট করা হয়েছে। এছাড়াও, আপনি হ্যাশ করা ফোন নম্বর এনক্রিপ্ট করতে পারবেন।
address_info	address	AddressInfo অবজেক্টে সেট করুন। ফর্ম্যাটিং ও হ্যাশিং সংক্রান্ত নির্দেশিকা অনুসরণ করুন। এছাড়াও, আপনি ঠিকানার হ্যাশ করা অ্যাট্রিবিউট এনক্রিপ্ট করতে পারবেন।
address_info.hashed_first_name	address.given_name
address_info.hashed_last_name	address.family_name
address_info.country_code	address.region_code
address_info.postal_code	address.postal_code
address_info.city	সমতুল্য কিছু নেই	Google Ads ডেস্টিনেশনের জন্য কাজ করে না।
address_info.state	সমতুল্য কিছু নেই	Google Ads ডেস্টিনেশনের জন্য কাজ করে না।
address_info.hashed_street_address	সমতুল্য কিছু নেই	Google Ads ডেস্টিনেশনের জন্য কাজ করে না।