Voordat je aan de slag gaat met Catalogi

Voordat je Catalogi kunt instellen, moet je deze stappen uitvoeren. Klik op een link om naar de sectie te gaan die je nodig hebt:

Is Catalogi voor jou geschikt?

Catalogi is een tool voor de gegevensopname van productfeeds, ontworpen voor bedrijven die producten op hun websites verkopen. Als je Catalogi wilt gebruiken, heb je het volgende nodig:

  • Een zakelijk Pinterest-account
  • Een gegevensbron: een bestand waarin al je producten en de bijbehorende eigenschappen zijn opgenomen - ook wel productencatalogus of productfeed genoemd
  • Een geclaimde website
  • Hosting voor de gegevensbron: een betrouwbare plek waar je een gegevensbron met je productgegevens kunt opslaan, waarna Pinterest deze elke dag kan uitlezen

Als je niet aan deze voorwaarden voldoet maar alsnog productpins wilt maken, kun je een webwinkelsysteem gebruiken. Dit systeem kan je producten vervolgens op de juiste manier opmaken voor gebruik op Pinterest. Op dit moment bieden we integraties met GoDataFeed en Productsup. Je kunt je content ook op andere manieren promoten op Pinterest.

Overzicht gegevensbronnen

Wat is een gegevensbron?

Een gegevensbron (ook wel productencatalogus, productfeed of gegevensfeed genoemd) is een bestand waarin al je producten en de bijbehorende eigenschappen op een gestructureerde manier zijn opgenomen. Dit bestand wordt dagelijks verwerkt om automatisch pins van je producten te maken.

Zo werkt een gegevensbron

Als je een gegevensbron naar Pinterest wilt verzenden, geef je een URL op waarvandaan we je gegevensbronbestand kunnen downloaden. We zullen het bestand controleren en een productpin aanmaken voor elk geldig artikel. Meer informatie over de specificaties voor gegevensbronnen.

Een gegevensbron beheren

Het hosten van een gegevensbron vergt discipline om de gegevens van je producten voortdurend actueel te houden. Pinterest downloadt en verwerkt dagelijks je gegevensbron, en stelt je op de hoogte indien er fouten optreden. Het is belangrijk om eventuele fouten zo snel mogelijk te onderzoeken en te verhelpen, zodat je productgegevens correct en actueel blijven.

Fouten kunnen er, afhankelijk van het type fout, toe leiden dat je volledige feed niet wordt bijgewerkt of dat sommige artikelen in je feed niet worden bijgewerkt. In andere gevallen moet je je feed op bepaalde vlakken aanpassen. Meer informatie over het oplossen van foutberichten.

Meer over gegevensbronnen

  • Werk ze dagelijks bij. We verwerken je gegevensbron elke 24 uur. Zorg ervoor dat je bijgewerkte gegevensbron dagelijks beschikbaar is om je productdetails actueel te houden. We bieden geen ondersteuning voor geplande verwerking of on-demand verwerking.
  • Host je gegevensbron. Host je eigen gegevensbron op een FTP-/SFTP-server, of met een directe HTTP-/HTTPS-downloadlink. Deze moet toegankelijk zijn voor een useragent, en mag niet worden afgeschermd door een IP-adrescontrole of SSH-sleutel. Als je een directe downloadlink gebruikt, mogen er geen aanvullende stappen vereist zijn om het bestand te downloaden. We bieden geen hosting voor gegevensbronnen.
  • Maximaal 5 miljoen producten. We kunnen tot 5 miljoen producten per account verwerken. Als je gegevensbron meer dan 5 miljoen producten heeft, verwerken we alleen de eerste 5 miljoen rijen.
  • Eén gegevensbron per zakelijk account.

Een website claimen op Pinterest

Alle bestemmings-URL's in je gegevensbron moeten bij een domein horen dat als geclaimde website op Pinterest is geregistreerd. Een bedrijf kan meerdere domeinen claimen, maar elk domein kan slechts door één zakelijk Pinterest-account worden geclaimd. Meer informatie over hoe je je website claimt.

Je gegevensbron voorbereiden

Voordat je je productfeed kunt instellen, moet je een gegevensbron maken. Een gegevensbron is een bestand waarin al je producten en de bijbehorende eigenschappen zijn opgenomen.

Vereisten aan de hosting van gegevensbronnen voor Catalogi

