Je platforms synchroniseren

Eén pagina voor al je platforms

Platforms in de zijbalk is waar je alles koppelt waarop je verkoopt en adverteert. Eén kaart per platform: het logo, of het werkt, en de ene knop die op dat moment telt.

Zoek op naam of filter op status. Alleen filters die echt iets zouden tonen worden aangeboden, dus een leeg filter kost je nooit een klik.

Wat elke status betekent

De band bovenaan de kaart is het hele antwoord.

Niet bijgewerkt is niet altijd een storing. Draft2Digital vernieuwt alleen zolang een browser open staat. Je advertentieplatforms vernieuwen wanneer je TrueRoyalties opent en uiterlijk één keer per dag vanzelf. KDP, Kobo, ThriveCart, Fourthwall, Squarespace, WooCommerce, Shopify en Apple Books vernieuwen sowieso op hun eigen serverschema. Na een dag weggeweest oranje zien betekent meestal gewoon dat je cijfers een dag oud zijn, en de volgende synchronisatie lost het op.

Wat je vandaag kunt koppelen

Meta en TikTok hebben hun eigen pagina in de app, waar je bepaalt welke advertentieaccounts meetellen en bij welk boek elke advertentie hoort. De kaart stuurt je daarheen in plaats van die knoppen te herhalen.

ThriveCart

Open in ThriveCart Settings, dan API & webhooks, dan API tokens, en maak een token aan. Plak het in het venster dat opent als je op Koppelen klikt. We controleren het bij ThriveCart voordat we het opslaan, en importeren daarna je hele verkoopgeschiedenis — een paar minuten bij een groot account.

Elk product, elke bump, upsell en downsell die je verkoopt wordt een titel onder Boeken. Zo worden de cijfers geteld:

• De bedragen zijn wat ThriveCart registreert, vóór de kosten van je betaalprovider en eventuele affiliatecommissies. Ze liggen dus hoger dan wat op je bankrekening binnenkomt.
• Een betaling in termijnen of een abonnement telt als één verkoop. Elke volgende termijn brengt geld op, geen extra exemplaar.
• Een terugbetaling wordt afgetrokken op de dag dat die plaatsvindt. Een volledige terugbetaling haalt ook de verkoop weg.
• Testaankopen worden nooit geïmporteerd.

ThriveCart zegt niet waar een koper woont, dus deze verkopen zijn aan geen land gekoppeld.

Fourthwall

Open in Fourthwall Settings, dan For developers, dan Open API, en klik op Create API user. Kopieer de gebruikersnaam en het wachtwoord die verschijnen — alleen een superbeheerder van de shop kan ze aanmaken — en plak beide in het venster dat opent als je op Koppelen klikt. We controleren ze bij Fourthwall voordat we ze opslaan, en importeren daarna je hele bestelgeschiedenis.

Elk product dat je verkoopt wordt een titel onder Boeken — digitale producten als e-book, de rest als gedrukt boek. Zo worden de cijfers geteld:

• De bedragen zijn je winst per product: wat de koper betaalde, min een eventuele korting en de productiekosten die Fourthwall je rekent. Verzending en belasting tellen niet mee.
• Een product dat Fourthwall zonder productiekosten doorgeeft, telt voor de volle prijs, en de Fourthwall-pagina in de app meldt dat.
• Een geannuleerde bestelling wordt verwijderd, en voltooide donaties komen erbij.
• Betaalkosten, gedeeltelijke terugbetalingen en lidmaatschapsbetalingen zijn niet inbegrepen — de API van Fourthwall levert ze niet.
• Verkopen van cadeaukaarten en je eigen bestellingen van proefexemplaren tellen nooit. Een cadeaukaart telt wanneer een koper die besteedt.

Verkopen krijgen de datum van de dag van bestelling (UTC) en zijn aan geen land gekoppeld.

Squarespace

Open in Squarespace Instellingen, dan Ontwikkelaarstools, dan API-sleutels voor ontwikkelaars. Maak een sleutel met Bestellingen en Transacties op alleen lezen, kopieer hem meteen — hij wordt maar één keer getoond — en plak hem in het venster dat opent als je op Koppelen klikt. We controleren bij Squarespace of de sleutel je bestellingen kan lezen voordat we hem opslaan, en importeren daarna je hele bestelgeschiedenis. Volgens de documentatie van Squarespace zijn API-sleutels er voor sites met het Commerce Advanced-abonnement.

Elk product dat je verkoopt wordt een titel onder Boeken — fysieke producten als gedrukt boek, de rest als e-book. Zo worden de cijfers geteld:

• De bedragen zijn wat kopers voor je producten betaalden, na kortingen, zonder belasting en verzending. Kosten voor betalingsverwerking worden niet afgetrokken.
• Btw die in een prijs zit, wordt eruit gehaald, op basis van de belasting die Squarespace bij de bestelling registreerde.
• Een terugbetaling neemt haar deel van de bestelling terug. Een volledige terugbetaling haalt de verkoop weg; een gedeeltelijke laat hem staan.
• Alleen betaalde bestellingen tellen. Onbetaalde, geannuleerde en testbestellingen blijven buiten beschouwing, en een betaling in termijnen telt zodra die volledig betaald is.
• Donaties tellen mee als de sleutel transacties kan lezen; anders meldt de Squarespace-pagina in de app dat ze ontbreken.
• Verkopen van cadeaukaarten en bestellingen die uit andere verkoopkanalen zijn geïmporteerd, tellen nooit. Een cadeaukaart telt wanneer een koper die besteedt.

Verkopen krijgen de datum van de dag van bestelling (UTC) en zijn aan geen land gekoppeld.

WooCommerce

Meld je als beheerder aan bij WordPress, klik dan op Koppelen en vul het adres van je winkel in. We sturen je naar je eigen winkel om alleen-lezen-toegang goed te keuren — niets met de hand aan te maken, geen sleutel te kopiëren. Zodra je winkel de toegang bevestigt, importeren we je hele bestelgeschiedenis.

Elk product dat je verkoopt wordt een titel onder Boeken — downloadbare en virtuele producten als e-book, de rest als gedrukt boek. Zo worden de cijfers geteld:

• De bedragen zijn wat kopers voor je producten betaalden, na kortingsbonnen, zonder belasting en verzending. Kosten voor betalingsverwerking worden niet afgetrokken.
• Een terugbetaling gaat af van de regel die ze terugbetaalt. Betaal je één van twee boeken terug, dan gaan één exemplaar en zijn prijs af van dat boek. Een terugbetaling van een bedrag zonder genoemde producten wordt over de producten van de bestelling verdeeld.
• Alleen betaalde bestellingen tellen. Openstaande, in de wacht gezette (een overschrijving die nog niet binnen is), geannuleerde en mislukte bestellingen blijven buiten beschouwing, en een bestelling die je naar de prullenbak verplaatst verdwijnt bij de volgende synchronisatie uit je cijfers.
• Verkopen van cadeaukaarten tellen nooit. Een cadeaukaart telt wanneer een koper die besteedt.

Verkopen krijgen de datum van de dag van bestelling (UTC) en zijn aan geen land gekoppeld. Je winkel moet de „mooie” permalinks van WordPress aan hebben staan.

Shopify

Shopify wordt gelezen via een kleine app die je eenmalig voor je eigen winkel maakt:

1. Maak in het Dev Dashboard van Shopify een app.
2. Geef de versie ervan de toegang read_orders en read_products, publiceer hem en installeer de app daarna in je winkel.
3. Kopieer in de instellingen van de app de Client-ID en het Client-secret.

Klik op Koppelen, vul het adres van je winkel in — het adres dat eindigt op .myshopify.com, ook als je winkel een eigen domein gebruikt — en plak de twee waarden. We controleren bij Shopify dat de app je bestellingen en producten kan lezen voordat we iets opslaan, en importeren daarna je bestelgeschiedenis.

Shopify laat een app alleen de bestellingen van de laatste 60 dagen zien, tenzij hij ook de toegang read_all_orders heeft, die Shopify op aanvraag geeft. Zonder die toegang meldt de Shopify-pagina in de app dat; zodra hij is gegeven, worden je oudere verkopen automatisch geïmporteerd.

Elk product dat je verkoopt wordt een titel onder Boeken — producten die verzonden worden als gedrukte boeken, de rest als e-books. Zo worden de cijfers geteld:

• De bedragen zijn wat kopers voor je producten betaalden, na alle kortingen, zonder belasting en verzending — ook als je prijzen inclusief btw zijn. Kosten voor betalingsverwerking worden niet afgetrokken.
• Een terugbetaling haalt weg wat ze terugbetaalt. Betaal je één van twee boeken terug, dan gaan één exemplaar en de prijs ervan van dat boek af. Een terugbetaling die als bedrag is ingevoerd, zonder gekozen product, gaat naar verhouding van de producten van de bestelling af.
• Alleen betaalde bestellingen tellen. Openstaande (een handmatige betaling die nog niet binnen is), geannuleerde, test- en volledig terugbetaalde bestellingen blijven buiten beschouwing.
• Een e-book en een paperback zijn twee boeken, ook als je ze als twee varianten van één product verkoopt.
• Verkopen van cadeaubonnen tellen nooit. Een cadeaubon telt wanneer een koper hem besteedt.

