Mobil SDK - iOS - Kleep Docs

Github Repository: https://github.com/KlipFit/kleep-spm

Installation

Denne proces skal kun følges én gang, første gang du skal installere SDK’et i dit projekt. Se afsnittet Opdatering for instruktioner til efterfølgende opdateringer.

Tilføj følgende pakke: https://github.com/KlipFit/kleep-spm
Ændr afhængighedsreglen til: op til næste major-version

Tilladelser

Tilføj følgende tilladelse til dit projekt i info.plist: NSCameraUsageDescription

Brug

Metode 1: `requestSize`

Denne metode giver mulighed for at implementere logikken bag CTA’en.

parameter	prioritet	beskrivelse
productID	påkrævet	Dit produkt-ID
retailerName	påkrævet	Navn på forhandleren
customerID	valgfri	CRM-identifikator, brugt til analyse
trackingID	valgfri	Bruger-ID brugt af ekstern sporingslø sning

Logikskema Dette skema forklarer, hvordan du opdaterer CTA’en, der åbner Kleep. https://www.figma.com/board/BlurZ01lR3JBQZeTUU98TE/Mobile---CTA-Logic?node-id=0-1&t=ccXWciNziIdfhgew-1 Implementeringseksempel

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)
	          }
        }
    }
}

Metode 2: `loadView`

Denne metode kaldes, når CTA’en klikkes. Den giver mulighed for at indlæse de forskellige skærme. Udvikleren, der integrerer SDK’et, bør indlejre dem i et bundark.

parameter	prioritet	beskrivelse
productID	påkrævet	Dit produkt-ID
retailerName	påkrævet	Navn på forhandleren
customerID	valgfri	CRM-identifikator, brugt til analyse
trackingID	valgfri	ID brugt af ekstern sporingsudbyder

Implementeringseksempel

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
}

Metode 3: `track`

Denne metode giver mulighed for at spore brugerdefinerede hændelser.

parameter	prioritet	beskrivelse
eventName	påkrævet	Navn på den hændelse der skal spores
params	valgfri	Information tilknyttet hændelsen

import Klipfit

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

Vi ønsker at spore 3 hændelser:

eventName	Trigger
`product_viewed`	Når PDP vises
`product_added_to_cart`	Når produkt lægges i kurven
`checkout_completed`	Når ordre bekræftes efter betaling

product_viewed Parametre (CSV) Eksempel

{
		productId: str
}

product_added_to_cart Parametre (CSV) Eksempel

{
    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 Parametre (CSV) Eksempel

{
    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"
				}
	    }
	    ...
    ],
}

Velkommen

CMS

Mobil

Dashboard

Data

Privatliv

Mobil SDK - iOS

Installation

Tilladelser

Brug

Metode 1: `requestSize`

Metode 2: `loadView`

Metode 3: `track`

​Installation

​Tilladelser

​Brug

​Metode 1: requestSize

​Metode 2: loadView

​Metode 3: track

Installation

Tilladelser

Brug

Metode 1: `requestSize`

Metode 2: `loadView`

Metode 3: `track`