Yerel Hizmetler kampanyaları

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'de desteklenen işlemler ve kısıtlamalar özetlenmektedir.

Desteklenen işlemler

Google Ads API, Yerel Hizmetler kampanyaları için aşağıdaki işlemleri destekler.

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 Hizmetler kampanyalarını düzenleme

Kampanyanın status ve ilişkili kampanya bütçesinin amount_micros alanlarını güncelleyebilirsiniz.

Teklif stratejisini belirleme

Aşağıdaki teklif stratejilerini Yerel Hizmetler kampanyalarının standart teklif stratejisi olarak ayarlayabilirsiniz:

• manual_cpa alanını ManualCpa olarak ayarlayarak

  ManualCpa tekliflerini LocalServicesCampaignSettings.category_bids üzerinden ayarlayabilirsiniz. Yerel Hizmetler kampanyalarının LocalServicesCampaignSettings özelliğini Campaign.local_services_campaign_settings aracılığıyla alabilir ve ayarlayabilirsiniz.

• maximize_conversions alanını MaximizeConversions olarak ayarlayarak

Reklam zaman planlamasını kampanya ölçütü olarak ayarlama

Yerel Hizmetler kampanyası için kampanya ölçütü olarak reklam zaman planlaması 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 alanı 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 Yerel Hizmetler kategori kimliklerinden biriyle LocalServiceIdInfo oluşturun, bunu bir CampaignCriterion öğesinin local_service_id alanında ayarlayın ve CampaignCriterionService.MutateCampaignCriteria kullanarak gönderin.

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, bağımsız Yerel Hizmetler kampanyaları (advertising_channel_type = 'LOCAL_SERVICES') için desteklenmeyen işlemler listelenmiştir.

Yerel Hizmetler kaynakları

Yerel Hizmet Reklamları'ndan alınan 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ı veya Yerel Hizmetler Maksimum Performans kampanyası bulunmalıdır. local_services_lead.campaign alanı, potansiyel müşteri kayıtlarını ilişkili kampanyalarına (campaign.advertising_channel_type = 'PERFORMANCE_MAX' ve campaign.pmax_campaign_settings.local_services_enabled = true olan hizmet talebi başına ödeme hedefleri için Maksimum Performans kampanyaları dahil) bağlar. Bu kaynakların ilişkili olduğu kampanyayı belirlemek için aşağıdaki sorguyu kullanın:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Yerel Hizmetler potansiyel müşteri

LocalServicesLead, bir tüketici reklamvereni aradığında, reklamverene mesaj gönderdiğinde, reklamverenden hizmet rezervasyonu yaptığında veya reklamverenin kuponunu kullandığında oluşturulan hizmet talebiyle ilgili ayrıntıları gösterir.

Potansiyel müşteri türü LocalServicesLeadType tarafından tanımlanır. v26 itibarıyla COUPON, Yerel Hizmetler ve Yerel Hizmetler Maksimum Performans kampanyalarında kupon hizmet talebi türlerini etkinleştirmek için desteklenmektedir.

campaign alanı, potansiyel müşteri kaydını ilişkili olduğu kampanyaya bağlar. İlişkilendirilmiş campaign alanlarını (ör. campaign.id ve campaign.name) seçmenin yanı sıra, potansiyel müşteri sorgularını kampanya kaynak adına (WHERE local_services_lead.campaign = ...) veya reklam kanalı türüne (WHERE campaign.advertising_channel_type = ...) göre filtreleyerek potansiyel müşterileri kampanya türüne göre segmentlere ayırabilirsiniz.

Yerel Hizmetler hizmet talebi verileri, local_services_lead kaynağından alınabilir. Örnek bir 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,
  local_services_lead.campaign
FROM local_services_lead

Sınırlamalar

• lead_status, WIPED_OUT değerine eşitse contact_details alanı boştur.
• v25 tarihinden itibaren ContactDetails.email kaldırılacak ve ContactDetails.phone_number_extension, local_services_lead.contact_details tarafından döndürülen ContactDetails mesajında kullanılabilir olacak.
• category_id sağlık hizmeti kategorisinde yer alan potansiyel müşterilerden gelen veriler kullanılamaz.

Yerel Hizmetler potansiyel müşteri görüşmesi

LocalServicesLeadConversation, bir LocalServicesLead kapsamında gerçekleşen görüşmelerin ayrıntılarını gösterir. LocalServicesLead ile bire çok ilişki vardır. Bir potansiyel müşteriyle birden fazla görüşme yapılabilir. İ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'

LocalServicesLeadConversation kaynaklarını bir LocalServicesLead kaynağına 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
  

Doğrulama çıktıları

LocalServicesVerificationArtifact, reklamverenlerin işletmeleriyle ilgili doğrulama verilerini gösterir. Bu doğrulamaların işletme düzeyinde olduğunu ve çalışanlar için doğrulamaları 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 bir 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 bir doğrulama öğesinin durumu
• Geçmiş kontrolü doğrulaması için kullanılacak geçmiş kontrolü URL'si
• Geçmiş kontrolü değerlendirme süresi (varsa)
• Daha önce gönderilen sigorta bilgilerini görüntülemek için sigorta belgesi URL'si
• Sigorta reddi nedeni (varsa)
• Lisans bilgileri (tür, numara, ad, soyadı)
• Lisansın reddedilme nedeni (varsa)
• Gönderilmiş olan lisans resmini görüntülemek için lisans belgesi URL'si (varsa)
• İşletme tescili bilgileri (kimlik, tescil numarası kontrolü)
• İşletme tescilinin reddedilme nedeni (varsa)
• Daha önce gönderilen tescil resmini görüntülemek için işletme tescil belgesi URL'si (varsa)

