Mendalami analitik AMP

Panduan ini membahas lebih dalam tentang komponen amp-analytics, membagi sampel konfigurasi amp-analytics ke dalam blok-blok penyusun utama ini:

Bagian lain di dalam panduan ini menggunakan sampel konfigurasi ini, yang melacak jumlah penayangan halaman dan klik pengguna pada tautan serta mengirimkan data analitik ke penyedia pihak ketiga, Google Analytics:

<amp-analytics
  type="googleanalytics"
  config="https://example.com/analytics.account.config.json"
>
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}",
        "event": "https://example.com/analytics?eid=${eventId}&elab=${eventLabel}&acct=${account}"
      },
      "vars": {
        "account": "ABC123"
      },
      "extraUrlParams": {
        "cd1": "AMP"
      },
      "triggers": {
        "trackPageview": {
          "on": "visible",
          "request": "pageview"
        },
        "trackAnchorClicks": {
          "on": "click",
          "selector": "a",
          "request": "event",
          "vars": {
            "eventId": "42",
            "eventLabel": "clicked on a link"
          }
        }
      },
      "transport": {
        "beacon": false,
        "xhrpost": false,
        "image": true
      }
    }
  </script>
</amp-analytics>

Kode contoh di atas adalah untuk membantu Anda belajar, tetapi ini sama sekali bukan contoh yang realistis. Jika Anda bekerja dengan penyedia analitik, sampel di atas mungkin tidak masuk akal; konfigurasi penyedia menghilangkan kerumitan. Kunjungi dokumentasi penyedia analitik Anda untuk melihat konfigurasi sampel.

Ke mana data analisis dikirimkan: atribut type (jenis)

AMP is designed to support two common patterns of data collection:

• Penyerapan data oleh endpoint milik penayang untuk sistem analitik internal.
• Ingestion by a vendor-owned endpoint for interoperability with a vendor solution (for example, Adobe Analytics, Chartbeat, Google Analytics).

Untuk mengirim data analisis ke penyedia analisis, sertakan atribut type ke dalam tag amp-analytics dan tetapkan nilainya ke vendor yang sesuai, seperti dijelaskan pada daftar Vendor Analisis.

Misalnya: <amp-analytics type="googleanalytics"> mengirim data analisis ke penyedia analisis pihak ketiga, Google Analytics. Untuk mengirim data ke endpoint milik penayang, jangan sertakan atribut type; data analisis dikirim ke endpoint yang ditentukan untuk masing-masing permintaan.

Konfigurasi vendor analisis adalah cara cepat untuk mulai menggunakan amp-analytics. Sebaiknya Anda pelajari dokumentasi vendor dan referensi bantuan untuk mendapatkan panduan lebih lanjut. Seperti disebutkan sebelumnya, daftar vendor yang telah berintegrasi dengan AMP, serta link ke dokumentasi spesifik mereka, dapat ditemukan di daftar Vendor Analisis.

Jika Anda adalah vendor analisis, pelajari lebih lanjut cara mengintegrasikan konfigurasi analisis Anda ke AMP HTML.

Memuat konfigurasi jarak jauh: atribut config (konfigurasi)

Anda tidak perlu menyertakan semua konfigurasi untuk amp-analytics sepenuhnya di halaman AMP Anda. Sebagai gantinya, Anda dapat memanggil URL jarak jauh untuk semua atau sebagian konfigurasi tersebut.

Dengan begitu, Anda dapat melakukan beberapa hal, seperti memvariasikan konfigurasi berdasarkan permintaan yang spesifik. Jika Anda sebagai penayang memiliki kontrol atas berkas jarak jauh, Anda dapat melakukan semua pemrosesan sisi server yang diperlukan untuk menyusun konfigurasi data.

Langkah pertama untuk memuat konfigurasi jarak jauh adalah dengan menyertakan atribut "config" ke dalam tag amp-analytics:

<amp-analytics
  config="https://example.com/analytics.account.config.json"
></amp-analytics>

Langkah selanjutnya adalah membuat konten JSON yang berada di URL jarak jauh. Dalam contoh sederhana ini, konfigurasi yang berada dalam objek JSON hanya berupa nilai variabel untuk akun analitik.

Konten contoh di https://example.com/analytics.account.config.json:

{
  "vars": {
    "account": "UA-XXXXX-Y"  // Replace with your property ID.
  }
}

Langkah terakhir adalah memastikan data apa di dalam berkas jarak jauh yang ditarik ke tempat yang sesuai dalam konfigurasi amp-analytics. Dalam kedua permintaan pageview dan event di sini, nilai variabel account otomatis ditetapkan ke nilai akun pada URL jarak jauh ("account": "UA-XXXXX-Y"):

"requests": {
  "pageview": "https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}",
  "event": "https://example.com/analytics?eid=${eventId}&elab=${eventLabel}&acct=${account}"
}

Atribut requests, triggers, & transport

Atribut requests menetapkan ‘data apa yang dikirimkan’ (misalnya, pageviews, events), dan ke mana data tersebut dikirimkan (URL yang digunakan untuk mengirimkan data).

