Als verkoper wil je misschien je producten als productpins naar Pinterest uploaden. Productpins hebben een speciale indeling zodat mensen die Pinterest bezoeken weten dat ze te koop zijn. Ze bevatten een producttitel en -beschrijving, evenals informatie over prijs en beschikbaarheid.
Voeg de gegevensbron van je winkelcatalogus toe aan Pinterest om veel van je producten tegelijk als productpins te uploaden. Vervolgens kun je ze op Pinterest sponsoren als winkeladvertenties. Je kunt de URL voor je gehoste gegevensbron opgeven of je gegevensbron handmatig uploaden.
Voordat je je winkelcatalogus toevoegt, doe je het volgende:
Als je niet aan de bovenstaande vereisten voldoet,
Winkelcatalogi werken afhankelijk van hoe je je gegevensbron wilt toevoegen, van waaruit we toegang hebben tot je winkelcatalogus.
Als je de URL voor je gehoste gegevensbron verstrekt, hebben we dagelijks toegang tot je gegevensbron, zodat we dynamisch productpins kunnen maken voor elk product in je winkelcatalogus. Zorg ervoor dat je bijgewerkte gegevensbron elke dag beschikbaar is, zodat je productgegevens actueel zijn. Je kunt zelfs je gegevensopname vooraf inplannen.
Als je je gegevensbron handmatig uploadt, hebben we bij het uploaden toegang tot je gegevensbron, en telkens wanneer je een bijgewerkte gegevensbron uploadt, zodat we productpins kunnen maken, of de metagegevens voor bestaande pins kunnen bijwerken, voor elk product in je winkelcatalogus.
We zullen je op de hoogte stellen van eventuele fouten. Het is belangrijk om eventuele fouten zo snel mogelijk te onderzoeken en te verhelpen, zodat je productgegevens correct en actueel blijven. Fouten kunnen ertoe 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.
We kunnen tot 20 miljoen producten per winkelcatalogus verwerken. Neem
Dit is alleen relevant als je je gegevensbron host. Als je je gegevensbron handmatig uploadt, kun je deze sectie overslaan.
Host je eigen gegevensbron op een FTP-/SFTP-/WebDAV-server of met een directe HTTP-/HTTPS-downloadlink. Deze moet toegankelijk zijn voor een user-agent, en mag niet worden afgeschermd met een IP-adrescontrole of SSH-sleutel. Als je een directe downloadlink gebruikt, mogen er geen aanvullende stappen zijn vereist om het bestand te openen.
We ondersteunen de volgende indelingen:
| Door tabs gescheiden (TSV) | (TSV-voorbeeld downloaden) |
| Door komma's gescheiden (CSV) | (CSV-voorbeeld downloaden) |
| XML (RSS 2.0, ATOM 1.0) | (XML-voorbeeld downloaden) |
Wij accepteren gecomprimeerde bestanden (.zip, .giz, .gz, .bz2 en andere), maar we ondersteunen op dit moment geen versleutelde, met een wachtwoord beveiligde gecomprimeerde bestanden, Google Drive-bestanden of Dropbox-bestanden.
Je winkelcatalogus moet de volgende velden bevatten, precies zoals je ze ziet. Als ze ontbreken of een onjuiste indeling hebben, wordt je volledige winkelcatalogus niet verwerkt.
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
| id |
Unieke ID die het product vertegenwoordigt. |
Maximaal 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. | Maximaal 500 tekens. | Spijkerjasje voor dames, maat L |
| description | Beschrijving van het product. | Maximaal 10.000 tekens zonder tekst (geen HTML). | Casual spijkerjasje, gemaakt van de beste Japanse spijkerstof |
| link | Landingspagina voor het product (moet rechtstreeks naar hetzelfde product leiden en dezelfde gegevens laten zien) |
Tekenreeks (URL) Maximaal 511 tekens en de URL moet beginnen met http:// (we raden harde returns af). |
https://www.voorbeeld.com/cat/dameskleding/denimshirt-0294 |
| image_link |
Link naar de hoofdafbeelding van het product (ten minste 75x75 pixels, toegankelijk voor onze user-agent en geen sjabloon- of tijdelijke afbeeldingen). Als je de afbeelding later wijzigt, moet de nieuwe afbeelding een andere link hebben. Anders wordt de afbeelding niet bijgewerkt. |
Tekenreeks (URL) Maximaal 2000 tekens, te beginnen met http:// of https:// (komma's coderen of verwijderen). Aanbevolen: omsluit de tekenreeks met aanhalingstekens. |
https://scene.voorbeeld.com/afbeelding/afbeelding.jpg |
| price |
Prijs van het product (moet lager zijn dan de prijs en valuta in ISO-4217 opnemen als deze niet in Amerikaanse dollar is, anders wordt de standaardwaarde gebruikt in Amerikaanse dollar) |
<numeriek> <ISO 4217> Valuta kan vóór of na de numerieke prijswaarde komen, met of zonder spatie en volgt de ISO-4217-standaardcode. Gebruik geen 0-waarden of valutatekens. |
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 |
in stock |
| item_group_id (alleen verplicht als producten meerdere varianten hebben) | De ID van het hoofdproduct. | Maximaal 127 tekens | DS0294 |
Je kunt optionele velden aan je winkelcatalogus toevoegen zodat we je producten beter aan mensen kunnen koppelen. Hoe meer informatie je opgeeft, hoe relevanter je pins zullen zijn voor de mensen die ze zien. Bekijk hieronder meer over de optionele velden.
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
| product_type | De categorie van je product volgens je eigen producttaxonomie. |
Maximaal vijf subcategorieën, met een maximum van 1000 tekens, moeten worden gescheiden door > omhuld door spaties (andere scheidingstekens, zoals de komma of de verticale streep, worden niet herkend). |
Kleding > Dames > Shirts > Spijkerstof |
| additional_image_link |
Links naar maximaal 10 aanvullende afbeeldingen van je product (ten minste 75x75 pixels, toegankelijk door onze user-agent en geen sjabloon of tijdelijke afbeeldingen). 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. |
Maximaal 2000 tekens per stuk, te beginnen met http:// of https:// (komma's coderen of verwijderen). Aanbevolen: omsluit de tekenreeks met aanhalingstekens. |
"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 landingspagina. | Moet beginnen met http:// of https:// | https://m.voorbeeld.com/cat/dameskleding/denim-blouse-0294 |
| sale_price |
Kortingsprijs van het product (moet lager zijn dan de prijs en valuta in ISO-4217 opnemen als deze niet in Amerikaanse dollar is, anders wordt de standaardwaarde gebruikt in Amerikaanse dollar) Wanneer dit is opgegeven, wordt de aanbiedingsprijs beschouwd als de huidige prijs van het artikel. |
<numeriek> <ISO 4217> Valuta kan vóór of na de numerieke prijswaarde komen, met of zonder spatie en volgt de ISO-4217-standaardcode. Gebruik geen 0-waarden of valutatekens. |
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. |
<numeriek> Tussen 1 en 5 |
5 |
| number_of_ratings | Het aantal beoordelingen voor het product. | <numeriek> | 2 |
| number_of_reviews | Aantal beoordelingen van het product. | <numeriek> | 4 |
| 'description_html' |
De HTML-beschrijving van het product. Aanbevolen: gebruik dit als je beschrijving langer is dan 200 tekens. Als dit veld is opgegeven, gebruiken we het in plaats van het vereiste beschrijvingsveld. |
HTML-indeling | <body> <h1><> Mijn product</h1> <p>Nu kopen</p> </body> |
| video_link |
Gehoste link naar de productvideo. Het bestandstype voor gekoppelde video's moet .mp4, .mov of .m4v zijn. Bestanden mogen niet groter zijn dan 2 GB. Opmerking: het kan tot een week duren voordat alle geüploade video's zijn verwerkt en gemaakt. |
Tekenreeks (URL) Maximaal 2000 tekens, te beginnen met http:// of https:// |
https://www.example.com/example.mp4 |
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
| item_group_id | De ID van het hoofdproduct. | Maximaal 127 tekens | DS0294 |
|
brand |
Het merk van het product. | Maximaal 100 tekens | Josie’s Denim |
| gtin | De unieke universele product-ID. | Numeriek volgens de GTIN-richtlijnen | 3234567890126 |
| mpn | Onderdeelnummer van de fabrikant van het product |
Maximaal 70 alfanumerieke tekens |
"mpn": "PI12345NTEREST" |
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
|
color |
De primaire kleur van het product. | Maximaal 30 tekens. | blue |
| gender | Het gender dat wordt geassocieerd met het product. | Moet een van de volgende waarden zijn: 'male' 'female' 'unisex' |
male |
| age_group | Het gender dat wordt geassocieerd met het product. |
Moet een van de volgende waarden zijn: newborn |
newborn |
| material | Het materiaal waarvan het product is gemaakt. | Maximaal 30 tekens. | cotton |
| pattern | Het patroon dat is gebruikt voor het product. | Maximaal 30 tekens. | plaid |
| size | De maat van het product. | Maximaal 30 tekens. | M |
| size_type | Aanvullende beschrijving voor de grootte van het product. |
Moet een van de volgende waarden zijn: regular |
regular |
| size_system | Van welk land het maatsysteem wordt gebruikt. | Landcode |
VS |
| alt_text | Beschrijving van wat er in de hoofdafbeeldingen van het product verschijnt. | Een of meerdere alt-tekstwaarden, gescheiden door komma's. Het aantal alt-tekstwaarden moet overeenkomen met het aantal afbeeldingen in je image_link-veld. Komma's moeten worden gecodeerd als , of worden verwijderd als ze deel uitmaken van de alt-tekst. Komma's moeten worden gebruikt om meerdere alt-teksten te scheiden. | Een lichtblauw gehaakt babymutsje met kwastjes |
| variant_names | Opties voor deze variant van het product (mensen op Pinterest zien deze opties naast je pin en kunnen de gewenste pin selecteren). | Teksten gescheiden door komma's in de volgorde die je wilt weergeven. | Kleur,Maat |
| variant_values | Waardeopties voor deze variant van het product (mensen op Pinterest zien deze opties naast je pin en kunnen de gewenste pin selecteren). |
Teksten gescheiden door komma's in de volgorde die je wilt weergeven. Moet in overeenstemming zijn met de volgorde van het veld variant_names. |
Rood,S |
| adult | Of het een pornoproduct is of niet. Pornoproducten worden niet weergegeven op Pinterest. |
Moet een van de volgende waarden zijn: TRUE |
false |
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
| tax | Btw-gegevens voor het product |
De btw-gegevens bestaan uit één groep met een tot vier elementen: country, region, rate (alle drie verplicht) en tax_ship (optioneel). Alle dubbele punten zijn verplicht, zelfs voor lege waarden. country:region:rate(required):tax_ship |
US:1025433:6.00:y |
| shipping | Verzendgegevens van het product |
De verzendgegevens bestaan uit één groep met een tot vier elementen: country, region, service (alle drie optioneel) en price (verplicht). Alle dubbele punten zijn verplicht, zelfs voor lege waarden. country:region:service:price(required) |
US::Express:13.12 |
|
shipping_weight |
Het gewicht van het product. |
<numeriek> <eenheid> Zorg ervoor dat er een spatie tussen de numerieke waarde en de eenheid zit. |
5 lbs |
| shipping_width | De breedte van de verpakking die nodig is om het product te verzenden. |
<numeriek> <eenheid> Zorg ervoor dat er een spatie tussen de numerieke waarde en de eenheid zit. |
16 in |
| shipping_height | De hoogte van de verpakking die nodig is om dit product te verzenden. |
<numeriek> <eenheid> Zorg ervoor dat er een spatie tussen de numerieke waarde en de eenheid zit. |
12 in |
| free_shipping_label |
Of je wel of niet gratis verzending voor het product aanbiedt. Vul 0 in het veld 'free_shipping_limit' in 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. |
Moet een van de volgende waarden zijn: TRUE |
true |
| free_shipping_limit | Minimale bestelling vereist om gratis verzending van het product te krijgen. |
<numeriek> <ISO 4217> |
35USD |
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
| custom_label_0 | Aangepaste groepering van producten (maximaal vijf) | Maximaal 200 tekens |
Zomeraanbiedingen |
| custom_label_1 | Aangepaste groepering van producten (maximaal vijf) | Maximaal 200 tekens | Bestsellers |
| custom_label_2 | Aangepaste groepering van producten (maximaal vijf) | Maximaal 200 tekens | Nieuwe producten |
| custom_label_3 | Aangepaste groepering van producten (maximaal vijf) | Maximaal 200 tekens | In de aanbieding |
| custom_label_4 | Aangepaste groepering van producten (maximaal vijf) | Maximaal 200 tekens | Halve prijs |
| Kolomnaam | Beschrijving | Syntaxis / ondersteunde waarden | Voorbeeld |
|---|---|---|---|
| ad_link | Link die kan worden gebruikt om verkeer te volgen dat afkomstig is van Pinterest-winkeladvertenties. |
Tekenreeks (URL) Je moet een volledige URL inclusief trackingparameters opgeven, niet alleen de trackingparameters. Impressietracking wordt op dit moment niet ondersteund. Moet beginnen met http:// of https:// |
https://www.voorbeeld.com/cat/spijkerjack/item012?utm_source=Pinterest |
| condition | De staat van het product. |
Moet een van de volgende waarden zijn: new |
new |
| google_product_category | De categorie volgens de gestandaardiseerde Google-producttaxonomie. |
Bekijk de volledige taxonomie in het Engels. Ga naar het Helpcentrum van Google voor toegang tot taxonomieën voor andere talen. Zowel tekstwaarden als numerieke codes worden geaccepteerd. |
Apparel & Accessories > Clothing > Shirts & Tops 21 |
Zorg ervoor dat je voldoet aan onze
Meer informatie over het