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

Google Ads API থেকে ডেটা ম্যানেজার API-তে আপনার কাস্টমার ম্যাচ ওয়ার্কফ্লোর প্রতিটি ধাপ আপগ্রেড করতে ফিল্ড ম্যাপিং ব্যবহার করুন:

যাচাইকরণ

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

অডিয়েন্স ম্যানেজমেন্ট ফিল্ড ম্যাপিং

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

UserList (Google Ads API) UserList (ডেটা ম্যানেজার API) নোট
resource_name name বিস্তারিত জানতে রিসোর্সের নাম দেখুন।
id id
read_only read_only
name display_name আবশ্যক
description description আবশ্যক
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

তালিকায় যোগ করার পরে অডিয়েন্স মেম্বার কতক্ষণ তালিকায় থাকবেন। মানটি অবশ্যই পুরো দিনের সাথে সামঞ্জস্যপূর্ণ হতে হবে। সেট করা না থাকলে, ডিফল্ট হিসেবে সর্বাধিক হিসেবে সেট করা হয়।

টাইমস্ট্যাম্প ফর্ম্যাট ব্যবহার করে ভ্যালু ফর্ম্যাট করুন।
size_for_display size_info.display_network_members_count
size_range_for_display সমতুল্য কিছু নেই। সাইজ সংক্রান্ত তথ্যের জন্য size_info.display_network_members_count ব্যবহার করুন।
size_for_search size_info.search_network_members_count
size_range_for_search সমতুল্য কিছু নেই। সাইজ সংক্রান্ত তথ্যের জন্য size_info.search_network_members_count ব্যবহার করুন।
type সমতুল্য কিছু নেই।
access_reason access_reason
account_user_list_status account_access_status
closing_reason closing_reason
eligible_for_search target_network_info.eligible_for_search
eligible_for_display target_network_info.eligible_for_display
match_rate_percentage ingested_user_list_info.contact_id_info.match_rate_percentage
basic_user_list ingested_user_list_info.pseudonymous_id_info কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
crm_based_user_list ingested_user_list_info প্রয়োজনীয়। কাস্টমার ম্যাচ অডিয়েন্স সম্পর্কিত তথ্য দেখুন।
সমতুল্য কিছু নেই। ingested_user_list_info.pair_id_info কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
সমতুল্য কিছু নেই। ingested_user_list_info.partner_audience_info কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
logical_user_list সমতুল্য কিছু নেই। কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
logical_user_list সমতুল্য কিছু নেই। কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
lookalike_user_list সমতুল্য কিছু নেই। কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
rule_based_user_list সমতুল্য কিছু নেই। কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।
similar_user_list সমতুল্য কিছু নেই। কাস্টমার ম্যাচের জন্য ব্যবহার করা হয়নি।

কাস্টমার ম্যাচ অডিয়েন্স সংক্রান্ত তথ্য

Google Ads API-তে, কাস্টমার ম্যাচ অডিয়েন্স তৈরি করার সময় আপনাকে অবশ্যই crm_based_user_list ফিল্ডটি CrmBasedUserListInfo-এ সেট করতে হবে।

Data Manager API-তে, ingested_user_list_info ফিল্ডকে IngestedUserListInfo-এ সেট করে সমতুল্য অ্যাট্রিবিউট সেট করুন, তারপর কাস্টমার ম্যাচ এবং ব্যবহারকারীর ডেটার ধরনের জন্য প্রয়োজনীয় ফিল্ড সেট করুন।

যোগাযোগের তথ্য

upload_key_types
সেট CONTACT_ID সহ একটি তালিকায় সেট করা হয়েছে। এটি Google Ads API-তে upload_key_type-কে CONTACT_INFO-এ সেট করার সমতুল্য।
contact_id_info

ContactIdInfo-এ সেট করুন।

data_source_type-কে DATA_SOURCE_TYPE_FIRST_PARTY-এ সেট করুন। এটি Google Ads API-তে data_source_type-কে FIRST_PARTY-এ সেট করার সমতুল্য।

মোবাইল আইডি

upload_key_types
সেট MOBILE_ID সহ একটি তালিকায় সেট করা হয়েছে। এটি Google Ads API-তে upload_key_type-কে MOBILE_ADVERTISING_ID-এ সেট করার সমতুল্য।
mobile_id_info

MobileIdInfo-এ সেট করুন।

  • data_source_type-কে DATA_SOURCE_TYPE_FIRST_PARTY-এ সেট করুন। এটি Google Ads API-তে data_source_type-কে FIRST_PARTY-এ সেট করার সমতুল্য।
  • key_space-কে IOS বা ANDROID-এ সেট করুন। ডেটা ম্যানেজার API-এর জন্য এই ভ্যালু প্রয়োজন। এটি Google Ads API-এর থেকে আলাদা, যেখানে কী স্পেস app_id থেকে অনুমান করা হয়।
  • app_id-কে এমন স্ট্রিং হিসেবে সেট করুন যা অনন্যভাবে সেই মোবাইল অ্যাপ্লিকেশনকে শনাক্ত করে যেখান থেকে ডেটা সংগ্রহ করা হয়েছে। Google Ads API-তে app_id-এর জন্য আপনি যে ফর্ম্যাট ব্যবহার করেন, সেই একই ফর্ম্যাট ব্যবহার করুন।

ব্যবহারকারীর আইডি

upload_key_types
সেট USER_ID সহ একটি তালিকায় সেট করা হয়েছে। এটি Google Ads API-তে upload_key_type-কে CRM_ID-এ সেট করার সমতুল্য।
user_id_info

UserIdInfo-এ সেট করুন।

data_source_type-কে DATA_SOURCE_TYPE_FIRST_PARTY-এ সেট করুন। এটি Google Ads API-তে data_source_type-কে FIRST_PARTY-এ সেট করার সমতুল্য।

রিসোর্সের নাম

ডেটা ম্যানেজার API, Google Ads API-এর থেকে আলাদা রিসোর্স নামের ফর্ম্যাট ব্যবহার করে।

Google Ads API

Google Ads API-তে, UserList রিসোর্সের নাম এই ফর্ম্যাট ব্যবহার করে:

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

ডেটা ম্যানেজার API-তে, UserList রিসোর্সের নাম এই ফর্ম্যাট ব্যবহার করে:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

ফিল্ড ম্যাপিং আপলোড করুন

Google Ads API-তে AddOfflineUserDataJobOperationsRequest-কে ডেটা ম্যানেজার API-তে এর সমতুল্য IngestionService অনুরোধে ম্যাপ করতে টেবিলের ম্যাপিং ব্যবহার করুন।

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

এই ম্যাপিংগুলি রেফারেন্স হিসেবে Data Manager API-তে IngestAudienceMembersRequest ব্যবহার করে, তবে আপনি যদি Google Ads API অনুরোধকে RemoveAudienceMembersRequest বা RemoveAllAudienceMembersRequest-এ কনভার্ট করেন, তাহলেও এই ম্যাপিংগুলি ব্যবহার করতে পারবেন।

AddOfflineUserDataJobOperationsRequest (Google Ads API) IngestAudienceMembersRequest (ডেটা ম্যানেজার API) নোট
  • customer_id ফিল্ড
  • OfflineUserDataJob-এর customer_match_user_list_metadata ফিল্ড
  • developer-token রিকোয়েস্ট হেডার
  • login-customer_id রিকোয়েস্ট হেডার
  • linked-customer-id রিকোয়েস্ট হেডার
 destinations গ্রাহক ও দর্শক সংক্রান্ত ফিল্ড দেখুন।
