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 productenfeeds, ontworpen voor bedrijven die producten op hun websites verkopen. Als je Catalogi wilt gebruiken, heb je het volgende nodig:
- Een zakelijk Pinterest-account
- Een geclaimde website
- Een website die voldoet aan onze Richtlijnen voor verkopers, met duidelijke en gemakkelijk te vinden informatie over verzenden, terugbetalen en contactgegevens
- Een gegevensbron of een bestand waarin al je producten en de bijbehorende eigenschappen zijn opgenomen (ook wel productencatalogus of productenfeed genoemd)
- Hosting voor de gegevensbron of een betrouwbare plek waar je een gegevensbron met je productgegevens kunt opslaan, waarna Pinterest deze elke dag kan uitlezen
Wil je dat iemand je helpt bij de bovenstaande stappen? Je kunt samenwerken met een e-commercesite die je producten klaarmaakt voor publicatie op Pinterest. Op dit moment ondersteunen we de volgende integraties:
Als Catalogi niet goed bij je past, kun je je content ook op andere manieren promoten op Pinterest. Lees meer over hoe je vanaf je profiel een advertentie kunt maken.
Overzicht gegevensbronnen
Wat is een gegevensbron?
Een gegevensbron (ook wel productencatalogus, productenfeed of gegevensfeed genoemd) is een bestand waarin al je producten en de bijbehorende eigenschappen op een specifieke manier zijn gestructureerd. 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 item. Lees meer over de vereisten 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 items 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
- We verwerken je gegevensbron elke 24 uur. Zorg ervoor dat je volledige, bijgewerkte gegevensbron dagelijks beschikbaar is om je productgegevens actueel te houden. We bieden ondersteuning voor geplande verwerking, maar noet voor on-demand verwerking.
- Host je eigen gegevensbron op een FTP/SFTP-server, of met een directe HTTP/HTTPS-downloadlink. Deze moet toegankelijk zijn voor een gebruikersagent, 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.
- We kunnen tot 20 miljoen producten per account verwerken. Als je gegevensbron meer dan 20 miljoen producten heeft, verwerken we alleen de eerste 20 miljoen rijen. Neem contact met ons op als je meer dan 20 miljoen rijen voor je catalogus wilt verwerken.
- Er geldt een limiet van één gegevensbron per zakelijk account.
Je website claimen
Alle bestemmings-URL's in je gegevensbron moeten bij een domein horen dat als geclaimde website voor je zakelijke account 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.
De Pinterest-tag installeren
De Pinterest-tag is een stukje JavaScript-code die je op je website kunt plaatsen om inzichten te verzamelen in conversies en om 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
enCheckouts
- De Pinterest-tag moet gebeurtenisgegevens voor 'product_id' als attribuut doorgeven voor
PageVisit
,AddToCart
enCheckouts
. - '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 of 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
- In totaal moet je in de afgelopen zeven dagen 100.000 PageVisit- en AddToCart-gebeurtenissen hebben die product-ID's hebben teruggegeven
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
- Het gegevensbronbestand van een door tabs of komma's gescheiden bestand mag alleen niet-opgemaakte tekst bevatten, gecodeerd in UTF-8 of Latin1
Vereisten voor productgegevens
Zorg ervoor dat je voldoet aan onze richtlijnen voor verkopers. Producten of accounts die in strijd zijn met deze richtlijnen, kunnen worden verwijderd.
Verplichte en optionele velden
Er zijn zeven 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 mensen kan afstemmen. Hoe meer informatie je opgeeft, hoe relevanter je pins zullen zijn voor de mensen 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 |
---|---|---|---|
id |
De door de gebruiker gemaakte unieke ID die dit product aanduidt. Alleen unicode-tekens worden geaccepteerd. |
Max. 127 tekens | DS0294-L |
title | De naam van het product. Moet dezelfde naam zijn als het product op de bestemmingspagina. Voeg de details van de variant toe, zoals kleur en grootte. | Max. 500 tekens | Spijkerjasje voor dames, maat L |
description | De 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. |
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 |
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 uitmaken van de afbeeldingslink, omdat wij geen links met komma's kunnen verwerken. |
https://scene.voorbeeld.com/afbeelding/afbeelding.jpg | |
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 ISO-4217-standaard volgen. De waarde 0 wordt niet als prijs geaccepteerd. Gebruik geen valutasymbolen. |
<numeriek> <ISO 4217> |
24.99 USD 24.99USD 24.99 24.99 GBP |
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 |
Optionele algemene eigenschappen
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
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 |
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 we 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" | |
mobile_link | De voor mobiele apparaten geoptimaliseerde versie van je bestemmingspagina. Moet beginnen met http:// of https:// | https://m.voorbeeld.com/cat/dameskleding/denim-blouse-0294 | |
sale_price | De kortingsprijs van het product. De sale_price moet lager zijn dan 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 wordt toegevoegd, gaan wij uit van Amerikaanse dollar. We accepteren valuta na de numerieke prijswaarde, met of zonder spatie. De waarde 0 wordt niet geaccepteerd. Gebruik geen valutasymbolen. |
<numeriek> <ISO 4217> |
14.99 USD 14.99USD 14.99 14.99 GBP |
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 |
Optionele productkenmerken
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
color |
De primaire kleur van het product | blue | |
gender | Het gender dat wordt geassocieerd met het product. Moet een van de volgende waarden zijn: ‘male’, ‘female’, ‘unisex’ | male female unisex |
female |
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 |
material | Het materiaal waarvan het product is gemaakt. | cotton | |
pattern | De beschrijving van het patroon dat voor het product is gebruikt. | plaid | |
size | De maat van het product. | M | |
size_type | Aanvullende beschrijving voor de maat. Moet een van de volgende waarden zijn: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ | regular petite plus big_and_tall maternity |
regular |
size_system | Geeft aan van welk land het maatsysteem wordt gebruikt. | Landcode |
US |
Optionele btw- en verzendgegevens
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
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 |
shipping | Elke verzendeigenschapgroep kan uit vier subeigenschappen bestaan: country, region, service, en 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 |
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 |
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 |
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 |
Optionele markering voor producten voor volwassenen
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
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 |
Optionele aangepaste labels
Aangepaste groepering van producten kan voor uiteenlopende doeleinden worden gebruikt. Denk aan seizoensgebonden producten, aanbiedingen en bestsellers. Er worden maximaal vijf verschillende aangepaste labels geaccepteerd.
In catalogi kun je aan de hand van aangepaste labels productgroepen maken.
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
custom_label_0 | Aangepaste groepering van producten | Max. 1000 tekens |
Bestsellers Zomeraanbiedingen |
custom_label_1 | Aangepaste groepering van producten | Max. 1000 tekens | |
custom_label_2 | Aangepaste groepering van producten | Max. 1000 tekens | |
custom_label_3 | Aangepaste groepering van producten | Max. 1000 tekens | |
custom_label_4 | Aangepaste groepering van producten | Max. 1000 tekens |
Optionele velden voor winkeladvertenties
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
ad_link | In dit veld kunnen adverteerders een aparte URL opgeven waarmee webverkeer afkomstig van winkeladvertenties 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 |
condition | De staat van het product. Moet een van de volgende waarden zijn: ‘new’, ‘used’, ‘refurbished’. | new used refurbished |
new |
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 |
En verder?
Bekijk onze gids over het Toevoegen van je gegevensbron voor meer informatie over het koppelen van je productfeed aan Pinterest.