Geliştirilmiş E-ticaret İzleme - iOS SDK'sı

Bu belgede, iOS sürüm 3 için Google Analytics SDK'sı ile uygulama içi e-ticaretle ilgili işlemlerin ve gösterimlerin nasıl ölçüleceğine genel bir bakış sunulmaktadır.

Not: Artık Google Analytics 4 mülkleriyle e-ticaret verileri toplayabilirsiniz.

Genel bakış

Geliştirilmiş e-ticaret, kullanıcının alışveriş deneyimi genelinde ürünlerle olan etkileşimlerinin ölçülmesini sağlar. Bu etkileşimler arasında ürün gösterimleri, ürün tıklamaları, ürün ayrıntılarını görüntüleme, alışveriş sepetine ürün ekleme, ödeme sürecini başlatma, işlemler ve geri ödemeler yer alır.

Önemli: Geliştirilmiş e-ticaret, iOS SDK'sına dahil olan, geliştirilmiş e-ticaretle ilgili kitaplıkları ve alanları kullanmanızı gerektirir. Geliştirilmiş e-ticaret değerleri, screenviews ve events gibi mevcut isabetlerle birlikte gönderilir. Standart E-ticaret İzleme'ye yönelik transaction ve item isabetlerini göndermemeniz gerekir.

Uygulama

Geliştirilmiş e-ticaret izlemeyi uygulamanızda kullanmaya başlamadan önce, geliştirilmiş e-ticaret kitaplığını uygulamanıza eklemeniz gerekir.

Uygulamanızı geliştirilmiş e-ticareti kullanacak şekilde yapılandırdıktan sonra:

• E-ticaret etkinliklerini ölçme
• İşlemleri ölçme
• Geri Ödemeleri Ölçme
• Ödeme Sürecini Ölçme
• Dahili Tanıtımları Ölçme

E-Ticaret Etkinliklerini Ölçme

Tipik bir geliştirilmiş e-ticaret uygulaması, ürün gösterimlerini ve aşağıdaki işlemlerin herhangi birini ölçer:

• Ürün seçmek.
• Ürün ayrıntılarını görüntüleme.
• Gösterim sayısı ve dahili tanıtım seçimi.
• Alışveriş sepetine ürün ekleme veya sepetten ürün çıkarma.
• Bir ürün için ödeme sürecini başlatma.
• Satın alma işlemleri ve geri ödemeler.

Gösterimleri Ölçme

Bir ürün gösterimini ölçmek için ürün ve gösterim değerlerini belirleyin ve bir isabetle gönderin:

id tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setCustomDimension:1 value:@"Member"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];

// Sets the product impression for the next available slot, starting with 1.
[builder addProductImpression:product
               impressionList:@"Search Results"
             impressionSource:@"From Search"];
[tracker set:kGAIScreenName value:@"My Impression Screen"];
[tracker send:[builder build]];

Ürünün bir name veya id [no] değeri olmalıdır. Diğer tüm değerler isteğe bağlıdır ve ayarlanması gerekmez.

İşlemleri Ölçme

İşlemler, ürün değerlerinin ve ardından gerçekleştirilen işlemi belirtmek amacıyla ürün işlem değerlerinin belirlenmesiyle ölçülür.

Örneğin, aşağıdaki kod arama sonuçları listesinde görüntülenen bir ürünün seçimini ölçer:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setCustomDimension:1 value:@"Member"];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPAClick];
[action setProductActionList:@"Search Results"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];
[builder setProductAction:action];

// Sets the product for the next available slot, starting with 1
[builder addProduct:product];
[tracker set:kGAIScreenName value:@"My Impression Screen"];
[tracker send:[builder build]];

Ürünün bir name veya id [no] değeri olmalıdır. Diğer tüm değerler isteğe bağlıdır ve ayarlanması gerekmez.

Gösterimleri ve İşlemleri Birleştirme

Hem ürün gösterimlerinizin hem de bir işlemin olduğu durumlarda, bunu tek bir isabette birleştirip ölçmek mümkündür.

Aşağıdaki örnekte, ilgili ürünler bölümüyle ürün ayrıntıları görünümünün nasıl ölçüleceği gösterilmektedir:

// The product from the related products section.
id tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12346"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"White"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];

// Sets the product impression for the next available slot, starting with 1.
[builder addProductImpression:product
               impressionList:@"Related Products"
             impressionSource:@"From Related"];

// The product being viewed.
product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPADetail];
[builder setProductAction:action];
// Sets the product for the next available slot, starting with 1.
[builder addProduct:product];
[tracker set:kGAIScreenName value:@"Related Products Screen"];
[tracker send:[builder build]];

İşlemleri Ölçme

Ürün değerlerini belirleyip ardından bir satın alma işlemini belirtmek için ürün işlemi değerlerini ayarlayarak bir işlemi ölçün. Toplam gelir, vergi ve gönderim bedeli gibi işlem düzeyindeki ayrıntılar, ürün işlemi değerleriyle belirlenir.

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setPrice:@29.20];
[product setCouponCode:@"APPARELSALE"];
[product setQuantity:@1];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Purchase"
                                                                        label:nil
                                                                        value:nil];
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPAPurchase];
[action setTransactionId:@"T12345"];
[action setAffiliation:@"Google Store - Online"];
[action setRevenue:@37.39];
[action setTax:@2.85];
[action setShipping:@5.34];
[action setCouponCode:@"SUMMER2013"];
[builder setProductAction:action];

// Sets the product for the next available slot, starting with 1
[builder addProduct:product];
[tracker send:[builder build]];

Para Birimi Belirtme

Varsayılan olarak, Google Analytics yönetimi web arayüzü üzerinden tüm işlemler ve öğeler için ortak, global bir para birimi yapılandırabilirsiniz.

Yerel para birimi ISO 4217 standardında belirtilmelidir. Desteklenen dönüşüm para birimlerinin tam listesi için Para Birimi Kodları Referansı belgesini okuyun.

Yerel para birimleri, izleyicideki para birimi kodu değerinin ayarlanmasıyla belirtilir. Örneğin, bu izleyici para birimi değerlerini Euro olarak gönderir:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTracker"];
[tracker set:kGAIScreenName value:@"transaction"];
[tracker set:kGAICurrencyCode value:@"EUR"]; // Set tracker currency to Euros.
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];
[tracker send:[builder build]];

Google Analytics'te para birimi dönüştürmenin işleyiş şekli hakkında daha fazla bilgi edinmek için e-ticaret özelliği referansındaki Birden Fazla Para Birimi bölümünü okuyun.

Geri Ödemeleri Ölçme

Bir işlemin tamamı için geri ödeme yapmak isterseniz işlem kimliğini ve geri ödeme işlem türünü belirten ürün işlemi değerleri belirleyin:

// Refund an entire transaction.
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Refund"
                                                                        label:nil
                                                                        value:nil];
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPARefund];
[action setTransactionId:@"T12345"];
[builder setProductAction:action];
[tracker send:[builder build]];

Eşleşen bir işlem bulunmazsa geri ödeme işleme alınmaz.

Kısmi geri ödemeyi ölçmek istiyorsanız işlem kimliğini, ürün kimliklerini ve geri ödenecek ürün miktarını belirtmek için ürün işlemi değerlerini ayarlayın:

// Refund a single product.
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Refund"
                                                                        label:nil
                                                                        value:nil];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"]; // Product ID is required for partial refund.
[product setQuantity:@1]; // Quanity is required for partial refund.
[builder addProduct:product];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPARefund];
[action setTransactionId:@"T12345"]; // Transaction ID is required for partial refund.
[builder setProductAction:action];
[tracker send:[builder build]];

Geri Ödemeler için Etkileşim Dışı Etkinlikleri Kullanma