OfflineUserDataJob-এর customer_match_user_list_metadata থেকে consent consent অনুরোধে অডিয়েন্স মেম্বারদের জন্য ঐচ্ছিক ডিফল্ট সম্মতি সেটিংস। আপনি AudienceMember-এর consent ফিল্ড সেট করে কোনও একজন অডিয়েন্স মেম্বারের জন্য এই ভ্যালু ওভাররাইড করতে পারবেন।
সমতুল্য কিছু নেই encoding প্রয়োজনীয়: UserIdentifier ভ্যালুর জন্য ব্যবহৃত Encoding-এ সেট করুন।
সমতুল্য কিছু নেই encryption_info অনুরোধে এনক্রিপ্ট করা ভ্যালু থাকলে সেট করুন। আরও বিবরণের জন্য এনক্রিপশন দেখুন।
job_id সমতুল্য কিছু নেই ডায়াগনস্টিক ফিরিয়ে আনতে উত্তরে পাওয়া request_id ব্যবহার করুন।
enable_partial_failure সমতুল্য কিছু নেই ডেটা ম্যানেজার API একটি ফাস্ট-ফেল এরর মডেল ব্যবহার করে। IngestAudienceMembersRequest-এর কোনও ফিল্ড যাচাইকরণে ব্যর্থ হলে, Data Manager API সম্পূর্ণ অনুরোধ বাতিল করে দেয়। ডায়াগনস্টিক ব্যবহার করে প্রসেসিং সংক্রান্ত সমস্যা খুঁজে বের করুন।
enable_warnings সমতুল্য কিছু নেই ডেটা ম্যানেজার API উত্তরে কোনও সতর্কতা দেখায় না। ডায়াগনস্টিক ব্যবহার করে প্রসেসিং সংক্রান্ত সতর্কতা পুনরুদ্ধার করুন।
validate_only validate_only
operations audience_members যোগ বা সরিয়ে দেওয়ার জন্য অডিয়েন্স মেম্বারের তালিকা। আরও তথ্যের জন্য অপারেশন ফিল্ড বিভাগ দেখুন।
সমতুল্য কিছু নেই terms_of_service প্রয়োজনীয়। ব্যবহারকারী কাস্টমার ম্যাচের জন্য পরিষেবার শর্তাবলী গ্রহণ বা প্রত্যাখ্যান করেছেন কিনা তা নির্দেশ করার জন্য সেট করা হয়েছে।

গ্রাহক ও দর্শক ফিল্ড

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

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

Google Ads API-তে, আপনি OfflineUserDataJobOperation-এর remove_all ফিল্ড true-এ সেট করে কোনও অডিয়েন্সের সব মেম্বারকে সরিয়ে দিতে পারবেন।

ডেটা ম্যানেজার API-তে, আপনি RemoveAllAudienceMembersRequest পাঠিয়ে এটি করতে পারবেন। বিস্তারিত জানতে সব মেম্বারকে সরিয়ে দিন নির্দেশিকা দেখুন।

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

Google Ads API Destination (ডেটা ম্যানেজার API) নোট
অনুরোধের customer_id operating_account 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 ফিল্ড সেট করবেন না।
OfflineUserDataJob-এর customer_match_user_list_metadata থেকে user_list product_destination_id প্রয়োজনীয়। অডিয়েন্সের নিউমেরিক আইডিতে সেট করুন। UserList-এর রিসোর্স নাম ব্যবহার করবেন না।
সমতুল্য কিছু নেই reference Destination-এর জন্য ব্যবহারকারীর দ্বারা নির্ধারিত শনাক্তকারী। আপনি একটি অনুরোধে একাধিক অডিয়েন্সের জন্য অডিয়েন্স মেম্বারদের পাঠালে এই ফিল্ড সেট করুন।

অপারেশন ফিল্ড

ডেটা ম্যানেজার API-তে অডিয়েন্স মেম্বার যোগ করা এবং সরানোর জন্য আলাদা পদ্ধতি রয়েছে। অন্যদিকে, Google Ads API-এর AddOfflineUserDataJobOperationsRequest-এ operations-এর একটি তালিকা থাকে, যার প্রতিটি অপারেশনের ধরনের উপর ভিত্তি করে একজন মেম্বারকে যোগ করে, একজন মেম্বারকে সরিয়ে দেয় অথবা সব মেম্বারকে সরিয়ে দেয়। ডেটা ম্যানেজার API-তে প্রতিটি অপারেশন টাইপ ও তার সংশ্লিষ্ট পদ্ধতির ম্যাপিং এখানে দেওয়া হল:

OfflineUserDataJobOperation (Google Ads API) IngestionService পদ্ধতি (ডেটা ম্যানেজার API) নোট
create IngestAudienceMembers আরও জানতে অডিয়েন্স মেম্বার ফিল্ড বিভাগ দেখুন।
remove RemoveAudienceMembers আরও জানতে অডিয়েন্স মেম্বার ফিল্ড বিভাগ দেখুন।
remove_all RemoveAllAudienceMembers বিস্তারিত জানতে সব অডিয়েন্স মেম্বারকে সরিয়ে দিন দেখুন।

অডিয়েন্স মেম্বার ফিল্ড

