Yerel Hizmetler 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 özetlenmiştir.
Desteklenen işlemler
Yerel Hizmetler kampanyalarını ve bütçelerini alma
Yerel Hizmetler kampanyaları ve bütçeleri, advertising_channel_type = 'LOCAL_SERVICES'
olan 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 Hizmet kampanyalarını düzenleyin
Kampanyanın status
ve ilişkili kampanya bütçesinin amount_micros
alanlarını güncelleyebilirsiniz.
Yerel Hizmet kampanyalarının teklif stratejisini belirleme
Aşağıdaki teklif stratejilerini Yerel Hizmet kampanyalarının standart teklif stratejisi olarak belirleyebilirsiniz:
ManualCpa
(manual_cpa
alanını ayarlayarak)Teklifleri
ManualCpa
ileLocalServicesCampaignSettings.category_bids
arasında belirleyebilirsiniz. AncakCampaign.local_services_campaign_settings
olsa daLocalServicesCampaignSettings
Yerel Hizmetler kampanyasını alıp ayarlayabilirsiniz.maximize_conversions
alanını ayarlayarakMaximizeConversions
Reklam zaman planlamasını kampanya ölçütü olarak ayarlama
Yerel Hizmetler kampanyasında kampanya ölçütü olarak reklam zaman planlaması ayarlayabilirsiniz.
Bir AdScheduleInfo
oluşturun ve CampaignCriterionService.MutateCampaignCriteria
aracını kullanarak Google Ads API'ye gönderilen
CampaignCriterion
için ad_schedule
olarak ayarlayın.
Konum hedeflemeyi ayarlama
Bir Yerel Hizmetler kampanyasında konum hedeflemeyi etkinleştirmek için bir
LocationInfo
ekleyin ve bunu,
CampaignCriterionService.MutateCampaignCriteria
kullanılarak Google Ads API'ye gönderilen
CampaignCriterion
öğesinin
location
değerine ayarlayın.
Daha fazla bilgi için Konum hedefleme bölümüne bakın.
Belirli hizmet türlerini hedefle
Hedeflemeyi belirli bir hizmet türü için etkinleştirmek üzere bir LocalServiceIdInfo
ekleyip 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 Hizmet kampanyalarının oluşturulmasını engeller. |
Bir kampanyadaki alt varlıklar üzerindeki işlemler | Google Ads API, Yerel Hizmetler 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ı
Google Ads API v15 sürümünden itibaren, 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 yapan müşteri hesabında bir Yerel Hizmetler kampanyası olmalıdır. Müşteri hesabı başına yalnızca bir Yerel Hizmetler kampanyası olabileceğinden, bu kaynaklar bir kampanyayı belirtmez. Bu kaynakların ilişkili 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 reklamverenden bir hizmeti aradığında, mesaj gönderdiğinde veya bu hizmet için rezervasyon yaptığında oluşturulan potansiyel müşteri ayrıntılarını gösterir.
Yerel Hizmetler hizmet talebi verileri local_services_lead
kaynağından alınabilir. Örnek bir sorgu şöyle:
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ı boştur.category_id
öğesinin bir sağlık kategorisinde yer aldığı hizmet taleplerindeki veriler kullanılamaz.
Yerel Hizmetler potansiyel müşteri görüşmesi
LocalServicesLeadConversation
, LocalServicesLead
kapsamında gerçekleşmiş görüşmelerin ayrıntılarını gösterir. LocalServicesLead
ile bire-çok bir ilişki vardır. Bu ilişkide bir potansiyel müşterinin çok sayıda görüşme yapılabilir. İlgili potansiyel müşterinin kaynak adı lead
alanında bulunabilir.
Sohbet 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, bir LocalServicesLead
öğesine LocalServicesLeadConversation
kaynakları eklemek için LocalServicesLeadService.AppendLeadConversation
yöntemini kullanabilirsiniz.
Sınırlamalar
- Arama kaydetme URL'sine erişmek için potansiyel müşterinin ilişkilendirildiği kampanyanın sahibi olan Google Ads müşteri hesabına en azından salt okuma erişimi olan bir e-posta adresiyle oturum açmanız gerekir.
Tüm görüşmeleri tek seferde istemek zaman alan bir istek olabilir. Bu nedenle, görüşmeleri potansiyel müşteriye göre filtrelemelisiniz. Ö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ısı
LocalServicesVerificationArtifact
, reklamverenlerin işletmeleri için doğrulama verilerini sunar. Bu doğrulamaların işletme düzeyinde olduğunu ve çalışanlar için doğrulama içermediğini unutmayın. Veriler şunları 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 müşteri 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 yapısı, temsil ettiği doğrulama isteğinin türüne bağlı olarak aşağıdaki bilgilerin bazılarını içerebilir:
- Her bir doğrulama yapısının durumu
- Geçmiş kontrolü doğrulaması için kullanılacak geçmiş kontrolü URL'si
- Geçmiş kontrolü karar zamanı (varsa)
- Önceden gönderilmiş olan Sigorta bilgilerini görüntülemek için sigorta belgesi URL'si
- Sigorta ret nedeni (varsa)
- Lisans ayrıntıları (tür, numara, ad, soyadı)
- Lisansın reddedilme nedeni (varsa)
- Daha önce gönderilen lisans resmini görüntülemek için lisans dokümanı URL'si (varsa)
- İşletme tescili bilgileri (kontrol kimliği, tescil numarası)
- İşletme tescilinin reddedilme nedeni (varsa)
- Daha önce gönderilen kayıt resmini gösteren işletme tescil belgesi URL'si (varsa)
Doğrulama yapı verileri local_services_verification_artifact
kaynağından alınabilir. Belirli bir müşteri hesabı için lisansla ilgili tüm doğrulama yapılarının verilerini alan örnek bir 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 de coğrafi hedef koduna) ve yerel hizmet kategorisi kimliğine göre programatik olarak belirlemek için customer
kaynağında LocalServicesSetting
adlı yeni bir alanı kullanabilirsiniz.
Bu alanda, konuma ve kategoriye göre lisans ve sigorta doğrulaması isteklerinin durumunun genel bir özeti gösterilir. Aşağıda, bu tür verilerin tamamını alan örnek bir 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
, yerel hizmet çalışanları hakkında reklamverenlerin reklam profillerini yüklediği verileri sistemlerimize gösterir.
Belirli bir müşteri hesabındaki tüm yerel hizmet çalışanlarına ait verileri alan örnek bir sorguyu aşağıda görebilirsiniz:
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