Je moet eigen hostingruimte op een FTP-/SFTP-server hebben, of een directe downloadlink via HTTP/HTTPS configureren. Pinterest biedt geen hosting voor gebruikers. Je gegevensbron moet te downloaden zijn door een useragent, en mag niet worden afgeschermd door een IP-adrescontrole of SSH-sleutel. Als je een directe downloadlink (HTTP/HTTPS) gebruikt, mogen er geen aanvullende stappen vereist zijn om het bestand te downloaden.

Vereisten aan de indeling van gegevensbronnen voor Catalogi

Ondersteunde indelingen:

Tips voor de indeling:

  • Als je een CSV-bestand gebruikt, worden de waarden omgeven door dubbele aanhalingstekens om eventuele verwerkingsfouten te voorkomen
  • Aanvullende scheidingstekens (komma's of tabs) kunnen ervoor zorgen dat het item of bestand niet goed kan worden verwerkt
  • Zorg ervoor dat de scheidingstekens in alle kolommen en rijen kloppen, en dat elke rij hetzelfde aantal scheidingstekens bevat.
  • De specificaties voor de feed moeten standaard-Amerikaans-Engels volgen voor de verplichte en ingestelde waarden.
  • TSV- en CSV-bestanden mogen alleen niet-opgemaakte tekst bevatten, gecodeerd in UTF-8 of Latin1.

Vereisten voor productgegevens

Zorg ervoor dat je voldoet aan de richtlijnen voor verkopers. Producten of accounts die in strijd zijn met deze richtlijnen, kunnen worden verwijderd.

Verplichte en optionele velden

Er zijn 9 verplichte velden. Als een van deze velden ontbreekt of een onjuiste notatie heeft, kan de volledige feed niet worden verwerkt.

Verplichte velden:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability
  • condition
  • google_product_category

Daarnaast zijn er enkele optionele velden die je kunt toevoegen, waarmee Pinterest je producten beter op pinners kan afstemmen. Hoe meer informatie je opgeeft, hoe relevanter je pins zullen zijn voor de pinners die ze zien. We raden je ten zeerste aan om onze optionele velden toe te voegen, zodat je feed uitgebreidere en relevantere gegevens bevat.

Verplichte velden

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
id

De door de gebruiker gemaakte unieke ID die dit product aanduidt.

Alleen unicode-tekens worden geaccepteerd.

Max. 127 tekens DS0294-L verplicht
title De naam van het product. Moet dezelfde naam hebben als het product op de bestemmingspagina. Voeg de details van de variant toe, zoals kleur en grootte. Max. 128 tekens Spijkerjasje voor dames, groot verplicht
description Beschrijving van het product. Dit veld ondersteunt geen HTML en moet niet-opgemaakte tekst bevatten voor de meest optimale ervaring. Max. 500 tekens Casual spijkerjasje, gemaakt van de beste Japanse spijkerstof.  verplicht
link De landingspagina voor het product. De link moet direct naar hetzelfde product verwijzen en dezelfde gegevens bevatten. We raden blokkerende pagina's af. De URL moet beginnen met http:// of https://  Max. 511 tekens https://www.voorbeeld.com/cat/dameskleding/denimshirt-0294 verplicht
image_link

De link naar de productafbeelding. De URL moet toegankelijk zijn voor een useragent en de juiste afbeelding retourneren. Zorg ervoor dat de link niet naar een sjabloonafbeelding of tijdelijke afbeelding verwijst. Moet beginnen met http:// of https://

Komma's moeten worden gecodeerd of verwijderd als ze onderdeel zijn van de afbeeldingslink, omdat we op dit moment geen afbeeldingslinks kunnen verwerken die komma's bevatten..

  https://scene.voorbeeld.com/afbeelding/afbeelding.jpg verplicht
price De prijs van het product. De prijs moet, indien die niet in Amerikaanse dollar is, de valuta volgens ISO-4217 bevatten. Als de valuta niet wordt toegevoegd, gaan wij uit van Amerikaanse dollar. We accepteren valuta na de numerieke prijswaarde, met of zonder spatie. Valuta moet de standaard-ISO-4217-code volgen. De waarde 0 wordt niet als prijs geaccepteerd. Gebruik geen valutatekens.

<numeriek>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
verplicht
availability De beschikbaarheid van het product. Moet een van de volgende waarden zijn: ‘in stock’, ‘out of stock’, ‘preorder’. in stock
out of stock
preorder
in stock verplicht
condition De staat van het product. Moet een van de volgende waarden zijn: ‘new’, ‘used’, ‘refurbished’. new
used
refurbished
new verplicht
google_product_category De categorie volgens de gestandaardiseerde Google-producttaxonomie. Dit is een vastgestelde taxonomie. Zowel de tekstwaarden als de numerieke codes worden geaccepteerd. Volledige taxonomie Apparel & Accessories > Clothing > Shirts & Tops
212
verplicht

Optionele algemene eigenschappen

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
product_type De categorie van je product volgens je eigen producttaxonomie. Subcategorieën moeten worden gescheiden door ' > '. Er moeten spaties om de > heen staan. Andere scheidingstekens, zoals een komma of een verticale streep, worden niet herkend. L0 > L1 > L2 > L3 > L4 Kleding > Dames > Shirts > Spijkerstof optioneel
additional_image_link

De links naar aanvullende afbeeldingen voor je product. De aanvullende afbeeldingen moeten worden gescheiden door een komma. We raden aan om aanhalingstekens om de gehele tekenreeks te plaatsen. Moet beginnen met http:// of https://

Komma's moeten worden gecodeerd of verwijderd als ze onderdeel zijn van de afbeeldingslink, omdat wij op dit moment geen links met komma's kunnen verwerken.
 

We maken een nieuwe pin voor elke aanvullende afbeeldingslink die je opgeeft.

  "https://scene.voorbeeld.com/image/image_v2.jpg, https://scene.voorbeeld.com/image/image_v3.jpg" optioneel
mobile_link De voor mobiele apparaten geoptimaliseerde versie van je bestemmingspagina. Moet beginnen met http:// of https:// Max. 511 tekens https://m.voorbeeld.com/cat/dameskleding/spijkerjasje-0294 optioneel
sale_price De kortingsprijs van het product. De sale_price moet lager zijn dan de price. Valuta heeft dezelfde indeling als bij price. De kortingsprijs moet, indien die niet in Amerikaanse dollar is, de valuta volgens ISO-4217 bevatten. Als de valuta niet is toegevoegd, gaan wij uit van Amerikaanse dollar. We accepteren valuta na de numerieke prijswaarde, met of zonder spatie. De waarde 0 wordt niet als kortingsprijs geaccepteerd. Gebruik geen valutasymbolen.

<numeriek>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
optioneel

Optionele productaanduiding

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
item_group_id De ID van het hoofdproduct.  Max. 127 tekens DS0294 verplicht voor artikelen met meerdere varianten

brand

Het merk van het product.   Josie’s Denim optioneel
gtin De unieke universele productaanduiding. Numeriek 3234567890126 optioneel
mpn Onderdeelnummers ('manufacturer part numbers') zijn alfanumerieke codes die door de fabrikant van een product worden gemaakt om het product uniek te onderscheiden van alle andere producten van dezelfde fabrikant.  Alfanumeriek "mpn":
"PI12345NTEREST"
optioneel
identifier_exists Verplicht wanneer er geen unieke productaanduiding (GTIN of MPN) bestaat. Als het veld niet wordt opgegeven, is de standaardwaarde TRUE. true
false
yes
no
true optioneel

Optionele productkenmerken

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?

color

De primaire kleur van het product   blue optioneel
gender Het gender dat wordt geassocieerd met het product. Moet indien opgegeven een van de volgende waarden zijn: ‘male’, ‘female’, ‘unisex’ male
female
unisex
female optioneel
age_group De leeftijdsgroep, waarmee een demografische doelgroep aan dit product kan worden toegekend. Moet een van de volgende waarden zijn: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ newborn
infant
toddler
kids
adult
adult optioneel
material Het materiaal waarvan het product is gemaakt.   katoen optioneel
pattern Beschrijving van het patroon dat voor het product is gebruikt.   plaid optioneel
size De maat van het product.   M optioneel
size_type Aanvullende beschrijving voor de maat. Moet indien opgegeven een van de volgende waarden zijn: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ regular
petite
plus
big_and_tall
maternity
regular optioneel
size_system Geeft aan van welk land het maatsysteem wordt gebruikt. Landcode

US
UK

optioneel

Optionele btw- en verzendgegevens

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
tax Elke btw-eigenschapgroep kan uit vier subeigenschappen bestaan: country:region:rate (required):tax_ship (land, regio, tarief (verplicht) en btw verzendkosten)
Alle dubbelepunten zijn verplicht, zelfs voor lege waarden.
country:region:rate(required):tax_ship US:1025433:6.00:y optioneel
shipping Elke verzendeigenschapgroep kan uit vier subeigenschappen bestaan: country, region, service, and price (required) (land, regio, dienst en prijs (verplicht)).
Alle dubbelepunten zijn verplicht, zelfs voor lege waarden.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

optioneel

shipping_weight

Het gewicht van het product. Zorg dat er een spatie tussen de numerieke waarde en de eenheid zit. <numeriek> <eenheid> 3 kg
5 lbs
optioneel
shipping_width De breedte van de verpakking die nodig is om het product te verzenden. Zorg dat er een spatie tussen de numerieke waarde en de eenheid zit. <numeriek> <eenheid> 16 in optioneel
shipping_height De hoogte van de verpakking die nodig is om dit product te verzenden. Zorg dat er een spatie tussen de numerieke waarde en de eenheid zit. <numeriek> <eenheid> 12 in optioneel

Optionele markering voor producten voor volwassenen

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
adult Stel dit kenmerk in op TRUE als je artikelen opneemt die worden beschouwd als 'voor volwassenen'. Deze worden niet op Pinterest weergegeven. TRUE
FALSE
true optioneel

Optionele aangepaste labels

Aangepaste groepering van producten. Deze kunnen voor uiteenlopende doeleinden worden gebruiken. Denk aan seizoensgebonden producten, aanbiedingen en bestsellers. Er worden maximaal 5 verschillende aangepaste labels geaccepteerd.

In Catalogi kun je aan de hand van aangepaste labels productgroepen maken.

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
custom_label_0 Aangepaste groepering van producten.  

Bestsellers

Zomeraanbiedingen

optioneel
custom_label_1 Aangepaste groepering van producten.     optioneel
custom_label_2 Aangepaste groepering van producten.     optioneel
custom_label_3 Aangepaste groepering van producten.     optioneel
custom_label_4 Aangepaste groepering van producten.     optioneel

Optionele velden voor winkeladvertenties

Kolomnaam Beschrijving Syntaxis/ondersteunde waarden Voorbeeld Verplicht?
adwords_redirect In dit veld kunnen adverteerders een aparte URL opgeven waarmee webverkeer afkomstig van productadvertenties op Pinterest kan worden gevolgd. Je moet een volledige URL inclusief trackingparameters opgeven, niet alleen de trackingparameters. Op dit moment bieden wij geen ondersteuning voor impressietracking. Moet beginnen met http:// of https:// tekenreeks (URL) https://www.voorbeeld.com/cat/spijkerjack/item012?utm_source=Pinterest optioneel

 

De Pinterest-tag installeren

De Pinterest-tag is een stukje JavaScript-code dat je op je website kunt plaatsen om inzichten te verzamelen in conversies en doelgroepen te maken op basis van acties die mensen op je site uitvoeren.

Zorg ervoor dat je winkel-specifieke velden doorgeeft via de Pinterest-tag.

  • De Pinterest-tag moet geïmplementeerd zijn met de volgende conversietypen: PageVisits, AddToCart en Checkouts 
  • Gebeurtenisgegevens voor 'product_id' moeten als attribuut worden doorgegeven voor PageVisit, AddToCart en Checkouts
    • 'product_id' moet worden doorgegeven onder een regel-item (dit is niet zichtbaar op de pagina Conversies bekijken).
    • Gebruik de Chrome-extensie Tag Helper om te controleren dat er product-ID's worden teruggegeven op productdetailpagina's.
  • De 'product_id' die in de tag wordt doorgegeven, moet overeenkomen met de 'item_group_id' of 'id' in de gegevensbron
  • Er moeten in de afgelopen 7 dagen samen minimaal 100.000 PageVisit- en AddtoCart-gebeurtenissen een product-ID hebben teruggegeven
     

Wat nu?

Bekijk onze gids over Verwerken van gegevensbronnen voor meer informatie over het koppelen van je productfeed aan Pinterest.

Nog steeds hulp nodig?
Neem contact met ons op