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 Hizmet 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:

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

Yerel Hizmet kampanyaları için kampanya ölçütü olarak reklam zaman planlaması belirleyebilirsiniz.

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 LocalServiceIdInfo oluşturun, Yerel Hizmetler kategori kimliklerinden birini kullanarak CampaignCriterion öğesinin local_service_id alanına 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 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 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ı

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:

Bu kaynakların veri döndürmesi için istekte bulunan müşteri hesabında bir Yerel Hizmetler kampanyası bulunmalıdır. Müşteri hesabı başına yalnızca bir Yerel Hizmetler kampanyası olabileceğinden bu kaynaklar bir kampanya belirtmez. 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 hizmet talebinin ayrıntılarını gösterir.

Yerel Hizmetler hizmet talebi 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 ile WIPED_OUT eşitse null olur.
  • v25 tarihinden itibaren ContactDetails.email kaldırılacak ve local_services_lead.contact_details tarafından döndürülen ContactDetails mesajında ContactDetails.phone_number_extension kullanılabilecek.
  • category_id öğesinin sağlık hizmeti kategorisinde yer aldığı 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ş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 aynı anda istemek zaman alabilir. 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ış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 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ıtı, 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ı için kullanılacak geçmiş kontrolü URL'si
  • Geçmiş kontrolü karar süresi (varsa)
  • Daha önce gönderilen sigorta bilgilerini görüntülemek için sigorta belgesi URL'si
  • Sigorta reddedilme nedeni (geçerliyse)
  • Lisans ayrıntıları (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_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 doğrulama verileri

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

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 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 itibarıyla Yerel Hizmetler ile ilgili ayarları desteklemektedir. 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.

v26 itibarıyla, pmax_campaign_settings üzerinde local_services_enabled = true değerini ayarlayarak API aracılığıyla yeni Yerel Hizmetler Maksimum Performans kampanyaları oluşturabilirsiniz (oluşturulduktan sonra değiştirilemez). Yerel Hizmetler Maksimum Performans kampanyası oluştururken country_code ve listing_id öğelerinin her ikisi de local_services_pmax_campaign_settings içinde gereklidir. v25 ve önceki sürümlerde API, izin verilenler listesindeki kullanıcılar tarafından kullanıcı arayüzünde oluşturulan mevcut kampanyalar için yalnızca güncellemeleri destekliyordu.

Yerel Hizmet 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.

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 listeleme 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 alanı IMMUTABLE olarak işaretlendiğinden, kampanya oluşturulduktan sonra bu alanı güncelleme girişimi RequestError.IMMUTABLE_FIELD ile 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. Bu alan değiştirilemez 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 harflerle yazılmış iki harfli bir ülke kodudur.
  • phone_numbers: Sağlayıcıyla ilişkili telefon numaralarının listesi, LocalServicesPhoneNumber mesajları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 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 (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ı.