iOS v3 - Enhanced E-commerce

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

Ringkasan

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

Sebelum Anda Mulai

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

Penerapan

Bagian berikut 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 akan 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 menerapkan tindakan click ke data bersama dengan productFieldObject untuk merepresentasikan lapisan produk:

[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, beserta 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 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 di aplikasi untuk mengiklankan diskon 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 mendeskripsikan 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 {i>checkout<i}, yang mungkin mencakup tombol {i>checkout<i} dan satu atau beberapa layar checkout tempat pengguna memasukkan pengiriman dan pembayaran informasi penting, gunakan tindakan checkout dan step untuk menunjukkan tahap mana dari proses {i>checkout<i} yang sedang diukur. Anda juga dapat menggunakan kolom option untuk memberikan bagian data tambahan tentang proses {i>checkout<i}, 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 diaktifkan tag yang diaktifkan Enhanced E-commerce. Dalam contoh ini, detail transaksi diketahui pada 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 transaksi ID 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 kuantitas produk yang 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 Anda memiliki tayangan produk dan tindakan, dapat digabungkan dan mengukurnya 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"}]}}}];