Mobile SDK - iOS - Kleep Docs

Repozytorium GitHub: https://github.com/KlipFit/kleep-spm

Instalacja

Proces ten należy wykonać tylko raz, przy pierwszej instalacji SDK w projekcie. W celu zapoznania się z instrukcjami dotyczącymi kolejnych aktualizacji prosimy o zajrzenie do sekcji Aktualizacja.

Dodaj następujący pakiet: https://github.com/KlipFit/kleep-spm
Zmień regułę zależności na: do następnej wersji głównej

Uprawnienia

Dodaj następujące uprawnienie do projektu w pliku info.plist: NSCameraUsageDescription

Użycie

Metoda 1: `requestSize`

Ta metoda umożliwia implementację logiki CTA.

parametr	priorytet	opis
productID	wymagany	Identyfikator Twojego produktu
retailerName	wymagany	Nazwa sprzedawcy
customerID	opcjonalny	Identyfikator CRM, używany do analityki
trackingID	opcjonalny	ID użytkownika używany przez zewnętrzne rozwiązanie śledzące

Schemat logiki Ten schemat wyjaśnia, jak aktualizować CTA otwierające Kleep. https://www.figma.com/board/BlurZ01lR3JBQZeTUU98TE/Mobile---CTA-Logic?node-id=0-1&t=ccXWciNziIdfhgew-1 Przykład implementacji

import Klipfit

struct ContentView: View {
    @State var isOpenView = false
        
    var body: some View {
        VStack {
            Spacer()
            Button("Open Kleep") {
                isOpenView = true
            }
            Spacer(minLength: 40)
            
            Button("obtenir la taille") {
                Klipfit.shared.requestSize(productID: String, retailerName: String, trackingID: String, customerID: String) { kleepResult in
                    switch kleepResult {
                    case .notSupported:
	                    // Hide CTA
                        print("NotSupported")
                    case .noRecommendationYet:
	                    // Display CTA with neutral label
                        print("NoRecommendationYet")
                    case .recommendationFound(let result):
	                    // Display CTA with size reco
                        print("RecommendationFound: ", result)
                    }
                }
            }
	            Spacer()
        }
        .sheet(isPresented: $isOpenView) {
            KlipFitFindSizeView { result, variantID in 
								// addToCart(variantID)
	          }
        }
    }
}

Metoda 2: `loadView`

Ta metoda jest wywoływana po kliknięciu CTA. Umożliwia załadowanie różnych ekranów. Programista integrujący SDK powinien umieścić je w bottom sheet.

parametr	priorytet	opis
productID	wymagany	Identyfikator Twojego produktu
retailerName	wymagany	Nazwa sprzedawcy
customerID	opcjonalny	Identyfikator CRM, używany do analityki
trackingID	opcjonalny	ID używany przez zewnętrznego dostawcę śledzenia

Przykład implementacji

struct KlipFitFindSizeView: UIViewControllerRepresentable {
		
		public var onResult: KleepOnResultCompletion

    func makeUIViewController(context: Context) -> KlipftNavigationController {
        guard let viewController =
        KlipftNavigationController.loadView(
                productID: String,
                retailerName: String,
                language: KleepLanguageCode, // .fr .en .es .it .pt .nl 
                trackingID: "",
                customerID: "",
                stocks: [String : Bool]?,
                onResult: onResult
        )
        else {
            fatalError("ViewController not implemented in storyboard")
        }
        viewController.navigationBar.isHidden = true
        return viewController
    }
    func updateUIViewController(_ uiViewController: KlipftNavigationController, context: Context) {
    }
    typealias UIViewControllerType = KlipftNavigationController
}

Metoda 3: `track`

Ta metoda umożliwia śledzenie niestandardowych zdarzeń.

parametr	priorytet	opis
eventName	wymagany	Nazwa zdarzenia do śledzenia
params	opcjonalny	Informacje powiązane ze zdarzeniem

import Klipfit

Klipfit.shared.track(eventName: String, params: [String: Any]? = nil)

Chcemy śledzić 3 zdarzenia:

eventName	Wyzwalacz
`product_viewed`	Po wyświetleniu strony produktu (PDP)
`product_added_to_cart`	Po dodaniu produktu do koszyka
`checkout_completed`	Po potwierdzeniu zamówienia po płatności

product_viewed Parametry (CSV) Przykład

{
		productId: str
}

product_added_to_cart Parametry (CSV) Przykład

{
    productId: str,
    variantId: str,
    cart: [
	    {
		    productId: "123ABC456",
		    variantId: "123ABC456-00R",
				sku: "XYZ",
		    size: "S",
		    quantity: 2,
		    price: {
						amount: "50",
				    currencyCode: "EUR"		    
		    }
	    },
	    {
		    productId: "123ABC456",
		    variantId: "123ABC456-00R",
		    sku: "XYZ",
		    size: "S",
		    quantity: 1,
		    price: {
				    amount: "40",
				    currencyCode: "USD"
				}
	    }
	    ...
    ],
}

checkout_completed Parametry (CSV) Przykład

{
    orderId: "000001",
    cart: [
	    {
		    lineItemId: "000001#1",
		    productId: "123ABC456",
		    variantId: "123ABC456-00R",
				sku: "XYZ",
		    size: "S",
		    quantity: 2,
		    price: {
						amount: "50",
				    currencyCode: "EUR"		    
		    }
	    },
	    {
			  lineItemId: "000000#2",
		    productId: "123ABC456",
		    variantId: "123ABC456-00R",
		    sku: "XYZ",
		    size: "S",
		    quantity: 1,
		    price: {
				    amount: "40",
				    currencyCode: "USD"
				}
	    }
	    ...
    ],
}

Witamy

CMS

Mobilne

Panel

Dane

Prywatność

Mobile SDK - iOS

Instalacja

Uprawnienia

Użycie

Metoda 1: `requestSize`

Metoda 2: `loadView`

Metoda 3: `track`

​Instalacja

​Uprawnienia

​Użycie

​Metoda 1: requestSize

​Metoda 2: loadView

​Metoda 3: track

Instalacja

Uprawnienia

Użycie

Metoda 1: `requestSize`

Metoda 2: `loadView`

Metoda 3: `track`