Google Ads Yerel Hizmet Uygunluğu API ile Nasıl Sorgulanır?

Kısa yanıt: Yerel hizmet reklamı uygunluğu nasıl sorgulanır?

Google Ads API v26.1, bir müşteri hesabı ve Google İşletme Profili listing ID'si için yerel hizmet uygunluğunu sorgulayan LocalServicesEligibilityService.CheckLocalServicesEligibility yöntemini ekledi. Dönen yanıt, genel uygunluk durumunu, uygun hedef ve hizmet kategorilerini ve varsa uygunluk sorunlarına ilişkin öneri nedenlerini ayrı alanlarda sunuyor. Bu sonuç, kendi başına kampanya oluşturma izni veya her ülkede reklam erişimi anlamına gelmez; gerçek hesap ve profil kimliğiyle değerlendirilmelidir. Google Ads API sürüm notu ve yöntem referansı bu alanları belgeliyor.

Bu yazı kampanya dönüşüm ayarından farklı olarak ön uygunluk yanıtının yorumlanmasına odaklanır. Sürüm yükseltmesindeki dönüşüm alanları için Google Ads API v26 dönüşüm ayarı rehberini inceleyebilirsiniz. Reklam hesabı, profil ve potansiyel müşteri ölçümünü birlikte değerlendirmek için Webinle Google ve Meta reklam optimizasyonu hizmet kapsamına bakın.

Sorgu öncesinde kimlikleri doğrulayın

Uygunluk sorgusunun bağlamı, Google Ads müşteri hesabı ile Google İşletme Profili listing ID'sidir. Bunları kampanya adı, şirket adı veya web sitesi URL'siyle karıştırmayın. Aynı işletmenin birden fazla profili varsa hangi kaydın hangi hizmete ve konuma ait olduğunu iş birimiyle doğrulayın. Yanlış listing ID ile alınan yanıt, doğru hesabın uygunluğu hakkında güvenilir karar vermez. Test kaydında kişisel veri yerine hesap ve profil kimliğinin kontrollü teknik referansını tutun.

Yöntem dokümanı, çağrı için Google Ads OAuth kapsamı gerektiğini belirtiyor. Yetki hatasını "işletme uygun değil" olarak sınıflandırmayın. Önce erişim, müşteri hesabı, API sürümü ve istek biçimi kontrol edilmeli; ancak geçerli bir yanıt geldikten sonra uygunluk alanları yorumlanmalıdır. Uygunluk sorgusunu geliştirme veya raporlama akışına koyarken her başarısız HTTP/gRPC yanıtını ayrı hata sınıfı olarak kaydedin. Servis hatası ile eligible:false aynı şey değildir.

Yeni API alanlarının hesabınızda göründüğünü varsaymadan istemci kütüphanesinin sürümünü ve alan şemasını doğrulayın. Resmî API sürümleme açıklaması, küçük sürümlerin mevcut ana sürüm uç noktasına uyumlu özellikler eklediğini ve yeni alanları istemci kütüphanesinde kullanmak için güncel tanımlar gerekebileceğini anlatır. Bu nedenle bir kütüphanede alan görünmüyorsa ilk iş olarak reklama yeni kampanya açmak değil, entegrasyon sürümünü kontrol etmektir.

Yanıttaki alanları ayrı okuyun

eligible, hesabın genel uygunluk durumunu gösterir. eligible_goals, uygun potansiyel müşteri türlerini bunların hizmet kategorileriyle eşler. Bu listedeki kategori kimliği, görünen ad, iş türü ve callout bilgilerini mümkünse ayrı saklayın; görünen etiketi tek karar anahtarı yapmayın. suggestion_reasons ise uygunluk sorunları için kısa ve ayrıntılı açıklamalar sağlar. Google'ın yanıt şeması üç alanın rolünü ayrı tanımlıyor.

Bir yanıtı değerlendirirken önce çağrının teknik başarı durumunu, ardından eligible değerini ve sonra hedef kategori listesini okuyun. Genel uygunluk olumlu olsa bile sizin planladığınız belirli hizmetin listede olup olmadığını kontrol edin. Olumsuz yanıtta neden metnini operasyon ekibine "düzeltilecek kesin mevzuat maddesi" olarak çevirmeyin; bu alan kısa açıklama sağlar. Lisans veya belge konularında kendi iş kolunuzun ve bulunduğunuz bölgenin güncel koşullarını resmî kanallardan ayrıca doğrulayın.

Kampanya kararına nasıl bağlanır?

