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

Desteklenmeyen işlemler
Kampanya oluşturma ve kaldırma Google Ads API, bağımsız Yerel Hizmetler kampanyalarının (advertising_channel_type = 'LOCAL_SERVICES') oluşturulmasını ve kaldırılmasını engeller. v26 tarihinden itibaren pmax_campaign_settings.local_services_enabled = true değerini ayarlayarak yeni Yerel Hizmetler Maksimum Performans kampanyaları (advertising_channel_type = 'PERFORMANCE_MAX') oluşturabilirsiniz. Yerel Hizmetler Maksimum Performans kampanyaları oluşturma başlıklı makaleyi inceleyin.
Kampanyadaki alt öğeler üzerinde yapılan işlemler Bağımsız Yerel Hizmetler kampanyaları (advertising_channel_type = 'LOCAL_SERVICES') için Google Ads API, Desteklenen işlemler bölümünde listelenen kampanya ölçütleri dışı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 Maksimum Performans kampanyaları için öğe gruplarını ve kampanya ölçütlerini kullanın.

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 potansiyel müşterinin ayrıntılarını gösterir.

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
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 ContactDetails.phone_number_extension, local_services_lead.contact_details tarafından döndürülen ContactDetails mesajında kullanılabilir olacak.
  • 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'

LocalServicesLead öğesine LocalServicesLeadService.AppendLeadConversation yöntemini kullanarak LocalServicesLeadConversation kaynakları 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 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ış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 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ı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ü değerlendirme süresi (varsa)
  • Daha önce gönderilmiş 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)
  • Daha önce gönderilmiş 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ı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 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, 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 itibarıyla, bir Maksimum Performans kampanyası (advertising_channel_type = 'PERFORMANCE_MAX') oluşturup pmax_campaign_settings üzerinde local_services_enabled = true değerini ayarlayarak (oluşturulduktan sonra değiştirilemez) API aracılığıyla yeni Yerel Hizmetler Maksimum Performans kampanyaları oluşturabilirsiniz. Yerel Hizmetler Maksimum Performans kampanyası oluştururken country_code ve listing_id öğelerinin her ikisi de local_services_pmax_campaign_settings içinde gereklidir.

v24 ve v25'te API, izin verilenler listesindeki hesaplar tarafından kullanıcı arayüzünde oluşturulan mevcut Yerel Hizmet Maksimum Performans kampanyaları için yalnızca güncellemeleri destekler.

Yerel Hizmetler 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 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 giriş kimliği. v26 tarihinden itibaren bu alan, yerel hizmet Maksimum Performans kampanyası oluşturma sırasında zorunlu ve değişmezdir. Listeleme 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 incelenerek) bağlı listeleme 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 sabittir 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 temsil edilir.

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ı.