Analiz aracınızı AMP ile entegre etme
Important: this documentation is not applicable to your currently selected format email!
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 onawindow.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
- 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.
- Aşağıdakileri uygulayan bir yama geliştirin:
- A new configuration json file
${vendorName}.json
in the vendors folder including any options above and beyond the default, such as:"vars": {}
ek varsayılan değişkenler için."requests": {}
hizmetinizin kullanacağı istekler için."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."warningMessage":
gerekirse. Konsolda sağlayıcıdan gelen uyarı bilgilerini (kullanımdan kaldırma veya geçiş gibi) görüntüler.
- 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 - examples/analytics-vendors.amp.html. referansında bir örnek.
- extensions/amp-analytics/0.1/test/vendor-requests.json dosyasında bir test.
- 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.
- Ö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.
- Bu yama ile Uygulama Amacı konusuna atıfta bulunarak bir Çekme İsteği gönderin.
- Hizmetinizin kullanım belgelerini güncelleyin ve müşterilerinizi bilgilendirin.
- 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
- Ayrıntılı İnceleme: Neden sadece bir iframe kullanılmıyor?
- Ayrıntılı İnceleme: Kimliği doğrulanmamış kullanıcı durumunu AMP ile yönetme
- amp-analytics örneği
- amp-analytics referans belgeleri
- amp-analytics değişkenleri referans belgeleri