Atribut triggers menjelaskan kapan data analitik harus dikirimkan, misalnya, saat pengguna melihat halaman, saat pengguna mengeklik suatu tautan.

Atribut transport menentukan cara mengirimkan permintaan, lebih tepatnya, protokol pengirimannya.

Baca terus untuk mengetahui lebih lanjut tentang konfigurasi ini. (Anda juga dapat membaca tentang konfigurasi ini di referensi amp-analytics

Data apa yang dikirimkan: atribut requests

Atribut request-name digunakan di dalam konfigurasi pemicu untuk menentukan permintaan apa yang harus dikirimkan sebagai respons atas peristiwa tertentu. Atribut request-value berupa URL https. Nilai ini dapat mencakup token bakal tempat yang dapat merujuk ke permintaan atau variabel lain.

"requests": {
  "pageview": "https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}",
  "event": "https://example.com/analytics?eid=${eventId}&elab=${eventLabel}&acct=${account}"
}

Beberapa penyedia analitik (termasuk Google Analytics) telah menyediakan konfigurasi, ini Anda gunakan melalui atribut type. Jika menggunakan penyedia analitik, Anda mungkin tidak perlu menyertakan informasi requests. Lihat dokumentasi vendor Anda untuk mencari tahu perlu tidaknya mengonfigurasi atribut requests dan cara melakukannya.

Menambahkan URL permintaan: Parameter URL Tambahan

Atribut extraUrlParams menentukan parameter tambahan untuk ditambahkan ke untai kueri dari URL permintaan melalui konvensi "& foo=baz" biasa.

Contoh amp-analytics menambahkan parameter tambahan cd1 ke permintaan dan menetapkan nilai parameter ke "AMP":

  "extraUrlParams": {
    "cd1": "AMP"
  }

Kapan data dikirimkan: atribut triggers

Atribut triggers menjelaskan kapan permintaan analitik harus dikirimkan. Atribut ini berisi pasangan kunci nilai, yaitu nama pemicu dan konfigurasi pemicu. Nama pemicu dapat berupa untai apa saja yang terdiri dari karakter alfanumerik (a-zA-Z0-9).

Misalnya, elemen amp-analytics berikut ini dikonfigurasi untuk mengirimkan permintaan ke https://example.com/analytics saat dokumen pertama kali dimuat, dan setiap kali tag a diklik:

"triggers": {
  "trackPageview": {
    "on": "visible",
    "request": "pageview"
  },
  "trackAnchorClicks": {
    "on": "click",
    "selector": "a",
    "request": "event",
    "vars": {
      "eventId": "42",
      "eventLabel": "clicked on a link"
    }
  }
}

AMP mendukung konfigurasi pemicu berikut ini:

Bagaimana data dikirimkan: atribut transport

Atribut transport menentukan cara mengirimkan permintaan. Tiga metode berikut ini diaktifkan sebagai standar:

Hanya satu metode transportasi yang digunakan, dan metode dengan prioritas tertinggi yang akan diaktifkan, diizinkan, dan tersedia. Prioritasnya adalah beacon > xhrpost > image. Jika agen pengguna klien tidak mendukung suatu metode, metode prioritas tertinggi berikutnya yang diaktifkan yang akan digunakan.

Sertakan atribut transport dalam konfigurasi Anda hanya jika Anda ingin membatasi opsi transport, jika tidak, Anda dapat menghentikan permintaan.

Pada contoh di bawah ini, beacon dan xhrpost ditetapkan sebagai false (semu), jadi keduanya tidak akan digunakan meskipun memiliki prioritas yang lebih tinggi daripada image. Jika agen pengguna klien mendukung metode image, maka akan digunakan; jika tidak, tidak ada permintaan yang dikirimkan.

'transport': {
  'beacon': false,
  'xhrpost': false,
  'image': true
}

Pengaturan urutan penggantian variabel

AMP mengisi variabel dengan nilai sesuai urutan prioritas:

1. Konfigurasi jarak jauh (melalui config).
2. vars yang ditempatkan di dalam pemicu dalam triggers.
3. vars di tingkat teratas yang ditempatkan dalam amp-analytics.
4. Nilai yang disediakan platform.

Dalam contoh ini, terdapat konfigurasi jarak jauh, variabel yang ditentukan di level teratas, pada pemicu, dan di tingkat platform:

<amp-analytics config="http://example.com/config.json">
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}&clientId=${clientId(cid-scope)}",
      },
      "vars": {
        "account": "ABC123",
        "title": "Homepage"
      },
      "triggers": {
        "some-event": {
          "on": "visible",
          "request": "pageview",
          "vars": {
            "title": "My homepage",
            "clientId": "my user"
          }
      }
    }
  </script>
</amp-analytics>

Saat var yang sama ditentukan di beberapa lokasi, urutan prioritas variabel menetapkan nilainya satu kali. Sehingga, jika konfigurasi jarak jauh menetapkan account sebagai UA-XXXXX-Y pada contoh di atas, maka nilai dari berbagai variabelnya adalah sebagai berikut: