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

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

• শ্রোতা ব্যবস্থাপনা ফিল্ড ম্যাপিংগুলিতে শ্রোতা তৈরি, আপডেট এবং পুনরুদ্ধারের জন্য ফিল্ড ম্যাপিং থাকে।

• ইনজেকশন ফিল্ড ম্যাপিং-এ দর্শকদের যোগ করার বা অপসারণের জন্য ফিল্ড ম্যাপিং থাকে।

শ্রোতা ব্যবস্থাপনা ক্ষেত্র ম্যাপিং

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

UserList (গুগল বিজ্ঞাপন 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-তে, Customer Match অডিয়েন্স তৈরি করার সময় crm_based_user_list ফিল্ডটি প্রয়োজন।

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

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

upload_key_types

CONTACT_INFO ধারণকারী একটি তালিকায় সেট করুন।

contact_id_info

একটি ContactIdInfo তে সেট করুন।

data_source_type কে DATA_SOURCE_TYPE_FIRST_PARTY তে সেট করুন।

মোবাইল আইডি

upload_key_types

MOBILE_ID ধারণকারী একটি তালিকায় সেট করুন।

mobile_id_info

একটি MobileIdInfo তে সেট করুন।

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

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

upload_key_types

USER_ID ধারণকারী একটি তালিকায় সেট করুন।

user_id_info

একটি UserIdInfo তে সেট করুন।

data_source_type কে DATA_SOURCE_TYPE_FIRST_PARTY তে সেট করুন।

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

ডেটা ম্যানেজার এপিআই গুগল বিজ্ঞাপন এপিআই থেকে আলাদা রিসোর্স নেম ফর্ম্যাট ব্যবহার করে।

গুগল বিজ্ঞাপন এপিআই

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

customers/{customer_id}/userLists/{user_list_id}

ডেটা ম্যানেজার এপিআই

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

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

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

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

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

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 এর কোনও ক্ষেত্র যাচাইকরণে ব্যর্থ হয়, তাহলে ডেটা ম্যানেজার 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 ক্ষেত্র ব্যবহার করে লগইন এবং লিঙ্ক করা গ্রাহক তথ্য নির্দিষ্ট করেন। গন্তব্য সম্পর্কে আরও তথ্যের জন্য গন্তব্য কনফিগার করুন দেখুন।

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

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

গুগল বিজ্ঞাপন এপিআই	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 বিজ্ঞাপন অ্যাকাউন্ট হয় তবে account_type GOOGLE_ADS এ সেট করুন, অথবা লগইন অ্যাকাউন্টটি যদি ডেটা পার্টনার অ্যাকাউন্ট হয় তবে DATA_PARTNER সেট করুন।
linked-customer-id অনুরোধের হেডার	linked_account	লিঙ্ক করা অ্যাকাউন্টের গ্রাহক আইডিতে account_id সেট করুন। account_type তে DATA_PARTNER সেট করুন।
OfflineUserDataJob customer_match_user_list_metadata থেকে user_list	product_destination_id	আবশ্যক। দর্শকদের সংখ্যাসূচক আইডিতে সেট করুন। UserList এর রিসোর্স নাম ব্যবহার করবেন না।
কোন সমতুল্য নেই	reference	Destination জন্য একটি ব্যবহারকারী-সংজ্ঞায়িত শনাক্তকারী। যদি আপনি একটি একক অনুরোধে একাধিক দর্শকের জন্য দর্শক সদস্য পাঠান তবে এই ক্ষেত্রটি সেট করুন।

দর্শক সদস্য ক্ষেত্র

UserData (গুগল বিজ্ঞাপন API)	AudienceMember (ডেটা ম্যানেজার এপিআই)	মন্তব্য
consent	consent	শ্রোতা সদস্যের জন্য সম্মতি নির্দিষ্ট করার জন্য সেট করুন। উভয় API একই রকম Consent বস্তু ব্যবহার করে (ad_user_data, ad_personalization)। ডেটা ম্যানেজার API-এর জন্য, আপনি অনুরোধ-স্তরের consent ক্ষেত্র সেট করে একটি অনুরোধে সমস্ত দর্শক সদস্যের জন্য সম্মতি সেট করতে পারেন।
transaction_attribute	কোন সমতুল্য নেই।	গ্রাহক ম্যাচের ক্ষেত্রে প্রযোজ্য নয়।
user_attribute	কোন সমতুল্য নেই।	গ্রাহক ম্যাচের ক্ষেত্রে প্রযোজ্য নয়।
user_identifiers	mobile_id_data user_id_data user_identifiers	দর্শকদের জন্য আপনি যে ধরণের ডেটা পাঠাচ্ছেন তার সাথে সঙ্গতিপূর্ণ ক্ষেত্রটি পূরণ করুন। বিস্তারিত জানার জন্য ব্যবহারকারী শনাক্তকারী ক্ষেত্রগুলি দেখুন।

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

Google Ads API-তে, আপনি যোগাযোগের তথ্য, মোবাইল আইডি, অথবা ব্যবহারকারী আইডি, যেটাই পাঠান না কেন, আপনি UserIdentifier ব্যবহার করেন। Data Manager API প্রতিটি ধরণের ডেটার জন্য আলাদা আলাদা ক্ষেত্র সহ একটি ভিন্ন পদ্ধতি ব্যবহার করে।

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

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

যদি আপনি ইমেল ঠিকানা, ফোন নম্বর, অথবা ঠিকানার তথ্যের মতো যোগাযোগের তথ্য ব্যবহার করেন, তাহলে user_data UserData তে সেট করুন এবং প্রতিটি যোগাযোগের তথ্য আইটেমের জন্য user_identifiers এ একটি পৃথক এন্ট্রি রাখুন।

UserIdentifier (গুগল বিজ্ঞাপন 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 এর মধ্যে ফিল্ড ম্যাপিং দেওয়া হল। আপনার Customer Match দর্শকদের পূরণ করার জন্য যোগাযোগের তথ্য ব্যবহার করলে এই ম্যাপিংগুলি ব্যবহার করুন।

OfflineUserAddressInfo (গুগল বিজ্ঞাপন 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	কোন সমতুল্য নেই।

মোবাইল আইডি

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

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

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

যদি আপনি ব্যবহারকারীর আইডি ব্যবহার করেন, তাহলে user_id_data UserIdData তে সেট করুন এবং দর্শকের জন্য user_id user ID তে সেট করুন।

UserIdentifier (গুগল বিজ্ঞাপন API)	UserIdData (ডেটা ম্যানেজার এপিআই)	মন্তব্য
third_party_user_id	user_id	Google Ads API-তে, আপনি দর্শক সদস্যের প্রতিটি ব্যবহারকারী আইডির জন্য third_party_user_id সহ একটি পৃথক UserIdentifier যোগ করেন। ডেটা ম্যানেজার API-তে, user_id_data ফিল্ডটিকে UserIdData তে সেট করুন এবং এর user_id ফিল্ডটিকে অডিয়েন্স মেম্বারের জন্য ইউজার আইডিতে সেট করুন। আপনি একই অডিয়েন্স মেম্বারের জন্য একাধিক ইউজার আইডি পাঠাতে পারবেন না।
user_identifier_source	কোন সমতুল্য নেই।