En iyi uygulamalar

Bu rehberde, uygulamalarınızın verimliliğini ve performansını optimize etmek için uygulayabileceğiniz bazı en iyi uygulamalar ele alınmaktadır.

Uygulamanızı sürdürme

Uygulamanızın kesintisiz çalışmasını sağlamak için aşağıdakileri yapın:

  • Google Cloud projenizin sahiplerinin ve düzenleyicilerinin listesinin güncel olduğundan emin olun. Acil durumlarda veya API Hükümleri ve Koşulları'na uygunlukla ilgili konularda bu kullanıcılarla iletişime geçeriz. API Hükümleri ve Koşulları'na uygunluk konusunda sizinle iletişime geçemezsek API erişiminiz düşürülebilir veya iptal edilebilir.

  • Ürün değişiklikleri, bakım için hizmet dışı kalma süresi ve desteğin sonlandırılma tarihleri gibi konularda bilgi almak için API blogumuza ve Ürün blogumuza abone olun.

  • Uygulamanızın Google Ads API Hükümler ve Koşulları'na (T&C) uygun olmasını sağlayın. Gerekirse API uygunluk ekibi, Google Cloud projenizin API erişimi olan sahipleri ve düzenleyicileriyle iletişime geçer. Hükümler ve Koşullar ile ilgili sorularınız veya endişeleriniz varsa API erişim başvurunuzu incelerken size gönderdikleri e-postayı yanıtlayarak uyumluluk ekibine ulaşabilirsiniz.

Optimizasyon

Toplu işlemler yaparak ve uygunsa seyrek nesneler göndererek uygulamanızı optimize edebilirsiniz.

Toplu işlemler

API'ye istekte bulunmak, gidiş-dönüş ağ gecikmesi, serileştirme ve seri durumdan çıkarma işleme ve 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şlem kabul edecek şekilde tasarlanmıştır. Her isteğe birden fazla işlem ekleyerek yaptığınız isteklerin sayısını ve ilgili sabit maliyetleri azaltabilirsiniz. Mümkünse yalnızca tek bir işlem içeren isteklerde bulunmayın.

Ö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 grup 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. Böylece, 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 içinde olmayan alanlar (FieldMask olarak da bilinir) 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 işlevini eklerken dikkate almanız gereken noktalar ve stratejiler açıklanmaktadır. Hataları yönetme hakkında daha fazla bilgi için bu bölümün yanı sıra Sorun giderme kılavuzu'nu da ziyaret edin.

İstek kaynaklarını ayırt etme

Bazı uygulamalar öncelikle etkileşimlidir ve kullanıcı arayüzünde kullanıcı tarafından başlatılan işlemlere yanıt olarak doğrudan API çağrıları yapar. Diğerleri ise öncelikli olarak çevrimdışı çalışır ve düzenli bir arka uç sürecinin parçası olarak API çağrıları yayınlar. 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 temel amacınız, kullanıcılarınıza iyi bir deneyim sunmak olmalıdır. Kullanıcıya kullanıcı arayüzünde mümkün olduğunca fazla bağlam bilgisi vermek için oluşan hatayı kullanın. Hatayı çözmek için uygulayabilecekleri net adımlar sunun (aşağıdaki önerilere bakın).

Arka uçta başlatılan istekler için uygulamanızın karşılaşabileceği farklı hata türleri için işleyiciler uygulayın. Nadir görülen 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 olan işlemi ve hatayı bir sıraya ekleyerek gerçek bir operatörün incelemesini ve uygun bir çözüm belirlemesini sağlamaktır.

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:

Daha fazla bilgi için Hata türleri ve Sık karşılaşılan hatalar bölümlerine bakın.

Senkronizasyon arka uçları

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 senkronize olmamasına neden olur. Hata türleri kılavuzumuzda belirtildiği gibi, senkronizasyonla ilgili hataları oluştuğu sırada giderebilir veya proaktif olarak önlemeye çalışabilirsiniz. Proaktif bir strateji olarak, yerel veritabanınızı hesaplarınızdaki Google Ads nesneleriyle eşleştirmek için düzenli olarak bir senkronizasyon işi çalıştırabilirsiniz. Büyük hesap hiyerarşilerinde, günlük kotaların tükenmesini önlemek için her gece tüm hesaplardaki tüm nesneleri çekmekten kaçının. Bunun yerine, değişiklikleri artımlı olarak senkronize etmek için ChangeStatus sorgulayın veya son değiştirilen öğeleri filtreleyin.

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 hatayı günlüğe kaydedin. Günlüğe kaydedilecek diğer bilgiler arasında müşteri kimliği, API hizmeti, gidiş dönüş isteği gecikmesi, yeniden deneme sayısı ve temizlenmiş ham istek ve yanıt yer alır (OAuth jetonları, eski istek başlıklarında hâlâ yer alıyorsa geliştirici jetonları ve tüm kimliği tanımlayabilecek bilgiler gibi hassas kimlik bilgilerinin çıkarıldığından emin olun).

Uygulamanızdaki sorunları tespit edip giderebilmek için API hatalarındaki trendleri izlediğinizden emin olun. Kendi çözümünüzü oluşturmayı veya günlüklerinizi kullanarak etkileşimli kontrol panelleri oluşturup otomatik uyarılar gönderebilen, piyasada bulunan ticari araçlardan birini kullanmayı düşünebilirsiniz.

Geliştirme

Geliştirme sırasında test hesaplarını kullanın.

Test hesaplarını kullanma

Test hesapları, aslında reklam yayınlamayan Google Ads hesaplarıdır. 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. Google Cloud projenizin, test hesabında kullanılabilmesi için yalnızca test erişimine ihtiyacı vardır. Böylece, Google'ın daha yüksek API erişim düzeyleri için başvurunuzu incelemesini beklerken Google Ads API ile geliştirmeye hemen başlayabilirsiniz.

Sonraki
API sınırları ve kotaları