Margly
Anbindungen

Verbindung Sklik

Tschechisches PPC von Seznam.cz — Verbindung mit Margly über einen API-Token aus den Sklik-Einstellungen.

7 Min. Lesezeit

Für wen Sklik ist#

Sklik ist die PPC-Plattform von Seznam.cz. Sie deckt Seznam.cz und das Sklik-Partnernetzwerk ab. Traditionelle Wahl für tschechische und slowakische E-Shops.

Zwei unabhängige Verbindungen#

In Margly können Sie zwei separate Teile von Sklik verbinden:

  1. Sklik (API Drak) — klassisches Werbekonto (Search, Display-Netzwerk, Retargeting). Verbindung über ein in den Sklik-Konto-Einstellungen generiertes Sklik-API-Token.
  2. Sklik Nákupy (Fénix API) — Shopping-Kampagnen auf Seznam Zboží. Verbindung über einen separaten Fénix-API-Schlüssel + ID der Betriebsstätte. Fénix API befindet sich in der Beta-Phase — detaillierte Produktstatistiken werden nach Abschluss der Beta vollständig verfügbar sein.

Beide Verbindungen sind unabhängig, Sie können nur eine von ihnen oder beide aktiviert haben.

Verbindung des klassischen Sklik-Kontos (API Drak)#

Sklik verwendet kein OAuth. Stattdessen generieren Sie in der Sklik-Administration ein API-Token für die Drak API (offizieller Name der Sklik API-Schnittstelle) und fügen es in Margly ein.

  1. Melden Sie sich auf sklik.cz an

    Auf www.sklik.cz melden Sie sich mit E-Mail und Passwort direkt als Benutzer an, der Zugriff auf Ihr Werbekonto hat. Achtung: „Verkörperung" in ein anderes Konto (typisch für Agenturen, die mehrere Kunden verwalten) funktioniert nicht — Margly kann aus technischen Gründen nicht mit Agentur-Tokens arbeiten und gibt einen Fehler zurück. Melden Sie sich deshalb direkt als Benutzer unter dem jeweiligen Konto an.

  2. Generieren Sie ein API-Token

    Nach der Anmeldung klicken Sie in Sklik auf Ihren Namen rechts oben → Nastavení → API přístup. Sie sehen zwei Bereiche — für diese Verbindung interessiert Sie der obere Přístup k API Drak. Generieren Sie dort ein neues API-Token und kopieren Sie es sofort.

    Sklik-Einstellungen API přístup mit zwei Bereichen: Přístup k API Drak (für klassisches Sklik) und Správa API Fénix klíčů (BETA, für Sklik Nákupy)
    Bereich API přístup in Sklik — für die klassische Verbindung wählen Sie Přístup k API Drak (oberer). Der untere Bereich Správa API Fénix klíčů dient für die separate Verbindung Sklik Nákupy (Fénix API).

    Achtung: Sklik zeigt das Token nur einmal an. Wenn Sie es verlieren, generieren Sie an derselben Stelle ein neues.

  3. Fügen Sie das Token in Margly ein

    Öffnen Sie in Margly Verbindungen → Sklik und fügen Sie das Token in das Feld API token ein. Klicken Sie auf Sklik verbinden. Margly testet das Token sofort über die Sklik-API und lädt Informationen zum Werbekonto.

  4. Margly lädt historische Daten herunter

    Nach erfolgreicher Verifizierung lädt Margly die letzten 365 Tage (1 Jahr) an historischen Tagesstatistiken und Kampagnendaten herunter. Bei normalen Konten dauert es größenordnungsmäßig Minuten.

Verbindung Sklik Nákupy (Fénix API)#

Wenn Sie Shopping-Kampagnen auf Seznam Zboží laufen lassen, können Sie auch Fénix API für detailliertere Daten zu Produkten und Kategorien verbinden.

  1. Generieren Sie einen Fénix-API-Schlüssel in Sklik

    Finden Sie in den Sklik-Einstellungen den Bereich Správa API Fénix klíčů und klicken Sie auf Vygenerovat nový API klíč. Kopieren Sie den Schlüssel.

  2. Finden Sie die ID der Betriebsstätte

    Fénix API benötigt eine ID der Betriebsstätte — eine sechsstellige Nummer, die Ihrer Betriebsstätte mit aktivem Kampagnentyp Kampaň Nákupy zugeordnet ist. Sie finden sie auf zwei Wegen:

    • In der Sklik-Administration in der Übersicht der Betriebsstätten (Sklik zeigt sie direkt bei jeder Betriebsstätte an)
    • In der Administration von zbozi.cz

    Fénix API kann die Liste der Betriebsstätten nicht aufzählen, sodass Sie die ID manuell eingeben müssen.

  3. Fügen Sie beides in Margly ein

    In Margly füllen Sie in Verbindungen → Sklik den Bereich Seznam Nákupy (Fénix API) aus — fügen Sie den Fénix-Schlüssel und die ID der Betriebsstätte ein und klicken Sie auf Verbinden. Margly überprüft die Kombination Schlüssel × ID der Betriebsstätte gegen die Sklik Fénix API.

Was Margly aus Sklik tatsächlich lädt#

Aus dem klassischen Sklik-Konto (API Drak)#

Margly speichert drei Arten von Daten:

  1. Zusammenfassende Tagesstatistiken (für das gesamte Werbekonto, Tagesgranularität, Fenster der gesamten Sync-Reichweite):

    • Anzahl der Ansichten (Impressionen), Anzahl der Klicks, Ausgaben, Anzahl der Konversionen und deren Wert
    • CTR (Klickrate), durchschnittlicher CPC (Preis pro Klick)
    • Berechneter ROAS (Werberentabilität)

  2. Snapshot der Kampagnen für die letzten 30 Tage (eine Zeile pro Kampagne):

    • ID der Kampagne, Name, Status (aktiv / pausiert)
    • Tagesbudget
    • Zusammenfassung für 30 Tage: Impressionen, Klicks, Ausgaben, Anzahl der Konversionen
    • (Dieser Snapshot enthält nicht den Konversionswert — für Details siehe folgenden Punkt.)

  3. Per-Kampagne-Tagesstatistiken (jede Kampagne × jeder Tag, Fenster der gesamten Sync-Reichweite):

    • Impressionen, Klicks, Ausgaben, Anzahl der Konversionen und deren Wert
    • Ermöglichen im Dashboard, die Leistung der Kampagne nach Tagen zu filtern

Plus aktueller Kreditstand des Sklik-Kontos.

Margly lädt kein Detail von Keywords noch die Ebene von Anzeigengruppen (ad group) — die Sicht ist auf Kampagnenebene, nicht auf Anzeigengruppenebene.

Aus Sklik Nákupy (Fénix)#

Margly speichert:

  1. Liste der Nákupy-Kampagnen (Snapshot, eine Zeile pro Kampagne):

    • ID der Kampagne, Status, ID der Betriebsstätte, Typ der Gebotssteuerung (zbozi / feed / sklik), Tagesbudget, verbrauchter Budgetanteil des Tages
    • (Fénix-Kampagnen haben in der Sklik-API keinen eigenen Namen — Margly zeigt deshalb „Kampaň #ID" an.)

  2. Per-Produkt-Statistiken für die letzten 30 Tage (jedes Produkt × jeder Tag):

    • ID und Name des Produkts, Kategorie
    • Aufschlüsselung nach Gerätetyp (Mobile / Desktop / Tablet) und Web-Typ (Hauptsuche / Partnernetzwerk)
    • Impressionen, Klicks, Ausgaben, Konversionen, Konversionswert
    • Anzahl verkaufter Stück (items sold)
    • Durchschnittlicher CPC, CTR und PNO (Kostenanteil am Umsatz) pro Produkt

  3. Per-Kategorie-Statistiken für die letzten 30 Tage — zusammenfassende gleiche Metriken wie bei Produkten, nur nach Kategorien aggregiert.

  4. Kreditstand der Fénix-Brieftasche.

MwSt. und Währung#

Sklik (Seznam.cz, MwSt.-Zahler) kann Werbung auch slowakischen Firmen in Rechnung stellen — die Rechnungsstellung sieht jedoch je nach Land und Status der MwSt.-Zahlung unterschiedlich aus:

Ihr Land und StatusWie Sklik in Rechnung stellt
CZ MwSt.-ZahlerMit tschechischer MwSt. 21 % (Standard-Inlandsrechnung, kein Reverse Charge)
CZ Nicht-MwSt.-ZahlerMit tschechischer MwSt. 21 %
SK MwSt.-ZahlerOhne MwSt. im Reverse-Charge-Verfahren — MwSt. veranlagen Sie sich selbst nach dem SK-Satz von 23 %
SK Nicht-MwSt.-ZahlerOSS/MOSS-Regeln, typischerweise mit tschechischer MwSt.

Was Margly damit macht:

  • Speichert die Ausgaben ohne MwSt. so, wie sie die Sklik Drak API zurückgibt
  • Berechnet gleichzeitig die Variante inkl. MwSt. nach dem Satz Ihres Geschäftslandes (CZ ×1,21, SK ×1,23). Bei CZ-Mandanten entspricht dieser Wert der realen Rechnung. Bei SK MwSt.-Zahlern dient er als Grundlage für die Selbstveranlagung — die Rechnung von Sklik ist bei ihnen ohne MwSt., aber buchhalterisch berechnen Sie die MwSt. nach dem slowakischen Satz.
  • Zeigt im Dashboard entweder inkl. MwSt. oder exkl. MwSt., je nach Ihrer Wahl in Abrechnung → Preise inkl. MwSt. anzeigen

Währung: Sklik gibt die Ausgaben ausschließlich in CZK zurück. Margly unterstützt Sklik deshalb nicht für E-Shops in einer anderen Währung als CZK — Margly lehnt die Sklik-Verbindung ab (siehe Callout oben). Eine slowakische Firma mit einem tschechischen E-Shop in CZK kann Sklik aber verbinden, die Rechnungsstellung erfolgt dann im Reverse-Charge-Verfahren nach den oben genannten Regeln.

Häufige Fehler#

  • „Dieses Token funktioniert nicht" — das Token wurde in den Sklik-Einstellungen gelöscht oder Sie haben es falsch kopiert (z. B. mit einem Leerzeichen). Generieren Sie in Sklik ein neues.
  • „Sie haben ein Agentur-Token eingegeben" — Sie haben das Token eines Agenturkontos eingefügt, das mehrere Werbekonten verwaltet. Margly kann ein solches Token nicht auf ein bestimmtes Konto aufteilen — melden Sie sich direkt als Benutzer des Werbekontos an und generieren Sie das Token dort.
  • „Dieses Sklik-API-Token wird bereits von einem anderen Konto in Margly verwendet" — dasselbe Token kann nicht zwei Margly-Konten zugeordnet werden. Trennen Sie es zuerst beim alten (Verbindungen → Sklik → Trennen).
  • „Sklik gibt keine Daten zurück" — die Sklik-Verbindung wurde hergestellt, aber das Konto hat leere Daten zurückgegeben. Am häufigsten, weil auf dem Konto real keine Kampagnen laufen oder das Token einem Konto ohne aktive Werbung gehört. Prüfen Sie direkt in Sklik, dass Kampagnen existieren und laufen.
  • Fénix „Die angegebene Shop-ID gehört nicht zu diesem Fénix-Token" — die Kombination aus Fénix-Token und ID der Betriebsstätte stimmt nicht. Das Token gehört einem anderen Benutzer oder die ID der Betriebsstätte ist von einem anderen Shop — überprüfen Sie die ID in der Übersicht der Betriebsstätten in der Sklik-Administration oder in der Administration von zbozi.cz.

Wie geht's weiter#

  • Verbindung Heureka — weiterer tschechischer Preisvergleicher, ebenfalls über API-Schlüssel
  • KI-Berater — vergleicht die Rentabilität von Sklik mit Google Ads und Meta in der Werbeanalyse

War das hilfreich?

Verwandte Artikel