AMP

Analiz aracınızı AMP ile entegre etme

Genel bakış

Yayıncıların trafiğini ve ziyaretçilerini daha iyi anlamaları için bir hizmet olarak yazılım aracı kullanıyorsanız, hizmetinizi amp-analytics ile entegre etmek isteyebilirsiniz. Bunu yapmanız, müşterilerinizin AMP HTML sayfalarına ilişkin trafik modellerini görüntülemesini sağlayacaktır.

Başlamadan önce

Analiz hizmetinizi AMP HTML çalışma zamanına eklemeden önce şunları yapmanız gerekebilir:

  • Analiz hizmetiniz için bir AMP HTML belgesinde ihtiyaç duyacağınız değişken ve istek türlerini tanımlamak.
  • Hizmetinizle ilgili olabilecek bir sayfadan analiz isteklerinin gönderilmesine neden olan tetikleyicileri belirlemek.
  • Birinci ve üçüncü taraf AMP bağlamları boyuna kullanıcıları nasıl takip edeceğinizi veya takip edip etmeyeceğinizi hesaba katmak.
  • Analiz panelinizin AMP trafiğini nasıl işlediğini belirlemek.
  • amp-analytics içindeki eksik işlevleri belirlemek ve gerekli özellikler için istekte bulunmak.
  • AMP Analytics, değişkenlerini, önceden yapılandırılmış bir uç noktaya gönderir. Halihazırda mevcut bir uç noktanız yoksa, nasıl oluşturulacağına dair genel bir bakış için bu örneği inceleyin.
  • iframe dışındaki tüm aktarım türleri için değişkenler, bir HTTPS isteğinde sorgu dizesi parametreleri olarak gönderilir.
  • iframe aktarım türü için bir iframe oluşturulur ve değişkenler ona window.postMessage aracılığıyla gönderilir. Bu durumda mesajın bir URL olması gerekmez. Bu seçenek yalnızca MRC onaylı sağlayıcılar tarafından kullanılabilir.
  • amp-analytics ile entegrasyonun herhangi bir politikayı (özellikle gizlilik politikanızı) veya sahip olabileceğiniz sözleşmeleri nasıl etkileyebileceğini düşünün.

Yapılandırmanızı AMP HTML çalışma zamanına ekleme

  1. Analiz hizmetinizin yapılandırmasını AMP HTML'nin çalışma zamanına ekleyeceğinizi belirten bir Uygulama Amacı konusu oluşturun. Açıklamanıza cc @ampproject/wg-analytics'i eklediğinizden emin olun.
  2. Aşağıdakileri uygulayan bir yama geliştirin:
  3. A new configuration json file ${vendorName}.json in the vendors folder including any options above and beyond the default, such as:
    1. "vars": {} ek varsayılan değişkenler için.
    2. "requests": {} hizmetinizin kullanacağı istekler için.
    3. "optout": gerekirse. Şu anda harika bir devre dışı bırakma sistemimiz yok, bu nedenle lütfen size uygun bir sistem tasarlamamıza yardımcı olmak için bize ulaşın.
    4. "warningMessage": gerekirse. Konsolda sağlayıcıdan gelen uyarı bilgilerini (kullanımdan kaldırma veya geçiş gibi) görüntüler.
  4. iframe aktarımı kullanıyorsanız iframe-transport-vendors.js'de ANALYTICS_IFRAME_TRANSPORT_CONFIG'e "*vendor-name*": "*url*" içeren yeni bir satır da ekleyin
  5. examples/analytics-vendors.amp.html. referansında bir örnek.
  6. extensions/amp-analytics/0.1/test/vendor-requests.json dosyasında bir test.
  7. Analiz hizmetinizi, extensions/amp-analytics/0.1/analytics-vendors-list.md dosyasındaki desteklenen sağlayıcılar listesine ekleyin. Kullanım belgelerinizin türünü, açıklamasını ve bağlantısını ekleyin.
  8. Örnekteki isabetlerin beklendiği gibi çalıştığından emin olmak için examples/analytics-vendors.amp.html içine koyduğunuz yeni örneği test edin. Örneğin, ihtiyaç duyulan veriler toplanıyor ve analiz panelinizde görüntüleniyor.
  9. Bu yama ile Uygulama Amacı konusuna atıfta bulunarak bir Çekme İsteği gönderin.
  10. Hizmetinizin kullanım belgelerini güncelleyin ve müşterilerinizi bilgilendirin.
  11. AMP bilgi havuzu dışında bir entegrasyon testi barındırmanız şiddetle tavsiye edilir.

Etiket Yöneticileri

Etiket yönetim hizmetlerinin AMP Analytics ile entegrasyon için iki seçeneği vardır:

  • Uç nokta yaklaşımı: amp-analytics için ek bir uç nokta olarak hareket etmek ve arka uçta pazarlama yönetimi yürütmek.
  • Yapılandırma yaklaşımı: Her yayıncıya özgü dinamik olarak oluşturulmuş bir JSON yapılandırma dosyası aracılığıyla etiket yönetimi yürütme.

Uç nokta yaklaşımı, önceki bölümde ayrıntılı olarak açıklanan standart yaklaşımla aynıdır. Yapılandırma yaklaşımı, her yayıncıya özgü ve tüm uyumlu analiz paketlerini içeren amp-analytics için benzersiz bir yapılandırma oluşturmayı içerir. Bir yayıncı, yapılandırmayı şuna benzer bir sözdizimi kullanarak ekler:

<amp-analytics
config="https://my-awesome-tag-manager.example.com/user-id.json"

> </amp-analytics>
> 

Bu yaklaşımı benimsemek için, yayıncıların AMP Analytics ile entegrasyonuna ilişkin belgeleri inceleyin.

Diğer Kaynaklar