En iyi uygulamalar

Bu kılavuzda, uygulamalarınızın verimliliğini ve performansını optimize etmek için uygulayabileceğiniz bazı en iyi yöntemler 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 sahip ve düzenleyici listesinin güncel olduğundan emin olun. Acil durumlarda veya API Hükümler ve Koşulları'na uygunlukla ilgili konularda bu kullanıcılarla iletişime geçeceğiz. API Hükümler ve Koşulları'na uygunluk konusunda sizinle iletişime geçemezsek API erişiminiz kısıtlanabilir veya iptal edilebilir.

  • Ürün değişiklikleri, bakım nedeniyle hizmet dışı kalma ve desteği sonlandırma 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 uygun olmasını sağlayın. Gerekirse API uyumluluk ekibi, API erişimi olan Google Cloud projenizin 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 ekibiyle iletişime geçebilirsiniz.

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 serileştirmeyi kaldırma işlemleri ve arka uç sistemlerine yapılan ç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 mutate yöntemi, bir dizi işlemi kabul edecek şekilde tasarlanmıştır. Her istekte birden fazla işlemi gruplandırarak yaptığınız isteklerin sayısını ve ilişkili sabit maliyetleri azaltabilirsiniz. Mümkünse tek bir işlem içeren istekler göndermekten kaçının.

Örneğin, bir kampanyaya birden fazla reklam grubu üzerinden 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önderin. 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 nesneleri gönderme

Nesneler API'ye gönderildiğinde alanların serileştirilmesi kaldırılmalı, doğrulanmalı ve veritabanında depolanmalıdır. Yalnızca birkaç alanı güncellemek istediğinizde nesnelerin tamamını iletmek, ek işlem 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 (FieldMask olarak da bilinir) içinde olmayan 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şabilirsiniz. Bu bölümde, uygulamanıza hata yönetimi eklemeyle 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 inceleyin.

İstek kaynaklarını ayırt etme

Bazı uygulamalar öncelikle etkileşimlidir ve doğrudan kullanıcı arayüzünde kullanıcı tarafından başlatılan işlemlere yanıt olarak API çağrıları gönderir. Diğerleri ise öncelikli olarak çevrimdışı çalışır ve periyodik bir arka uç işleminin parçası olarak API çağrıları yapar. Birçok uygulama 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 isteklerde önceliğiniz, kullanıcılarınıza iyi bir deneyim sunmak olmalıdır. Kullanıcı arayüzünde kullanıcıya mümkün olduğunca fazla bağlam bilgisi sağlamak için oluşan hatayı kullanın. Hatayı çözmek için atabilecekleri 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ürlerine yönelik işleyiciler uygulayın. Nadir görülen veya daha önce karşılaşılmamış hataları ele almak 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ı bir kuyruğa ekleyerek bir insan 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 sistemi oluşturmak için ç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şebiliyorsa uygulamanızın haberi olmadan değişiklikler yapabilir ve uygulamanızın yerel veritabanının senkronizasyonunun bozulmasına neden olabilir. Hata türleri kılavuzumuzda belirtildiği gibi, senkronizasyonla ilgili hataları meydana geldiklerinde reaktif olarak ele alabilirsiniz ancak bunları proaktif olarak önlemeye de çalışabilirsiniz. Proaktif stratejilerden biri, yerel veritabanınızı hesaplarınızdaki Google Ads nesneleriyle mutabık kılmak için periyodik bir senkronizasyon işi çalıştırmaktır. Büyük hesap hiyerarşilerinde, günlük kotaların tükenmesini önlemek için her gece her hesaptaki tüm nesneleri çekmekten kaçının. Bunun yerine, değişiklikleri kademeli olarak senkronize etmek için ChangeStatus sorgusu yapın veya yakın zamanda değiştirilen varlıkları filtreleyin.

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 temizlenmiş ham istek ve yanıt (OAuth jetonları ve kimliği tanımlayabilecek bilgiler gibi hassas kimlik bilgilerinin çıkarıldığından emin olun) yer alır.

Uygulamanızla ilgili sorunları tespit edip çözebilmek 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 birçok ticari araçtan birini kullanmayı düşünebilirsiniz.

Geliştirme

Geliştirme aşamasında test hesapları kullanın.

Test hesaplarını kullanma

Test hesapları, 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şlemlerinin beklendiği gibi çalıştığını test etmek için bir test hesabı kullanabilirsiniz. Google Cloud projenizin bir 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 hemen geliştirmeye başlayabilirsiniz.

Sonraki
API sınırları ve kotaları