Klaar om je catalogus te uploaden en je producten op Pinterest te zetten? Voordat je aan de slag gaat, moet je
Heb je Catalogi geconfigureerd?
Als je een ontwikkelaar bent, kun je ook
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:
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
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.
Je moet een gegevensbron maken voordat je je feed kunt instellen. Je kunt maximaal 50 gegevensbronnen toevoegen voor de verschillende afzetmarkten, talen en valuta's waarbinnen je je producten wilt sponsoren.
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.
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.
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 als 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 de indeling van je gegevens aanpassen.
Opmerking: Als je je pins als advertenties sponsort en je de afbeeldingen van je gehele catalogus aanpast, kan het enkele dagen duren voordat je winkeladvertenties en verzamelingadvertenties worden weergegeven.
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.
Ondersteunde indelingen:
Wij accepteren gecomprimeerde bestanden (onder andere .zip, .giz, .gz en .bz2), maar deze mogen niet versleuteld zijn of met een wachtwoord zijn beveiligd. Google Drive- en Dropbox-feeds worden ook niet ondersteund.
Zorg ervoor dat je voldoet aan onze
Er zijn zeven verplichte velden. Zorg ervoor dat de spaties, streepjes en hoofdletters exact overeenkomen met de onderstaande veldnamen. Als een van deze velden ontbreekt of een onjuiste notatie heeft, kan de feed in z'n geheel niet worden verwerkt.
Verplichte velden:
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.
Opmerking: Als je de image_link of de item_id bijwerkt, worden er standaard nieuwe pins gemaakt. Als je de prijs, beschrijving of link bijwerkt, worden er geen nieuwe pins gemaakt.
Opmerking: Als je de productafbeelding later wijzigt, moet je de URL van de afbeelding wijzigen in het veld 'image_link'. Anders wordt de afbeelding niet bijgewerkt.
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 | |
image_link |
De link naar de primaire productafbeelding. Afbeeldingen moeten minimaal 75x75 pixels zijn om fouten te voorkomen. Gebruik het veld additional_image_link om meer afbeeldingen van je product toe te voegen. De afbeeldingslink moet toegankelijk zijn voor de useragent van Pinterest en de juiste afbeeldingen retourneren. Zorg ervoor dat de link niet naar een sjabloonafbeelding of tijdelijke afbeelding verwijst. De afbeeldingslink mag maximaal 2000 tekens bevatten en moet beginnen met http:// of https://. Codeer of verwijder komma's uit de afbeeldingslink. We kunnen namelijk geen links met komma's erin verwerken. We raden aan om aanhalingstekens om de gehele tekenreeks te plaatsen. Als je de afbeelding later wijzigt, moet de nieuwe afbeelding een andere link hebben. Anders wordt de afbeelding niet bijgewerkt. |
||
price |
De prijs van het product. De prijs moet overeenkomen met de werkelijke waarde van het product. Als de prijs niet in Amerikaanse dollar is, moet deze de valuta volgens ISO-4217 bevatten. Als de valuta niet wordt toegevoegd, gaan wij uit van Amerikaanse dollar. We accepteren valuta voor of na de numerieke prijswaarde, met of zonder spatie. De valuta moet de ISO-4217-standaard volgen. De waarde 0 wordt niet als prijs geaccepteerd. Gebruik geen valutasymbolen. Als er een aanbiedingsprijs is opgegeven, wordt dat veld als de catalogusprijs beschouwd, en wordt de aanbiedingsprijs als de huidige prijs beschouwd. |
<numeriek> <ISO 4217> |
24.99 USD 24.99USD 24,99 USD 24,99USD 24.99 24,99 GBP24.99 GBP 24.99 GBP24,99 GBP 24,99 |
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 |
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
product_type | De categorie van je product volgens je eigen producttaxonomie. Subcategorieën, waarvan je er maximaal vijf kunt hebben, 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 Maximaal vijf subcategorieën |
Kleding > Dames > Shirts > Spijkerstof |
additional_image_link |
De links naar aanvullende afbeeldingen voor je product. Er kunnen tot tien aanvullende afbeeldingen worden gebruikt om foto's vanuit verschillende hoeken of foto's van verschillende stadia van het product te laten zien. Afbeeldingen moeten minimaal 75x75 pixels zijn om fouten te voorkomen. De afbeeldingslink moet toegankelijk zijn voor de useragent van Pinterest en de juiste afbeeldingen retourneren. Zorg ervoor dat de link niet naar een sjabloonafbeelding of tijdelijke afbeelding verwijst. Elke afbeeldingslink mag maximaal 2000 tekens bevatten en moet beginnen met http:// of https://. Codeer of verwijder komma's uit de afbeeldingslink. We kunnen namelijk geen links met komma's erin verwerken. Andere scheidingstekens worden niet herkend. Gebruik komma's om meerdere aanvullende afbeeldingslinks te scheiden. We raden aan om aanhalingstekens om de gehele tekenreeks te plaatsen. We maken een nieuwe pin voor elke aanvullende afbeeldingslink. Als je de afbeelding later wijzigt, moet de nieuwe afbeelding een andere link hebben. Anders wordt de afbeelding niet bijgewerkt. |
" |
|
mobile_link | De voor mobiele apparaten geoptimaliseerde versie van je bestemmingspagina. Moet beginnen met http:// of https:// | ||
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 voor of na de numerieke prijswaarde, met of zonder spatie. De waarde 0 wordt niet geaccepteerd. Gebruik geen valutasymbolen. Wanneer dit is opgegeven, wordt de aanbiedingsprijs beschouwd als de huidige prijs van het artikel. |
<numeriek> <ISO 4217> |
14.99 USD 14.99USD 14,99 USD 14,99USD 14.99 14,99 GBP 14.99 GBP14.99 GBP 14,99 GBP14,99 |
average_review_rating | Het gemiddeld aantal beoordelingen voor het product. | <getal> tussen 1 en 5 | 5 |
number_of_ratings | Het aantal beoordelingen voor het product. | <numeriek> | 2 |
number_of_reviews | Het aantal beschikbare beoordelingen voor het product. | <numeriek> | 4 |
'description_html' | De HTML-beschrijving van het item. Met dit veld kun je HTML-indeling gebruiken, zoals opsommingstekens, zodat je beschrijving gemakkelijker te lezen is. We raden je aan dit te gebruiken als je beschrijving langer is dan 200 tekens. Als dit veld beschikbaar is, gebruiken we dit in plaats van een beschrijving. Het veld 'Description' (Beschrijving) is echter nog wel verplicht. |
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. | Maximaal 100 tekens | Josie’s Denim | optioneel |
gtin | De unieke universele product-ID. Deze moet voldoen aan |
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 Max. 70 tekens |
"mpn": "PI12345NTEREST" |
optioneel |
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 |
alt_text | Aanvullend attribuut om te beschrijven wat er te zien is in de hoofdafbeeldingen van het product. | Een of meerdere alt-tekstwaarden, gescheiden door komma's. Het aantal alt-tekstwaarden moet overeenkomen met het aantal afbeeldingen in je image_link-kolom. Komma's moeten worden gecodeerd als , of worden verwijderd als ze onderdeel zijn van de alt-tekst, omdat we geen afbeeldingslinks met alt-tekst kunnen verwerken. Komma's moeten worden gebruikt om meerdere alt-teksten te scheiden. | Een lichtblauw gehaakt babymutsje met kwastjes |
variant_names | De opties voor deze variant. Mensen zien deze opties naast je pin en kunnen de gewenste optie selecteren. Vermeld ze in de volgorde waarin je ze wilt weergeven. | Teksten gescheiden door komma's | Kleur,Maat |
variant_values | De waarden van de opties voor deze variant. Mensen zien deze opties naast je pin en kunnen de gewenste optie selecteren. Vermeld ze in de volgorde waarin je ze wilt weergeven. De volgorde van de variantwaarden moet overeenkomen met de volgorde van de variantnamen. | Teksten gescheiden door komma's | Rood,S |
Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
---|---|---|---|
tax | De btw-gegevens bestaan uit één groep met een tot vier elementen: country, region, rate (alle drie verplicht) en tax_ship (optioneel). Alle dubbelepunten zijn verplicht, zelfs voor lege waarden. | country:region:rate(required):tax_ship | US:1025433:6.00:y |
shipping | De verzendgegevens bestaan uit één groep met een tot vier elementen: country, region, service (alle drie optioneel) en price (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 |
free_shipping_label | Of je wel of niet gratis verzending voor het artikel aanbiedt. Vul 0 in bij 'free_shipping_limit' als je gratis verzending aanbiedt. Als je pas gratis verzending aanbiedt bij een bepaald bestelbedrag, vul je bij 'free_shipping_limit' de waarde van dat bedrag in. | true false |
true |
free_shipping_limit | Het minimale bestelbedrag voor gratis verzending. Alleen van toepassing als je gratis verzending aanbiedt. |
<numeriek> <ISO 4217> |
35USD |
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 |
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 | Maximaal 100 tekens |
Bestsellers Zomeraanbiedingen |
custom_label_1 | Aangepaste groepering van producten | Maximaal 100 tekens | |
custom_label_2 | Aangepaste groepering van producten | Maximaal 100 tekens | |
custom_label_3 | Aangepaste groepering van producten | Maximaal 100 tekens | |
custom_label_4 | Aangepaste groepering van producten | Maximaal 100 tekens |
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) | |
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. | Bekijk de |
Apparel & Accessories > Clothing > Shirts & Tops 212 |
De
Denk aan het volgende wanneer je winkelspecifieke velden via de Pinterest-tag doorgeeft:
PageVisits
, AddToCart
en Checkouts
PageVisit
, AddToCart
en Checkouts
Gebruik de
Bekijk onze