Technical Documentation – Kleinanzeigen

Content


Purpose

The purpose of this document is to assist Kleinanzeigen Advertising Partners during the Technical Onboarding phase and post technical onboarding. It serves as a guide in feed set-up and management.


Getting Started

  • Step 1: Set up your feed.

  • Step 2: Access essential resources.

  • Step 3: Familiarize yourself with the Retail Media Advertising platform.


Introduction

Dear Valued Customer,

Congratulations on choosing Kleinanzeigen. We are thrilled to partner with you and assist you in showcasing your products to our extensive network of users. This guide will help you import product feeds into our Ad Server quickly and efficiently.

CSV Feed: Kleinanzeigen recommends using CSV format for flexibility and simplicity. Step-by-step instructions are included below.


Feed Schema

Mandatory Fields

  • Title: ≤ 120 characters

  • Description: ≤ 500 characters

  • Vendor_ID: unique product/ad identifier

  • Category_ID: Kleinanzeigen category ID or Google Product Category

  • Price: in euro (for job category, price = 0)

  • Image URL: valid URL

  • Product URL: valid http(s) link

Feed fieldsDefinitionMandatory?Requirementsexample
SKUStock Keeping Unit is the article number in the shop. It is usually on product level, a unique identifier assigned to a product by a vendor, distributor, or manufacturer for inventory tracking purposesOptionalText, freely selectable shop specific ID.123456
MPNHAN (Manufacturer’s Article Number) is a unique identification number assigned by manufacturers to identify their own products within the company and along the supply chain. These numbers help in differentiating between similar products made by the same manufacturer. Auf Deutsch: HAN (Hersteller-Artikelnummer)OptionalTextDMC-TZ10EB-K
GTINGlobal Trade Item Number is a standardized identifier used globally to identify trade items.OptionalOptional but improves product matching.4029011568541
Ad_Group_IDIndicates an ad is a variant of a certain product (e.g., a shirt in multiple sizes, colors or patterns). This can help recommend and show similar items to a user interested in products who have the same parentOptionalThe Ad_Group_ID is the parent ID of several ads in the same group. The Ad_Group_ID can contain up to 50 alphanumeric characters, including underscores and dashes.Tshirt_camel_232435
Vendor_Ad_IDAn ad identifier defined by the advertiser and used to track feed & ad changes.MandatoryMust be unique for the advertiser.iphone-c-2312482
TitleThe main name of the product, displayed to users and search engines.MandatoryText (no html), within the 120-character limit.Canada Goose Carson down-jacket men, navy blue
DescriptionA detailed product description that is used by the algorithm to decide which ads to show when. It might also be shown to users on the Advertising Detail PageMandatoryText (no html), within the 500 character limit.Digital Camera EOS D5300 with 24 MP and optical Image stabilization, including telephoto lens
Google_Category_IDThe category identifying number according to Google’s taxonomy.Optionalmust match Google Merchant Center’s predefined taxonomy.7385
Google_Category_PathThe category path according to Google’s taxonomy.Optionalmust match Google Merchant Center’s predefined taxonomy. Can be in English or in GermanAnimals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories
KA_Category_IDNumber corresponding to a category, see the tab belowMandatorymust match with a KA category ID102
Product_TypeCustom product categorization defined by the advertiser.Optionalflexibly defined by the advertiser who can direct ads to campaigns based on this parameter + might be relevant for searchHaus>Staubsauger>Staubsauger unter 50€
MaterialThe fabric or material of the product, improving relevancy in search and categorization.Optionaltext fieldcotton
ColorThe product’s primary color, especially for visually distinct items like apparel.Optionaltext fieldred
SizeThe product’s dimensions or measurements, critical for apparel and hardware.OptionalRestrictions: Non-empty string with a maximum of 100 characters.medium
GenderIndicates the target gender audience (e.g., unisex, male, female).OptionalRestrictions: Allowed values are male, female, unisexunisex
Age_GroupIndicates the target age ranges (e.g., toddlers, adults).Optionaltext field. recommended values: newborn, infant, toddler, kids, adultadult
BrandIdentifies the product’s brand to help users and improve search relevance.OptionalMandatory for most categories. For your own brands, please provide us with the shop name.Samsung
Product_URLURL directing to the product page.MandatoryURL, must be valid and accessible. Cannot contain characters not permitted by URL standards (e.g. spaces, >, <,…) & should be % encoded.www.myshop.de/s10
Image_URL1 or more URLs linking to minimum 1 product image. Provides various product views to improve user confidence and conversion rates.MandatoryA list of comma separated image URLs for the ad. Cannot contain characters not permitted by URL standards (e.g. spaces, >, <,…) & should be % encoded. The first one will be the main picture. Ideally use standard web formats up to 3MB. The quality of the images has an influence on the search ranking; images with a white background have a higher ranking. If you’re submitting a URL that contains a comma, make sure that comma is encoded (as %2C). Guidance & examples on how to include multiple URLs. Supported formats: JPEG, PNG, GIF, WebP, HEIF, TIFF, SVG Ideal image format: 2x3. Your image gets resized to fit the ad slot.https://myshop.de/philips-hue-weiss-und-farbig2%2C3.jpg, https://myshop.de/philips-hue-weiss-und-farbig-12.jpg
ConditionThe condition of the product (e.g., new, B-Ware, refurbished, used). Tags are translated to german (e.g. “erneuert”)OptionalDefined labels based on platform standards: new, B-Ware, refurbished, used. This is translated in ad rendering: new = neu, B-Ware = B-Ware, refurbished = erneuert, used = gebrauchtrefurbished
Condition_GradeState the article is in. Used in combination with “condition Type”.It dependswhen the condition ≠ new. Accepted values: excellent, very good, good, acceptableexcellent
Energy_EfficiencyDisplays the product’s energy efficiency to meet regulations and user expectations.OptionalAllowed values: A+++, A++, A+, A, B, C, B, E, F, GA++
WarrantyInformation about product warranty, acting as a conversion driver.OptionalText; Optional; must be clearly stated if provided.2 Jahre Garantie inklusive!
AvailabilityStatus of the product’s availability, which enables advertisers to filter their campaigns to only contain products in stock or search & kevel to filter out products that are out of stock.OptionalOptional; Allowed values: in_stock, out_of_stock, preorder, backorder. Default value: in_stockin_stock
Custom_LabelsAdditional tags or labels defined by the advertiser. could be used for advanced campaign segmentation.OptionalOptional; textBio-Baumwolle
Offer_PriceCurrent selling price of the product in Euro.It dependsMandatory, unless KA_category_ID=102,118,111,114,110,107,105,125,123,247,117,109,297,288,289,290,291,292,293,294,295,296,298. If not part of these categories, cannot be null or empty. Please provide the price including VAT. The decimal separator has to be the same for all prices (shipping and handling costs, etc.). Please provide the price in Euros without a currency sign.177.99
Original_PriceThe strike-through price or the original price, showcasing discounts in Euro.OptionalOptional, structured as the “original price.”288.99
Unit_Pricing_MeasureDefines the measure and dimension of the item. That value helps buyers to understand the exact price per unit for your item. Example 125ml, 100g. See Google Merchant Center.OptionalRestrictions: Value should be an integer number with a unit. Supported unit values: Gewicht: mg, g, kg Volumen: ml, cl, l, cbm Länge: cm, m Fläche: qm Pro Einheit: St.125ml
Unit_Pricing_Base_MeasureThe denominator for item unit price. See Google Merchant Center. This field attribute tells the buyers how the price of your item translates per unit.OptionalRestrictions: Value should be an integer number with unit. The unit should be the same as Unit_pricing_Measure Supported unit values: Gewicht: mg, g, kg Volumen: ml, cl, l, cbm Länge: cm, m Fläche: qm Pro Einheit: St.100ml
Installment_PaymentOption for installment-based payment, allows users to pay in parts rather than in full.OptionalOptional; text; must include details if availableMin. 24 x €14/Monat
voucher_CodeThe code of the voucher applicable the offerOptionalFormat: string: “VOUCHER (description of the voucher / validity period)”. The voucher text can be up to 200 chars and must include the time when it is valid.CAR10 (10% discount for any articles of the category tyres until Dec 31st!)
ShippingDefines delivery methods available for the product. When defined, then the product gets ranked higherOptionaloptions: “shipping possible” “pickup only”. if Shipping= “pickup only” we show on the ad: “Nur Abholung”shipping possible
Postal_CodeLocation details for product pickupIt dependsRequired if pickup is offered; must be a valid German postal code.10245
Shipping_costshipping costs in EuroIt dependsIf shipping possible, possible labels Empty = “Versand möglich” zero 0 = “Versand gratis” 3,99 = “+3,99 € Versand”4.99
Delivery_TimeEstimated delivery time in days.OptionalOptional; must be provided in numeric days: format: <number (not starting with 0)>d2d-5d
Payment_methodInformation on accepted payment methods.OptionalOptional but improves checkout experiencePayPal, Kreditkarte, Vorkasse, Nachnahme, Lastschrift, Google Checkout, Giropay, Rechnung, Postanweisung, Paysafecard, Sofortüberweisung, Amazon Zahlung, Elektronisches Zahlungssystem (EPS), Ökosteuer, Bizum
Campaign_IDCustom identifier for each campaign defined by the advertiser. Used to manage campaigns through a central distributing feed management service connected to multiple publishers.OptionalIdeally matches an existing campaign IDSchuhe25478

