Einrichtung eines lokalisierten Katalogs

Verwende diesen Leitfaden für die Einrichtung deines Katalogs für die Lokalisierung. Weitere Informationen findest du unter Einrichtung eines Katalog für mehrere Sprachen und Länder, Hilfebereich für Anzeigen.

Anforderungen

  • Du musst einen sprach- oder länderspezifischen Überschreibungs-Daten-Feed erstellen, der nur die Felder (mit Werten) enthält, die du ändern möchtest.
  • Du musst ein id-Feld in deinen Überschreibungs-Daten-Feed aufnehmen. Die id für jeden Artikel muss einer id in einem deiner Haupt-Daten-Feeds deines Katalogs und/oder der Inhalts-ID aus deinem Pixel entsprechen.
  • Du musst ein override-Feld einfügen.
  • Du kannst nur bestimmte Felder lokalisieren (überschreiben), nicht alle. Eine Liste der unterstützten Katalogfelder findest du unter Unterstützte Felder – Lokalisierte Kataloge.
  • Stelle sicher, dass Produktbilder die Kataloganforderungen erfüllen .
  • Stellen Sie sicher, dass Produkttitel die Kataloganforderungen erfüllen.
  • Stelle sicher, dass die Produktbeschreibungen die Kataloganforderungen erfüllen.

Empfehlungen

Bei der Planung deiner Katalogeinrichtung bitten wir dich, die folgenden Empfehlungen zu befolgen:

  • Auch wenn du mehrere Sprachen in einen Sprachen-Feed und mehrere Länder in einen Länder-Feed aufnehmen kannst, empfehlen wir dir, deine Länder- und Sprach-Feeds separat zu erstellen.
  • Wenn du über einen großen Katalog verfügst (über 100.000 Artikel), musst du einen Daten-Feed pro Sprache oder Land erstellen.
  • Wenn du einen Sprachen-Feed und einen Länder-Feed erstellst, empfehlen wir, dass die Felder, die in jedem Feed enthalten sind, nur für diesen Feed-Typ gelten. Gib beispielsweise den Produktnamen nicht sowohl im Sprachen-Feed als auch im Länder-Feed an.
  • Für Produkte (E-Commerce) empfehlen wir, title und description in deinen Sprachen-Feed aufzunehmen und price, sale_price, sale_price_effective_date, availability und link in deinen Länder-Feed.
  • Als Beispiele stellen wir eine Sprachüberschreibungsvorlage und eine Länderüberschreibungsvorlage bereit.

Siehe auch

Schritt 1: Sprachen- und Länderfeeds erstellen

Feed-Typen

Du kannst lokalisierte Eigenschaften für deine Katalogartikel bereitstellen, indem du zusätzliche Arten von Feeds verwendest.

Feed-TypBeschreibungBeispiel

Länder-Feed

Enthält Überschreibungen für ausgewählte Länder. Du kannst Länder-Feeds mit dem Commerce Manager oder über die API erstellen und hochladen. Siehe unterstütztes Feed-Format.

Ein Artikel kann unterschiedliche Preise in verschiedenen Ländern haben.

Sprachen-Feed

Enthält Übersetzungen für bestimmte Felder. Du kannst Sprachen-Feeds mit dem Commerce Manager oder über die API erstellen und hochladen. Siehe unterstütztes Feed-Format.

Ein Artikel kann unterschiedliche Beschreibungen in unterschiedlichen Sprachen haben.

Sprachen und Länder-Feed

Für fortgeschrittene Anwendungsfälle, in denen ein Länder- oder Sprachen-Feed nicht ausreicht, um die Lokalisierung deiner Artikel zu beschreiben. Ein Sprachen- und Länder-Feed sollte nur für Felder verwendet werden, die wirklich notwendig sind.


Du kannst nur einen Sprachen- und Länder-Feed über die API erstellen, aber du kannst den Feed mit dem Commerce Manager oder über die API ändern und hochladen. Der Commerce Manager stellt Details zu jeder Länder- und Sprachen-Einrichtung bereit.


Hinweis: Um ein Feld für sowohl die Sprache als auch für das Land zu lokalisieren, sollte der Wert in der override-Spalte ein unterstützter ISO-Sprachencode und ein unterstützter ISO-Ländercode sein, getrennt durch ein „|“-Zeichen, z. B. en_XX|US.

Deine Produkt-URLs können sowohl von der Sprache als auch vom Land des*der Betrachter*in abhängen.

Beispiel: http://www.mysite.com/ca/item12345?lang=fr
Or
http://www.mysite.com/ca/fr/item12345

Du kannst lokalisierte Felder für maximal 350 Sprach- und Landespaare pro Katalogartikel definieren.

Feed-Formate

Länder-Feed