Geri ödeme verilerini bir etkinlik kullanarak göndermeniz gerekiyorsa ve etkinlik, normal şekilde ölçülen kullanıcı davranışının bir parçası değilse (ör. kullanıcı tarafından başlatılmıyorsa) etkileşim olmayan bir etkinlik göndermeniz önerilir. Böylece belirli metriklerin etkinlikten etkilenmesi önlenmiş olur. Örneğin:

// Refund an entire transaction.
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Refund"
                                                                        label:nil
                                                                        value:nil];

[builder set:@"1" forKey:kGAINonInteraction];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPARefund];
[action setTransactionId:@"T12345"];

[builder setProductAction:action];
[tracker send:[builder build]];

Ödeme Sürecini Ölçme

Ödeme sürecindeki her adımı ölçmek için:

1. Ödeme işleminin her adımını ölçmek için izleme kodu ekleyin.
2. Varsa, ödeme seçeneklerini ölçmek için izleme kodu ekleyin.
3. İsteğe bağlı olarak, web arayüzünün yönetici bölümünde E-ticaret Ayarları'nı yapılandırarak ödeme dönüşüm hunisi raporu için kullanıcı dostu adım adları ayarlayın.

1. Ödeme Adımlarını Ölçme

Google Analytics'e veri göndermek için, ödeme işleminizdeki her adıma karşılık gelen izleme kodunu uygulamanız gerekir.

Step Alan

Ölçtüğünüz her ödeme adımı için bir step değeri eklemeniz gerekir. Bu değer, ödeme işlemlerinizi E-ticaret Ayarları'nda her adım için yapılandırdığınız etiketlerle eşlemek amacıyla kullanılır.

Not: Tek adımlı bir ödeme işleminiz varsa veya E-ticaret Ayarları'nda bir ödeme dönüşüm hunisi yapılandırmadıysanız ödeme adımı alanı isteğe bağlıdır.

Option Alan

Adımın ölçülmesi sırasında belirtilen ödeme adımıyla ilgili ek bilgiye sahipseniz bu bilgileri yakalamak için ödeme işlemi ile ödeme seçeneği alanını ayarlayabilirsiniz. Örneğin, kullanıcı için varsayılan ödeme türü (ör. "Visa").

Bir Ödeme Adımını Ölçme

Bir ödeme adımını ölçmek için ürün değerlerini belirleyin ve ardından ürün işlemi değerlerini ödeme işlemini belirtecek şekilde ayarlayın. Mümkünse ödeme ile birlikte ödeme adımı ve ödeme seçeneği değeri de belirleyebilirsiniz.

Aşağıdaki örnekte, bir ödeme işleminin ilk adımının tek bir ürünle nasıl ölçüleceği ve ödeme türüyle ilgili bazı ek bilgiler gösterilmektedir:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setId:@"P12345"];
[product setName:@"Android Warhol T-Shirt"];
[product setCategory:@"Apparel/T-Shirts"];
[product setBrand:@"Google"];
[product setVariant:@"Black"];
[product setPrice:@29.20];
[product setCouponCode:@"APPARELSALE"];
[product setQuantity:@1];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Checkout"
                                                                        label:nil
                                                                        value:nil];

// Add the step number and additional info about the checkout to the action.
GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPACheckout];
[action setCheckoutStep:@1];
[action setCheckoutOption:@"Visa"];

[builder addProduct:product];
[builder setProductAction:action];
[tracker send:[builder build]];

2. Ödeme Seçeneklerini Ölçme

Ödeme seçenekleri, ödeme işleminin durumuyla ilgili ek bilgileri ölçmenize olanak tanır. Bu özellik, bir ödeme adımını ölçtüğünüz ancak kullanıcı tarafından belirlenen bir seçenek ayarlandıktan sonra aynı ödeme adımıyla ilgili ek bilgilerin alınabildiği durumlarda faydalıdır. Örneğin, kullanıcı bir gönderim yöntemi seçer.

