Video: 2019 atölyesinde gerçekleştirilen en iyi uygulamalar konuşmasına göz atın
Bu kılavuzda, uygulamalarınızın verimliliğini ve performansını optimize etmek için uygulayabileceğiniz bazı en iyi uygulamalar ele alınmaktadır.
Sürekli bakım
Uygulamanızın kesintisiz çalışmasını sağlamak için:
API Merkezi'ndeki geliştirici iletişim e-posta adresinizi güncel tutun. Bu, sizinle iletişim kurmak için kullandığımız takma addır. API Şartlar ve Koşulları'na uygunluk konusunda sizinle iletişime geçemezsek API erişiminiz önceki bilginiz dışında iptal edilebilir. Bireysel veya kontrol edilmeyen bir hesaba bağlı kişisel bir e-posta adresi kullanmaktan kaçının.
Ürün değişiklikleri, bakımda kapalı kalma süresi ve kullanımdan kaldırılma tarihleri gibi konulardan haberdar olmak için
Forum, Google Ads API ekibi tarafından düzenli olarak izlenmektedir. Bu nedenle, forum API'lerle ilgili soruları yayınlamak için ideal bir yerdir.
- Uygulamanızın Google Ads API Hükümler ve Koşulları'na uygun olmasını sağlayın (Hükümler ve Koşullar). Gerekirse jeton inceleme ve uygunluk ekibi, iletişim e-posta adresinizi kullanarak size ulaşır. Şartlar ve Koşullar ile ilgili sorularınız veya endişeleriniz varsa, geliştirici simgesi başvurunuzu incelerken size gönderdikleri e-postayı yanıtlayarak inceleme ekibine ulaşabilirsiniz.
Optimizasyon
Toplu işlemler
API'ye istekte bulunmak için gidiş dönüş ağ gecikmesi, serileştirme, serileştirme işleme ve arka uç sistemlerine yapılan çağrılar gibi bir dizi sabit maliyet gerekir. Bu sabit maliyetlerin etkisini azaltmak ve genel performansı artırmak için API'deki çoğu değişen yöntem, bir dizi işlemi kabul edecek şekilde tasarlanmıştır. Birden fazla işlemi her bir istekte gruplayarak, yaptığınız isteklerin sayısını ve ilişkili sabit maliyetleri azaltabilirsiniz. Yapabiliyorsanız tek bir işlemle istek yapmaktan kaçının.
Örneğin, birden çok reklam grubundaki bir kampanyaya 50.000 anahtar kelime eklediğinizi varsayalım. Her biri 1 anahtar kelime içeren 50.000 istek yapmak yerine, her biri 500 anahtar kelime içeren 100 istek, hatta her biri 5.000 anahtar kelime içeren 10 istek yapın. Bir istekte izin verilen işlem sayısıyla ilgili sınırlar vardır, bu nedenle en iyi performansa ulaşmak için toplu işlem boyutunu ayarlamanız gerekebilir.
Seyrek nesneleri gönder
API'ye nesne gönderildiğinde alanların seri durumdan çıkarılması, doğrulanması ve veritabanında depolanması gerekir. Yalnızca birkaç alanı güncellemek istediğinizde nesneleri tam olarak aktarmak, ek işleme süresine ve performansın düşmesine neden olabilir.
Google Ads API bu durumu azaltmak için seyrek güncellemeleri destekleyerek bir nesnede yalnızca değiştirmeniz gereken veya gerekli alanları doldurmanıza olanak tanır. Seyrek güncellemeler daha hızlı işlenir ve hata üretme olasılığı daha düşüktür.
update_mask (FieldMask olarak da bilinir) kapsamında olmayan alanlar değiştirilmeden bırakılır.
Örneğin, yalnızca reklam grubu kimliği, ölçüt kimliği ve teklif alanlarının doldurulması gerektiğinden, anahtar kelime düzeyindeki teklifleri güncelleyen bir uygulama, az güncellemelerden yararlanabilir.
Hata işleme ve yönetme
Geliştirme sırasında hatalarla karşılaşabilirsiniz. Bu bölümde, uygulamanızda hata yönetimi oluşturmayla ilgili dikkat edilmesi gereken noktalar ve stratejiler açıklanmaktadır. Bu bölüme ek olarak hataları yönetme hakkında daha fazla bilgi için Sorun giderme kılavuzunu ziyaret edin.
İstek kaynaklarını ayırt etme
Bazı uygulamalar esasen etkileşimlidir ve kullanıcı arayüzünde kullanıcı tarafından başlatılan işlemlere doğrudan yanıt olarak API çağrıları yapar. Bazıları ise düzenli bir arka uç işlemi kapsamında API çağrıları yaparak çoğunlukla çevrimdışı çalışır. Birçok uygulama bu ikisini bir araya getirir. Hata yönetimini düşünürken, bu farklı istek türlerini ayırt etmek faydalı olabilir.
Kullanıcı tarafından başlatılan istekler için birincil endişeniz, kullanıcılarınıza iyi bir deneyim sağlamak olmalıdır. Kullanıcı arayüzünde mümkün olduğunca fazla bilgi sağlamak için, oluşan belirli bir hatayı kullanın. Hatayı çözmek için uygulayabilecekleri kolay adımlar sunun (aşağıdaki önerilere göz atın).
Arka uçta başlatılan isteklerde, uygulamanızın karşılaşabileceği farklı hata türleri için işleyiciler uygulayın. Nadir veya daha önce karşılaşılmamış hataları ele almak için her zaman bir varsayılan işleyici ekleyin. Başarısız olan işlemi ve hatayı, gerçek kişi olan operatörün inceleyip uygun bir çözüm belirlemesi için sıraya eklemek, varsayılan işleyicide iyi bir yaklaşımdır.
Hata türlerini ayırt etme
Güçlü bir hata işleme sistemi oluştururken, Google Ads API'deki hata türleri arasındaki farkları bilmek çok önemlidir. En yaygın hata türlerinden bazıları şunlardır:
- Kimlik doğrulama hataları
- Yeniden denenebilir hatalar
- Doğrulama hataları
- Senkronizasyonla ilgili hatalar
Daha fazla ayrıntı için Hata Türleri ve Genel Hatalar bölümlerine bakın.
Arka uçları senkronize et
Uygulamanızın kullanıcıları Google Ads hesaplarına manuel olarak erişebiliyorsa uygulamanızın farkında olmadığı değişiklikler yaparak uygulamanızın yerel veritabanının senkronizasyonunu bozabilir. Hata Türleri kılavuzumuzda belirtildiği gibi, senkronizasyonla ilgili hataları ortaya çıktıklarında sonra gerekli şekilde ele alabilir ancak bunları proaktif bir şekilde önlemeyi de deneyebilirsiniz. Proaktif bir strateji, tüm hesaplarınızda gecelik bir senkronizasyon işi çalıştırmak, hesaplarınızdaki Google Ads nesnelerini almak ve yerel veritabanınızla karşılaştırmaktır.
Günlük hataları
Hata ayıklamayı ve izlemeyi kolaylaştırmak için tüm hatalar günlüğe kaydedilmelidir. En azından istek kimliğini, hataya neden olan işlemleri ve hatanın kendisini günlüğe kaydedin. Günlüğe kaydedilen diğer bilgiler arasında müşteri kimliği, API hizmeti, gidiş-dönüş istek gecikmesi, yeniden deneme sayısı ve ham istek ve yanıt bulunur.
Trendleri izleyin
Uygulamanızdaki sorunları tespit edip giderebilmek için API hatalarındaki eğilimleri izlediğinizden emin olun. Kendi çözümünüzü oluşturabilir veya etkileşimli gösterge tabloları oluşturmak ve otomatik uyarılar göndermek için günlüklerinizi kullanabilecek birçok ticari araçtan birini kullanabilirsiniz.
Geliştirme
Test hesaplarını kullanma
Test hesapları, gerçekte reklam yayınlamayan Google Ads hesaplarıdır. Google Ads API ile deneme yapmak ve uygulamanızın bağlantısının, kampanya yönetimi mantığının veya diğer işlemlerinin beklendiği gibi çalışıp çalışmadığını test etmek için bir test hesabı kullanabilirsiniz. Geliştirici jetonunuzun test hesabında kullanılması için onaylanması gerekmez. Bu nedenle, geliştirici jetonu istedikten hemen sonra, hatta uygulamanız incelenmeden önce Google Ads API ile geliştirmeye başlayabilirsiniz.