Beispiel-CSV: Dieser Feed enthält Landeslokalisierungen für das Vereinigte Königreich (GB) und Italien (IT).

      
id; override; price; link; delete
FB_product_1234; GB; 9.00 GBP; http://www.example.com/en_GB/FB_product_1234; false
FB_product_1234; IT; 10.49 EUR; http://www.example.com/it_IT/FB_product_1234; false
    

price, sale_price, unit_price, base_price, status (Sichtbarkeit) und availability dürfen nur in einem Länderfeed angegeben werden. Diese Felder dürfen nicht in einem Sprachfeed angegeben werden. So kann sichergestellt werden, dass Kund*innen die richtigen lokalisierten Produktdaten angezeigt werden.


Sprachfeed

Beispiel-CSV: Dieser Feed enthält Sprachlokalisierungen für Französisch (fr_XX) und Englisch (en_XX).

      
id; override; description; title; delete
FB_product_1234; fr_XX; Le t-shirt American Apparel préféré de tous. Le t-shirt comporte une encolure ajustée de 3/4 pouce au cou, une bande épaule à épaule et un ourlet de 1 pouce sur les manches.; T-shirt Unisexe d'American Apparel; false
FB_product_1234; en_XX ; Everyone's favorite American Apparel T-shirt. The t-shirt features 3/4 inches set-in neck, shoulder to shoulder tape and 1 inch hem on sleeves.; American Apparel Unisex T-Shirt; false
    

Sprachen- und Länder-Feed

Beispiel: Dieser Feed enthält „Sprache und Land“-Lokalisierungen für französischsprachige Nutzer*innen in den USA (fr_XX|US) und französischsprachige Nutzer*innen in Kanada (fr_XX|CA).

id; override; url; delete
FB_product_1234; fr_XX|US; http://us.example.com/fr/product_1234; false
FB_product_1234; fr_XX|CA; http://ca.example.com/fr/product_1234; false

Schritt 2: Deinen Feed überprüfen – Rangfolge

Bei der Auswahl, welche lokalisierten Informationen einem*einer Nutzer*innen angezeigt werden sollen, prüfen wir die Feed-Inhalte in dieser Reihenfolge:

  1. Sprach- und Länder-Feed-Werte für die gesprochenen Sprachen und das Heimatland des*der Nutzer*in
  2. Sprachen-Feed-Werte für die gesprochenen Sprachen des*der Nutzer*in
  3. Länder-Feed-Werte für das Heimatland des*der Nutzer*in

Schritt 3: Sprachen- und Länder-Feeds hochladen

Sobald du deine Feeds erstellt hast, kannst du diese manuell über den Commerce Manager oder über die API hochladen, wie unten gezeigt.

Feeds über die API hochladen

  1. Stelle Feeds auf deinem Server zur Verfügung.
  2. Verknüpfe die Feeds mit deinem Katalog, indem du einen zusätzlichen override_type-Parameter verwendest.

Sprachfeed

Beispiel: Sprachen-Feed hochladen

curl \
  -F 'name=Language feed' \
  -F 'schedule={
    "interval": "DAILY",
    "url": "http:\/\/www.example.com\/sample_language_feed.tsv",
    "hour": 22
  }' \
	-F 'override_type=language'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Länder-Feed

Beispiel: Länder-Feed hochladen

curl \
  -F 'name=Country Feed' \
  -F 'schedule={
    "interval": "DAILY",
    "url": "http:\/\/www.example.com\/sample_country_feed.tsv",
    "hour": 22
  }' \
	-F 'override_type=country'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Sprachen- und Länder-Feed

Beispiel: Sprachen und Länder-Feed

curl \
  -F 'name=language and country Feed' \
  -F 'schedule={
        "interval": "DAILY",
        "url": "http:\/\/www.example.com\/sample_language_and_country_feed.tsv",
        "hour": 22
      }' \
  -F 'override_type=language_and_country'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Parameter

Parameter Wert

url

Pfad, an dem wir die Feed-Datei abrufen können

interval

Häufigkeit der Feed-Dateiabfragen

hour

Tagesstunde (24-Stundenformat) des Feed-Abrufs

Schritt 4: Land- oder Sprachinformationen eines Produkts entfernen (optional)

So entfernst du lokalisierte Informationen aus einem Artikel:

  1. Gib in deinem Länder- oder Sprachen-Feed die Spalte „Delete“ an.
  2. Setze den Wert auf true.

Die Lokalisierung für dieses Produkt wird dann entfernt.

Hinweis: Du kannst auch Artikel in deinem Hauptartikel-Feed löschen (delete). Wenn du einen Hauptartikel löschst, werden alle Überschreibungen entfernt.

Schritt 5: Überprüfe deine Einrichtung im Commerce Manager

Der Commerce Manager stellt auf der Seite Artikel > Details Einzelheiten zu den Länder- und Sprachfeldern für jedes Produkt bereit.



Du kannst auch auf die internationale Abdeckung deines gesamten Katalogs über den Tab Artikel > Internationale Abdeckung zugreifen.