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

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

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

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

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

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-তে, আপনি যে ধরণের ডেটা পাঠাচ্ছেন তার সাথে সঙ্গতিপূর্ণ ক্ষেত্রটি পূরণ করুন: