Yerel Hizmetler kampanyaları, işletmenizin Google'da reklamını yapmanıza ve doğrudan potansiyel müşterilerden hizmet talebi almanıza olanak tanır. Bu kılavuzda, Google Ads API'nin mevcut sürümünde desteklenen işlemler ve kısıtlamalar özetlenmiştir.
Desteklenen işlemler
Aşağıdaki işlemler desteklenir.
Yerel Hizmetler kampanyalarını ve bütçelerini alma
Yerel hizmetler kampanyaları ve bütçeleri, advertising_channel_type = 'LOCAL_SERVICES'
olduğunda kampanya kaynaklarını sorgulamak için GoogleAdsService.Search
veya GoogleAdsService.SearchStream
yöntemi kullanılarak alınabilir. Örnek:
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'
Yerel hizmetler kampanyalarını düzenleme
Kampanyanın status
ve ilişkili kampanya bütçesinin amount_micros
alanlarını güncelleyebilirsiniz.
Yerel hizmet kampanyalarının teklif stratejisini ayarlama
Aşağıdaki teklif stratejilerini yerel hizmet kampanyalarının standart teklif stratejisi olarak ayarlayabilirsiniz:
ManualCpa
manual_cpa
alanını ayarlayarakManualCpa
teklifleriniLocalServicesCampaignSettings.category_bids
üzerinden ayarlayabilirsiniz.Campaign.local_services_campaign_settings
aracılığıylaLocalServicesCampaignSettings
Yerel Hizmet Reklamları kampanyasını alıp ayarlayabilirsiniz.MaximizeConversions
alanını ayarlayarakmaximize_conversions
Kampanya ölçütü olarak reklam zaman planlaması belirleme
Yerel hizmetler kampanyası için kampanya ölçütü olarak bir reklam zaman planlaması ayarlayabilirsiniz.
CampaignCriterionService.MutateCampaignCriteria
kullanarak bir AdScheduleInfo
oluşturun ve Google Ads API'ye gönderilen CampaignCriterion
öğesinin ad_schedule
olarak ayarlayın.
Konum hedeflemeyi ayarlama
Yerel Hizmetler kampanyası için yer hedeflemeyi etkinleştirmek üzere bir LocationInfo
ekleyin ve CampaignCriterionService.MutateCampaignCriteria
kullanarak Google Ads API'ye gönderilen CampaignCriterion
öğesinin location
olarak ayarlayın.
Daha fazla bilgi için konum hedefleme bölümüne bakın.
Belirli hizmet türlerini hedefleme
Belirli bir hizmet türü için hedeflemeyi etkinleştirmek üzere bir LocalServiceIdInfo
ekleyin ve hizmet türüne ayarlayın.
Kampanyanızın hedefleme konumu ve kategorisi ile eşleşen bir hizmet kimliği kullanmanız gerekir.
Desteklenmeyen işlemler
Aşağıdaki tabloda listelenen kısıtlamalar, Google Ads API'nin gelecekteki sürümlerinde değişebilir.
Desteklenmeyen işlemler | |
---|---|
Kampanya oluşturma ve kaldırma | Google Ads API, yeni Yerel Hizmetler kampanyalarının oluşturulmasını engeller. |
Bir kampanyadaki alt öğelerle ilgili işlemler | Google Ads API, Yerel Hizmet kampanyalarında reklam gruplarının, reklamların veya ölçütlerin oluşturulmasını, değiştirilmesini, kaldırılmasını ya da aranmasını desteklemez. |
Yerel Hizmetler kaynakları
Yerel Hizmet Reklamları'ndaki bazı veriler, aşağıdaki salt okunur rapor kaynakları aracılığıyla doğrudan Google Ads API'de gösterilir:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Bu kaynakların veri döndürmesi için istek yapan müşteri hesabında bir Yerel Hizmetler kampanyası olmalıdır. Ayrıca, müşteri hesabı başına yalnızca bir Yerel Hizmet kampanyası olabileceğinden bu kaynaklarda kampanya belirtilmez. Bu kaynakların bağlı olduğu kampanyayı tanımlamak için aşağıdaki sorguyu kullanın:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Yerel Hizmetler hizmet talebi
LocalServicesLead
, bir tüketici reklamvereni aradığında, reklamverene mesaj gönderdiğinde veya reklamverenden bir hizmet rezervasyonu yaptığında oluşturulan potansiyel müşterinin ayrıntılarını gösterir.
Yerel Hizmetler potansiyel müşteri verileri, local_services_lead
kaynağından alınabilir. Aşağıda örnek bir sorgu verilmiştir:
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
Sınırlamalar
lead_status
,WIPED_OUT
değerine eşitsecontact_details
alanı null olur.category_id
değerinin bir sağlık hizmeti kategorisinin parçası olduğu hizmet taleplerinden elde edilen veriler kullanılamaz.
Yerel Hizmetler hizmet talebi sohbeti
LocalServicesLeadConversation
, LocalServicesLead
kapsamında gerçekleşen görüşmelerin ayrıntılarını gösterir. LocalServicesLead
ile bire çok ilişki vardır. Bu ilişkide bir potansiyel müşterinin birden fazla görüşmesi olabilir. İlgili potansiyel müşterinin kaynak adını lead
alanında bulabilirsiniz.
İleti dizisi verileri local_services_lead_conversation
kaynağından alınabilir. Aşağıda, telefon araması olan sonuçları filtreleyen örnek bir sorgu verilmiştir:
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'
Google Ads API'nin 17. sürümünden itibaren, LocalServicesLeadConversation
kaynaklarını bir LocalServicesLead
'e eklemek için LocalServicesLeadService.AppendLeadConversation
yöntemini kullanabilirsiniz.
Sınırlamalar
- Arama kaydı URL'sine erişmek için potansiyel müşterinin ilişkili olduğu kampanyanın sahibi olan Google Ads müşteri hesabına en az salt okuma erişimi olan bir e-posta adresiyle oturum açmanız gerekir.
Tüm görüşmeleri tek seferde istemek zaman alıcı bir istek olabilir. Bu nedenle, görüşmeleri potansiyel müşteriye göre filtrelemeniz gerekir. Örneğin:
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.id = LEAD_ID
Yerel hizmetler doğrulama yapıları
LocalServicesVerificationArtifact
reklamverenlerin işletmelerine ait doğrulama verilerini gösterir. Bu doğrulamaların işletme düzeyinde olduğunu ve çalışanların doğrulamalarını içermediğini unutmayın. Bu veriler aşağıdakileri içerir:
- Lisans doğrulamaları
- Sigorta doğrulamaları
- Geçmiş kontrolü doğrulamaları
- İşletme tescili doğrulamaları
Yerel Hizmet Reklamları'na her doğrulama isteği gönderildiğinde Google Ads API'de bu istek için yeni bir doğrulama yapı örneği oluşturulur ve her doğrulama yapı örneği tek bir doğrulama isteğini temsil eder. Her doğrulama yapısını temsil ettiği doğrulama isteği türüne bağlı olarak aşağıdaki bilgilerden bazılarını içerebilir:
- Her doğrulama yapısını durumu
- Geçmiş kontrolü doğrulaması için kullanılacak geçmiş kontrolü URL'si
- Geçmiş kontrolü karar verme süresi (varsa)
- Daha önce gönderilmiş sigorta bilgilerini görüntülemek için sigorta belgesi URL'si
- Sigorta reddedilme nedeni (varsa)
- Lisans ayrıntıları (tür, numara, ad, soyadı)
- Lisans reddedilme nedeni (varsa)
- Gönderilmiş lisans resmini görüntülemek için lisans belgesi URL'si (varsa)
- İşletme tescili bilgileri (kimlik numarası, tescil numarası)
- İşletme tescili reddedilme nedeni (varsa)
- Gönderilmiş tescil resmini görüntülemek için işletme tescili belgesi URL'si (varsa)
Doğrulama yapı verileri local_services_verification_artifact
kaynağından alınabilir. Belirli bir müşteri hesabının lisansla ilgili tüm doğrulama yapılarının verilerini alan örnek bir sorgu aşağıda verilmiştir:
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'
Coğrafi ve kategorik lisans ve sigorta verileri
Doğrulama isteklerinin durumunu coğrafi konuma (özellikle coğrafi hedef kodu) ve yerel hizmet kategorisi kimliğine göre programatik olarak belirlemek için customer
kaynağında LocalServicesSettings
adlı yeni bir alanı kullanabilirsiniz.
Bu alan, lisans ve sigorta doğrulama isteklerinin durumunu konuma ve kategoriye göre üst düzey bir özet halinde gösterir. Aşağıda, bu tür tüm verileri alan bir örnek sorgu verilmiştir:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
Yerel hizmet çalışanı
LocalServicesEmployee
, reklamverenlerin reklam profillerini sistemlerimize yüklediği yerel hizmet çalışanlarıyla ilgili verileri gösterir.
Belirli bir müşteri hesabındaki tüm yerel servis çalışanlarının verilerini alan örnek bir sorgu aşağıda verilmiştir:
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