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

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

এপিআই পদ্ধতি

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

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

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

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

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

গুগল অ্যাডস এপিআই অনুরোধের ফিল্ডগুলো ডেটা ম্যানেজার এপিআই-এর সাথে যেভাবে সংযুক্ত, তা এখানে দেখানো হলো।

CreateOfflineUserDataJobRequest

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

CreateOfflineUserDataJobRequest (গুগল অ্যাডস এপিআই) IngestEventsRequest (ডেটা ম্যানেজার এপিআই) নোট
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 এর অথবা আইটেম লেভেলে ItemCustomVariable এর variable ফিল্ডের সাথে ম্যাপ করুন।
enable_match_rate_range_preview কোনো সমতুল্য নেই
validate_only validate_only
কোনো সমতুল্য নেই consent Google Ads API শুধুমাত্র UserData তে ইভেন্ট লেভেলে consent নির্দিষ্ট করা সমর্থন করে। Data Manager API-এর ক্ষেত্রে, আপনি IngestEventsRequest এর consent ফিল্ড সেট করার মাধ্যমে একটি রিকোয়েস্টের সমস্ত ইভেন্টের জন্য সম্মতি নির্দিষ্ট করতে পারেন। আপনি Event এর consent ফিল্ড সেট করে কোনো নির্দিষ্ট ইভেন্টের জন্য এই মানটি ওভাররাইড করতে পারেন।
কোনো সমতুল্য নেই encoding UserData আপলোডের জন্য আবশ্যক। UserIdentifier ​​মানগুলির জন্য ব্যবহৃত Encoding এ সেট করুন।
কোনো সমতুল্য নেই encryption_info অনুরোধে এনক্রিপ্ট করা UserData ব্যবহারকারী শনাক্তকারী থাকলে সেট করুন। বিস্তারিত জানতে এনক্রিপশন দেখুন।

AddOfflineUserDataJobOperationsRequest

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

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

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

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

ডেটা ম্যানেজার এপিআই-এর জন্য কোনো ডেভেলপার টোকেনের প্রয়োজন হয় না, এবং আপনি রিকোয়েস্ট হেডারের পরিবর্তে একটি 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 যদি আপনি কোনো পার্টনার লিঙ্ক ব্যবহার করে operating_account অ্যাক্সেস করেন, তাহলে account_id লিঙ্ক করা অ্যাকাউন্টের কাস্টমার আইডিতে এবং account_type DATA_PARTNER এ সেট করুন। অন্যথায়, linked_account ফিল্ডটি সেট করবেন না।
conversion_action product_destination_id রূপান্তর ক্রিয়ার সাংখ্যিক আইডিতে সেট করুন। রিসোর্স নামটি ব্যবহার করবেন না।

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

নিম্নলিখিত সারণিতে দেখানো হয়েছে কিভাবে একটি স্টোরের বিক্রয় রূপান্তর ফিল্ডগুলো দুটি এপিআই-এর মধ্যে বিন্যস্ত হয়।

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

OfflineUserDataJobOperation.create (গুগল অ্যাডস এপিআই) Event (ডেটা ম্যানেজার এপিআই) নোট
কোনো সমতুল্য নেই 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 রূপান্তর মানের জন্য, 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 এর ভ্যালু ফিল্ডে অথবা আইটেম লেভেলের ItemCustomVariable এর value ফিল্ডে ম্যাপ করুন।
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 মতোই, কিন্তু এটি নির্দেশ করে যে ব্যবহারকারীর শনাক্তকারীগুলো কোনো প্রথম-পক্ষের বিজ্ঞাপনদাতার ডেটা না হয়ে, একটি তৃতীয়-পক্ষের উৎস থেকে এসেছে।

third_party_user_data পূরণ করার অনুমতি শুধুমাত্র তখনই দেওয়া হয়, যখন লগইন অ্যাকাউন্টটি একজন ডেটা পার্টনার হয় ( login_account.account_type DATA_PARTNER হয়)।

বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ক্ষেত্রগুলি দেখুন।

consent consent উভয় API-ই একটি অনুরূপ Consent অবজেক্ট ( ad_user_data , ad_personalization ) ব্যবহার করে। Data Manager API-এর ক্ষেত্রে, আপনি IngestEventsRequest এর consent ফিল্ডটি সেট করার মাধ্যমে একটি রিকোয়েস্টের সমস্ত ইভেন্টের জন্য সম্মতি নির্ধারণ করতে পারেন।

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

UserIdentifier (গুগল অ্যাডস এপিআই) UserIdentifier (ডেটা ম্যানেজার এপিআই) নোট
user_identifier_source

ডেটা ম্যানেজার এপিআই Event কোন ফিল্ডটি পূরণ করতে হবে তা উৎস নির্ধারণ করে:

  • user_data
  • third_party_user_data

third_party_user_data গঠন user_data মতোই, কিন্তু এটি নির্দেশ করে যে ব্যবহারকারীর শনাক্তকারীগুলো কোনো প্রথম-পক্ষের বিজ্ঞাপনদাতার ডেটা না হয়ে, একটি তৃতীয়-পক্ষের উৎস থেকে এসেছে।

third_party_user_data পূরণ করার অনুমতি শুধুমাত্র তখনই দেওয়া হয়, যখন লগইন অ্যাকাউন্টটি একজন ডেটা পার্টনার হয় ( login_account.account_type DATA_PARTNER হয়)।

বিস্তারিত জানতে ব্যবহারকারী শনাক্তকারী ক্ষেত্রগুলি দেখুন।

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 কোনো সমতুল্য নেই ডেটা ম্যানেজার এপিআই-এর বর্তমান সংস্করণে এটি সমর্থিত নয়।
address_info.state কোনো সমতুল্য নেই ডেটা ম্যানেজার এপিআই-এর বর্তমান সংস্করণে এটি সমর্থিত নয়।
address_info.hashed_street_address কোনো সমতুল্য নেই ডেটা ম্যানেজার এপিআই-এর বর্তমান সংস্করণে এটি সমর্থিত নয়।
পূর্ববর্তী
আপগ্রেড করার পদক্ষেপ, আপগ্রেড করার পদক্ষেপ