Anzeigen für Reiseziele – Katalog und Feed

Um Reiseziele auf Facebook zu bewerben, musst du Facebook Informationen zu den Zielen mitteilen. Hierfür erstellst du einen Reisezielkatalog und trägst Reiseziele ein.

CSV- oder XML-Dateien für Reiseziel-Feeds mit zu bewerbenden Reisezielen hochladen

Du kannst deine Reisezielkatalog in deinem Commerce Manager erstellen und verwalten.

So verwaltest du deinen Katalog über die API:

1. Reisezielkatalog erstellen
2. Feed auf Facebook hochladen
3. Produktpalette aus Reisezielkatalog erstellen
4. Katalog deinen Event-Quellen zuordnen

Reiseziel-Feed: deine Reiseziele auf Facebook hochladen

Ein Reiseziel-Feed ist eine Datei mit den Reisezielen, die du bewerben möchtest. Hierbei steht jede Zeile bzw. jedes Element in der Datei für ein Reiseziel. Du kannst mehrere Reiseziel-Feeds verwenden, sofern alle Feeds gemeinsam alle zu bewerbenden Reiseziele enthalten.

Unterstützte Formate für den Reiseziel-Feed

CSV: Beispiel und Beschreibung

CSV-Beispiel | TSV-Beispiel (Flat File) | TSV-Beispiel (JSON-Stil)

• Die erste Zeile muss die gewählten Feldnamen in der Reihenfolge aufführen, in der die Werte angegeben sind. In den nachfolgenden Zeilen werden die entsprechenden Werte für jedes Reiseziel bereitgestellt.
• Felder mit Leerzeichen oder Kommas sollten in "doppelte Anführungszeichen" gesetzt werden.
• Verschachtelte Felder oder Felder mit mehreren Werten, wie z. B. address, neighborhood oder image, können mithilfe von JSON-codierten Werten oder durch eine Gruppe reiner Textspalten im Flat-Format dargestellt werden, die mit der JSON-Pfadsyntax, wie z. B. address.city, neighborhood[0], image[0].url, image[0].tag[0] oder image[0].tag[1], gekennzeichnet wurden. Du kannst beide Konventionen in einer Datei verwenden.

XML: Beispiel und Beschreibung

XML-Beispiel

• Ein <listings>-XML-Stammknoten umfasst eine Gruppe von <listing>-Knoten, von denen jeder für ein Reiseziel steht.
• Die Datei muss mit einem gültigen <?xml-Deklarations-Tag beginnen.

Unterstützte Felder: Reiseziele

Die folgenden unterstützten Felder sind für Elemente vorgesehen, die du deinem Produktkatalog hinzufügst.

Lokalisierte Kataloge findest du unter unterstützte Felder für Reiseziele.

Deep Links für Produkte

Gib Deep Links im Feed an und befolge dabei die App-Links-Spezifikation. Deep Link-Informationen im Feed haben Vorrang vor Informationen, die Facebook mit App-Links-Metadaten mit dem Webcrawler sammelt.

Wenn du bereits Deep Link-Informationen aus App-Links hast, musst du diese Daten nicht angeben. Facebook verwendet Informationen aus App-Links, um den richtigen Deep Link anzuzeigen. Wie du Deep Links in deinen Anzeigen einblendest, erfährst du in Advantage+ Catalog Ads, Anzeigenvorlage.

Parameter des Objekts „image“

Parameter des Objekts „address“

Die folgenden Abschnitte sind nur relevant, wenn du deine Kataloge mithilfe dieser API verwaltest.

Reisezielkatalog mit der API erstellen

Ein Reisezielkatalog ist ein Container mit den Reisezielen, die du bewerben möchtest. Um die Catalog API zu verwenden, benötigst du die erforderlichen Marketing API-Zugriffsberechtigungen und musst die Nutzungsbedingungen akzeptieren, indem du deinen ersten Katalog über den Business Manager erstellst.

Um einen Reisezielkatalog für Reisezielanzeigen zu erstellen, lege vertical auf destinations fest:

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

Deine Reiseziel-Feeds über die API hochladen

Sobald du den Katalog erstellt hast, musst du deine Reiseziel-Feeds auf Facebook hochladen. Verwende die API, um ein Feed-Objekt für jeden Feed zu erstellen, den du hochladen möchtest. Wir unterstützen geplante und direkte Uploads.

Reisezielkatalog nach Gruppen von Reisezielen filtern

Eine Zielauswahl ist eine Untergruppe deines Katalogs. Um Reisezielanzeigen einzurichten, benötigst du eine Zielauswahl. Deshalb musst du mindestens eine erstellen.

Zielauswahlen werden durch Filter definiert, die auf den Reisezielkatalog angewendet werden. Du kannst z. B. eine Zielauswahl mit allen Reisezielen mit starker Preissenkung erstellen. Du kannst auch ohne Filter eine Zielauswahl erstellen. In diesem Fall enthält die Reisezielauswahl alle Reiseziele in deinem Katalog.

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$destination_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();

from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()

curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

Der filter-Parameter besteht aus folgenden Operatoren und Daten: