Śledzenie Ulepszone e-commerce – pakiet SDK do iOS

Ten dokument zawiera omówienie pomiaru działań i wyświetleń e-commerce w aplikacji za pomocą pakietu SDK Google Analytics na iOS w wersji 3.

Uwaga: możesz teraz zbierać dane e-commerce za pomocą usług Google Analytics 4.

Przegląd

Ulepszony e-commerce umożliwia pomiar interakcji użytkowników z produktami podczas zakupów. Obejmuje to m.in. wyświetlenia produktów, kliknięcia produktów, wyświetlanie szczegółów produktów, dodawanie produktów do koszyka, rozpoczęcie procesu płatności, transakcji i zwrotów środków.

Ważne: Ulepszony e-commerce wymaga użycia bibliotek i pól związanych z Ulepszonym e-commerce, które są dostępne w pakiecie SDK do iOS. Wartości Ulepszonego e-commerce są wysyłane z działaniami takimi jak screenviews i events. Nie wysyłaj działań transaction ani item, które są związane ze standardowym śledzeniem e-commerce.

Wdrażanie

Zanim wdrożysz w swojej aplikacji Ulepszone e-commerce, musisz dodać do niej bibliotekę Ulepszonego e-commerce.

Po skonfigurowaniu aplikacji do korzystania z Ulepszonego e-commerce możesz:

• Mierzenie działań e-commerce
• Pomiar transakcji
• Pomiar zwrotów środków
• Pomiar procesu płatności
• Pomiar promocji wewnętrznych

Pomiar działań e-commerce

Typowa implementacja Ulepszonego e-commerce będzie zliczać wyświetlenia produktów i dowolne z tych działań:

• Wybór usługi.
• Wyświetlam szczegóły produktu.
• Wyświetlenia i wybór promocji wewnętrznych.
• Dodanie produktu do koszyka lub usunięcie go z niego.
• rozpoczynania procesu płatności za produkt,
• Zakupy i zwroty środków.

Pomiar wyświetleń

Aby zmierzyć wyświetlenie produktu, ustaw wartości tych produktów i wyślij je z działaniem:

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]];

Produkt musi mieć nazwę lub wartość identyfikatora. Wszystkie pozostałe wartości są opcjonalne i nie trzeba ich ustawiać.

Działania pomiarowe

Działania są mierzone przez ustawienie wartości produktów, a następnie wartości tych działań, aby określić wykonywane działanie.

Na przykład ten kod mierzy wybór produktu wyświetlanego na liście wyników wyszukiwania:

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]];

Produkt musi mieć nazwę lub wartość identyfikatora. Wszystkie pozostałe wartości są opcjonalne i nie trzeba ich ustawiać.

Łączenie wyświetleń i działań

W przypadku, gdy masz zarówno wyświetlenia produktu, jak i działanie, możesz połączyć je i zmierzyć w jednym działaniu.

Poniższy przykład pokazuje, jak mierzyć widok szczegółów produktu w sekcji produktów powiązanych:

// 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]];

Pomiar transakcji

Mierz transakcję, ustawiając wartości produktów, a następnie ustawiając wartości działań dotyczących produktu, aby określić działanie zakupowe. Szczegóły poziomu transakcji, takie jak łączne przychody, podatek i koszty dostawy, są określane przy użyciu wartości działań dotyczących produktu.

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]];

Określanie waluty

Domyślnie za pomocą interfejsu internetowego zarządzania Google Analytics możesz ustawić wspólną, globalną walutę dla wszystkich transakcji i elementów.

Waluta lokalna musi być określona w standardzie ISO 4217. Pełną listę obsługiwanych walut konwersji znajdziesz w dokumencie Kody walut.

Waluty lokalne określa się, ustawiając wartość kodu waluty w trackerze. Na przykład tracker śledzi wartości walut w euro:

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]];

Aby dowiedzieć się więcej o przeliczaniu walut w Google Analytics, zapoznaj się z sekcją Wiele walut w przewodniku dotyczącym funkcji e-commerce.

Pomiar zwrotów

Aby uzyskać zwrot środków za całą transakcję, ustaw wartości działań związanych z produktami, aby określić identyfikator transakcji i typ zwrotu środków:

// 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]];

W przypadku braku pasującej transakcji zwrot środków nie zostanie przetworzony.

Aby zmierzyć częściowy zwrot środków, ustaw wartości działań produktu, aby określić identyfikator transakcji, identyfikatory produktów i ilości produktów, które zostaną zwrócone:

// 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]];

Zwrot środków za zdarzenia niezwiązane z interakcją

Jeśli chcesz wysyłać dane o zwrocie za pomocą zdarzenia, które nie jest częścią normalnego zachowania użytkownika (czyli nie zostało zainicjowane przez użytkownika), zalecamy wysłanie zdarzenia niewymagającego interakcji. Zdarzenie nie będzie miało wpływu na niektóre dane. Przykład:

// 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]];

Pomiar procesu płatności

Aby mierzyć każdy etap procesu płatności:

1. Dodaj kod śledzenia, aby mierzyć każdy etap procesu płatności.
2. W razie potrzeby dodaj kod śledzenia, aby zmierzyć opcje płatności.
3. Opcjonalnie wybierz w raporcie Ścieżki płatności przydatne nazwy kroków dla użytkowników, konfigurując Ustawienia e-commerce w sekcji Administracja w interfejsie internetowym.

1. Pomiar kroków procesu płatności

Na każdym etapie procesu płatności musisz zaimplementować odpowiedni kod śledzenia, aby wysyłać dane do Google Analytics.

Pole Step

Dla każdego kroku, który mierzysz, musisz podać wartość step. Ta wartość służy do mapowania działań procesu płatności do etykiet skonfigurowanych dla każdego kroku w ustawieniach e-commerce.

Uwaga: jeśli masz jeden etap realizacji transakcji lub nie masz skonfigurowanej ścieżki do płatności w Ustawieniach e-commerce, pole kroku płatności jest opcjonalne.

Pole Option

Jeśli masz jeszcze dodatkowe informacje o danym kroku płatności w chwili pomiaru kroku, możesz ustawić pole opcji płatności z określonym działaniem, aby rejestrować te informacje. Może to być na przykład domyślny typ płatności dla użytkownika (np. 'Visa&#39).

Pomiar etapu płatności

Aby mierzyć etap procesu płatności, ustaw wartości produktów, a następnie ustaw wartości działań dotyczących produktów wskazujące działanie płatności. W razie potrzeby możesz też określić kroki płatności i wartość opcji płatności w momencie płatności.

Poniższy przykład pokazuje, jak zmierzyć pierwszy etap procesu płatności za pomocą jednego produktu i dodatkowe informacje o typie płatności:

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. Pomiar opcji płatności

Opcje płatności umożliwiają pomiar dodatkowych informacji o stanie procesu płatności. Jest to przydatne, gdy mierzysz etap procesu płatności, ale po ustawieniu opcji wyboru przez użytkownika dostępne są dodatkowe informacje o tym samym kroku. Na przykład użytkownik wybiera metodę dostawy.

Aby zmierzyć opcję płatności, ustaw wartości działań dotyczących produktu, aby wskazać opcję płatności, uwzględnić numer kroku i opis opcji.

Uwaga: nie należy ustawiać żadnych wartości produktów ani wyświetleń.

Takie działanie najprawdopodobniej wykonasz, gdy użytkownik wykona określone działanie, aby przejść do kolejnego kroku procesu płatności. Przykład:

// (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. Konfiguracja ścieżki płatności

Każdy krok w procesie płatności może mieć nazwę opisową, która będzie używana w raportach. Aby je skonfigurować, przejdź do sekcji Administracja w interfejsie internetowym Google Analytics, wybierz widok (profil) i kliknij Ustawienia e-commerce. Postępuj zgodnie z instrukcjami konfiguracji e-commerce, aby oznaczyć etykietą każdy etap procesu płatności, który chcesz śledzić.

Uwaga: jeśli nie skonfigurujesz nazw kroków kontroli, pojawią się one tylko jako kroki 1, 2, 3 itp.

Rysunek 1: Konfiguracja e-commerce – Ścieżka płatności

Pomiar promocji wewnętrznych

Ulepszony e-commerce obejmuje obsługę pomiaru wyświetleń i wybierania promocji wewnętrznych, takich jak banery wyświetlane w celu sprzedaży.

Wyświetlenia promocji

Do pomiaru wyświetleń promocji wewnętrznej służą pierwsze wyświetlenie ekranu lub zdarzenie. W tym celu należy ustawić wartości promocji. Przykład:

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]];

Ważne: dozwolone jest ustawienie działania powodującego wyświetlenie promocji, ale nie może ono być kliknięciem kliknięcia. Jeśli chcesz mierzyć działania związane z kliknięciami promocji, należy je wykonać w osobnym działaniu, po wyświetleniu promocji.

Kliknięcia promocji

Kliknięcia promocji wewnętrznych można mierzyć za pomocą wartości promocji, a następnie ustawiając wartości działań produktu, które wskazują kliknięcie promocji. Przykład:

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]];

Powiązany artykuł

• Ulepszony e-commerce w Centrum pomocy Analytics