UserData (Google Ads API) AudienceMember (ডেটা ম্যানেজার API) নোট
consent consent

অডিয়েন্স মেম্বারের জন্য সম্মতি নির্দিষ্ট করতে সেট করুন।

দুটি API একই ধরনের Consent অবজেক্ট ব্যবহার করে (ad_user_data, ad_personalization)।

ডেটা ম্যানেজার API-এর জন্য, আপনি অনুরোধ-লেভেল consent ফিল্ড সেট করে অনুরোধে সব অডিয়েন্স মেম্বারের জন্য সম্মতি সেট করতে পারেন।
transaction_attribute সমতুল্য কিছু নেই। কাস্টমার ম্যাচের ক্ষেত্রে প্রযোজ্য নয়।
user_attribute সমতুল্য কিছু নেই। কাস্টমার ম্যাচের ক্ষেত্রে প্রযোজ্য নয়।
user_identifiers
  • mobile_data
  • user_id_data
  • composite_data
    • user_data
    • ip_data

অডিয়েন্স মেম্বারদের জন্য আপনি যে ধরনের ডেটা পাঠাচ্ছেন, সেই অনুযায়ী ফিল্ড পূরণ করুন। বিস্তারিত জানতে ইউজার আইডেন্টিফায়ার ফিল্ড দেখুন।

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

Google Ads API-তে, আপনি যোগাযোগের তথ্য, মোবাইল আইডি বা ব্যবহারকারীর আইডি, যা-ই পাঠান না কেন, আপনাকে UserIdentifier ব্যবহার করতে হবে। ডেটা ম্যানেজার API আলাদা পদ্ধতি ব্যবহার করে, যেখানে প্রতিটি ধরনের ডেটার জন্য আলাদা ফিল্ড থাকে।

ডেটা ম্যানেজার API-তে, আপনি যে ধরনের ডেটা পাঠাচ্ছেন তার সাথে সম্পর্কিত ফিল্ডটি পূরণ করুন:

যোগাযোগের তথ্য

ইমেল আইডি, ফোন নম্বর বা ঠিকানার মতো যোগাযোগের তথ্য ব্যবহার করলে, composite_data-কে CompositeData-এ সেট করুন এবং প্রতিটি যোগাযোগের তথ্য আইটেমের জন্য user_data.user_identifiers-এ আলাদা এন্ট্রি করুন।

user_data এখনও কাজ করলেও, আমরা সাজেস্ট করি যে composite_data ব্যবহার করুন যাতে আপনার ইন্টিগ্রেশন ভবিষ্যতের উন্নতির জন্য প্রস্তুত থাকে। আরও জানতে কম্পোজিট ডেটা দেখুন।

UserIdentifier (Google Ads API) UserIdentifier (ডেটা ম্যানেজার API) নোট
address_info address বিস্তারিত জানতে ঠিকানার ফিল্ড দেখুন।
hashed_email email_address ফর্ম্যাট করা ও হ্যাশ করা ইমেল আইডিতে সেট করুন। এছাড়াও, আপনি হ্যাশ করা ইমেল আইডি এনক্রিপ্ট করতে পারবেন।
hashed_phone_number phone_number ফর্ম্যাট করা ও হ্যাশ করা ফোন নম্বরে সেট করুন। এছাড়াও, আপনি হ্যাশ করা ফোন নম্বর এনক্রিপ্ট করতে পারবেন।
user_identifier_source সমতুল্য কিছু নেই।

ঠিকানার ফিল্ড

Google Ads API-তে OfflineUserAddressInfo এবং Data Manager API-তে AddressInfo-এর মধ্যে ফিল্ড ম্যাপিং এখানে দেওয়া হল। আপনি যদি কাস্টমার ম্যাচ অডিয়েন্সের তথ্য পূরণ করার জন্য যোগাযোগের তথ্য ব্যবহার করেন, তাহলে এই ম্যাপিং ব্যবহার করুন।

OfflineUserAddressInfo (Google Ads API) AddressInfo (ডেটা ম্যানেজার API) নোট
city সমতুল্য কিছু নেই।
country_code region_code আবশ্যক
hashed_first_name given_name