Verkopen worden gedateerd op de dag waarop Shopify de bestelling verwerkte (UTC), in de valuta van je winkel, en zijn aan geen enkel land gekoppeld.

Apple Books

Open in iTunes Connect de rapportenpagina onder Sales and Trends, maak een Reporter-toegangstoken aan en plak het in het venster dat opengaat als je op Koppelen klikt. We vragen Apple of het token je uitgeversaccount opent voordat we iets opslaan, en importeren daarna het hele jaar aan dagrapporten dat Apple bewaart.

Twee dingen over dat token, allebei regels van Apple: het verloopt na 180 dagen, en er is er één per Apple-account — ergens een nieuwe aanmaken doodt het onze meteen. De kaart waarschuwt je voor het verloopt en toont Opnieuw koppelen zodra Apple het weigert.

Elk boek dat Apple verkoopt wordt een titel onder Boeken, in het formaat dat Apple meldt (e-book of luisterboek). Zo worden de cijfers geteld:

• De bedragen zijn Apples eigen schatting van wat je gaat ontvangen — dat staat in Apples eigen gids —, per boek en per land, na de commissie van Apple. Belastingen en inhoudingen staan niet in deze regels, en Apples definitieve maandafrekening lezen we nog niet.
• Gratis downloads zijn nooit verkopen. Ze staan bij je gratis exemplaren, nooit bij je royalty's.
• Een correctie gaat eraf op de dag waarop Apple ze meldt. Apple kan een dag achteraf corrigeren; elke ronde leest de laatste dagen daarom opnieuw.
• Een dag zonder verkoop is een dag, geen mislukte synchronisatie.

Verkopen worden gedateerd op de dag van Apples rapport (UTC) en dragen het land van de aankoop, dus ze verschijnen op de kaart en in Marketplaces. Apple bewaart 365 dagen aan dagrapporten: ouder kan niet worden geïmporteerd.

Nu synchroniseren

Nu synchroniseren vraagt meteen om een verversing in plaats van op de automatische te wachten. Twee dingen zijn goed om te weten:

• Amazon Ads accepteert één handmatige synchronisatie per uur. Daarna vertelt de knop wanneer de volgende wordt geaccepteerd, in plaats van te doen alsof.
• Een synchronisatie is niet meteen klaar. Amazon bouwt het rapport op zijn eigen moment, dus een verversing duurt meestal een paar minuten. Er valt ondertussen niets te klikken.

Je hebt hem zelden nodig — alles ververst vanzelf, zoals beschreven in Synchronisatie en actualiteit van je data.

Een gekoppeld platform beheren

Elk platform dat je vandaag kunt koppelen heeft zijn eigen pagina in de app — klik op de kaart om die te openen. Daar kun je:

• Ontkoppelen — stopt ons met lezen en verwijdert de sessie of sleutel die we vasthielden, maar behoudt je cijfers. Handig als je van computer of Amazon-account wisselt.
• Je gegevens wissen — ontkoppelt en verwijdert permanent alles wat dat platform ooit heeft aangeleverd. Gebruik dit als je het verkeerde account hebt gekoppeld.

Platforms die je vast kunt koppelen

Zeventien andere platforms zijn al te koppelen, vooruitlopend op het moment dat we ze gaan lezen. Er komt nog niets in je cijfers terecht — de kaart toont Gekoppeld ✓ — binnenkort synchroniseren — maar zodra het lezen van een platform live gaat, begint de import vanzelf, zonder dat jij nog iets hoeft te doen. Je kunt in de tussentijd op elk moment ontkoppelen.

Wat Koppelen doet, hangt af van het platform:

Drie grenzen die je vooraf moet kennen:

• De API van BookFunnel bestaat alleen in de abonnementen Bestseller en Publisher, en de support van BookFunnel moet hem voor je account aanzetten.
• Amazon Attribution wordt niet aangeboden op Amazon Australië en Japan. Staan al je Amazon Ads-accounts daar, dan zegt de kaart dat.
• Square toont Binnenkort tot de koppeling ervan opengaat. Vanaf dan worden de verkopen elke 4 uur rechtstreeks vanaf onze servers gelezen, en gaat een terugbetaling eraf op de dag waarop ze wordt gedaan.

Eén platform — Smashwords — staat nog echt op Binnenkort: nog niet te koppelen, en er valt nog niets te klikken.