|
| `inventory` | Kötelező | Szám
32 bites előjel nélküli egész szám ajánlott
| A termék készlete. Ha az érték 0, a termékhirdetések nem jelennek meg a termékhez. | 1 |
| `description` | Kötelező | Szöveg
Max 5000 karakter
| A termék leírása. | A hímzett Trefoil logókkal és a kontrasztos fehér színű, körvonalazott 3-Stripes csíkokkal ellátott Sport Sweat Shorts egy friss ajánlat az Adidas Originalstól. |
| `KEY (as a value)` | Kötelező a kategória és a broad display elhelyezésekhez | Szöveg
Max 1000 karakter oszloponként
| Ha ezt az oszloptípust használja, a kiskereskedőknek értéket kell megadniuk a \ elemhez.
Egy TSV-fájlban több ilyen szintaxisú oszlop is lehet.
| Az oszlop neve lehet "brand", a cella értéke pedig az oszlopban "green-fairy". Ez a "brand:green-fairy" szűrőt eredményezi a terméken. |
| `subClassName` | Elavult.
Kötelező a termék cross-sell/upsell elhelyezésekhez
| Szöveg
Max 750 karakter
| Annak az alkategóriának/kategóriának a neve, amelyben a vonatkozó termék található.
Az alkategóriák jobb termékcélzást tesznek lehetővé, pl. egy vajtermék megcélozhatja a kenyeret, de nem célozza meg a sebtapaszt.
| Sajt |
| `xSellSubClassName` | Elavult.
Kötelező a termék cross-sell/upsell elhelyezésekhez
| Szöveg
Max 750 karakter
| Azoknak az alkategóriáknak/kategóriáknak a nevei, amelyeken belül a vonatkozó termék képes termékeket megcélozni. | Kenyerek, Kencék, Kétszersültek |
| `price` | Opcionális | Szám
2 tizedesjegy ajánlott
| A termék ára. | 30.00 |
| `brand` | Kötelező | Szöveg
Max 70 karakter
| A termék márkája. | Tommy Hilfiger |
| `type` | Kötelező | Szöveg
Max 750 karakter
| A terméktípus. | Ruházat |
| `retailer_taxonomy` | Kötelező a kibővített attribúcióhoz. Nem lehet szóköz a `>` karakterek között | Szöveg
Max 750 karakter
| A termék egyedi kiskereskedelmi rendszertana. | Férfi>Férfi ruházat>Pulóverek |
| `google_taxonomy` | Kötelező a kibővített attribúcióhoz, ha a `retailer_taxonomy` nem adható meg | Szöveg
Max 750 karakter
| A termék standard Google rendszertana. További információ itt található: | Ruházat és kiegészítők > Ruházat > Felsők |
| `global_identifier` | Kötelező | Szöveg
Max 50 karakter
| A termék globális azonosítója. | 08719108994761 |
| `global_identifier_type` | Kötelező | Szöveg | A globális azonosító típusa. | GTIN |
| `custom_payload` | Nem kötelező, kivéve ha külön előírt. | Base64-kódolású bájt tömb | Ez a mező egy egyedi hasznos terhet (custom payload) tartalmaz, amelyet át kell vezetni a hirdetésgeneráláson. A mezőnek egy bájt tömbbé szerializált és Base64-kódolású érvényes JSON-objektumot kell tartalmaznia. A JSON-objektumnak egy sémához kell igazodnia. | Lásd az egyedi hasznos terhekről szóló részt. |
| `hfss` | Opcionális | Boolean | Annak jelzésére szolgál, hogy egy termék HFSS-e vagy sem. Ez továbbá felhasználásra kerül a következőkben: Epsilon Retail Mediafelülete. Tekintse meg a [HFSS dokumentációt](/retail-media-interface/integration/hu/feature-integrations/placement-level-product-type-blocking-hfss-support.md) további információért. | true |
| `seller_id` | Opcionális | Szöveg
Max 50 karakter
| A eladó egyedi azonosítója. Csak a marketplace eladók bevezetésekor (onboarding) szükséges. Nem marketplace termékek esetén üresen hagyható.
A seller\_ids integrálásához további követelmények kapcsolódnak, kérjük, hivatkozzon a következőre: Marketplace sellerId további információért.
| aes-de4-ss |
Egy táblázatként ábrázolt példafájl alább látható:
| `product_code` | `name` | `image_url` | `inventory` | `description` | `filter:Category` | `filter:Size` | `filter:Country` | `groups` | `price` | `brand` | `type` | `retailer_taxonomy` | `google_taxonomy` | `global_identifier` | seller\_id | subClassName | xSellSubClassName |
| -------------- | --------------------------------------- | ------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------- | ---------------- | ------------------------------------- | ------- | ----------- | ------- | ----------------------------------- | -------------------------------------------------------------------------------------- | ------------------- | ----------------- | --------------- | ----------------- |
| 80591101 | Green Fairy Absinth ajándékcsomag 500mL | | `20` | Ez a Green Fairy Absinth & Kanál ajándékcsomag tökéletes ajándék minden abszint- vagy koktélrajongónak. Helyezzen egy kockacukrot a kanálra, és öntse rá az abszintot, hogy autentikus módon fogyaszthassa ezt a röviditalt! | Ajándékok, Alkoholos, Ajándékcsomagok | 500ml | Csehország | Ajándékok, Alkoholos, Ajándékcsomagok | `5.00` | Green Fairy | Alkohol | Ajándékok>Alkoholos>Ajándékcsomagok | Élelmiszer, Ital & Dohány>Italok>Alkoholos italok>Röviditalok & Szeszes italok>Abszint | 8594001443079 | 7328s-dmie3-9jdae | Ajándékcsomagok | Szeszes ital |
{% hint style="info" %}
A TSV fájlok nem lehetnek idézőjeles formátumban.
{% endhint %}
## Termékképek frissítése
Epsilon gyorsítótárazza a kép URL-eket az egyenletes teljesítmény biztosítása és a képszerver felé irányuló kérések csökkentése érdekében. Ha úgy frissít egy képet, hogy nem változtatja meg annak URL-jét, kifejezetten frissítést kell kiváltania a következőkben: Epsilon. Ehhez tegye a következőket:
* Távolítsa el a meglévő image\_url értéket a termékből.
* Küldje el újra ugyanazt az image\_url-t, amint a frissítés befejeződött.
Alternatív megoldásként, ha a képszervere támogatja, kikényszerítheti a frissítést egy lekérdezési karakterlánc (például egy verzió vagy időbélyeg) hozzáadásával a meglévő URL-hez. Ez arra készteti a következőt: Epsilon hogy újratöltse a képet..
{% hint style="info" %}
A képek csak a felhasználói felületen használatosak
A termékképek nem kerülnek kiküldésre a hirdetési válaszokban. A képfrissítések csak azt befolyásolják, hogyan jelenik meg a termék a következőkben: Epsilon UI, miközben a gyorsítótár frissítése megtörténik.
{% endhint %}
## XML fájlok - kivezetése tervezett
{% hint style="danger" %}
️ Új ügyfelek számára elavult
Az alábbiak azon meglévő ügyfelek számára állnak rendelkezésre, akik még mindig XML formátumot használnak. Új katalógusok bevezetéséhez (onboarding) a fent dokumentált TSV és CSV formátumokat támogatjuk, amelyek nagyobb fájl-rugalmasságot, valamint a fájl napi többszöri szinkronizálásának lehetőségét biztosítják.
{% endhint %}
Epsilon Retail Media meghatározott egy címkelistát (tags), amelyek a termékek XML-dokumentumainak leírására szolgálnak. Az alábbi táblázat bemutatja a címkéket és azok leírását. Az ‘item’ címke egy termék leírására szolgál egy XML-dokumentumban. Az összes többi mező címkéjét ezen a címkén belül kell megírni.
| XML címkék | Kötelező/Opcionális | Leírás |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `item` | Kötelező | Ez a címke egy termék leírására szolgál. Egy termék összes többi XML címkéjének ezen a címkén belül kell lennie. A termékekre vonatkozó XML-dokumentumnak item címkék listáját kell tartalmaznia. Ez a mező megegyezik az API-ban és a TSV fájlszinkronizálásban található gtin és product\_code mezőkkel. |
| `id` | Kötelező | Egy kód a termék azonosítására az Ön rendszerében. A következők megfelelője: `product_code` TSV fájlokban. Ez a mező megegyezik az API-ban és az XML fájlszinkronizálásban található gtin és item mezőkkel. |
| `title` | Kötelező | A termék neve. |
| `image_link` | Kötelező
Max 50 karakter
| Egy hivatkozás a termék képére. Érvényes URL-nek kell lennie. |
| `brand` | Kötelező
Max 70 karakter
| A termék márkája. |
| `availability` | Kötelező
32 bites előjel nélküli egész szám ajánlott
| Ez a címke a termék készletének leírására szolgál. Az értéknek számnak kell lennie. |
| `description` | Kötelező
Max 5000 karakter
| Ez a címke a termék leírásának megadására szolgál. |
| `price` | Opcionális
2 tizedesjegy ajánlott
| Ez a címke a termék árának leírására szolgál. Ha a címkén belüli érték meg van adva, annak számnak kell lennie. |
| `type` | Opcionális
Max 750 karakter
| A terméktípus. |
| `retailer_taxonomy` | Kötelező a kibővített attribúcióhoz. Szintén kötelező a kategória-integrációkhoz.
Max 750 karakter
| Az Ön egyedi kiskereskedői taxonomiája a termékre vonatkozóan. pl. Férfi>Férfi ruházat>Pulóverek |
| `google_taxonomy` | Kötelező a kibővített attribúcióhoz, ha a retailer\_taxonomy nem adható meg
Max 750 karakter
| A termék standard Google rendszertana. További információ itt található: |
| `global_identifier` | Kötelező
Max 50 karakter
| A termék globális azonosítója. pl. `08719108994761` |
| `global_identifier_type` | Kötelező | A globális azonosító típusa. pl. `GTIN` |
| `custom_payload` | Nem kötelező, kivéve ha külön előírt. | Ez a mező egy egyedi hasznos terhet (custom payload) tartalmaz, amelyet át kell vezetni a hirdetésgeneráláson. A mezőnek egy bájt tömbbé szerializált és Base64-kódolású érvényes JSON-objektumot kell tartalmaznia. A JSON-objektumnak egy sémához kell igazodnia. |
| `hfss` | Opcionális | Annak jelzésére szolgál, hogy egy termék HFSS-e vagy sem. Ez továbbá felhasználásra kerül a következőkben: Epsilon Retail Mediafelülete. Tekintse meg a [HFSS dokumentációt](/retail-media-interface/integration/hu/feature-integrations/placement-level-product-type-blocking-hfss-support.md) további információért. |
| `seller_id` | Opcionális
Max 50 karakter
| A eladó egyedi azonosítója. Csak a marketplace eladók bevezetésekor (onboarding) szükséges. Nem marketplace termékek esetén üresen hagyható.
A seller\_ids integrálásához további követelmények kapcsolódnak, kérjük, hivatkozzon a következőre: Marketplace sellerId további információért.
|
Egy példa a címkékkel ellátott, érvényes XML-dokumentumra alább látható:
```xml
-
80591011
Melissa & Doug Dinosaur Stamp Set, 4yrs+
Imagine a rugged landscape littered with volcanoes, and full of dinosaurs roaming around
https://www.retailer.com/productImages/image1.jpg
£9.99
Melissa & Doug
Food Cupboard
10
true
-
87086011
Waitrose Splits Strawberry Ice Lollies
Strawberry splits; Suitable for vegetarians. Strawberry splits vanilla flavoured ice cream with a fruity strawberry ice coating. Our fundamental belief is that few things in life are more important than the food you buy. Good quality is essential.
https://www.retailer.com/productImages/image2.jpg
£1.25
Waitrose
Frozen Ice Cream Ice Cream Lollies
20
Waitrose
false
432un3-sd32s-ssaar
```
## Egyedi hasznos terhek (Custom payloads)
### Melyek az egyedi hasznos terhek (custom payloads)?
Az egyedi hasznos terhek olyan mezők, amelyek „változtatás nélkül” adódnak át a katalógus bevitelétől a hirdetéskiszolgálásig. A mezőre nem alkalmazunk transzformációt. Azonban JSON Schema () alapú ellenőrzés történik a mezőn. A hasznos teher specifikációja az alábbi linken érhető el (JSON Schema jelöléssel):
A termékhirdetési válaszban a pontos egyedi hasznos teher visszatér az integrátorhoz egy az alábbiak szerint elnevezett mezőben `customPayload`
Alább látható egy példa az érvényes hasznos teherre (payload):
```json
{
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
}
```
{% hint style="warning" %}
Csak fájl
Kérjük, vegye figyelembe, hogy az egyedi hasznos terhek (custom payloads) csak a termékek fájlon keresztüli szinkronizálásakor támogatottak.
{% endhint %}
### Egyedi hasznos terhek a hirdetésgenerálásban
A termékhirdetések visszaküldésekor az egyedi hasznos teher a generált hirdetés részeként továbbításra kerül. A visszaküldött hirdetési hasznos terhek egy további mezőt fognak tartalmazni `customPayload` amely egy olyan JSON-objektumot fog tartalmazni, amely megfelel a hírcsatornában (feed) megadott információkkal azonos specifikációnak.
Egy válaszpélda a következő lehet:
```json
{
"ads": [
{
"id": "display_SEY2W7-VZzspoirbw4ANs-r-w6YyODk5MDQ5UA==",
"gtin": "4400000463",
"customPayload": {
"id": "102013703",
"upc": "4400000463",
"name": "Bee Farms Honey - 14.4 Oz",
"nutrientName": [
"Kosher"
],
"description": "Honey",
"brand": "Bee Farms",
"imageUrl": "https://www.retailer.com/products/1/image.png",
"productUrl": "https://www.retailer.com/products/1/page.html",
"aisleId": "1_22_2_3",
"departmentName": "Breakfast ",
"aisleName": "Breakfast spreads",
"shelfName": "Honeu",
"salesRank": 481,
"details": "Made with real honey. No high fructose corn syrup. 8 g of while grain per 31 g serving. Per 8 Crackers: 130 calories; 0 g sat fat (% DV); 160 mg sodium (7% DV); 8 g total sugars. Start with: Bee farms honey grahams. Fill grahams with toasted marshmallows. Add milk chocolate squares. For full nutritional information, go to honeymaid.com. Try our other delicious flavors: Grahams made with real cinnamon. Grahams made with real chocolate. 8 g of whole grain per 31 g serving. Nutritionist recommend eating 18 g or more of whole grains throughout the day. 100% Whole Grain: 8 per serving. Eat 48 g or more of whole grains daily. WholeGrainsCouncil.org. Smartlabel. Visit us at: beefarms.com 1-809-622-4726 please have package available. Keep it Going: 100 recycled paperboard. Please recycle this carton. Minimum 35% post-consumer content. Made in Mexico.",
"averageWeight": 0,
"displayType": 0,
"stores": [
{
"storeId": "2543",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
},
{
"storeId": "2544",
"price": 3.99,
"salePrice": 0.28,
"pricePer": 4.99,
"unitOfMeasure": "OUNCE",
"restrictedFlag": false,
"sellByWeight": false,
"promoDescription": "I",
"promoText": "Club Price: $3.99<BR>SAVE up to: $1",
"promoType": "P",
"offerFlag": true
}
]
} ,
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2019-12-10T01:46:07.516943179Z"
}
],
"banners": [],
"products": []
}
```
{% hint style="warning" %}
Mivel az egyedi hasznos terhek további munkaterhelést jelentenek a hirdetésgeneráló szolgáltatásunk számára, kérjük, vegye figyelembe, hogy az egyedi hasznos terhek integrációjára nem vonatkozik a Epsilon Retail Media SLA, hacsak másként nincs meghatározva.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.citrusad.com/retail-media-interface/integration/hu/data-api/catalog-products-2/syncing-catalog-products-via-file.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.