INTEGRATIONsanleitung
Möchtest du ein
Web-SDK einbinden?
Möchtest du ein
iOS-SDK einbinden?
Möchtest du ein
Android-SDK einbinden?
Beispieleinbindung im checkout
Verfügbar für alle Endgeräte
iOS Android HTML5
Die Danke-Banner können passend in eurem CI oder auch im Premium Shopping Layout eingebunden werden. Diese stellen wir dir gern zur Verfügung.
einbindung des WEB-SDK
Um unser Web-SDK aufzurufen, sind die folgenden Schritte erforderlich:
ANleitung
-
Hinterlege die URL deiner Webseite, auf die du NetScaleNow einbinden möchtest, als Referrer in my.NetScaleNow
-
Lege die Dankes-Grafik auf dem Server ab und gebe den Pfad im Skript an.
-
Unser externes Skripts muss dann zunächst geladen werden.
-
Anschließend erfolgen die Initialisierung und
der Aufruf der Gutscheinübersicht. Die user id
(im Beispiel 00) findest du in my.NetScaleNow
Optional können hier die Metadaten (email, zipCode, gender, firstName, lastName, birthday) des Kunden übergeben werden.
-
Mobile Integration:
Zur Optimierung der Darstellung auf mobilen Geräten, wird diese zusätzliche Zeile im head-Bereich benötigt.
QUELLCODE
<a href="#" onclick="show_vouchers()"><img
src=""
alt="" width="XX" height="YY" /></a>
<script src="//my.netscalenow.de/sdk/app.js"></script>
<script>
function show_vouchers()
{NetScaleNow.initialize({
user: 00,
email: '',
zipCode: '12345',
gender: 'male',
firstName: 'Vorname',
lastName: 'Nachname',
birthday: '1990-01-01'
});}
</script>
MOBILE INTEGRATION:
<meta name="viewport" content="width=device-width,
initial-scale=1, maximum-scale=1">
Du hast Fragen? Schreib mir gerne eine Mail an christian.hain@netscalenow.com oder ruf mich an 030/577 023 441.
einbindung des ios-SDK
Um unser iOS-SDK in deine App einzubinden, sind folgende Schritte zu erledigen.
-
Lade dir unser iOS-SDK aus GitHub herunter
-
NetScaleNow ist über CocoaPods verfügbar, um es zu installieren, füge die 1.Zeile aus dem Quellcode in dein Podfile.
-
Das Setzen des SDK-Key und SDK-Token kann beispielsweise in der AppDelegate erfolgen.
Deine Daten findest du in my.NetScaleNow
Die Konfiguration erfolgt über das Config struct. Hier muss der SDK-Key und das SDK-Token
gesetzt werden.
-
Anzeige der Gutscheinübersicht und Übergabe von optionalen Metadaten des Käufers
(email, gender, firstName, lastName, zipCode, birthday)
ANleitung
pod "NetScaleNow"
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
Config.apiKey = "ios-sdk-123456789"
Config.apiSecret = "123456789"
return true
}
let metadata = Metadata(email: "")
metadata.gender = .male // .female
metadata.firstName = "Vorname"
metadata.lastName = "Nachname"
metadata.zipCode = "12345"
metadata.birthday = Date(1990-01-01)
CampaignManager.showCampaigns(metadata: metadata)
QUELLCODE
Du hast Fragen? Schreib mir gerne eine Mail an christian.hain@netscalenow.com oder ruf mich an 030/577 023 441.
einbindung des android-SDK
Nachfolgend findest du eine einfache Anleitung zur Android-SDK-Einbindung.
-
Lade dir unser Android-SDK aus GitHub herunter.
-
Füge die Library über build.gradle hinzu.
-
Erzeuge einen Intent, welcher den Klassennamen VoucherActivity enthält, dann kann die Library mit dem Befehl startIntent gestartet werden.
-
Die Konfiguration erfolgt über die Konstantenklasse Config, welche die konfigurierbaren Parameter enthält. Um Zugriff auf diese zu haben, muss die Klasse importiert werden.
-
Übergabe von API-KEY und API-SECRET als Extras in dem zuvor erzeugten Intent.
-
Optional können die Metadaten des Käufers (EMAIL, ZIP_CODE, FIRST_NAME, LAST_NAME, GENDER, BIRTHDAY) übergeben werden.
ANleitung
QUELLCODE
compile 'com.netscalenow.android:1.0.1'
Intent intent = new Intent(this, VoucherActivity.class);
startActivity(intent);
import static de.cmc.android.config.Config.*;
import static de.cmc.android.config.Config.*;
intent.putExtra(API_KEY, "android-sdk-123456789");
intent.putExtra(API_SECRET, "123456789");
intent.putExtra(EMAIL, "");
intent.putExtra(ZIP_CODE, "12345");
intent.putExtra(FIRST_NAME, "Vorname");
intent.putExtra(LAST_NAME, "Nachname");
intent.putExtra(GENDER, Metadata.Gender.Male);
intent.putExtra(BIRTHDAY, "01.01.1990");
Du hast Fragen? Schreib mir gerne eine Mail an christian.hain@netscalenow.com oder ruf mich an 030/577 023 441.
einbindung Des Tracking-pixel
Das Tracking-Pixel meldet uns, wenn ein Gutschein in deinem Shop eingelöst wurde.
Am einfachsten lässt sich dieses über einen Google-Tag-Manager einbinden.
-
Füge das img-Tag auf deiner Bestellabschlussseite/ Confirmation-Page beispielsweise mit Hilfe des Google-Tag-Managers hinzu.
-
Hinterlege deine advertiser id
(user id aus my.NetScaleNow).
-
Verknüpfe den Gutscheincode mit dem Parameter voucher_code, der in der Bestellung verwendet
wurde (nicht der Gutscheinname).
-
Verknüpfe die Nummer der Bestellung mit dem Parameter order_id.
ANleitung
QUELLCODE
<img src='https://my.netscalenow.de/api/redeem?
advertiser_id=00&voucher_code=ABCDE&order_id=
12345'alt='Tracking-Pixel für CMC' />
Alternativ kann die Einlösung des Gutscheins auch
aus dem Backend/ERP über die JSON-Applikation
gemeldet werden.
Du hast Fragen? Schreib mir gerne eine Mail an christian.hain@netscalenow.com oder ruf mich an 030/577 023 441.
Dein Ansprechpartner
Du hast Fragen zur Integration? Gerne berate ich dich persönlich.
Wir freuen uns auch über Feedback, Anregungen und Verbesserungsvorschläge.
