En İyi Uygulamalar

Video: 2019 atölyesindeki en iyi uygulamalar konulu 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 şekilde çalışmasını sağlamak için:

  • API merkezindeki geliştirici iletişim e-postanızı güncel tutun. Bu, sizinle iletişim kurmak için kullandığımız takma addır. API Hükümler ve Koşulları'na uygunluk konusunda sizinle iletişime geçemezsek API erişiminiz önceden haber verilmeden iptal edilebilir. Bir kişiye veya izlenmeyen bir hesaba bağlı kişisel e-posta adresleri kullanmaktan kaçının. API Merkezi'ni görüntülemek için yönetici hesabınıza giriş yapmış olmanız gerekir.

  • Ürün değişiklikleri, bakım nedeniyle hizmet dışı kalma süreleri, desteği sonlandırılan ürünlerle ilgili tarihler gibi konularda bilgi edinmek için

Forum, Google Ads API ekibi tarafından düzenli olarak izlendiği için API soruları yayınlamak için ideal bir yerdir.

  • Uygulamanızın Google Ads API Hükümler ve Koşulları'na (H&K) 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 hakkında 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 uygun durumlarda 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 bozma işlemleri ve arka uç sistemlerine yapılan çağrılar gibi çeşitli sabit maliyetler içerir. Bu sabit maliyetlerin etkisini azaltmak ve genel performansı artırmak için API'deki çoğu mutasyon yöntemi, bir dizi işlem kabul edecek şekilde tasarlanmıştır. Her istek için birden fazla işlemi toplu olarak göndererek gönderdiğiniz istek sayısını ve ilişkili sabit maliyetleri azaltabilirsiniz. Mümkünse yalnızca bir işlem içeren istekler göndermekten kaçının.

Örneğin, birden fazla reklam grubunda bir kampanyaya 50.000 anahtar kelime eklediğinizi varsayalım. Her biri 1 anahtar kelime içeren 50.000 istek yerine, her biri 500 anahtar kelime içeren 100 istek veya hatta her biri 5.000 anahtar kelime içeren 10 istek gönderin. Bir istekte izin verilen işlem sayısı sınırlıdır. Bu nedenle, optimum performans elde etmek için toplu işlem boyutunuzu ayarlamanız gerekebilir.

Seyrek nesneleri gönderme

API'ye gönderilen nesnelerin alanları, seri dışına çıkarılmalı, doğrulanmalı ve veritabanında depolanmalıdır. 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 nesnenin yalnızca değiştirmeniz gereken veya gerekli olan alanlarını doldurabilirsiniz. Seyrek güncellemeler daha hızlı işlenir ve hata oluşturma olasılıkları daha düşüktür. update_mask (FieldMask olarak da bilinir) içinde olmayan alanlar değiştirilmeden bırakılır.

Örneğin, anahtar kelime düzeyinde teklifleri güncelleyen bir uygulama, yalnızca reklam grubu kimliği, ölçüt kimliği ve teklifler 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. Hataları yönetme hakkında daha fazla bilgi için bu bölüme ek olarak Sorun giderme kılavuzunu da ziyaret edin.

İstek kaynaklarını ayırt etme

Bazı uygulamalar, kullanıcı arayüzünde kullanıcı tarafından başlatılan işlemlere doğrudan yanıt olarak API çağrıları göndererek öncelikle etkileşimlidir. Diğerleri ise düzenli bir arka uç işleminin parçası olarak API çağrıları göndererek öncelikle çevrimdışı çalışır. Birçok uygulama bu ikisini bir arada kullanır. 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 birincil endişeniz, kullanıcılarınıza iyi bir deneyim sunmaktır. Kullanıcı arayüzünde kullanıcıya olabildiğince fazla bağlam bilgisi sağlamak için gerçekleşen 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 istekler için 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 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 sıraya eklemektir. Böylece gerçek bir operatör, hatayı inceleyip uygun bir çözüm belirleyebilir.

Hata türlerini ayırt etme

Google Ads API'deki hata türleri arasındaki farkları bilmek, güçlü bir hata işleme mekanizması oluştururken çok önemlidir. En yaygın hata türlerinden bazıları şunlardır:

  1. Kimlik doğrulama hataları
  2. Yeniden denemeye uygun hatalar
  3. Doğrulama hataları
  4. Senkronizasyonla ilgili hatalar

Daha fazla bilgi için Hata Türleri ve Sık Karşılaşılan Hatalar bölümüne 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 yapabilir ve uygulamanızın yerel veritabanının senkronizasyonunun bozulmasına neden olabilirler. Hata Türleri kılavuzumuzda belirtildiği gibi, senkronizasyonla ilgili hataları oluştuklarında reaktif olarak ele alabilir ancak proaktif olarak önlemeye de çalışabilirsiniz. Proaktif bir strateji, tüm hesaplarınızda gecelik bir senkronizasyon işi çalıştırarak hesaplarınızdaki Google Ads nesnelerini almak ve yerel veritabanınızla karşılaştırmaktır.

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 hatayı 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.

Uygulamanızdaki sorunları tespit edip giderebilmek için API hatalarındaki trendleri izlemeyi unutmayın. Kendi çözümünüzü oluşturabilir veya etkileşimli kontrol panelleri oluşturmak ve otomatik uyarılar göndermek için günlüklerinizi kullanabilen birçok ticari araçtan birini kullanabilirsiniz.

Geliştirme

Geliştirme aşaması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'yi denemek 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ılabilmesi için onaylanmasına gerek yoktur. Bu nedenle, geliştirici jetonu isteğinde bulunduktan hemen sonra, hatta uygulamanız incelenmeden önce bile Google Ads API ile geliştirme yapmaya başlayabilirsiniz.

Sonraki
API sınırları ve kotaları