ChatGPT Shopping productfeeds: instellen met Koongo

Uw klanten zijn begonnen ChatGPT te vragen wat ze moeten kopen. “Een handbagage rugzak die onder de stoel past,” “een stille ventilator voor een kleine slaapkamer,” en de assistent kan antwoorden met echte producten: afbeeldingen, prijzen en een link naar een winkel. Nauwkeurige productgegevens helpen ChatGPT te begrijpen wat u verkoopt, en een productfeed is de gestructureerde manier om deze aan te leveren. Het indienen van een feed garandeert niet dat uw producten in een bepaald antwoord verschijnen, maar zonder feed heeft ChatGPT niets betrouwbaars om mee te werken.

Een productfeed is een gestructureerd bestand dat uw producten en hun gegevens (titel, prijs, beschikbaarheid, afbeeldingen en meer) vermeldt in het formaat dat een kanaal verwacht. Voor ChatGPT is dat het eigen formaat van OpenAI. U kunt mogelijk uitgaan van de Google Shopping-feed die u al heeft: OpenAI accepteert zijn eigen formaat, en voor bevestigde integraties kan het ook een Google-compatibele feed accepteren. De eerste vraag is welke van deze opties van toepassing is op uw configuratie. Deze gids doorloopt zowel de vereisten als het voorbereiden van het bestand met Koongo.

Voordat u begint. Het uploaden van een productfeed naar OpenAI is momenteel alleen mogelijk voor goedgekeurde partners en geregistreerde integraties, en de beschikbaarheid van betaalde ChatGPT Ads hangt af van uw markt en account. Controleer of het kanaal beschikbaar is voor uw account en doelmarkten voordat u tijd investeert in de feed. Deze gids richt zich op de CSV-productfeed en behandelt niet het uitvoeren van betaalde campagnes.

In deze gids

• Wat deze gids behandelt
• Waarom nauwkeurige productfeeds belangrijk zijn
• Discovery, Ads en checkout: drie verschillende zaken
• Hoe u uw ChatGPT-productfeed instelt met Koongo
• De vereiste velden en een feed-voorbeeld
• Varianten, prijsstelling en andere technische details
• Levering, updates en foutafhandeling
• Checklist voor lancering
• Veelgestelde vragen

Wat deze gids behandelt

ChatGPT toont producten in de antwoorden op winkelgerelateerde vragen. Sommige plaatsingen zijn organisch; andere zijn betaald. Beide maken gebruik van dezelfde onderliggende productgegevens, en beide sturen de shopper naar uw eigen winkel om de aankoop te voltooien.

Hoe ChatGPT Shopping werkt: een shopper stelt een vraag, ChatGPT kan producten aanbevelen, en de shopper klikt door naar uw eigen winkel.

Deze gids behandelt wat het feedbestand moet bevatten, van hoe een prijs wordt geschreven en hoe een variant wordt gegroepeerd, tot hoe u dit voorbereidt en levert met Koongo, en hoe u controleert of het is verwerkt. Het behandelt niet het instellen van of bieden op betaalde campagnes; dit gebeurt in de Ads Manager van OpenAI.

Waarom nauwkeurige productfeeds belangrijk zijn

Een door de verkoper geleverde feed geeft OpenAI rechtstreeks gestructureerde gegevens over uw catalogus, in plaats van de assistent deze zelf te laten samenstellen. De feed fungeert als de enige bron van waarheid voor uw productgegevens: titels, beschrijvingen, huidige prijs, voorraad en beschikbaarheid, merk en identificatiegegevens.

Wat een productfeed aan OpenAI geeft: gestructureerde, nauwkeurige gegevens over wat u verkoopt.

Daarom is de specificatie veeleisend wat betreft nauwkeurigheid, identiteit van de verkoper, retourzendingen en levering. De assistent leest uw gegevens, de shopper klikt door, en u sluit de verkoop in uw eigen checkout. Wat u verstrekt is een volledige, nauwkeurige catalogus in exact de vorm die OpenAI vraagt.

Discovery, Ads en checkout: drie verschillende zaken