Uygunluk yanıtı, kampanya planındaki ilk kapıdır. Sonraki adımlarda hizmet kategorisi, profil bilgisi, hedef, bütçe, açılış sayfası ve ölçülen talep birlikte değerlendirilmeli. Bir reklamın teknik olarak açılabilmesi, nitelikli talep üreteceği anlamına gelmez. Kullanılabilir kategori ile işletmenin gerçekten sunduğu hizmet eşleşmiyorsa yanlış talep toplama riski doğar. Profil ve sitedeki hizmet açıklamasını içerik olarak tutarlı tutun; uygun olmayan bir kategori seçerek bir uygunluk sorununu gizlemeye çalışmayın.

Bu yazı Türkiye'deki herhangi bir sektörün otomatik olarak uygun olduğunu iddia etmez. Yerel hizmet reklamlarının erişimi hesap, profil, bölge ve kategoriye göre değişebilir. Tam da bu nedenle yeni yöntemi, gerçek hesapta sorgu ve yanıt kaydıyla kullanmak değerlidir. Bir müşterinin uygunluk sonucunu başka müşterinin kampanyasına kopyalamayın. Farklı lokasyonlar varsa her profilin kimliğini ve dönen kategoriyi ayrı değerlendirmeniz gerekir.

Hata ve kabul testleri

Yanıtı karar kaydına dönüştürün

Uygunluk sorgusunun çıktısını yalnızca bir yeşil-kırmızı rozet olarak göstermeyin. Hangi müşteri hesabı ve hangi profil için, hangi tarihte, hangi hedef kategoriyle sorgulandığını kaydedin. Yanıttaki açıklama alanı boşsa bunun anlamını kendi yorumunuzla doldurmayın. Kategori adı değişmiş veya iş kolunuz farklı sınıflandırılmış olabilir; kimlikleri ve kaynağı yeniden doğrulayın. Bu kayıt, ekip içinde "geçen ay uygundu" gibi bağlamı eksik sözleri somut bir tarihe ve hesaba bağlar.

Birden fazla ajans veya ekip aynı hesabı yönetiyorsa, uygunluk kontrolünden kampanya kurulumuna geçiş için açık bir onay sahibi belirleyin. Teknik entegrasyonun eligible yanıtı, işletmenin reklam mesajını veya bütçe kararını onayladığı anlamına gelmez. Bu ayrım, reklam metni ile gerçekten verilebilen hizmet arasında tutarlılık sağlamaya yardımcı olur. Hesap erişimi yoksa sahte örnek sonuçla canlı karar vermek yerine kontrolü bekleyen iş olarak kaydedin.

Örnek test seti kurun: doğru hesap ve doğru listing ID; yanlış profil kimliği; eksik yetki; uygun ama hedef kategori bulunmayan yanıt; uygun olmayan yanıt ve açıklama; geçici servis hatası. Her senaryoda ürün arayüzünün ve ekip raporunun hangi mesajı göstereceğini önceden yazın. Kullanıcıya yalnızca "uygun değil" göstermek, erişim hatasıyla gerçek uygunluk sonucunu karıştırabilir. API yanıtı değiştiğinde eski önbelleğin ne zaman geçersiz olacağını da belirleyin.

Yanıtın suggestion_reasons alanı bir düzeltme listesi gibi görünse bile her maddeyi bağımsız inceleyin. Profil sahibine hangi verinin eksik olduğu söylenmeden "kampanyayı açın" demek doğru değildir. Öte yandan olumsuz sonucun tek başına yeni bir GBP sayfası, şehir sayfası veya blog yazısı ihtiyacı yarattığını da varsaymayın. Önce mevcut profil ve hizmet sayfasındaki gerçek uyumsuzluğu belirleyin. Webinle'nin reklam optimizasyonu yaklaşımı, bütçe, mesaj ve ölçümü birlikte ele alır; uygunluk kontrolü bu karar zincirinin teknik girişidir.

Son değerlendirmede arama gösterimi, tıklama ve gerçek talebi ayırın. GSC tıklamasıyla Analytics oturumu bire bir aynı metrik değildir; form, telefon ve WhatsApp olaylarının ölçülüp ölçülmediği bilinmiyorsa dönüşüm performansı hakkında kesin hüküm kurmayın. Aynı uzunlukta dönemlerle tekrar kontrol edin ve uygunluk yanıtını kaydettiğiniz tarihle kampanya sonuçlarını ilişkilendirin. Böylece bir API kontrolünü yanlışlıkla performans vaadine dönüştürmeden karar verebilirsiniz.