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
Yerel Hizmetler kampanyalarını ve bütçelerini alma
Yerel Hizmetler kampanyaları ve bütçeleri, advertising_channel_type = 'LOCAL_SERVICES'
olduğu 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ü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 Hizmetler kampanyalarının standart teklif stratejisi olarak ayarlayabilirsiniz:
ManualCpa
:manual_cpa
alanını ayarlayarakLocalServicesCampaignSettings.category_bids
ileManualCpa
tutarında teklif belirleyebilirsiniz.Campaign.local_services_campaign_settings
üzerindenLocalServicesCampaignSettings
Yerel Hizmetler kampanyasını alıp ayarlayabilirsiniz.MaximizeConversions
maximize_conversions
alanını ayarlayarak
Reklam zaman planlamasını kampanya ölçütü olarak ayarlama
Bir Yerel Hizmetler kampanyası için reklam zaman planlamasını kampanya ölçütü olarak ayarlayabilirsiniz.
Bir AdScheduleInfo
oluşturun ve CampaignCriterionService.MutateCampaignCriteria
kullanarak Google Ads API'ye gönderilen CampaignCriterion
öğesinin ad_schedule
değerini ayarlayın.
Yer hedeflemeyi ayarlama
Bir Yerel Hizmetler kampanyasında konum hedeflemeyi etkinleştirmek için LocationInfo
ekleyin ve CampaignCriterionService.MutateCampaignCriteria
yardımıyla Google Ads API'ye gönderilen CampaignCriterion
öğesinin location
olarak ayarlayın.
Daha fazla ayrıntı için Yer hedefleme bölümüne bakın.
Belirli hizmet türlerini hedefle
Belirli bir hizmet türü için hedeflemeyi etkinleştirmek istiyorsanız LocalServiceIdInfo
ekleyip bunu hizmet türü olarak ayarlayın.
Kampanyanızın hedefleme konumu ve kategorisiyle 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 varlıklarla ilgili işlemler | Google Ads API, Yerel Hizmetler kampanyalarında reklam gruplarının, reklamların veya ölçütlerin oluşturulmasını, değiştirilmesini, kaldırılmasını veya alınmasını desteklemez. |
Yerel Hizmetler kaynakları
Google Ads API 15. sürümden itibaren, Yerel Hizmet Reklamları'ndan gelen 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 istekte bulunan 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 kampanya 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 lideri
LocalServicesLead
, bir tüketici reklamverenden bir hizmeti aradığında, mesaj gönderdiğinde veya reklamverenden bir 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. Burada örnek bir sorgu görebilirsiniz:
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
'ye eşitsecontact_details
alanı boş olur.category_id
öğesinin bir sağlık hizmeti kategorisinin parçası olduğu potansiyel müşteri verileri 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 bir ilişki vardır ve
bir potansiyel müşteri birden çok kez görüşebilir. İ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 aramaları ile ilgili sonuçları filtreleyen bir örnek 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'
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 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ısı
LocalServicesVerificationArtifact
, reklamverenlerin işletmeleri için doğrulama verilerini gösterir. Bu doğrulamaların işletme düzeyinde olduğunu ve çalışanlar için doğrulama içermediğini unutmayın. 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 yapısı, 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 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)
- Halihazırda gönderilmiş olan sigorta bilgilerini görüntülemek için kullanılan sigorta belgesi URL'si
- Sigortanın reddedilme nedeni (varsa)
- Lisans ayrıntıları (tür, numara, ad, soyadı)
- Lisansın reddedilme nedeni (varsa)
- Daha önce gönderilen lisans resmini (varsa) görüntülemek için lisans dokümanı URL'si
- İşletme tescili bilgileri (kimlik ve tescil numarasını kontrol edin)
- İşletme tescilinin reddedilme nedeni (varsa)
- Önceden gönderilmiş tescil resmini görüntülemek için işletme tescil belgesi URL'si (varsa)
Doğrulama yapısı verileri local_services_verification_artifact
kaynağından alınabilir. Aşağıda, belirli bir istemci hesabı için lisansla ilgili tüm doğrulama yapılarının verilerini alan örnek bir sorgu 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 koda) 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ğrulama isteklerinin üst düzey özeti gösterilir. Burada, 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ı hakkındaki verileri gösterir.
Belirli bir müşteri hesabı için tüm yerel hizmet çalışanlarına ilişkin verileri 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