Het is verleidelijk om te denken dat één correct voorbereid bestand alles tegelijk inschakelt. Dat is niet zo. OpenAI behandelt discovery, Ads en checkout als afzonderlijke lagen, elk met eigen toegang, geschiktheid en vereisten. U begint met discovery-gegevens en voegt vervolgens toe wat elke verdere integratie nodig heeft. (OpenAI productfeed-specificatie.)

Discovery en betaalde advertenties maken gebruik van dezelfde feed, maar hebben afzonderlijke toegang en vereisten.

Discovery (organisch). ChatGPT kan uw producten in antwoorden tonen op basis van relevantie en gegevenskwaliteit. Dit is de basislaag: een geldige discovery-feed in het formaat van OpenAI.

Ads (betaald). Betaalde productfeed-campagnes lopen via Ads Manager op basis van een schema dat lijkt op Google Merchant Center. Het systeem bouwt gesponsorde producteenheden op basis van uw feed, maar voor elk product dat u wilt promoten moet de vlag voor Ads-geschiktheid zijn ingesteld, en campagnes hebben hun eigen toegang en configuratie. Een geldige discovery-feed is een vereiste, geen betaalde campagne op zich.

Checkout. Als u aankopen binnen ChatGPT inschakelt, voegt dat extra vereiste velden en beleids-URL’s toe bovenop discovery. Dit is wederom een afzonderlijke integratie.

Het voorbereiden van een geldige feed is een belangrijke stap. Of uw producten vervolgens organisch verschijnen, als advertenties worden weergegeven of in-chat checkout ondersteunen, hangt af van deze afzonderlijke lagen.

Hoe u uw ChatGPT-productfeed instelt met Koongo

Koongo’s Feed Manager bouwt en ververst productfeeds voor meer dan 500 kanalen vanuit één kopie van uw catalogus, zodat u geen kolommen hoeft te hernoemen of handmatig een CSV hoeft te bouwen. Het koppelt uw winkelgegevens aan de veldnamen van OpenAI, transformeert waarden met de Rules Editor (Koongo’s no-code tool voor het herstructureren van productgegevens), houdt identificatiegegevens intact als tekst en formatteert prijzen met de juiste precisie per valuta.

Hoe Koongo uw productgegevens voorbereidt als een ChatGPT-klare feed.

Op hoofdlijnen ziet het instellen van de feed er als volgt uit:

1. Verbind uw winkel. Koppel uw platform, bijvoorbeeld Shopify of WooCommerce, zodat Koongo uw catalogus kan lezen.
2. Kies het feed-sjabloon. Selecteer het ChatGPT-productfeed-sjabloon.
3. Koppel uw velden. Koppel uw winkelgegevens aan de veldnamen van OpenAI en gebruik de Rules Editor om waarden in te vullen of af te leiden waar uw brongegevens onvolledig zijn.
4. Controleer de export. Controleer het gegenereerde bestand aan de hand van de vereiste velden en het prijsformaat voordat u het levert.
5. Lever de feed. Lever het bestand aan OpenAI via uw goedgekeurde onboarding-methode (SFTP, bestandsupload of een gehoste URL).
6. Bevestig de verwerking. Bevestig na levering of de feed is geaccepteerd en let op fouten tijdens de eerste runs.

Om duidelijk te zijn over de reikwijdte: Koongo genereert en ververst het feedbestand. Het voert uw ChatGPT-campagnes niet uit, stelt geen biedingen in en beheert geen budgetten. Omdat dit een feed-integratie is, worden er geen bestellingen geïmporteerd. Uw bestaande checkout handelt de verkoop af.

De vereiste velden en een feed-voorbeeld

Dit is het gedeelte dat het waard is om twee keer te lezen, want dit is waar uploads vaak mislukken. De feed van OpenAI is een plat bestand, één rij per product of variant, UTF-8 gecodeerd. Zelfs velden die u al heeft, moeten worden hernoemd naar de namen van OpenAI. Een discovery-feed vereist deze negen velden op elke rij. (OpenAI productfeed-specificatie.)