Bir ödeme seçeneğini ölçmek için ürün işlemi değerlerini, ödeme seçeneğini belirtecek ve adım numarası ile seçenek açıklamasını içerecek şekilde ayarlayın.

Not: Herhangi bir ürün veya gösterim değeri ayarlamamalısınız

.

Kullanıcı ödeme işleminin sonraki adımına geçmek için bir işlem yaptıktan sonra bu işlemi ölçmek isteyebilirsiniz. Örneğin:

// (On "Next" button click.)
id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"CheckoutOption"
                                                                        label:nil
                                                                        value:nil];

GAIEcommerceProductAction *action = [[GAIEcommerceProductAction alloc] init];
[action setAction:kGAIPACheckoutOption];
[action setCheckoutStep:@1];
[action setCheckoutOption:@"Fedex"];

[builder setProductAction:action];
[tracker send:[builder build]];
// Advance to next page.

3. Ödeme Dönüşüm Hunisi Yapılandırması

Ödeme sürecinizdeki her adıma, raporlarda kullanılacak açıklayıcı bir ad verilebilir. Bu adları yapılandırmak için Google Analytics Web Arayüzü'nün Yönetici bölümünü ziyaret edin, görünümü (profil) seçin ve E-ticaret Ayarları'nı tıklayın. İzlemek istediğiniz her ödeme adımını etiketlemek için E-ticaret kurulum talimatlarını uygulayın.

Not: Kontrol adımı adlarını yapılandırmazsanız bunlar yalnızca 1., 2., 3. Adım vb. şeklinde görünür.

Şekil 1: E-ticaret Kurulumu - Ödeme Dönüşüm Hunisi

Dahili Tanıtımları Ölçme

Geliştirilmiş e-ticaret, gösterimleri ve dahili tanıtım seçimlerini (ör. bir indirimi tanıtmak için görüntülenen banner'lar) ölçme desteği içerir.

Promosyon Gösterim Sayısı

Dahili tanıtım gösterimleri genellikle ilk ekran görüntüleme veya bir etkinlikle ölçülür. Bunun için promosyon değerlerinin ayarlanması gerekir. Örneğin:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommercePromotion *promotion = [[GAIEcommercePromotion alloc] init];
[promotion setId:@"PROMO_1234"];
[promotion setName:@"Summer Sale"];
[promotion setCreative:@"summer_banner2"];
[promotion setPosition:@"banner_slot1"];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Ecommerce"
                                                                       action:@"Promotion"
                                                                        label:nil
                                                                        value:nil];

[builder addPromotion:promotion];
[tracker send:[builder build]];

Önemli: Tanıtım gösterimi içeren bir işlem ayarlamak kabul edilebilse de işlem, tanıtım işlemi tıklaması olamaz. Bir promosyon tıklama işlemini ölçmek istiyorsanız bu işlem, tanıtım gösteriminden sonra ayrı bir isabette yapılmalıdır.

Promosyon Tıklama Sayısı

Dahili tanıtımlara yapılan tıklamalar, promosyon değerleri kullanılarak ve ardından bir promosyon tıklamasını belirten ürün işlemi değerleri belirleyerek ölçülebilir. Örneğin:

id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"MyTrackingId"];
GAIEcommercePromotion *promotion = [[GAIEcommercePromotion alloc] init];
[promotion setId:@"PROMO_1234"];
[promotion setName:@"Summer Sale"];
[promotion setCreative:@"summer_banner2"];
[promotion setPosition:@"banner_slot1"];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"Internal Promotions"
                                                                       action:@"click"
                                                                        label:@"Summer Sale"
                                                                        value:nil];

[builder set:kGAIPromotionClick forKey:kGAIPromotionAction];
[builder addPromotion:promotion];
[tracker send:[builder build]];

İlgili kaynak

• Analytics Yardımı'nda Geliştirilmiş E-ticaret