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 kampanya 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 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:
manual_cpaalanınıManualCpaolarak ayarlayarakManualCpateklifleriniLocalServicesCampaignSettings.category_bidsüzerinden ayarlayabilirsiniz. Yerel Hizmet kampanyalarınınLocalServicesCampaignSettingsözelliğiniCampaign.local_services_campaign_settingsaracılığıyla alabilir ve ayarlayabilirsiniz.maximize_conversionsalanınıMaximizeConversionsolarak 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 özelliğinin ad_schedule öğesi olarak ayarlayın.
Konum hedeflemeyi ayarlama
Bir Yerel Hizmetler kampanyasında konum hedeflemeyi etkinleştirmek için LocationInfo ekleyin ve CampaignCriterionService.MutateCampaignCriteria kullanarak Google Ads API'ye gönderilen CampaignCriterion özelliğinin location öğesi 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 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üşteriye puan ve geri bildirim göndermek için LocalServicesLeadService özelliğinin ProvideLeadFeedback() yöntemini kullanın. 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 yöntemini de 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 kullanıma sunulur:
local_services_leadlocal_services_lead_conversationlocal_services_verification_artifactlocal_services_employee
Bu kaynakların veri döndürebilmesi için isteği gönderen müşteri hesabında bir Yerel Hizmetler kampanyası olması gerekir. 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 potansiyel müşteri
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_detailsalanı,lead_statusileWIPED_OUTeşitse null olur.category_idsağlık hizmeti kategorisinde yer alan hizmet taleplerinden elde edilen veriler kullanılamaz.
Yerel Hizmetler potansiyel müşteri 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.
Görüşme 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 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 öğ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 (varsa)
- Daha önce gönderilmiş lisans resmini görüntülemek için lisans belgesi URL'si (varsa)
- İşletme tescili bilgileri (kimlik kontrolü, tescil numarası)
- İşletme tescilinin reddedilme nedeni (varsa)
- Daha önce gönderilmiş tescil resmini (varsa) görüntülemek için işletme tescili belgesi URL'si
Doğrulama yapısı verileri, local_services_verification_artifact kaynağından alınabilir. Belirli bir müşteri hesabıyla ilgili tüm lisans doğrulama yapıları için verileri 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, konuma ve kategoriye göre lisans ve sigorta doğrulama isteklerinin durumuyla ilgili üst düzey bir özet sunar. Aşağıda, bu tür verilerin tümünü alan bir sorgu örneği 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
Yerel Hizmetler Maksimum Performans kampanyaları
Maksimum Performans kampanyaları, v24.2'den itibaren Yerel Hizmetler ile ilgili ayarları destekler. Bu ayarlar, Yerel Hizmet Reklamları yayınlayan bir Maksimum Performans kampanyası (GLS PMax) yapılandırmanıza ve tanımlamanıza olanak tanır.
Yerel Hizmet Maksimum Performans kampanyalarını belirleme
Bir Maksimum Performans kampanyasının Yerel Hizmet kampanyası olup olmadığını belirlemek için kampanyanın pmax_campaign_settings bölümündeki salt okunur local_services_enabled alanını kontrol edin.
Ayarları yapılandırma
local_services_enabled değerinin true olduğu kampanyalarda, local_services_pmax_campaign_settings alanındaki ayarları yapılandırın:
navigational_query_leads_enabled: Gezinme sorgusu filtresi kullanılıp kullanılmayacağı.founding_year: İşletmenin kuruluş yılı.country_code: Yerel Hizmet Reklamı'nın ülke kodu. Bu alan değişmezdir ve reklam oluşturma sırasında bir kez ayarlanır. Doğrulama şartlarını belirlemek ve konum ölçütü seçimini doğrulamak için kullanılan, büyük harflerden oluşan iki harfli bir ülke kodudur.phone_numbers: Sağlayıcıyla ilişkili telefon numaralarının listesi,LocalServicesPhoneNumbermesajlarıyla gösterilir.
Telefon numaraları
phone_numbers yinelenen alanındaki her giriş, aşağıdaki alanlarla birlikte LocalServicesPhoneNumber ileti türünü kullanır:
phone_number: Telefon numarası.country_code: Büyük harf, iki harfli ülke kodu.phone_number_type:GlsPhoneNumberTypeEnum.GlsPhoneNumberTypetarafından tanımlanan telefon numarası türü. Desteklenen türler şunlardır:DESTINATION_PHONE_NUMBER_FOR_ADS: Yerel Hizmet reklam biriminden gelen aramalar için kullanılacak hedef numara (varsayılan).DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: SMS'i destekleyen hedef numara.DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Sağlayıcının WhatsApp hesabının hedef numarası.