Yerel Hizmet kampanyaları, Google'da işletmenizin 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 özetlenmektedir.
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, GoogleAdsService.Search
veya GoogleAdsService.SearchStream
yöntemi kullanılarak campaign kaynakları için sorgulanabilir. Burada advertising_channel_type = 'LOCAL_SERVICES'
. Ö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 Hizmet 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
alanınımanual_cpa
olarak ayarlayarakManualCpa
teklifleriniLocalServicesCampaignSettings.category_bids
üzerinden ayarlayabilirsiniz. Yerel Hizmet kampanyalarınınLocalServicesCampaignSettings
'ınıCampaign.local_services_campaign_settings
aracılığıyla alabilir ve ayarlayabilirsiniz.MaximizeConversions
alanınımaximize_conversions
olarak ayarlayarak
Reklam zaman planlamasını kampanya ölçütü olarak ayarlama
Yerel Hizmet kampanyaları için reklam zaman planlamasını kampanya ölçütü olarak ayarlayabilirsiniz.
AdScheduleInfo
oluşturun ve CampaignCriterionService.MutateCampaignCriteria
kullanarak Google Ads API'ye gönderilen CampaignCriterion
'nin ad_schedule
olarak ayarlayın.
Yer hedeflemeyi ayarlama
Bir Yerel Hizmetler kampanyasında yer hedeflemeyi etkinleştirmek için LocationInfo
ekleyin ve CampaignCriterionService.MutateCampaignCriteria
kullanarak Google Ads API'ye gönderilen CampaignCriterion
'nın location
olarak ayarlayın. Daha fazla bilgi için Konum hedefleme başlıklı makaleyi inceleyin.
Belirli hizmet türlerini hedefleme
Belirli bir hizmet türü için hedeflemeyi etkinleştirmek üzere LocalServiceIdInfo
ekleyin ve bunu hizmet türü olarak ayarlayın.
Kampanyanızın hedefleme konumu ve kategorisiyle eşleşen bir hizmet kimliği kullanmanız gerekir.
Hizmet talebi geri bildirimi gönderme
Bir potansiyel müşteri için puan ve geri bildirim göndermek üzere ProvideLeadFeedback()
yöntemini kullanın.LocalServicesLeadService
Bir potansiyel müşterinin derecelendirilip derecelendirilmediğini ve geri bildirim gönderilip gönderilmediğini belirlemek için LocalServicesLead
alanının lead_feedback_submitted
alanını da inceleyebilirsiniz.
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. |
Kampanyadaki alt öğeler üzerinde yapılan işlemler | Google Ads API, Yerel Hizmet kampanyalarındaki reklam gruplarının, reklamların veya ölçütlerin oluşturulmasını, değiştirilmesini, kaldırılmasını ya da alınması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 isteği gönderen müşteri hesabında bir Yerel Hizmetler kampanyası olması gerekir. Ayrıca, müşteri hesabı başına yalnızca bir Yerel Hizmet kampanyası olabileceğinden bu kaynaklarda kampanya belirtilmez. Bu kaynakların ilişkili olduğu kampanyayı belirlemek 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 hizmet rezervasyonu yaptığında oluşturulan potansiyel müşteri ayrıntılarını gösterir.
Yerel Hizmetler potansiyel müşteri verileri, local_services_lead
kaynağından alınabilir. Örnek sorgu:
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
contact_details
alanı,lead_status
ileWIPED_OUT
eşitse null olur.category_id
sağlık hizmeti kategorisinde yer alan potansiyel müşterilerden elde edilen veriler kullanılamaz.
Yerel Hizmetler hizmet talebi görüşmesi
LocalServicesLeadConversation
LocalServicesLead
kapsamında gerçekleşen görüşmelerin ayrıntılarını gösterir. LocalServicesLead
ile bire-çok ilişkisi vardır. Bir potansiyel müşterinin birden fazla görüşmesi olabilir. İlgili potansiyel müşterinin kaynak adı lead
alanında bulunabilir.
İleti dizisi verileri, local_services_lead_conversation
kaynağından alınabilir. Aşağıda, telefon görüşmesi olan sonuçları filtreleyen bir sorgu örneği 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'
LocalServicesLeadService.AppendLeadConversation
yöntemini kullanarak
LocalServicesLeadConversation
kaynaklarını bir LocalServicesLead
'ye ekleyebilirsiniz.
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 giriş yapmanız gerekir.
Tüm görüşmeleri aynı anda istemek zaman alabilir. Bu nedenle, görüşmeleri potansiyel müşteriye göre filtrelemeniz önerilir. Ö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
Local Services doğrulama öğesi
LocalServicesVerificationArtifact
Reklamverenlerin işletmeleriyle ilgili doğrulama verilerini gösterir. Bu doğrulamaların işletme düzeyinde olduğunu ve çalışan 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ısı örneği oluşturulur ve her doğrulama yapısı tek bir doğrulama isteğini temsil eder. Her doğrulama öğesi, temsil ettiği doğrulama isteğinin türüne bağlı olarak aşağıdaki bilgilerden bazılarını içerebilir:
- Her doğrulama öğesinin durumu
- Geçmiş kontrolü doğrulamasında kullanılacak geçmiş kontrolü URL'si
- Geçmiş kontrolü karar süresi (varsa)
- Daha önce gönderilmiş sigorta bilgilerini görüntülemek için sigorta belgesi URL'si
- Sigorta reddi nedeni (varsa)
- Lisans ayrıntıları (tür, numara, ad, soyadı)
- Lisansın reddedilme nedeni (geçerliyse)
- Daha önce gönderilmiş lisans resmini görüntülemek için lisans belgesi URL'si (varsa)
- İşletme tescili bilgileri (kimlik, tescil numarası)
- İşletme tescilinin reddedilme nedeni (varsa)
- Daha önce gönderilen kayıt resmini (varsa) görüntülemek için işletme tescili belgesi URL'si
Doğrulama yapısı verileri, local_services_verification_artifact
kaynağında alınabilir. Belirli bir müşteri hesabıyla ilgili tüm lisans doğrulama öğelerinin verilerini alan bir örnek sorguyu aşağıda bulabilirsiniz:
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 konum ve kategoriye göre durumunun üst düzey bir özetini gösterir. Aşağıda, bu tür verilerin tümünü 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 hizmet çalışanlarının verilerini alan bir sorgu örneğini aşağıda bulabilirsiniz:
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