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

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 পাঠানোর সমতুল্য। ডেটা ম্যানেজার 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 account_id-কে Google Ads কনভার্সন অ্যাকাউন্ট-এর কাস্টমার আইডি হিসেবে সেট করুন। 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 ডেস্টিনেশনের জন্য কাজ করে না।
পূর্ববর্তী
আপগ্রেড করার ধাপ