# Data importeren vanuit SalesFeed ## Data importeren vanuit SalesFeed Met de importfunctie van SalesFeed kun je de data over herkende bedrijven in een spreadsheet ophalen. Daar kun je vervolgens zelf grafieken, draaitabellen, etcetera maken. Je kunt de spreadsheet ook gebruiken als databron voor tools zoals Looker Studio of Power BI. *** ## Wanneer gebruik je deze importfunctie? Je gebruikt deze functie wanneer je: * zelf in een spreadsheet analyses wilt maken over herkende bedrijven; * draaitabellen en grafieken wilt maken op basis van SalesFeed-data; * je SalesFeed-data wilt voeden aan een dashboard-tool zoals Looker Studio (Google) of Power BI (Microsoft) via een tussenstap (Google Spreadsheet of Microsoft Flow). Voor andere vormen van export zijn aparte functies beschikbaar. Zie hiervoor: * [Data naar een webhook sturen](https://handleiding.salesfeed.com/salesfeed/bedrijven/exporteren/salesfeed-data-naar-een-webhook-sturen) * [Data via Google Tag Manager sturen](https://handleiding.salesfeed.com/salesfeed/triggers/data-via-google-tag-manager-sturen) * [Exporteren naar een Excel bestand](https://handleiding.salesfeed.com/salesfeed/bedrijven/exporteren) * [Exporteren naar een RSS reader](https://handleiding.salesfeed.com/salesfeed/bedrijven/exporteren/exporteren-naar-een-rss-reader) {% hint style="success" %} Data over herkende bedrijven en hun gedrag ontsluiten in een andere omgeving, zoals een CDP of DMP? Neem contact op via {% endhint %} *** ## Voorwaarden en randvoorwaarden Deze importfunctie is beschikbaar voor **Professional licenties** met jaarabonnement. Voor **Enterprise-licenties** kan de hoeveelheid data een belemmering zijn. In dat geval zijn er vaak betere, alternatieve manieren om met SalesFeed-data te werken. Neem hiervoor contact op met SalesFeed om de beste aanpak te bepalen. De importfunctie: * kan alleen worden gebruikt in een **Google Spreadsheet** of in **Microsoft Flow**; * Wil je in een andere omgeving data ophalen, neem dan contact op via ****. Het **token** dat je gebruikt: * wordt per licentie aangemaakt; * is 2 jaar geldig. *** ## Stap-voor-stap aan de slag #### Stap 1 – Vraag een token aan 1. Stuur een e-mail naar **** met het verzoek om een token voor de data-importfunctie voor jouw licentie. 2. Je ontvangt vervolgens een e‑mail met jouw unieke token. Dit token heb je straks nodig in de importfunctie. #### Stap 2 – Maak een nieuwe lege spreadsheet 1. Ga naar **Google Drive** en maak een **nieuw Google Spreadsheet** aan. 2. Laat het blad verder leeg; je gaat alleen werken in **cel A1**. Wil je met **Microsoft Flow** werken en de data vervolgens naar **Power BI** sturen? Dan gebruik je in de basis dezelfde logica: SalesFeed levert via de importfunctie de ruwe data, en Microsoft Flow haalt deze op en Power BI gebruikt de dataset als bron. #### Stap 3 – Plaats de importfunctie in cel A1 In je lege spreadsheet plaats je de importfunctie in **cel A1**. De functie haalt de data over een bepaalde periode uit je SalesFeed-licentie op en zet deze in de spreadsheet. Dit is de importfunctie: ``` =IMPORTDATA("https://query-api.salesfeed.com/v1/party/pivot? t=3&start=start_of_last_week&end=end_of_last_week&token=TOKEN";",") ``` * **`start`** en **`end`** bepalen de periode; * **`TOKEN`** vervang je door het token dat je per e‑mail hebt ontvangen; #### Voorbeeld: data over "de vorige week" Gebruik de bovenstaande importfunctie om data over de **vorige week** op te halen. Plak deze in **cel A1** en vervang `TOKEN` door je eigen token: #### Voorbeeld: data over "de vorige maand" Gebruik onderstaande functie om data over de **vorige maand** op te halen. Plak deze in **cel A1** en vervang opnieuw `TOKEN`: ``` =IMPORTDATA("https://query-api.salesfeed.com/v1/party/pivot? t=3&start=start_of_last_month&end=end_of_last_month&token=TOKEN";",") ``` Na het vervangen van `TOKEN` door het token dat je per mail kreeg, haalt je spreadsheet automatisch de data op en vult het blad met rijen en kolommen. #### Stap 4 – De periode van de data instellen De importfunctie haalt altijd data op over een **bepaalde periode**. In de voorbeelden hierboven is dat "vorige week" of "vorige maand". Achter de schermen werken de parameters `start` en `end` met **tijdsexpressies**. Die tijdsexpressies worden vertaald naar timestamps waarmee de database van SalesFeed bevraagd wordt. Voorbeelden van tijdsexpressies zijn onder andere: * "gisteren"; * "vorige week"; * "de vorige maand"; * "de afgelopen 28 dagen". Wil je een andere periode, dan kan SalesFeed je helpen om de importfunctie zo aan te passen dat deze precies data levert over de door jou gewenste periode. Neem daarvoor contact op via ****. *** ## Hoe de geïmporteerde data is opgebouwd De data die je in het spreadsheet binnenkrijgt, is **draaitabel-vriendelijk** ingericht. #### Overzicht van kolommen en prefixen In je spreadsheet zie je kolommen met verschillende **prefixen**: * **P:** * `P:name` – naam van de organisatie * `P:address` – adres * `P:postalcode` – postcode * `P:city` – plaats * `P:state` – provincie * `P:sbicode` – SBI-code (branchecode) * `P:sbidesc` – omschrijving van de SBI-code * `P:id` – intern ID van de partij in SalesFeed * `P:domain` – domeinnaam van de organisatie * **STAT:** * `STAT:sessions` – aantal webbezoeken (sessies) in de gekozen periode * `STAT:pageviews` – aantal pageviews in de gekozen periode * **TAG:** * Kolommen die beginnen met `TAG:` horen bij tags die je in je licentie hebt ingericht. * In elke `TAG:`-kolom staat: * **`1`** als het bedrijf deze tag heeft * **`0`** als het bedrijf deze tag niet heeft * **REL:** * Kolommen die beginnen met `REL:` geven het relatietype weer: * `REL:klanten` * `REL:prospects` * `REL:concurrenten` * `REL:ex klanten` * `REL:leveranciers` * `REL:niet interessant` * `REL:partners/bekenden` * `REL:leads`. * Ook hier geldt: * **`1`** als het bedrijf dit relatietype heeft * **`0`** als dat niet het geval is {% hint style="info" %} Belangrijk: tags en relatietypen worden op **organisatieniveau** opgeslagen, niet per sessie of pageview. Verderop staat een uitgebreide toelichting. {% endhint %} ### Structuur per rij Belangrijke kenmerken van de rijen: * Elke **rij** staat voor één **herkend bedrijf** in de gekozen periode; * De kolommen met prefix `P:` bevatten stamgegevens over dat bedrijf; * De kolommen met prefix `STAT:` bevatten aggregaties over gedrag in de gekozen periode (sessies, pageviews); * De kolommen met prefix `TAG:` en `REL:` bevatten binaire waarden (1/0) die aangeven of een tag of relatietype wel of niet van toepassing is. Deze opmaak is draaitabel vriendelijk. *** ## Perioden met elkaar vergelijken (meerdere tabbladen) Wil je data over verschillende perioden naast elkaar leggen, dan kun je het beste werken met **meerdere tabbladen** in hetzelfde spreadsheet. Een praktische werkwijze: 1. **Tabblad 1 – Vorige maand** 2. **Tabblad 2 – "De maand daarvoor"** Per periode kies je in de importfunctie het gewenste tijdsinterval In Looker Studio of Power BI kun je vervolgens deze verschillende tabbladen of datasets naast elkaar leggen. *** ## Data gebruiken in Looker Studio en Power BI #### Google Spreadsheet → Looker Studio Een veelgebruikte werkwijze: 1. Haal de data via de importfunctie op in een Google Spreadsheet. 2. Gebruik dit spreadsheet vervolgens als **databron voor Looker Studio**. 3. In Looker Studio bouw je dashboards, grafieken en filters op basis van de kolommen in het spreadsheet. Doordat elke tag in een eigen kolom staat met 1/0-waarden, kun je in Looker Studio makkelijk segmenten en filters bouwen. Bijvoorbeeld: "toon alleen bedrijven met tag 'klant' én tag 'interesse-productgroep-X'". #### Microsoft Flow → Power BI Voor Microsoft-omgevingen gebruik je: * **Microsoft Flow** (Power Automate) om de data vanuit SalesFeed op te halen; * **Power BI** om op basis van die data rapportages en dashboards te maken. De gedachte is vergelijkbaar met Google: SalesFeed levert via de importfunctie de ruwe data, en jij gebruikt een BI-tool naar keuze om daar visualisaties en analyses van te maken. *** ## Belangrijke aandachtspunten: relatietype en tags In de database van SalesFeed worden **tags** en **relatietype** (zoals klant of prospect) aan een **organisatie** gekoppeld, niet aan een individueel bezoek of een pageview. Dit heeft een paar belangrijke gevolgen: * De tag en het relatietype die je in de data ziet, zijn altijd de **actuele status ("nu")**. * Ook als je een periode in het verleden opvraagt (bijvoorbeeld vorige maand), wordt bij elk bedrijf de **huidige** tag- en relatietype-status getoond. Belangrijk: * Er is **geen logboek** van wijzigingen in tags of relatietype. * Wil je de status en tags op een bepaald moment in de tijd **"bevriezen"**, dan moet je de data die je toen hebt opgehaald bewaren en **niet opnieuw ophalen** voor diezelfde periode. Als je dat wel doet, zie je opnieuw de actuele status, niet de historische. *** ## Veelgemaakte fouten en tips Een aantal dingen die vaak misgaan en hoe je ze voorkomt: 1. **`TOKEN` niet vervangen** * Zorg dat je in de functie in cel A1 het woord `TOKEN` altijd vervangt door het token dat je per mail hebt ontvangen. Laat je per ongeluk `TOKEN` staan, dan werkt de import niet. 2. **Gebruik in een niet-ondersteunde omgeving** * De beschreven importfunctie is bedoeld voor **Google Spreadsheet** of **Microsoft Flow**. Wil je data direct in een ander systeem ophalen, neem dan contact op via . 3. **Onjuiste of onduidelijke periode-instellingen** * Controleer altijd of je de juiste tijdsexpressies gebruikt (`start_of_last_week`, `end_of_last_week`, etc.). * Weet je niet zeker welke expressies je nodig hebt? Laat SalesFeed je helpen om de functie goed in te stellen. 4. **Token is verlopen** * Tokens zijn **2 jaar geldig**. Krijg je ineens fouten terwijl de functie eerder goed werkte, kan het zijn dat je token verlopen is. Vraag in dat geval een nieuw token aan via ****.