Installation og initialisering

For at installere Finteza SDK, brug CocoaPods eller Carthage pakkehåndtering eller download filarkivet fra GitHub manuelt.

Installation via CocoaPods #

For at forbinde Finteza SDK skal du tilføje følgende streng til Podfile af dit projekt:

pod 'FintezaSDK'

Herefter, eksekver installationskommandoen:

pod install

Når du arbejder med CocoaPods, skal du altid bruge .xcworkspace filen i stedet for .xcodeproj.

Installation via Carthage #

For at forbinde Finteza SDK skal du tilføje følgende streng til Cartfile af dit projekt:

github "finteza/mobile-sdk-ios"

Manuel installation #

Download og unzip FintezaSDK-X.X.X.framework.zip filen. Herefter, overfør FintezaSDK.framework til dit projekt i Xcode.

Aktiver indstillingen "Copy items if needed" under installation.

Initialisering af SDK i applikationen #

Åbn filen for din applikationsdelegat og importer Finteza SDK:

Objective-C:

#import <FintezaSDK/FintezaSDK.h>

Swift:

import FintezaSDK

Initialisering af SDK i didFinishLaunchingWithOptions metode ved hjælp af websted-ID og adresse:

Objective-C:

[Finteza initialize:@"{WEBSITE_ID}" site:@"{WEBSITE_URL}" product:@"{PRODUCT}"];

Swift:

Finteza.initialize("{WEBSITE_ID}", site: "{WEBSITE_URL}", product: "{PRODUCT}")

Indstil websted-ID som {WEBSITE_ID}. Det kan fås i webstedsindstillingerne (ID-felt) i Finteza panel. Herefter, indstil parametrene:

Parameter

Type

Beskrivelse

site

string

Websted domænenavn, for eksempel, "my.site.com".

product

string

Produktnavn, der skal bruges som præfiks til mærkning af begivenheder, der sendes til Finteza fra din applikation.

Du har muligvis brug for det for at adskille begivenheder på tværs af forskellige platforme, hvis du har apps til pc, iOS, Android osv. For eksempel, hvis du angiver "iOS App"-produktet og sender "Registrering" begivenheden, vil det endelige begivenhedsnavn i Finteza være "iOS App Registration".

Indstil 'nil' for at undgå at bruge præfikset.

Du kan ændre produktnavnet senere ved at bruge setProduct function:

Objective-C:

[Finteza setProduct:@"{PRODUCT}"];

Swift:

Finteza.setProduct("{PRODUCT}")

Applikationen starter begivenheder #

Føj den følgende kode til applicationDidBecomeActive:

Objective-C:

[Finteza activate];

Swift:

Finteza.activate()

Når der ringes aktiver, SDK sender "Install Finish" begivenheden til Finteza under den første opstart af applikationen (hvis produkt præfiks er indstillet, herefter "{PRODUCT} Install Finish").

Også, når der ringes aktiver, en ny arbejdssession og "Session Start" begivenheden er registreret (hvis produkt præfiks er indstillet, så "{PRODUCT} Session Start").

Den nye session begynder kun, hvis der er gået mere end tre minutter siden forrige gang applikationen blev inaktiv.

Fejlfinding i meddelelser #

For at teste at arbejde med SDK, kan du aktivere output af fejlfindingsdata til udviklerens konsol. Data på begivenheder og annoncer vises separat.

Begivenheder

Objective-C:

[Finteza addLogging:FintezaLogModeEvents];

Swift:

Finteza.addLogging(FintezaLogModeEvents)

Annoncer

Objective-C:

[Finteza addLogging:FintezaLogModeBanner];

Swift:

Finteza.addLogging(FintezaLogModeBanner)

Eksempel

Følgende fejlfindingsmeddelelse angiver en fejl ved afsendelse af begivenheder på grund af fraværet af aktiver metode ringning:

[event] kan ikke sende begivenheden 'Book Load': ring 'activate' metoden først