স্থানীয় পরিষেবার ক্যাম্পেন আপনাকে Google-এ ব্যবসার বিজ্ঞাপন দিতে এবং সম্ভাব্য গ্রাহকদের থেকে সরাসরি লিড পেতে দেয়। এই নির্দেশিকায় Google Ads API-তে কাজ করে এমন অপারেশন ও বিধিনিষেধের সংক্ষিপ্তসার দেওয়া আছে।
যেসব অপারেশন কাজ করে
Google Ads API, স্থানীয় পরিষেবা ক্যাম্পেনের জন্য নিম্নলিখিত অপারেশনগুলি সাপোর্ট করে।
স্থানীয় পরিষেবার ক্যাম্পেন ও বাজেট ফিরিয়ে আনুন
GoogleAdsService.Search বা
GoogleAdsService.SearchStream
পদ্ধতি ব্যবহার করে স্থানীয় পরিষেবা ক্যাম্পেন ও বাজেট ফিরিয়ে আনা যেতে পারে, যেখানে Campaign রিসোর্সের জন্য কোয়েরি করা হয়, যেখানে
advertising_channel_type = 'LOCAL_SERVICES'। এখানে একটি উদাহরণ দেওয়া হল:
SELECT
campaign.id,
campaign.status,
campaign_budget.id,
campaign_budget.period,
campaign_budget.amount_micros,
campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
স্থানীয় পরিষেবার ক্যাম্পেন এডিট করুন
আপনি ক্যাম্পেনের status এবং
সংশ্লিষ্ট ক্যাম্পেন বাজেটের
amount_micros ফিল্ড আপডেট করতে পারবেন।
বিডিং স্ট্র্যাটেজি সেট করুন
আপনি স্থানীয় পরিষেবা ক্যাম্পেনের স্ট্যান্ডার্ড বিডিং স্ট্র্যাটেজি হিসেবে নিম্নলিখিত বিডিং স্ট্র্যাটেজি সেট করতে পারবেন:
manual_cpaফিল্ড সেট করেManualCpaআপনি
ManualCpa-এর বিডLocalServicesCampaignSettings.category_bids-এর মাধ্যমে সেট করতে পারবেন। আপনিCampaign.local_services_campaign_settings-এর মাধ্যমে স্থানীয় পরিষেবা ক্যাম্পেনেরLocalServicesCampaignSettingsপুনরুদ্ধার ও সেট করতে পারবেন।maximize_conversionsফিল্ড সেট করেMaximizeConversions
ক্যাম্পেন সংক্রান্ত মাপকাঠি হিসেবে বিজ্ঞাপন শিডিউল সেট করা
আপনি ক্যাম্পেন মাপকাঠি হিসেবে স্থানীয় পরিষেবা ক্যাম্পেনের জন্য বিজ্ঞাপনের শিডিউল সেট করতে পারবেন।
Google Ads API-তে পাঠানো
CampaignCriterion-এর
ad_schedule-এ একটি AdScheduleInfo তৈরি করে সেট করুন। এটি করতে
CampaignCriterionService.MutateCampaignCriteria ব্যবহার করুন।
লোকেশন টার্গেটিং সেট করুন
স্থানীয় পরিষেবা ক্যাম্পেনের জন্য লোকেশন টার্গেটিং চালু করতে, একটি
LocationInfo যোগ করুন এবং এটিকে Google Ads API-তে পাঠানো
location ফিল্ডের
CampaignCriterion-এ সেট করুন, এর জন্য
CampaignCriterionService.MutateCampaignCriteria ব্যবহার করুন।
আরও জানতে, লোকেশন
টার্গেটিং দেখুন।
নির্দিষ্ট পরিষেবার ধরন টার্গেট করা
নির্দিষ্ট পরিষেবার ধরনের জন্য টার্গেটিং চালু করতে, একটি
LocalServiceIdInfo তৈরি করুন যার মধ্যে একটি
স্থানীয় পরিষেবার বিভাগ আইডি আছে, এটি
CampaignCriterion-এর
local_service_id ফিল্ডে সেট করুন এবং
CampaignCriterionService.MutateCampaignCriteria ব্যবহার করে জমা দিন।
আপনার ক্যাম্পেনের টার্গেটিংয়ের সাথে মেলে এমন পরিষেবা আইডি ব্যবহার করা উচিত লোকেশন এবং বিভাগ।
লিড সংক্রান্ত মতামত জমা দেওয়া
লিডের জন্য রেটিং ও মতামত জমা দিতে
LocalServicesLeadService-এর
ProvideLeadFeedback পদ্ধতি ব্যবহার করুন। এছাড়াও, আপনি
LocalServicesLead-এর
lead_feedback_submitted ফিল্ডটি পরীক্ষা করে দেখতে পারেন,
যাতে কোনও লিড রেট করা হয়েছে এবং মতামত জমা দেওয়া হয়েছে কিনা তা নির্ধারণ করতে সাহায্য করা যায়।
অসমর্থিত অপারেশন
নিচের সারণীতে স্ট্যান্ডঅ্যালোন স্থানীয় পরিষেবা ক্যাম্পেনের (advertising_channel_type = 'LOCAL_SERVICES') জন্য কাজ না করা অপারেশনগুলি তালিকাভুক্ত করা হয়েছে।
| কাজ করে না এমন অপারেশন | |
|---|---|
| ক্যাম্পেন তৈরি ও সরিয়ে দেওয়া | Google Ads API, স্বতন্ত্র স্থানীয় পরিষেবা
ক্যাম্পেন (advertising_channel_type = 'LOCAL_SERVICES') তৈরি ও সরিয়ে দেওয়া ব্লক করে।
v26 থেকে শুরু করে, আপনি
pmax_campaign_settings.local_services_enabled = true সেট করে নতুন স্থানীয়
পরিষেবা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন
(advertising_channel_type = 'PERFORMANCE_MAX') তৈরি করতে পারবেন; দেখুন
স্থানীয় পরিষেবা পারফর্ম্যান্স ম্যাক্স
ক্যাম্পেন তৈরি করুন। |
| ক্যাম্পেনের মধ্যে সাব-এন্টিটি সংক্রান্ত অপারেশন | স্ট্যান্ডঅ্যালোন স্থানীয় পরিষেবা ক্যাম্পেনের
(advertising_channel_type = 'LOCAL_SERVICES') জন্য, Google Ads API
সমর্থিত অপারেশন-এ তালিকাভুক্ত ক্যাম্পেন সংক্রান্ত মাপকাঠি ছাড়া অন্য কোনও বিজ্ঞাপন
গ্রুপ, বিজ্ঞাপন বা মাপকাঠি তৈরি, পরিবর্তন, সরানো বা ফিরিয়ে আনার সুবিধা প্রদান
করে না। স্থানীয়
পরিষেবা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের জন্য, অ্যাসেট গ্রুপ এবং
ক্যাম্পেন সংক্রান্ত মাপকাঠি ব্যবহার করুন। |
স্থানীয় পরিষেবা সংক্রান্ত রিসোর্স
স্থানীয় পরিষেবার বিজ্ঞাপন থেকে পাওয়া কিছু ডেটা নিম্নলিখিত শুধুমাত্র-পঠনযোগ্য রিপোর্ট রিসোর্সের মাধ্যমে Google Ads API-তে সরাসরি প্রকাশ করা হয়:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
এইসব রিসোর্স থেকে ডেটা পেতে হলে, ক্লায়েন্ট অ্যাকাউন্টে অবশ্যই কোনও Local Services ক্যাম্পেন থাকতে হবে যা অনুরোধ করছে। যেহেতু প্রতিটি ক্লায়েন্ট অ্যাকাউন্টে শুধুমাত্র একটি স্থানীয় পরিষেবা ক্যাম্পেন থাকতে পারে, তাই এই রিসোর্সগুলি কোনও ক্যাম্পেন নির্দিষ্ট করে না। এইসব রিসোর্স কোন ক্যাম্পেনের সাথে অ্যাফিলিয়েট করা আছে তা শনাক্ত করতে, নিম্নলিখিত কোয়েরি ব্যবহার করুন:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
স্থানীয় পরিষেবার লিড
LocalServicesLead-এর মাধ্যমে
বিজ্ঞাপনদাতার থেকে কোনও গ্রাহক কল, মেসেজ বা বুকিং করলে তৈরি হওয়া লিডের
বিবরণ প্রকাশ করা হয়।
স্থানীয় পরিষেবার লিড ডেটা
local_services_lead রিসোর্স থেকে ফিরিয়ে আনা যাবে। এখানে একটি
কোয়েরির উদাহরণ দেওয়া হল:
SELECT
local_services_lead.lead_type,
local_services_lead.category_id,
local_services_lead.service_id,
local_services_lead.contact_details,
local_services_lead.lead_status,
local_services_lead.creation_date_time,
local_services_lead.locale,
local_services_lead.lead_charged,
local_services_lead.credit_details.credit_state,
local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead
সীমাবদ্ধতা
lead_status,WIPED_OUT-এর সমান হলেcontact_detailsফিল্ডটি নাল হয়।v25থেকে শুরু করে,ContactDetails.emailসরিয়ে দেওয়া হয়েছে এবংContactDetails.phone_number_extension,local_services_lead.contact_details-এর মাধ্যমে ফেরত পাঠানোContactDetailsমেসেজে উপলভ্য।category_idকোনও স্বাস্থ্য পরিষেবা বিভাগের অংশ হলে, লিড থেকে পাওয়া ডেটা উপলভ্য হয় না।
স্থানীয় পরিষেবার লিড কথোপকথন
LocalServicesLeadConversation
LocalServicesLead-এর
অংশ হিসেবে হওয়া কথোপকথনের বিবরণ প্রকাশ করে। LocalServicesLead-এর সাথে এক থেকে একাধিক সম্পর্ক আছে, যেখানে একটি লিডের সাথে একাধিক কথোপকথন হতে পারে। সম্পর্কিত লিডের জন্য রিসোর্সের
নাম lead ফিল্ডে পাওয়া যাবে।
কথোপকথন সংক্রান্ত ডেটা
local_services_lead_conversation
রিসোর্স থেকে পাওয়া যেতে পারে। ফোন
কলের ফলাফল ফিল্টার করার জন্য এখানে একটি কোয়েরির উদাহরণ দেওয়া হল:
SELECT
local_services_lead_conversation.id,
local_services_lead_conversation.conversation_channel,
local_services_lead_conversation.participant_type,
local_services_lead_conversation.lead,
local_services_lead_conversation.event_date_time,
local_services_lead_conversation.phone_call_details.call_duration_millis,
local_services_lead_conversation.phone_call_details.call_recording_url,
local_services_lead_conversation.message_details.text,
local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'
আপনি
LocalServicesLeadService.AppendLeadConversation
পদ্ধতি ব্যবহার করে
LocalServicesLeadConversation
রিসোর্স LocalServicesLead-এ যোগ করতে পারবেন।
সীমাবদ্ধতা
- কল রেকর্ডিং URL অ্যাক্সেস করতে, আপনাকে এমন একটি ইমেল আইডি দিয়ে সাইন-ইন করতে হবে যার কাছে লিডের সাথে যুক্ত ক্যাম্পেনের মালিক Google Ads ক্লায়েন্ট অ্যাকাউন্টের অন্তত শুধু পড়ার অ্যাক্সেস আছে।
একসাথে সব কথোপকথনের অনুরোধ করলে অনেক সময় লাগতে পারে, তাই আপনার উচিত লিড অনুযায়ী কথোপকথন ফিল্টার করা, যেমন:
SELECT local_services_lead_conversation.id, local_services_lead_conversation.event_date_time, local_services_lead_conversation.message_details.text FROM local_services_lead_conversation WHERE local_services_lead_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
যাচাইকরণ আর্টিফ্যাক্ট
LocalServicesVerificationArtifact
বিজ্ঞাপনদাতার ব্যবসার যাচাইকরণ ডেটা প্রকাশ করে। মনে রাখবেন যে এই
যাচাইকরণগুলি ব্যবসার লেভেলে করা হয় এবং এর মধ্যে কর্মীদের
যাচাইকরণ অন্তর্ভুক্ত নয়। ডেটাতে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত:
- লাইসেন্স যাচাইকরণ
- বীমা সংক্রান্ত যাচাইকরণ
- ব্যাকগ্রাউন্ড চেক যাচাইকরণ
- ব্যবসার রেজিস্ট্রেশন যাচাইকরণ
স্থানীয় পরিষেবার বিজ্ঞাপনে কোনও যাচাইকরণের অনুরোধ জমা দেওয়া হলে, Google Ads API-তে সেটির জন্য একটি নতুন যাচাইকরণ আর্টিফ্যাক্ট ইনস্ট্যান্স তৈরি করা হয় এবং প্রতিটি যাচাইকরণ আর্টিফ্যাক্ট একটি যাচাইকরণের অনুরোধকে বোঝায়। যাচাইকরণের প্রতিটি আর্টিফ্যাক্টে নিম্নলিখিত কিছু তথ্য থাকতে পারে, এটি কোন ধরনের যাচাইকরণের অনুরোধ উপস্থাপন করে তার উপর নির্ভর করে:
- প্রতিটি যাচাইকরণ আর্টিফ্যাক্টের স্ট্যাটাস
- ব্যাকগ্রাউন্ড চেক যাচাইকরণের জন্য ব্যাকগ্রাউন্ড চেক URL ব্যবহার করা হবে
- ব্যাকগ্রাউন্ড চেক সংক্রান্ত সিদ্ধান্ত নেওয়ার সময় (প্রযোজ্য হলে)
- আগে জমা দেওয়া ইন্স্যুরেন্স সংক্রান্ত তথ্য দেখতে ইন্স্যুরেন্স ডকুমেন্টের URL
- বীমা বাতিল করার কারণ (প্রযোজ্য হলে)
- লাইসেন্সের বিবরণ (ধরন, নম্বর, প্রথম ও শেষ নাম)
- লাইসেন্স প্রত্যাখ্যানের কারণ (প্রযোজ্য হলে)
- আগে জমা দেওয়া লাইসেন্সের ছবি দেখার জন্য লাইসেন্স ডকুমেন্ট URL (প্রযোজ্য হলে)
- ব্যবসার রেজিস্ট্রেশন সংক্রান্ত বিবরণ (আইডি, রেজিস্ট্রেশন নম্বর চেক করুন)
- ব্যবসার রেজিস্ট্রেশন বাতিল করার কারণ (প্রযোজ্য হলে)
- আগে জমা দেওয়া রেজিস্ট্রেশন ছবি (প্রযোজ্য হলে) দেখার জন্য ব্যবসার রেজিস্ট্রেশন ডকুমেন্টের URL
যাচাইকরণ আর্টিফ্যাক্ট ডেটা
local_services_verification_artifact
রিসোর্স থেকে পাওয়া যেতে পারে। এখানে একটি উদাহরণ কোয়েরি দেওয়া হল যা নির্দিষ্ট ক্লায়েন্ট অ্যাকাউন্টের জন্য লাইসেন্স-সম্পর্কিত যাচাইকরণ আর্টিফ্যাক্টের সব ডেটা ফিরিয়ে আনে:
SELECT
local_services_verification_artifact.id,
local_services_verification_artifact.creation_date_time,
local_services_verification_artifact.status,
local_services_verification_artifact.artifact_type,
local_services_verification_artifact.license_verification_artifact.license_type,
local_services_verification_artifact.license_verification_artifact.license_number,
local_services_verification_artifact.license_verification_artifact.licensee_first_name,
local_services_verification_artifact.license_verification_artifact.licensee_last_name,
local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'
ভৌগোলিক ও বিভাগীয় যাচাইকরণ ডেটা
ভৌগোলিক
লোকেশন (নির্দিষ্টভাবে, জিও টার্গেট কোড) এবং
স্থানীয় পরিষেবার বিভাগ
আইডি অনুসারে যাচাইকরণের অনুরোধের স্ট্যাটাস প্রোগ্রাম্যাটিক উপায়ে নির্ধারণ করতে, আপনি customer রিসোর্সে
local_services_settings
ফিল্ড ব্যবহার করতে পারেন, যার ধরন হল
LocalServicesSettings।
এই ফিল্ডে লোকেশন ও বিভাগ অনুযায়ী লাইসেন্স ও ইন্স্যুরেন্স যাচাইকরণের অনুরোধের স্ট্যাটাসের একটি হাই-লেভেল সারাংশ দেখানো হয়। এখানে একটি উদাহরণ কোয়েরি দেওয়া হল যা এই ধরনের সব ডেটা ফিরিয়ে আনে:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
স্থানীয় পরিষেবা প্রদানকারী কর্মচারী
LocalServicesEmployee স্থানীয় পরিষেবা কর্মীদের ডেটা প্রকাশ করে
যেখানে বিজ্ঞাপনদাতারা তাদের বিজ্ঞাপন
প্রোফাইল আমাদের সিস্টেমে আপলোড করেছেন।
এখানে একটি উদাহরণ কোয়েরি দেওয়া হল যা কোনও নির্দিষ্ট ক্লায়েন্ট অ্যাকাউন্টের জন্য সব স্থানীয় পরিষেবা কর্মচারীর ডেটা ফিরিয়ে আনে:
SELECT
local_services_employee.status,
local_services_employee.type,
local_services_employee.university_degrees,
local_services_employee.residencies,
local_services_employee.fellowships,
local_services_employee.job_title,
local_services_employee.year_started_practicing,
local_services_employee.languages_spoken,
local_services_employee.first_name,
local_services_employee.middle_name,
local_services_employee.last_name
FROM local_services_employee
স্থানীয় পরিষেবা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন
v24 থেকে শুরু করে, পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন স্থানীয় পরিষেবা-সম্পর্কিত সেটিংস
সাপোর্ট করে। এইসব সেটিংস আপনাকে এমন একটি পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন কনফিগার ও শনাক্ত করতে দেয় যা স্থানীয় পরিষেবার বিজ্ঞাপন (GLS PMax) পরিবেশন করে।
স্থানীয় পরিষেবার পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন তৈরি করা
v26 থেকে, আপনি API-এর মাধ্যমে নতুন স্থানীয় পরিষেবা পারফর্ম্যান্স ম্যাক্স
ক্যাম্পেন তৈরি করতে পারবেন। এর জন্য আপনাকে পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন
(advertising_channel_type = 'PERFORMANCE_MAX') তৈরি করতে হবে এবং
local_services_enabled = true-এ
pmax_campaign_settings (তৈরি করার পরে অপরিবর্তনীয়) সেট করতে হবে।
স্থানীয় পরিষেবার পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন তৈরি করার সময়, local_services_pmax_campaign_settings-এ country_code ও listing_id
দুটিই প্রয়োজন।
v24 ও v25-এ, API, আগে থেকে থাকা স্থানীয়
পরিষেবা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনের জন্য শুধুমাত্র আপডেট কাজ করে। এই ক্যাম্পেন UI-তে
হোয়াইটলিস্টে থাকা অ্যাকাউন্ট তৈরি করে।
স্থানীয় পরিষেবা পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন শনাক্ত করা
পারফর্ম্যান্স ম্যাক্স ক্যাম্পেনটি স্থানীয় পরিষেবার ক্যাম্পেন কিনা তা শনাক্ত করতে,
ক্যাম্পেনের pmax_campaign_settings-এ
local_services_enabled ফিল্ড চেক করুন।
সেটিংস কনফিগার করুন
যেসব ক্যাম্পেনে local_services_enabled হল true, সেগুলির জন্য
local_services_pmax_campaign_settings
ফিল্ডের
অধীনে সেটিংস কনফিগার করুন:
listing_id: ক্যাম্পেনের সাথে লিঙ্ক করা Google Business Profile লিস্টিং আইডি।v26থেকে শুরু করে, স্থানীয় পরিষেবার পারফর্ম্যান্স ম্যাক্স ক্যাম্পেন তৈরি করার সময় এই ফিল্ডটি প্রয়োজনীয় এবং অপরিবর্তনীয়। লিস্টিং আইডি অবশ্যই অ্যাকাউন্টের সাথে চালু করাLOCATIONঅ্যাসেট হিসেবে লিঙ্ক করা থাকতে হবে; অন্যথায়, APICampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_IDসমস্যা দেখাবে। যেহেতুlisting_id-কেIMMUTABLEহিসেবে চিহ্নিত করা হয়েছে, তাই ক্যাম্পেন তৈরি করার পরে এই ফিল্ড আপডেট করার চেষ্টা করলেRequestError.IMMUTABLE_FIELDদেখানো হবে। ডেভেলপাররাLOCATIONঅ্যাসেট (location_asset.business_profile_locationsইন্সপেক্ট করা) চালু করার জন্যAssetরিসোর্স কোয়েরি করে লিঙ্ক করা লিস্টিং আইডি খুঁজতে বা যাচাই করতে পারবেন। আরও তথ্যের জন্য, লোকেশন অ্যাসেট দেখুন।navigational_query_leads_enabled: নেভিগেশনাল কোয়েরি ফিল্টার ব্যবহার করা হবে কিনা।founding_year: ব্যবসাটি যে বছরে শুরু হয়েছে।country_code: স্থানীয় পরিষেবার বিজ্ঞাপনের কান্ট্রি কোড। এই ফিল্ড অপরিবর্তনীয় এবং বিজ্ঞাপন তৈরি করার সময় একবারই সেট করা হয়। এটি হল বড় হাতের অক্ষরে লেখা, দুই-অক্ষরের দেশ কোড, যা যাচাইকরণের প্রয়োজনীয়তা নির্ধারণ করতে এবং লোকেশন সংক্রান্ত মাপকাঠি যাচাই করতে ব্যবহার করা হয়।phone_numbers: পরিষেবা প্রদানকারীর সাথে যুক্ত ফোন নম্বরের তালিকা, যাLocalServicesPhoneNumberমেসেজের মাধ্যমে দেখানো হয়েছে।
ফোন নম্বর
phone_numbers রিপিট করা ফিল্ডের প্রতিটি এন্ট্রিতে
LocalServicesPhoneNumber মেসেজ টাইপ ব্যবহার করা হয় এবং
নিম্নলিখিত ফিল্ড থাকে:
phone_number: ফোন নম্বর।country_code: বড় হাতের অক্ষর, দু'টি অক্ষর দেশের কোড।phone_number_type: ফোন নম্বরের ধরন,GlsPhoneNumberTypeEnum.GlsPhoneNumberTypeদ্বারা নির্ধারিত। এই ধরনের ফাইল কাজ করে:DESTINATION_PHONE_NUMBER_FOR_ADS: লোকাল সার্ভিস বিজ্ঞাপন ইউনিট (ডিফল্ট) থেকে করা কলের জন্য ব্যবহার করার গন্তব্য নম্বর।DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: গন্তব্যের নম্বর যাতে এসএমএস কাজ করে।DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: কোনও পরিষেবা প্রদানকারীর WhatsApp অ্যাকাউন্টের গন্তব্য নম্বর।