Video: 2019'daki atölye çalışmasında en iyi uygulamalarla ilgili konuşmaya 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 merkezindeki geliştirici iletişim e-posta adresinizi güncel tutun. Sizinle iletişime geçerken kullandığımız e-posta adresi budur. API Hükümleri ve Koşulları'na uygunluk konusunda sizinle iletişime geçemezsek API erişiminiz önceden haberiniz olmadan iptal edilebilir. Bireysel veya izlenmeyen bir hesaba bağlı kişisel e-posta adresi kullanmaktan kaçının. API Merkezi'ni görüntülemek için yönetici hesabınıza giriş yapmanız gerekir.
Ürün değişiklikleri, bakım nedeniyle hizmet kesintisi ve desteğin sonlandırılacağı tarihler gibi konularda bilgi almak için
Forum, Google Ads API ekibi tarafından düzenli olarak izlenir. Bu nedenle, API ile ilgili sorularınızı yayınlamak için ideal bir yerdir.
- Uygulamanızın Google Ads API Hükümler ve Koşulları'na (T&C) uygun olmasını sağlayın. Gerekirse jeton inceleme ve uygunluk ekibi, iletişim e-postanızı kullanarak sizinle iletişime geçer. Hükümler ve Koşullar ile ilgili sorularınız veya endişeleriniz varsa geliştirici jetonu başvurunuzu incelerken size gönderdikleri e-postayı yanıtlayarak inceleme ekibine ulaşabilirsiniz.
Optimizasyon
Toplu işlemler çalıştırarak ve uygunsa seyrek nesneler göndererek uygulamanızı optimize edebilirsiniz.
Toplu işlemler
API'ye istek göndermek, gidiş dönüş ağ gecikmesi, serileştirme ve seri durumdan çıkarma işlemleri ile arka uç sistemlerine yapılan çağrılar gibi bir dizi sabit maliyeti içerir. Bu sabit maliyetlerin etkisini azaltmak ve genel performansı artırmak için API'deki çoğu değiştirme yöntemi, bir dizi işlemi kabul edecek şekilde tasarlanmıştır. Her isteğe birden çok işlemi toplu olarak ekleyerek yaptığınız isteklerin sayısını ve ilişkili sabit maliyetleri azaltabilirsiniz. Mümkünse yalnızca bir işlem içeren istekler göndermeyin.
Örneğin, bir kampanyaya birden fazla reklam grubu genelinde 50.000 anahtar kelime eklediğinizi varsayalım. Her biri 1 anahtar kelime içeren 50.000 istek göndermek yerine, her biri 500 anahtar kelime içeren 100 istek veya her biri 5.000 anahtar kelime içeren 10 istek gönderebilirsiniz. Bir istekte izin verilen işlem sayısıyla ilgili sınırlar vardır. Bu nedenle, optimum performans elde etmek için toplu işlem boyutunuzu ayarlamanız gerekebilir.
Seyrek nesneler gönderme
Nesneler API'ye gönderildiğinde alanların seri durumdan çıkarılması, doğrulanması ve veritabanında depolanması gerekir. Yalnızca birkaç alanı güncellemek istediğinizde tam nesneleri iletmek, ek işleme süresine ve performansın düşmesine neden olabilir.
Google Ads API, bu sorunu azaltmak için seyrek güncellemeleri destekler. Bu sayede, bir nesnede yalnızca değiştirmeniz gereken veya zorunlu olan alanları doldurabilirsiniz. Seyrek güncellemeler daha hızlı işlenir ve hata üretme olasılığı daha düşüktür.
update_mask'ta (diğer adıyla FieldMask) bulunmayan alanlar değiştirilmez.
Örneğin, anahtar kelime düzeyindeki teklifleri güncelleyen bir uygulama, yalnızca reklam grubu kimliği, ölçüt kimliği ve teklif alanlarının doldurulması gerektiğinden seyrek güncellemelerden yararlanabilir.
Hata işleme ve yönetimi
Geliştirme sırasında hatalarla karşılaşmanız olasıdır. Bu bölümde, uygulamanıza hata yönetimi eklemeyle ilgili dikkat edilmesi gereken noktalar ve stratejiler açıklanmaktadır. Bu bölümün yanı sıra, hataları yönetme hakkında daha fazla bilgi için Sorun giderme kılavuzu'nu ziyaret edin.
İstek kaynaklarını ayırt etme
Bazı uygulamalar öncelikli olarak 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. Diğerleri ise öncelikle çevrimdışı çalışır ve düzenli bir arka uç sürecinin parçası olarak API çağrıları yapar. Birçok uygulama bu ikisini birleştirir. Hata yönetimi hakkında düşünürken bu farklı istek türlerini ayırt etmek faydalı olabilir.
Kullanıcı tarafından başlatılan isteklerdeki birincil amacınız, kullanıcılarınıza iyi bir deneyim sunmak olmalıdır. Kullanıcıya kullanıcı arayüzünde olabildiğince fazla bağlam bilgisi vermek için oluşan hatayı kullanın. Hatayı çözmek için kolay adımlar sunun (aşağıdaki önerilere göz atın).
Arka uçta başlatılan istekler için uygulamanızın karşılaşabileceği farklı hata türlerine yönelik işleyiciler uygulayın. Nadir veya daha önce karşılaşılmamış hataları gidermek için her zaman varsayılan bir işleyici ekleyin. Varsayılan işleyici için iyi bir yaklaşım, başarısız işlemi ve hatayı, gerçek bir operatörün inceleyip uygun bir çözüm belirlemesi için bir sıraya eklemektir.
Hata türlerini ayırt etme
Google Ads API'deki hata türleri arasındaki farkları bilmek, sağlam bir hata işleme oluştururken ç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 bilgi için Hata Türleri ve Sık Karşılaşılan Hatalar bölümlerine bakın.
Senkronizasyonun sonlandırılması
Uygulamanızın kullanıcıları Google Ads hesaplarına manuel olarak erişiyorsa uygulamanızın farkında olmadığı değişiklikler yapabilirler. Bu durum, uygulamanızın yerel veritabanının senkronizasyonunun bozulmasına neden olur. Hata Türleri kılavuzumuzda belirtildiği gibi, senkronizasyonla ilgili hataları oluştuğunda giderebilir veya proaktif olarak önlemeye çalışabilirsiniz. Proaktif bir strateji olarak, tüm hesaplarınızda gece senkronizasyon işi çalıştırabilir, hesaplarınızdaki Google Ads nesnelerini alabilir ve yerel veritabanınızla karşılaştırabilirsiniz.
Günlük hataları
Hata ayıklama 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 kaydedilecek diğer bilgiler arasında müşteri kimliği, API hizmeti, gidiş-dönüş istek gecikmesi, yeniden deneme sayısı ve ham istek ile yanıt yer alır.
Trendleri izleme
Uygulamanızdaki sorunları tespit edip giderebilmek için API hatalarındaki trendleri izlemeyi unutmayın. Kendi çözümünüzü oluşturabilir veya günlüklerinizi kullanarak etkileşimli kontrol panelleri oluşturup otomatik uyarılar gönderebilen, piyasada bulunan birçok ticari araçtan birini kullanabilirsiniz.
Geliştirme
Geliştirme sırasında test hesaplarını kullanın.
Test hesaplarını kullanma
Test hesapları, Google Ads hesaplarıdır ve bu hesaplarda reklam yayınlanmaz. Google Ads API ile denemeler yapmak ve uygulamanızın bağlantısının, kampanya yönetimi mantığının veya diğer işlemlerin beklendiği gibi çalıştığını test etmek için bir test hesabı kullanabilirsiniz. Geliştirici jetonunuzun test hesabında kullanılabilmesi için onaylanması gerekmez. Bu nedenle, uygulamanız incelenmeden önce bile, geliştirici jetonu isteğinde bulunduktan hemen sonra Google Ads API ile geliştirmeye başlayabilirsiniz.