Frequently Asked Questions

How to use CSV format
We introduced the CSV format in our system to simplify the integration process. Our customers commonly use spreadsheets to store and manipulate data, and “CSV export” is a standard option in most spreadsheet programs.

How can I set the CPC at item level?
To set the CPC at item level, you need to group all items with the same CPC and create a campaign.

Do I need to add a Price?
Yes, the price is mandatory. For customers importing Jobs or Services, using ‘0’ for the price is suggested.

How many times per day do you import the feed?
Four times per day, which means every six hours. The last import is at 7 PM.

Can we add UTM parameters directly in the campaign?
No, UTM parameters must be added in the feed.

If one user clicks on our ad five times, does that count as five separate clicks from the same user?
Multiple clicks on the same ad are counted as a single click. We register a click whenever a user clicks on an ad with a unique impression. If a user clicks on the same ad multiple times without refreshing the page, we do not register new impressions and therefore do not count clicks after the initial click.

Is it possible to put a budget cap on an item?
You can create ad-specific campaigns if you’d like to apply a budget cap at the item level.

Kleinanzeigen-Google Category Match

https://docs.google.com/spreadsheets/d/1nDumqPOj5pHmyNT4IYtjcGi9TXokEyZNR-SfQtbsu_g/edit?gid=845607299#gid=845607299