OpenAI-veld	Wat het bevat
item_id	Een stabiel, uniek ID per item of variant, nooit hergebruikt voor een ander item
title	Productnaam (tot 150 tekens), inclusief de variant indien relevant
description	Een feitelijke productbeschrijving in platte tekst (tot 5.000 tekens)
url	De link naar de productpagina, met de geselecteerde variant waar mogelijk
brand	Het productmerk zoals getoond op de pagina (tot 70 tekens)
seller_name	De naam van de verkoper die het aanbod levert, een echte naam, geen tijdelijke aanduiding
image_url	Een directe URL naar de hoofdafbeelding van het product (JPEG of PNG, HTTPS bij voorkeur)
availability	Een van de vijf exacte waarden (hieronder)
price	Bedrag met de valuta in de waarde

De negen vereiste discovery-velden in een OpenAI-productfeed. Prijs bevat de valuta binnen de waarde.

Ondersteunde formaten. De bestandsupload-configuratie van OpenAI geeft de voorkeur aan Parquet en ondersteunt ook gecomprimeerde JSONL, CSV en TSV. Het gebruikt geen XML. Deze gids richt zich op CSV. (OpenAI feed-levering overzicht.)

De vijf beschikbaarheidswaarden

availability moet exact één van de volgende zijn: in_stock, out_of_stock, pre_order, backorder of unknown. Een weggelaten, lege of verkeerd gespelde waarde leidt tot afwijzing van de rij. Gebruik unknown expliciet wanneer u het echt niet weet; het betekent niet “op voorraad”. Let op de underscore in pre_order: het Google-compatibele pad spelt het als preorder en accepteert unknown niet, dus de juiste spelling hangt af van het formaat dat u uploadt.

CSV-mechanismen die feeds stilletjes kapotmaken

Omdat dit een CSV-integratie is, zijn deze formateringsregels van belang:

• Plaats elke cel tussen aanhalingstekens die een komma, aanhalingsteken of nieuwe regel bevat, en verdubbel elk ingebed aanhalingsteken. Titels en beschrijvingen bevatten bijna altijd komma’s, dus deze moeten tussen aanhalingstekens staan.
• Houd identificatiegegevens als strings zodat voorloopnullen behouden blijven. Een GTIN zoals 09506000134352 verliest zijn voorloopnul zodra een spreadsheet het als een getal behandelt.
• Meerdere afbeeldingen gaan in één cel als een door komma’s gescheiden lijst; als een URL een komma bevat, codeer deze dan als %2C.
• Een JSON-waarde in een CSV-cel, zoals variant_dict, wordt geserialiseerd als JSON en vervolgens tussen aanhalingstekens geplaatst, zodat de dubbele aanhalingstekens er als volgt uitzien: „{„”color””:””Slate blue””,””size””:””750 ml””}”.

Een minimaal, geldig voorbeeld met twee varianten en de vereiste velden:

item_id,group_id,listing_has_variations,variant_dict,title,description,url,brand,seller_name,image_url,availability,price
BTL-SLATE-750,BTL-INS,true,”{„”color””:””Slate blue””,””size””:””750 ml””}”,”Larkmont geïsoleerde waterfles, 750 ml, leiblauw”,”Dubbelwandige roestvrijstalen fles die dranken 24 uur koud houdt.”,https://example.com/insulated-bottle?c=slate&s=750,Larkmont,Larkmont Supply,https://example.com/img/bottle-slate.jpg,in_stock,29.00 EUR
BTL-SAND-750,BTL-INS,true,”{„”color””:””Zand””,””size””:””750 ml””}”,”Larkmont geïsoleerde waterfles, 750 ml, zand”,”Dubbelwandige roestvrijstalen fles die dranken 24 uur koud houdt.”,https://example.com/insulated-bottle?c=sand&s=750,Larkmont,Larkmont Supply,https://example.com/img/bottle-sand.jpg,out_of_stock,29.00 EUR

Varianten, prijsstelling en andere technische details

Varianten: group_id, en één rij per optie

U stuurt een afzonderlijke rij voor elke variant, één voor elke kleur en maat, met een eigen item_id, prijs, beschikbaarheid, URL en afbeelding. U koppelt ze aan elkaar met drie velden:

• group_id: een stabiel ID van de bovenliggende vermelding dat wordt gedeeld door elke variant van hetzelfde product. Het moet verschillen van elk item_id.
• listing_has_variations: ingesteld op true voor elke variantrij.
• variant_dict: een kleine map van de geselecteerde opties, bijvoorbeeld {„color”:”Slate blue”,”size”:”750 ml”}.

