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

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

• অডিয়েন্স ম্যানেজমেন্ট ফিল্ড ম্যাপিং-এ অডিয়েন্স তৈরি, আপডেট এবং পুনরুদ্ধার করার জন্য ফিল্ড ম্যাপিং অন্তর্ভুক্ত রয়েছে।

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

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

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

UserList (গুগল বিজ্ঞাপন এপিআই)	UserList (ডেটা ম্যানেজার এপিআই)	নোট
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	কোনো সমতুল্য নেই।	কাস্টমার ম্যাচ-এর জন্য ব্যবহৃত হয় না।

গ্রাহক ম্যাচ দর্শকদের তথ্য

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

ডেটা ম্যানেজার এপিআই-তে, 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 তে সেট করুন।

সম্পদের নাম

ডেটা ম্যানেজার এপিআই, গুগল অ্যাডস এপিআই-এর চেয়ে ভিন্ন একটি রিসোর্স নেম ফরম্যাট ব্যবহার করে।

গুগল অ্যাডস এপিআই

গুগল অ্যাডস এপিআই-তে, একটি UserList রিসোর্স নেম নিম্নলিখিত ফর্ম্যাট ব্যবহার করে:

customers/{customer_id}/userLists/{user_list_id}

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

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

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

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

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

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

AddOfflineUserDataJobOperationsRequest (Google Ads API)	IngestAudienceMembersRequest (ডেটা ম্যানেজার এপিআই)	নোট
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	কোনো সমতুল্য নেই	ডেটা ম্যানেজার এপিআই আংশিক ব্যর্থতা সমর্থন করে না। যদি কোনো IngestAudienceMembersRequest এর কোনো ফিল্ড ভ্যালিডেশনে ব্যর্থ হয়, তাহলে ডেটা ম্যানেজার এপিআই সম্পূর্ণ অনুরোধটি প্রত্যাখ্যান করে। ডায়াগনস্টিকস ব্যবহার করে প্রসেসিং ত্রুটিগুলো সংগ্রহ করুন।
enable_warnings	কোনো সমতুল্য নেই	ডেটা ম্যানেজার এপিআই রেসপন্সে কোনো সতর্কবার্তা রিপোর্ট করে না। ডায়াগনস্টিকস ব্যবহার করে প্রসেসিং সতর্কবার্তাগুলো সংগ্রহ করুন।
validate_only	validate_only
operations	audience_members	দর্শক সদস্যদের তালিকা। বিস্তারিত তথ্যের জন্য ‘ দর্শক সদস্য ক্ষেত্রসমূহ’ অংশটি দেখুন।
কোনো সমতুল্য নেই	terms_of_service	আবশ্যক। ব্যবহারকারী কাস্টমার ম্যাচের পরিষেবার শর্তাবলী গ্রহণ করেছেন বা প্রত্যাখ্যান করেছেন, তা বোঝানোর জন্য এটি সেট করতে হবে।

গ্রাহক এবং দর্শক ক্ষেত্র

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

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

ডেটা ম্যানেজার এপিআই কোনো অডিয়েন্সের সকল সদস্যকে অপসারণ করা সমর্থন করে না। গুগল অ্যাডস এপিআই-তে, আপনি একটি OfflineUserDataJobOperation এর remove_all ফিল্ডকে true সেট করার মাধ্যমে কোনো অডিয়েন্সের সকল সদস্যকে অপসারণ করতে পারেন।

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

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

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

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

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

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

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

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

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

ঠিকানা ক্ষেত্র

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

OfflineUserAddressInfo (গুগল বিজ্ঞাপন এপিআই)	AddressInfo (ডেটা ম্যানেজার এপিআই)	নোট
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 (গুগল অ্যাডস এপিআই)	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 অডিয়েন্স মেম্বারের ইউজার আইডিতে সেট করুন।

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