Doğrulama yapay nesnesi verileri, local_services_verification_artifact kaynağından alınabilir. Belirli bir müşteri hesabının lisansla ilgili tüm doğrulama yapıları için veri 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_override_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 doğrulama verileri

Doğrulama isteklerinin durumunu coğrafi konuma (özellikle coğrafi hedef kodu) ve Yerel Hizmetler kategori kimliğine göre programatik olarak belirlemek için customer kaynağındaki local_services_settings alanını kullanabilirsiniz. Bu alanın türü LocalServicesSettings şeklindedir.

Bu alan, lisans ve sigorta doğrulama isteklerinin durumunun konuma ve kategoriye göre üst düzey bir özetini gösterir. Aşağıda, bu tür tüm verileri 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.

Aşağıda, belirli bir müşteri hesabındaki tüm yerel hizmet çalışanlarının verilerini alan bir sorgu örneği 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

Yerel Hizmetler Maksimum Performans kampanyaları

Maksimum Performans kampanyaları, v24 tarihinden itibaren Yerel Hizmetler ile ilgili ayarları destekler. Bu ayarlar, Yerel Hizmet Reklamları yayınlayan bir Maksimum Performans kampanyasını (GLS Maksimum Performans) yapılandırmanıza ve tanımlamanıza olanak tanır.

Yerel Hizmetler Maksimum Performans kampanyaları oluşturma

v26 tarihinden itibaren Google Ads API, Yerel Hizmetler Maksimum Performans kampanyaları oluşturmayı ve güncellemeyi desteklemektedir. API üzerinden yeni Yerel Hizmetler Maksimum Performans kampanyaları oluşturmak için bir Maksimum Performans kampanyası (advertising_channel_type = 'PERFORMANCE_MAX') oluşturun ve pmax_campaign_settings üzerinde local_services_enabled = true değerini ayarlayın (oluşturulduktan sonra değiştirilemez). Yerel Hizmetler Maksimum Performans kampanyası oluştururken local_services_pmax_campaign_settings içinde hem country_code hem de listing_id gereklidir. v24 ve v25 sürümlerinde API, izin verilenler listesindeki hesaplar tarafından kullanıcı arayüzünde oluşturulan mevcut Yerel Hizmetler Maksimum Performans kampanyaları için yalnızca güncellemeleri destekler. Ön koşulları yapılandırma ve kampanyaları atomik olarak oluşturma ile ilgili uçtan uca talimatlar için Hizmet talebi başına ödeme hedefleri için Maksimum Performans kılavuzunu inceleyin.

Yerel Hizmetler Maksimum Performans kampanyalarını belirleme

Bir Maksimum Performans kampanyasının Yerel Hizmetler kampanyası olup olmadığını belirlemek için kampanyanın pmax_campaign_settings bölümündeki local_services_enabled alanını kontrol edin. Bu alan, kampanya oluşturulurken true olarak ayarlanan, değiştirilemez (CREATE ONLY) bir boole değeridir.

Ayarları yapılandırma

local_services_enabled değerinin true olduğu kampanyalar için local_services_pmax_campaign_settings alanındaki ayarları yapılandırın:

• listing_id: Kampanyaya bağlı Google İşletme Profili giriş kimliği. v26 tarihinden itibaren bu alan, Yerel Hizmetler Maksimum Performans kampanyası oluşturma sırasında zorunlu ve değiştirilemez olacak. Giriş kimliği, hesaba etkin bir LOCATION öğesi olarak bağlanmalıdır. Aksi takdirde API, CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID hatası döndürür. listing_id, IMMUTABLE olarak işaretlendiğinden kampanya oluşturulduktan sonra bu alanı güncelleme denemesi RequestError.IMMUTABLE_FIELD hatasıyla başarısız olur. Geliştiriciler, etkinleştirilmiş LOCATION öğeleri için Asset kaynağını sorgulayarak (location_asset.business_profile_locations öğesini inceleyerek) bağlı giriş kimliklerini keşfedebilir veya doğrulayabilir. Daha fazla bilgi için Yer öğeleri başlıklı makaleyi inceleyin.
• 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. v26 sürümünden itibaren bu alan zorunlu ve sabittir. Kampanya 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 harfle yazılmış iki harfli bir ülke kodudur (şu anda Yerel Hizmetler Maksimum Performans kampanyaları için yalnızca US desteklenmektedir).
• phone_numbers: Sağlayıcıyla ilişkili telefon numaralarının listesi. LocalServicesPhoneNumber mesajlarıyla temsil edilir. Atlanırsa arama numarası, varsayılan olarak bağlı Google İşletme Profili girişindeki telefon numarası olur. İşletme Profili girişinde telefon numarası yoksa bu numara zorunludur.

Telefon numaraları

phone_numbers yinelenen alanındaki her giriş, aşağıdaki alanlarla birlikte LocalServicesPhoneNumber mesaj türünü kullanır:

• phone_number: Telefon numarası.
• country_code: Büyük harfle yazılmış, iki harfli ülke kodu.
• phone_number_type: GlsPhoneNumberTypeEnum.GlsPhoneNumberType tarafından tanımlanan telefon numarası türü. Desteklenen türler şunlardır:
  • DESTINATION_PHONE_NUMBER_FOR_ADS: Yerel Hizmetler reklam biriminden gelen aramalar için kullanılacak hedef numara (telefon aramasıyla kazanılan potansiyel müşteriler için varsayılan).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: SMS'i destekleyen hedef numara (isteğe bağlı, mesajla hizmet talebi SMS bildirimleri için).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: Sağlayıcının WhatsApp hesabının hedef numarası.