Houd de optienamen consistent binnen een groep (“color” overal, niet “colour” op sommige rijen), en houd elk item_id, group_id en elk offer_id stabiel, zelfs als de prijs of voorraad verandert. Eén regel om te onthouden: zet de prijs nooit in een offer_id.

Varianten groeperen met een gedeeld group_id, één rij per optie.

Het prijsveld

De prijs wordt geschreven als een bedrag, een spatie en een drieletterige ISO 4217-valutacode in hoofdletters, bijvoorbeeld 29.00 EUR. Gebruik een punt als decimaalteken, geen duizendtallen-scheidingstekens en geen exponentiële notatie: 1299.00 EUR, nooit 1.299 EUR. De specificatie is duidelijk dat 79.99 USD 79 dollar en 99 cent betekent, dus laat de decimalen niet weg. Valideer het prijsformaat vóór het uploaden, omdat een onjuiste koprij of valutanotatie een veelvoorkomende reden is waarom een hergebruikte Google-export wordt geweigerd.

Voeg voor een korting sale_price toe in dezelfde valuta, groter dan nul en strikt lager dan price. Een aanbiedingsprijs die gelijk is aan, hoger dan of in een andere valuta is dan de normale prijs, wordt genegeerd zonder foutmelding en zonder dat de korting wordt getoond.

Identificatiegegevens: GTIN-regels die worden gecontroleerd

Een GTIN, EAN of MPN met het merk is het sterkste identiteitssignaal dat u kunt sturen. Als u een GTIN opgeeft, moet deze exact 8, 12, 13 of 14 cijfers bevatten met een geldig controlegetal, met behoud van voorloopnullen en zonder spaties of scheidingstekens. Een UPC-A is een 12-cijferige GTIN; een ISBN-13 kan worden ingevoerd als een 13-cijferige GTIN, maar een ISBN-10 niet. Verzin geen MPN ter vervanging van een ontbrekende GTIN; laat de identificatiecode in dat geval weg.

Extra velden voor discovery, Ads en checkout

Naast de negen vereiste discovery-velden definieert OpenAI verdere velden. Welke u nodig heeft, hangt af van de laag die u instelt:

• Optionele discovery-details. Velden zoals extra afbeeldingen en retourinformatie (een URL voor het retourbeleid en een retourtermijn in dagen) zijn optioneel voor discovery, maar het is de moeite waard ze op te nemen als u ze heeft, zodat ChatGPT vragen kan beantwoorden als “is het makkelijk te retourneren?”
• Geschiktheidsvlaggen. is_eligible_search en is_eligible_checkout bepalen of een product vindbaar of koopbaar is; geschiktheid voor checkout is alleen van toepassing als search ook is ingeschakeld.
• Ads. Voor betaalde campagnes is is_ads_eligible voorwaardelijk vereist: stel dit in op true voor elk product dat Ads moet verwerken. (Gids voor Ads-productfeeds.)
• Checkout. Het inschakelen van aankopen binnen ChatGPT voegt vereiste beleids-URL’s toe (privacybeleid en servicevoorwaarden via HTTPS) bovenop discovery.

Waarom andere gidsen verschillende veldnamen vermelden: de hernoemingen in de bèta

Als twee handleidingen het niet eens zijn over veldnamen, dan is dit de reden. OpenAI heeft tijdens de bèta verschillende velden hernoemd. De oude namen werken nog steeds als aliassen, maar stuur slechts één naam per waarde, waarbij de huidige naam voorrang heeft:

Oude naam (nog steeds geaccepteerd)	Huidige naam
id of sku	item_id
item_group_id	group_id
enable_search	is_eligible_search
enable_checkout	is_eligible_checkout
is_eligible_ads	is_ads_eligible
return_window	return_deadline_in_days

OpenAI’s bèta-veldhernoemingen: oude namen werken nog steeds als aliassen, maar de huidige namen hebben voorrang.

Zorg dat uw bestand overeenkomt met de versie van de specificatie die van kracht is wanneer u het bouwt, en meng geen oude naam met zijn vervanger in dezelfde feed.

Een opmerking voor Europese verkopers: de standaardmarkt

