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
- Een website die voldoet aan onze Richtlijnen voor verkopers, met duidelijke en gemakkelijk te vinden informatie over verzenden, terugbetalen en contactgegevens
- 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:
- Door tabs gescheiden (.tsv) (Voorbeeld-TSV-bestand downloaden)
- Door komma's gescheiden (.csv) (Voorbeeld-CSV-bestand downloaden)
- XML (RSS 2.0) (Voorbeeld-XML-bestand downloaden)
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 7 verplichte velden. Als een van deze velden ontbreekt of een onjuiste notatie heeft, kan de feed in z'n geheel niet worden verwerkt.
Verplichte velden:
- id
- title
- description
- link
- image_link
- price
- availability
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. 500 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. 10.000 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 |
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 Max. 1000 tekens |
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:// | 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 |
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. | Max. 1000 tekens |
Bestsellers Zomeraanbiedingen |
optioneel |
| custom_label_1 | Aangepaste groepering van producten. | Max. 1000 tekens | optioneel | |
| custom_label_2 | Aangepaste groepering van producten. | Max. 1000 tekens | optioneel | |
| custom_label_3 | Aangepaste groepering van producten. | Max. 1000 tekens | optioneel | |
| custom_label_4 | Aangepaste groepering van producten. | Max. 1000 tekens | 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 |
| condition | De staat van het product. Moet een van de volgende waarden zijn: ‘new’, ‘used’, ‘refurbished’. | new used refurbished |
new | optioneel |
| 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 |
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,AddToCartenCheckouts - Gebeurtenisgegevens voor 'product_id' moeten als attribuut worden doorgegeven voor
PageVisit,AddToCartenCheckouts.- '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.