প্রয়োজনীয়। প্রদত্ত নাম ফর্ম্যাট ও হ্যাশ করে সেট করুন। এছাড়াও, আপনি হ্যাশ করা প্রদত্ত নাম এনক্রিপ্ট করতে পারবেন।
hashed_last_name family_name

প্রয়োজনীয়। ফর্ম্যাট করা ও হ্যাশ করা পদবিতে সেট করুন। এছাড়াও, আপনি হ্যাশ করা ফ্যামিলি নেম এনক্রিপ্ট করতে পারবেন।
hashed_street_address সমতুল্য কিছু নেই।
postal_code postal_code আবশ্যক
state সমতুল্য কিছু নেই।

IP অ্যাড্রেস

ডেটা ম্যানেজার API, ইউজার আইডেন্টিফায়ার ছাড়াও কাস্টমার ম্যাচ আপলোডের জন্য IP অ্যাড্রেস অন্তর্ভুক্ত করার সুবিধা প্রদান করে। এগুলি CompositeData-এ প্রদান করা হয়, যা UserData এবং IpData-এর বান্ডেল। এইসব ফিল্ড একসাথে প্রদান করলে ম্যাচ রেট উন্নত করতে সাহায্য করতে পারে।

আরও জানতে কাস্টমার ম্যাচের জন্য IP ইনজেশন দেখুন।

Google Ads API CompositeData (ডেটা ম্যানেজার API) নোট
সমতুল্য কিছু নেই। ip_data.ip_address র IPv4 বা IPv6 অ্যাড্রেসে সেট করুন। IP অ্যাড্রেস ফর্ম্যাট সংক্রান্ত নির্দেশিকা দেখুন।
সমতুল্য কিছু নেই। ip_data.observe_start_time IP অ্যাড্রেস প্রথমবার যখন লক্ষ্য করা হয়েছিল, সেই সময়ের টাইমস্ট্যাম্প RFC 3339 ফর্ম্যাটে সেট করুন।
সমতুল্য কিছু নেই। ip_data.observe_end_time IP অ্যাড্রেস শেষবার যখন দেখা গিয়েছিল, সেই টাইমস্ট্যাম্প RFC 3339 ফর্ম্যাটে সেট করুন।
user_identifiers user_data UserData অবজেক্টে সেট করুন।

মোবাইল আইডি

মোবাইল আইডি ব্যবহার করলে, প্রতিটি আইডির জন্য mobile_ids-এ এন্ট্রি সহ mobile_data-কে MobileData-এ সেট করুন।

UserIdentifier (Google Ads API) MobileData (ডেটা ম্যানেজার API) নোট
mobile_id mobile_ids অডিয়েন্স মেম্বারের জন্য মোবাইল আইডি-এর তালিকায় সেট করুন।

Google Ads API-তে, আপনি অডিয়েন্স মেম্বারের প্রতিটি মোবাইল আইডির জন্য mobile_id সহ আলাদা UserIdentifier যোগ করেন। Data Manager API-তে, একটি MobileData যোগ করুন, যেখানে mobile_ids অডিয়েন্স মেম্বারের সব মোবাইল আইডির তালিকায় সেট করা থাকে।

user_identifier_source সমতুল্য কিছু নেই।

ব্যবহারকারীর আইডি

ব্যবহারকারীর আইডি ব্যবহার করলে, user_id_data-কে UserIdData হিসেবে সেট করুন এবং user_id-কে অডিয়েন্স মেম্বারের ব্যবহারকারীর আইডি হিসেবে সেট করুন।

UserIdentifier (Google Ads API) UserIdData (ডেটা ম্যানেজার API) নোট
third_party_user_id user_id

Google Ads API-তে, আপনি অডিয়েন্স মেম্বারের প্রতিটি ব্যবহারকারী আইডির জন্য third_party_user_id সহ আলাদা UserIdentifier যোগ করেন।

Data Manager API-তে, user_id_data ফিল্ডটি UserIdData-এ সেট করুন এবং এর user_id ফিল্ডটি অডিয়েন্স মেম্বারের জন্য ব্যবহারকারীর আইডিতে সেট করুন। একই অডিয়েন্স মেম্বারের জন্য আপনি একাধিক ব্যবহারকারীর আইডি পাঠাতে পারবেন না।

user_identifier_source সমতুল্য কিছু নেই।
পূর্ববর্তী
আপগ্রেড করার ধাপ