De standaard OpenAI-upload richt zich op één enkele standaardmarkt, tenzij verwerking voor meerdere landen is bevestigd voor uw integratie. Landkolommen op rijniveau veranderen dat op zichzelf niet. Een Europese handelaar kan dus niet simpelweg een target_countries-kolom toevoegen en verwachten Nederland te bedienen. Bevestig uw toegestane landen en valuta’s tijdens de onboarding voordat u een markt om hen heen plant.

Wat een sterke feed maakt

Dit zijn geen garanties voor zichtbaarheid, maar ze geven ChatGPT nauwkeurige, specifieke gegevens om mee te werken en ze houden uw bestand geldig.

Sterke feedgegevens versus veelvoorkomende feedfouten.

• Titels volgens het patroon dat shoppers gebruiken: merk, product, belangrijk kenmerk, variant. “Larkmont geïsoleerde waterfles, 750 ml, leiblauw” leest beter dan “Larkmont waterfles, gratis verzending!”
• Beschrijvingen die feitelijk en volledig zijn: materialen, afmetingen, compatibiliteit en wat er in de doos zit.
• Prijs en beschikbaarheid die overeenkomen met de landingspagina op het moment dat een shopper arriveert.
• Correcte variantgroepering en een duidelijke hoofdafbeelding, plus extra hoeken waar u die heeft.

Veelvoorkomende redenen waarom feeds worden afgewezen: kolomnamen die niet van OpenAI zijn, ontbrekende vereiste velden, een prijs zonder valutacode of met onjuiste getallen, ongeldige afbeelding- of product-URL’s, niet-unieke item_id-waarden, en prijs of beschikbaarheid die niet overeenkomt met de live productpagina.

Levering, updates en foutafhandeling

U plakt geen openbare feed-URL in een formulier. Onboarding is momenteel open voor goedgekeurde partners, en u levert het bestand via SFTP, bestandsupload of een gehoste URL, afhankelijk van uw configuratie. Items worden behandeld als bederfelijk, dus de feed moet worden ververst.

Koongo ververst uw feed volgens een schema; OpenAI neemt deze als een afzonderlijke stap op.

Twee afzonderlijke stappen zijn hier van belang. Koongo kan uw feedbestand volgens een schema verversen (vaker bij betaalde abonnementen, eenmaal per dag bij het gratis abonnement), waardoor het bestand dat u levert actueel blijft met uw winkel. OpenAI neemt dat bestand vervolgens aan hun kant op, wat een afzonderlijke stap is en niet onmiddellijk gebeurt. Met andere woorden, vaker verversen in Koongo houdt uw kant up-to-date, maar hoe snel een wijziging ChatGPT bereikt, hangt ook af van de opname door OpenAI.

Een stukje goed nieuws over fouten: een enkele onjuist geformatteerde rij kan worden afgewezen terwijl de rest van uw geldige rijen gewoon wordt verwerkt. De uploadgeschiedenis vertelt u welke kolommen of waarden zijn mislukt, zodat u het specifieke probleem kunt oplossen in plaats van het hele bestand.

Checklist voor lancering

1. Bevestig toegang. Controleer of het kanaal beschikbaar is voor uw account en doelmarkten.
2. Bouw het bestand volgens de specificaties van OpenAI: juiste kolomnamen, valuta binnen de prijs, één rij per variant.
3. Vul de velden in die uw laag nodig heeft: de negen discovery-velden, plus Ads- of checkout-velden als u die instelt.
4. Vul uw identificatiegegevens aan: een geldige GTIN of MPN, plus merk, waar mogelijk.
5. Schrijf titels en beschrijvingen als feiten. Verwijder promotionele taal; voeg de kenmerken toe die iemand hardop zou zeggen.
6. Valideer prijs- en voorraadgelijkheid tussen feed en productpagina.
7. Lever en bevestig de verwerking, en controleer vervolgens de eerste runs op fouten.
8. Voorzie uw links van UTM-parameters zodat sessies afkomstig van ChatGPT herkenbaar zijn in de statistieken.

Veelgestelde vragen

Wat is een ChatGPT Shopping-feed?