Kleinanzeigen Category Tree

L1 - MAIN CATEGORYL2 - SUB CATEGORYCATEGORY IDAttributes
Auto_Rad_Boot
Anhaenger_Nutzfahrzeuge276Agrarfahrzeuge, Anhänger, Baumaschinen, Busse, LKW, Sattelzugmaschinen & Auflieger, Stapler, Nutzfahrzeugteile & Zubehör, Weitere Nutzfahrzeuge & Anhänger
Autos216#N/A
Autoteile_Reifen223Auto Hifi & Navigation, Ersatz- & Reparaturteile, Reifen & Felgen, Tuning & Styling, Werkzeug, Weitere Autoteile
Boote_Bootszubehoer211Motorboote, Segelboote, Kleinboote, Schlauchboote, Jetski, Bootstrailer, Bootsliegeplätze, Bootszubehör, Weitere Boote
Fahrraeder217#N/A
Motorraeder_Roller305Mofas & Mopeds, Motorräder, Quads, Motorroller & Scooter
Motorraeder_Roller_Teile306Ersatz- & Reparaturteile, Reifen & Felgen, Motorradbekleidung
Reparaturen_Dienstleistungen280#N/A
Wohnwagen_Mobile220Alkoven, Integrierter, Kastenwagen, Teilintegrierter, Wohnwagen, Weitere Wohnwagen & -mobile
Sonstiges241#N/A
#N/A
Eintrittskarten_Tickets
Comedy_Kabarett254#N/A
Kinder252#N/A
Klassik_Kultur251#N/A
Konzerte255#N/A
Sport257#N/A
Bahn_OEPNV286#N/A
Gutscheine287#N/A
Sonstige256#N/A
#N/A
Familie_Kind_Baby
Altenpflege236#N/A
Baby_Kinderkleidung22Hosen & Jeans, Kleider & Röcke, Shirts & Tops, Hemden, Jacken & Mäntel, Pullover & Strickjacken, Wäsche, Sportbekleidung, Bademode, Accessoires, Kleidungspakete, Weitere Baby- & Kinderkleidung
Baby_Kinderschuhe19Ballerinas, Halb- & Schnürschuhe, Hausschuhe, Sandalen, Outdoor & Wanderschuhe, Sneaker & Sportschuhe, Stiefel & Stiefeletten, Badeschuhe, Weitere Schuhe
Babyausstattung258#N/A
Babyschalen_Kindersitze21#N/A
Babysitter_Kinderbetreuung237#N/A
Kinderwagen_Buggys25#N/A
Kinderzimmermoebel20Betten & Wiegen, Hochstühle & Laufställe, Schränke & Kommoden, Wickeltische & Zubehör, Wippen & Schaukeln, Weitere Kinderzimmermöbel
Spielzeug23Action- & Spielfiguren, Babyspielzeug, Barbie & Co, Dreirad & Co, Gesellschaftsspiele, Holzspielzeug, LEGO & Duplo, Lernspielzeug, Playmobil, Puppen, Spielzeugautos, Spielzeug für draußen, Stofftiere, Weiteres Spielzeug
Sonstiges18#N/A
#N/A
Freizeit_Nachbarschaft
Esoterik_Spirituelles232#N/A
Essen_Trinken248#N/A
Freizeitaktivitaeten187#N/A
Handarbeit_Basteln_Kunsthandwerk282#N/A
Kuenstler_Musiker191#N/A
Kunst240#N/A
Modellbau249#N/A
Reise_Eventservices233#N/A
Sammeln234Ansichts- & Postkarten, Autogramme, Bierkrüge & -gläser, Briefmarken, Comics, Flaggen, Münzen, Porzellan, Puppen & Puppenzubehör, Sammelbilder & Sticker, Sammelkartenspiele, Überraschungseier, Werbeartikel, Weiteres Sammeln
Sport_Camping230Ballsport, Camping & Outdoor, Fitness, Radsport, Tanzen & Laufen, Wassersport, Wintersport, Weiteres Sport & Camping
Troedel_kistenweise250#N/A
Verloren_Gefunden189#N/A
Sonstiges242#N/A
#N/A
Haus_Garten
Badezimmer91#N/A
Bueromoebel93#N/A
Dekoration246Bilder & Poster, Kerzen & Kerzenhalter, Spiegel, Vasen, Weitere Dekoration
Dienstleistungen_Haus_Garten239Bau & Handwerk, Garten- & Landschaftsbau, Haushaltshilfe, Reinigungsservice, Reparaturen, Wohnungsauflösungen, Weitere Dienstleistungen Haus & Garten
Garten_Pflanzen89Blumentöpfe, Dekoration, Gartengeräte, Gartenmöbel, Pflanzen, Weiteres Gartenzubehör & Pflanzen
Heimtextilien90#N/A
Heimwerken84#N/A
Kueche_Esszimmer86Besteck, Geschirr, Gläser, Kleingeräte, Küchenschränke, Stühle, Tische, Weiteres Küche & Esszimmer
Lampen_Licht82#N/A
Schlafzimmer81Betten, Lattenroste, Matratzen, Nachttische, Schränke, Weiteres Schlafzimmer
Wohnzimmer88Regale, Schränke & Schrankwände, Sitzmöbel, Sofas & Sitzgarnituren, Tische, TV & Phonomöbel, Weiteres Wohnzimmer
Sonstiges87#N/A
#N/A
Haustiere
Fische138Aquariumfische, Barsche, Diskusfische, Garnelen & Krebse, Koi, Schnecken, Wasserpflanzen, Welse, Weitere Fische
Hunde134Mischlinge, Beagle, Bernhardiner, Border Collie, Boxer, Cocker Spaniel, Collie, Dackel, Dalmatiner, Dobermann, Dogge, Golden Retriever, Husky, Jack Russell Terrier, Labrador, Malteser, Pudel, Schäferhunde, Spitz, Terrier, Weitere Hunde
Katzen136Britisch Kurzhaar, Hauskatze, Maine Coon, Perser, Siam, Weitere Katzen
Kleintiere132Hamster, Hasen & Kaninchen, Mäuse & Ratten, Meerschweinchen, Weitere Kleintiere
Pferde139Großpferde, Kleinpferde & Ponys
Reptilien244Schlangen, Echsen, Spinnen, Weitere Reptilien
Tierbetreuung_Training133#N/A
Vermisste_Tiere283Entlaufen, Gefunden
Vogel243#N/A
Sonstige131#N/A
zubehoer313Fische, Hunde, Katzen, Kleintiere, Pferde, Reptilien, Vögel, Weiteres Zubehör Haustiere
#N/A
Immobilien
Auf_Zeit_WG199#N/A
Ferienwohnung_Ferienhaus275Kaufen, Mieten
Garage_Lagerraum197Kaufen, Mieten
Gewerbeimmobilien277Kaufen, Mieten
Grundstuecke_Garten207#N/A
Haus_kaufen208#N/A
Haus_mieten205#N/A
Umzug_Transport238#N/A
Wohnung_kaufen196#N/A
Wohnung_mieten203#N/A
Sonstiges198#N/A
#N/A
Jobs
Ausbildung118#N/A
Bau_Handwerk_Produktion111Bauhelfer, Dachdecker, Elektriker, Fliesenleger, Maler, Maurer, Produktionshelfer, Schlosser, Tischler, Weitere Berufe
Bueroarbeit_Verwaltung114Buchhalter, Bürokauffrau/-mann, Sachbearbeiter/-in, Sekretärin, Weitere Berufe
Gastronomie_Tourismus110Barkeeper, Hotelfachfrau/-mann, Kellner/-in, Koch/Köchin, Küchenhilfe, Servicekraft, Zimmermädchen, Weitere Berufe
Heimarbeit_Mini_Nebenjobs107#N/A
Kundenservice_Callcenter105#N/A
Praktika125#N/A
Sozialer_Sektor_Pflege123Altenpfleger/-in, Arzthelferin, Erzieher/-in, Krankenschwester/ Krankenpfleger, Physiotherapeut/-in, Weitere Berufe
Transport_Logistik_Verkehr247Kraftfahrer, Kurierfahrer, Lagerhelfer, Staplerfahrer, Weitere Berufe
Vertrieb_Einkauf_Verkauf117Buchhalter/-in, Immobilienmakler, Kaufmann/-frau, Verkäufer/-in, Weitere Berufe
Sonstige_Berufe109Designer/Grafiker, Friseur/-in, Haushaltshilfe, Hausmeister, Reinigungskraft, Weitere Berufe
#N/A
Mode_Beauty
Accessoires_Schmuck156Mützen, Schals & Handschuhe, Schmuck, Sonnenbrillen, Taschen & Rucksäcke, Uhren, Weitere Accessoires & Schmuck
Beauty_Gesundheit224Make-Up & Gesichtspflege, Haarpflege, Körperpflege, Hand- & Nagelpflege, Gesundheit, Weiteres Beauty & Gesundheit
Kleidung_Damen154Hemden & Blusen, Hosen, Jacken & Mäntel, Pullover, Röcke & Kleider, Shirts & Tops, Umstandsmode, Weitere Damenbekleidung
Kleidung_Herren160Hemden, Hosen, Jacken & Mäntel, Pullover, Shirts, Weitere Herrenbekleidung
Schuhe_Damen159Ballerinas, Halb- & Schnürschuhe, Hausschuhe, Outdoor & Wanderschuhe, Pumps & High Heels, Sandalen, Sneaker & Sportschuhe, Stiefel & Stiefeletten, Weitere Schuhe
Schuhe_Herren158Halb- & Schnürschuhe, Hausschuhe, Sandalen, Sneaker & Sportschuhe, Stiefel & Stiefeletten, Outdoor & Wanderschuhe, Weitere Schuhe
Sonstiges155#N/A
#N/A
Multimedia_Elektronik
Audio_Hifi172CD Player, Lautsprecher & Kopfhörer, MP3 Player, Radio & Receiver, Stereoanlagen, Weiteres Audio & Hifi
Dienstleistungen_EDV226#N/A
Foto245Kamera, Objektiv, Zubehör, Kamera & Zubehör, Weiteres Foto
Handy_Telekom173Apple, HTC, LG, Motorola, Nokia, Samsung, Siemens, Sony, Faxgeräte, Telefone, Weitere Handys & Telefone
Haushaltsgeraete176Haushaltskleingeräte, Herde & Backöfen, Kaffee- & Espressomaschinen, Kühlschränke & Gefriergeräte, Spülmaschinen, Staubsauger, Waschmaschinen & Trockner, Weitere Haushaltsgeräte
Konsolen279Pocket Konsolen, PlayStation, Xbox, Wii, Weitere Konsolen
Notebooks278#N/A
PC_Videospiele227DS, Nintendo Spiele, PlayStation Spiele, Xbox Spiele, Wii Spiele, PC Spiele, Weitere Videospiele
PC_Zubehoer_Software225Drucker & Scanner, Festplatten & Laufwerke, Gehäuse, Grafikkarten, Kabel & Adapter, Mainboards, Monitore, Multimedia, Netzwerk & Modem, Prozessoren / CPUs, Speicher, Software, Tastatur & Maus, Weiteres PC-Zubehör
PCs228#N/A
TV_Video175DVD-Player & Recorder, Fernseher, TV-Receiver, Weitere TV & Video
Tablets_reader285iPad, Kindle, Samsung Tablets, Weitere Tablets & Reader
Sonstiges168#N/A
#N/A
Musik_Film_Buecher
Buecher_Zeitschriften76Antiquarische Bücher, Kinderbücher, Krimis & Thriller, Kunst & Kultur, Sachbücher, Science Fiction, Unterhaltungsliteratur, Zeitgenössische Literatur & Klassiker, Zeitschriften, Weitere Bücher & Zeitschriften
Buero_Schreibwaren281#N/A
Comics284#N/A
Fachbuecher_Schule_Studium77#N/A
Film_DVD79#N/A
Musik_CDs78#N/A
Musikinstrumente74#N/A
Sonstiges75#N/A
#N/A
Unterricht_Kurse
Beauty & Gesundheit269#N/A
Computerkurse260#N/A
Esoterik_Spirituelles265#N/A
Kochen_Backen263#N/A
Kunst_Gestaltung264#N/A
Musik_Gesang262#N/A
Nachhilfe268#N/A
Sportkurse261#N/A
Sprachkurse271#N/A
Tanzkurse267#N/A
Weiterbildung266#N/A
Sonstige270#N/A
#N/A
Zu_verschenken_Tauschen
Tauschen273#N/A
Verleihen274#N/A
Zu_verschenken192#N/A
#N/A
Dienstleistungen
Altenpflege288#N/A
Auto_Rad_Boot289#N/A
Babysitter_Kinderbetreuung290#N/A
Haus_Garten291Bau & Handwerk, Garten- & Landschaftsbau, Haushaltshilfe, Reinigungsservice, Reparaturen, Wohnungsauflösungen, Weitere Dienstleistungen Haus & Garten
Kuenstler_Musiker292#N/A
Multimedia_Elektronik293#N/A
Reise_Event294#N/A
Tierbetreuung_Training295#N/A
Umzug_Transport296#N/A
Sonstige298#N/A