iOS v3 - Enhanced E-commerce

Panduan ini menjelaskan cara menerapkan fitur Enhanced E-commerce Universal Analytics menggunakan SDK Google Tag Manager untuk iOS.

Ringkasan

Enhanced E-commerce Google Analytics memungkinkan data penjualan, promosi, dan tayangan produk dikirim bersama tampilan layar dan peristiwa Google Analytics.

Sebelum Memulai

Sebaiknya tinjau bagian Jenis dan Tindakan Data Enhanced E-commerce dalam Panduan Developer Enhanced E-commerce (Web) Google Analytics untuk membantu Anda merencanakan penerapan. Panduan ini akan membantu Anda memahami kolom mana yang wajib dan opsional untuk setiap interaksi e-commerce yang ingin Anda ukur.

Penerapan

Bagian ini akan menunjukkan cara menggunakan lapisan data untuk mengukur aktivitas Enhanced E-commerce berikut:

Mengukur Tayangan Produk

  • Pengukuran E-commerce: impressions
  • Menerima Data: array impressionFieldObjects

Ukur tayangan produk menggunakan tindakan impression dan satu atau beberapa impressionFieldObjects. Contoh berikut mengasumsikan detail tentang produk yang ditampilkan diketahui pada saat layar ditampilkan:

// Product impressions are sent by pushing an impressions object
// containing one or more impressionFieldObjects.
[dataLayer push:@{@"ecommerce": @{
                    @"currencyCode": @"EUR",                      // Local currency is optional.
                    @"impressions": @[
                      @{@"name": @"Triblend Android T-Shirt",     // Name or ID is required.
                        @"id": @"12345",
                        @"price": @"15.25",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Gray",
                        @"list": @"Search Results",
                        @"position": @1},
                      @{@"name": @"Donut Friday Scented T-Shirt",
                        @"id": @"67890",
                        @"price": @"33.75",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Black",
                        @"list": @"Search Results",
                        @"position": @2}]}}];

Mengukur Klik/Pilihan Produk

  • Pengukuran E-commerce: click
  • Menerima Data: list, array productFieldObjects

Ukur pilihan produk dengan mengirim tindakan click ke lapisan data, bersama productFieldObject untuk mewakili produk yang dipilih:

[dataLayer push:@{@"event": @"productClick",
                  @"ecommerce": @{
                    @"click": @{
                      @"actionField": @{
                        @"list": @"Search Results"},              // Optional list property.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",   // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray"}]}}}];

Mengukur Tampilan Detail Produk

  • Pengukuran E-commerce: detail
  • Menerima Data: list, array productFieldObjects

Ukur tampilan detail produk dengan mengirim tindakan detail ke lapisan data, bersama satu atau beberapa productFieldObjects yang merepresentasikan produk yang dilihat:

// Measure a view of product details.
[dataLayer push:@{@"ecommerce": @{
                    @"detail": @{
                      @"actionField": @{
                        @"list": @"Apparel Gallery"},             // 'detail' actions have an optional list property.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",   // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray"}]}}}];

Mengukur Penambahan atau Penghapusan Produk dari Keranjang Belanja

  • Pengukuran E-commerce: add, remove
  • Menerima Data: list, array productFieldObjects

Ukur penambahan atau penghapusan produk dari keranjang belanja menggunakan add atau remove actionFieldObject dan daftar productFieldObjects:

Menambahkan Produk ke Keranjang Belanja

// Measure adding a product to a shopping cart by using an "add"
// actionFieldObject and a list of productFieldObjects.
[dataLayer push:@{@"event": @"addToCart",
                  @"ecommerce": @{
                    @"currencyCode": @"EUR",
                    @"add": @{                                  // 'add' actionFieldObject measures.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1}]}}}];

Menghapus Produk dari Keranjang Belanja

// Measure the removal of a product from a shopping cart.
[dataLayer push:@{@"event": @"removeFromCart",
                  @"ecommerce": @{
                    @"remove": @{                               // 'remove' actionFieldObject measures.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1}]}}}];

Mengukur Promosi

Anda dapat mengukur tayangan dan pilihan pada promosi aplikasi internal, seperti banner yang ditampilkan dalam aplikasi untuk mengiklankan promo pada subkumpulan produk tertentu atau penawaran pengiriman gratis.

Mengukur Tayangan Promosi

  • Pengukuran E-commerce: promoView
  • Menerima Data: array promoFieldObjects

Untuk mengukur tayangan promosi, tetapkan kunci promoView di lapisan data e-commerce ke promoFieldObject yang menjelaskan promosi yang ditampilkan kepada pengguna di layar:

// An example of measuring promotion views. This example assumes that
// information about the promotions displayed is available when the screen is
// displayed.
[dataLayer push:@{@"ecommerce": @{
                    @"promoView": @{
                      @"promotions": @[                     // Array of promoFieldObjects.
                        @{@"id": @"JUNE_PROMO13",           // ID or Name is required.
                          @"name": @"June Sale",
                          @"creative": @"banner1",
                          @"position": @"slot1"},
                        @{@"id": @"FREE_SHIP13",
                          @"name": @"Free Shipping Promo",
                          @"creative": @"skyscraper1",
                          @"position": @"slot2"}]}}}];

Mengukur Klik/Pilihan Promosi

Untuk mengukur pilihan promosi, kirim tindakan promoClick ke lapisan data dengan array yang berisi promoFieldObject yang menjelaskan promosi yang dipilih:

[dataLayer push:@{@"event": @"promotionClick",
                  @"ecommerce": @{
                    @"promoClick": @{
                      @"promotions": @[
                        @{@"id":  @"JUNE_PROMO13",          // Name or ID is required.
                          @"name": @"June Sale",
                          @"creative": @"banner1",
                          @"position": @"slot1"}]}}}];

Mengukur Checkout

Untuk mengukur setiap langkah dalam proses checkout, Anda perlu:

  1. Mengukur setiap langkah proses checkout menggunakan tindakan checkout.
  2. Mengukur opsi checkout menggunakan tindakan checkout_option, jika relevan.
  3. (Opsional) Menetapkan nama langkah yang mudah dipahami untuk laporan funnel checkout dengan mengonfigurasi Setelan E-commerce di bagian Admin pada antarmuka web.

1. Mengukur Langkah Checkout

  • Pengukuran E-commerce: checkout
  • Menerima Data: step, array productFieldObjects

Untuk mengukur proses checkout, yang mungkin mencakup tombol checkout dan satu atau beberapa layar checkout tempat pengguna memasukkan informasi pengiriman dan pembayaran, gunakan tindakan checkout dan kolom step untuk menunjukkan tahap pada proses checkout yang sedang diukur. Anda juga dapat menggunakan kolom option untuk memberikan bagian data tambahan tentang proses checkout, seperti jenis pembayaran yang dipilih oleh pengguna.

[dataLayer push:@{@"event": @"checkout",
                  @"ecommerce": @{
                    @"checkout": @{
                      @"actionField": @{
                        @"step": @1,
                        @"option": @"Visa"},
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1}]}}}];

2. Mengukur Opsi Checkout

  • Pengukuran E-commerce: checkout_option
  • Menerima Data: step, option

Opsi checkout berguna jika Anda telah mengukur langkah checkout, tetapi ingin mencatat informasi tambahan tentang langkah checkout tersebut. Misalnya, metode pengiriman yang dipilih oleh pengguna. Untuk mengukurnya, gunakan tindakan checkout_option bersama dengan kolom step dan option.

[dataLayer push:@{@"event": @"checkoutOption",
                  @"ecommerce": @{
                    @"checkout_option": @{
                      @"actionField": @{
                        @"step": @1,
                        @"option": @"Express"}}}}];

3. Konfigurasi Funnel Checkout

Opsional, setiap langkah dalam proses checkout dapat diberi nama deskriptif yang akan digunakan dalam laporan. Untuk mengonfigurasi nama ini, kunjungi bagian Admin pada Antarmuka Web Google Analytics, pilih tampilan (profil), lalu klik Setelan E-commerce. Ikuti petunjuk penyiapan E-commerce untuk memberi label pada setiap langkah checkout yang ingin Anda lacak.

Penyiapan e-commerce di bagian admin pada antarmuka Google Analytics. Funnel
         checkout didefinisikan dengan empat langkah: 1. Meninjau Keranjang, 2. Mengumpulkan Info
         Pembayaran, 3. Mengonfirmasi Detail Pembelian, 4. Tanda Terima.
Gambar 1: Penyiapan e-commerce, funnel checkout.

Mengukur Pembelian

  • Pengukuran E-commerce: purchase
  • Menerima Data: id (ID Transaksi), array productFieldObjects

Kirim detail transaksi Anda ke lapisan data menggunakan tindakan purchase, bersama dengan event yang akan mengaktifkan tag yang diaktifkan Enhanced E-commerce. Dalam contoh ini, detail transaksi diketahui saat layar ditampilkan:

// Send transaction data with a screenview if possible.
// Otherwise, use an event when the transaction data becomes available.
[dataLayer push:@{@"ecommerce": @{
                    @"purchase": @{
                      @"actionField": @{
                        @"id": @"T12345",                         // Transaction ID. Required for purchases and refunds.
                        @"affiliation": @"Online Store",
                        @"revenue": @"35.43",                     // Total transaction value (incl. tax and shipping)
                        @"tax":"4.90",
                        @"shipping": @"5.99",
                        @"coupon": @"SUMMER_SALE"},
                      @"products": @[                             // List of productFieldObjects.
                        @{@"name": @"Triblend Android T-Shirt",   // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray",
                          @"quantity": @1,
                          @"coupon": @""},                        // Optional fields may be omitted or set to empty string.
                        @{@"name": @"Donut Friday Scented T-Shirt",
                          @"id": @"67890",
                          @"price": @"33.75",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Black",
                          @"quantity": @1}]}}}];

Mengukur Pengembalian Dana

  • Pengukuran E-commerce: refund
  • Menerima Data: id (ID Transaksi), array productFieldObjects

Untuk mengukur pengembalian dana penuh dari sebuah transaksi, kirim refund actionFieldObject bersama dengan ID transaksi untuk transaksi yang dananya dikembalikan:

// Refund an entire transaction by providing the transaction ID. This example
// assumes the details of the completed refund are available when the screen
// is displayed:
[dataLayer push:@{@"ecommerce": @{
                    @"refund": @{
                      @"actionField": @{
                        @"id": @"T12345"}}}}];  // Transaction ID. Required for refunds.

Untuk mengukur pengembalian dana sebagian, tambahkan daftar productFieldObjects, termasuk ID dan jumlah produk yang dananya dikembalikan:

// Measure a partial refund by providing an array of productFieldObjects and
// specifying the ID and quantity of each product being returned. This example
// assumes the partial refund details are known at the time the screen is
// displayed:
[dataLayer push:@{@"ecommerce": @{
                    @"refund": @{
                      @"actionField": @{
                        @"id": @"T12345"},      // Transaction ID.
                      @"products": @[
                        @{@"id": @"P4567",
                          @"quantity": @1},     // Product ID & quantity. Required for partial refunds.
                        @{@"id": @"P8901",
                          @"quantity": @2}]}}}];

Menggabungkan Tayangan dan Tindakan

Jika memiliki tayangan produk dan tindakan, Anda dapat menggabungkan dan mengukur keduanya dalam satu hit.

Contoh di bawah ini menunjukkan cara mengukur tampilan detail produk dengan tayangan produk dari bagian produk terkait:

[dataLayer push:@{@"ecommerce": @{
                    @"impressions": @[
                      @{@"name": @"Triblend Android T-Shirt",       // Name or ID is required.
                        @"id": @"12345",
                        @"price": @"15.25",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Gray",
                        @"list": @"Related Products",
                        @"position": @1},
                      @{@"name": @"Donut Friday Scented T-Shirt",
                        @"id": @"67890",
                        @"price": @"33.75",
                        @"brand": @"Google",
                        @"category": @"Apparel",
                        @"variant": @"Black",
                        @"list": @"Related Products",
                        @"position": @2}],
                    @"detail": @{
                      @"actionField": @{
                        @"list": @"Apparel Gallery"},               // 'detail' actions have an optional list property.
                      @"products": @[
                        @{@"name": @"Triblend Android T-Shirt",     // Name or ID is required.
                          @"id": @"12345",
                          @"price": @"15.25",
                          @"brand": @"Google",
                          @"category": @"Apparel",
                          @"variant": @"Gray"}]}}}];