Een ChatGPT Shopping-feed is een gestructureerd productbestand dat uw catalogus vermeldt in het door OpenAI vereiste formaat, zodat ChatGPT nauwkeurige gegevens over uw producten kan gebruiken en shoppers naar uw winkel kan leiden. Het gebruikt OpenAI’s eigen kolomnamen en vereiste velden, die verschillen van een Google Shopping-feed.

Kan ik mijn Google Shopping-feed gebruiken voor ChatGPT?

Mogelijk, als startpunt. OpenAI ondersteunt zijn eigen formaat, en voor bevestigde integraties kan het ook een Google-compatibele feed accepteren en de ondersteunde velden zelf koppelen. Welke optie van toepassing is, hangt af van uw geregistreerde configuratie, dus controleer dat eerst in plaats van ervan uit te gaan dat een bestaande export ongewijzigd zal werken. Koongo kan de feed voor u genereren in de eigen structuur van OpenAI.

Garandeert het indienen van een feed dat mijn producten in ChatGPT verschijnen?

Nee. Een geldige feed geeft ChatGPT nauwkeurige gegevens om mee te werken, maar het garandeert niet dat uw producten in een bepaald antwoord of advertentieplaatsing verschijnen. Organische discovery, betaalde Ads en checkout zijn afzonderlijke lagen met hun eigen geschiktheid en vereisten.

Hoe schrijf ik de prijs in een OpenAI-productfeed?

Als een bedrag, een spatie en een drieletterige ISO 4217-valutacode, bijvoorbeeld 29.00 EUR. Gebruik een punt als decimaalteken, geen duizendtallen-scheidingstekens en het juiste aantal decimalen voor de valuta. Een aanbiedingsprijs moet in dezelfde valuta zijn en strikt lager dan de normale prijs, anders wordt deze genegeerd.

Hoe worden productvarianten afgehandeld?

Stuur één rij per variant, elk met een eigen item_id, prijs en voorraad. Koppel ze aan elkaar met een gedeeld group_id (verschillend van elk item_id), stel listing_has_variations in op true en vermeld de geselecteerde opties in variant_dict, bijvoorbeeld {„color”:”Slate blue”,”size”:”750 ml”}. Houd de optienamen consistent binnen de groep.

Wat gebeurt er als ik een product uit mijn feed verwijder?

Het wordt niet noodzakelijkerwijs direct uit ChatGPT verwijderd. Voor de gedocumenteerde snapshot-upload wordt een rij die u verwijdert niet onmiddellijk gewist; het laatst verwerkte record kan tot 14 dagen blijven bestaan. Om een product snel te verwijderen, dient u de verwijderingsopties te volgen die uw integratie ondersteunt, in plaats van alleen de rij weg te laten.

Importeert Koongo bestellingen uit ChatGPT?

Nee. De hier beschreven Koongo-integratie genereert en ververst uw productfeed; deze importeert geen bestellingen. ChatGPT Shopping stuurt de shopper naar uw eigen site om te kopen, dus bestellingen worden afgehandeld door uw bestaande checkout, net als bij elk ander feedkanaal.

Heb ik een betaald Koongo-abonnement nodig om een ChatGPT-feed te maken?

Feed Manager is inbegrepen in elk Koongo-abonnement, inclusief het gratis abonnement. Betaalde abonnementen verversen uw feedbestand vaker, waardoor uw kant actueel blijft; hoe snel een wijziging vervolgens ChatGPT bereikt, hangt ook af van de eigen opname door OpenAI. Zie de Koongo prijzenpagina voor de huidige abonnementen.

Aan de slag

ChatGPT Shopping is een nieuwe manier voor klanten om producten te vinden. Deelname is een proces, geen schakelaar: bevestig dat het kanaal beschikbaar is voor uw account en markten, bereid een geldige feed voor in het formaat van OpenAI, lever deze en monitor hoe deze na de lancering wordt verwerkt. Koongo helpt bij het gedeelte waar u de meeste directe controle over heeft: het produceren en verversen van een correct gestructureerde feed vanuit uw bestaande catalogus.

Klaar om uw feed voor te bereiden? Begin met Koongo’s Feed Manager. Er is een gratis abonnement beschikbaar zonder dat een creditcard vereist is, en betaalde abonnementen beginnen vanaf €24/maand met een gratis proefperiode van 7 dagen.

Continue reading →