Video: 2019 atölyesindeki 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 Hükümler ve Koşulları'na uygunlukla ilgili olarak sizinle iletişime geçemezsek API erişiminiz önceden haberiniz olmadan iptal edilebilir. Bir bireye bağlı veya kontrol edilmeyen bir hesaba bağlı kişisel bir e-posta adresi kullanmaktan kaçının.
Ürün değişiklikleri, bakım kesintileri, desteğin kaldırılma tarihleri ve benzeri konularda bilgi almak için
Google Ads API ekibi tarafından düzenli olarak izlenen forum, API ile ilgili sorular 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-posta adresinizi kullanarak size ulaşır. Şartlar 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
API'ye istekte bulunmak; gidiş dönüş ağ gecikmesi, serileştirme, seri durumdan çıkarma işlemi ve arka uç sistemlerine çağrılar gibi bir dizi sabit maliyet gerektirir. Bu sabit maliyetlerin etkisini azaltmak ve genel performansı artırmak için API'deki çoğu değişiklik yöntemi, bir dizi işlemi kabul edecek şekilde tasarlanmıştır. Her istekte birden çok işlemi gruplar halinde, gönderdiğiniz istek sayısını ve ilişkili sabit maliyetleri azaltabilirsiniz. Yapabilirseniz 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 göndermek yerine, her biri 500 anahtar kelime içeren 100 istek veya her biri 5.000 anahtar kelime içeren 10 istek oluşturun. Bir istekte izin verilen işlem sayısı için sınırlar vardır. Bu nedenle, en iyi performansı elde etmek için grup boyutunuzu ayarlamanız gerekebilir.
Seyrek nesneleri gönder
Nesneler API'ye gönderildiğinde alanların seri dışı bırakılması, doğrulanması ve veritabanında depolanması gerekir. Yalnızca birkaç alanı güncellemek istediğinizde tam nesneleri aktarmak, ek işleme süresine ve performansın düşmesine neden olabilir.
Google Ads API, bu sorunu azaltmak için az sayıda güncellemeleri destekleyerek bir nesnede yalnızca değiştirmeniz gereken veya gerekli olan alanları doldurmanıza olanak tanır. Seyrek güncellemeler daha hızlı işlenir ve hata oluşturma ihtimali daha düşüktür.
"update_mask" (FieldMask olarak da bilinir) içinde 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ı gerekeceğinden, anahtar kelime düzeyindeki teklifleri güncelleyen bir uygulama, az sayıda güncelleme kullanmanın avantajından yararlanabilir.
Hata işleme ve yönetim
Geliştirme sırasında hatalarla karşılaşma olasılığınız yüksektir. Bu bölümde, uygulamanızda hata yönetimi oluşturmak için dikkate alınması 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 da ziyaret edin.
İstek kaynaklarını ayırt etme
Bazı uygulamalar esas 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ı gönderir. Bazıları ise periyodik arka uç süreci kapsamında API çağrıları göndererek çevrimdışı olarak çalışır. Birçok uygulama bu ikisini birleştirir. Hata yönetimi üzerine düşünürken bu farklı istek türlerini ayırt etmek yararlı 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ıya kullanıcı arayüzünde mümkün olduğunca fazla bağlam sağlamak için ortaya çıkan hatayı kullanın. Hatayı çözmek için kolayca uygulayabilecekleri 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şılmayan hataları ele almak için her zaman varsayılan bir işleyici ekleyin. Başarısız işlemi ve hatayı, gerçek kişi olan bir operatörün inceleyip uygun çözümü belirlemesi için bir sıraya eklemek, varsayılan işleyici için iyi bir yaklaşımdır.
Hata türlerini ayırt etme
Güçlü 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 Yaygın Hatalar bölümlerine bakın.
Senkronizasyon arka uçları
Uygulamanızın kullanıcıları Google Ads hesaplarına manuel olarak erişebiliyorsa uygulamanızın farkında olmadığı değişiklikler yapabilirler. Bu da uygulamanızın yerel veritabanının senkronize olmamasına neden olur. Hata Türleri kılavuzumuzda belirtildiği gibi, senkronizasyonla ilgili hataları ortaya çıktıkları zaman reaktif olarak ele alabilirsiniz. Ancak isterseniz bunları proaktif olarak önlemeyi de deneyebilirsiniz. Proaktif stratejilerden biri, tüm hesaplarınızda her gece bir senkronizasyon işi çalıştırmak, hesaplarınızdaki Google Ads nesnelerini almak ve yerel veritabanınızla karşılaştırmaktır.
Hataları günlüğe kaydet
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 ve yanıt yer alır.
Trendleri izleyin
Uygulamanızla ilgili sorunları tespit edip giderebilmek için API hatalarındaki trendleri izlediğinizden emin olun. Kendi çözümünüzü oluşturabilir veya günlüklerinizi etkileşimli kontrol panelleri oluşturmak ve otomatik uyarılar göndermek için kullanabilen ticari araçlardan 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şlemlerin beklendiği gibi çalışıp çalışmadığını test etmek için bir test hesabı kullanabilirsiniz. Geliştirici jetonunuzun test hesabında kullanılmak üzere onaylanması gerekmez. Bu nedenle, geliştirici jetonu isteğinde bulunduktan hemen sonra, uygulamanız incelenmeden önce bile Google Ads API ile geliştirmeye başlayabilirsiniz.