Fluganzeigen – Katalog und Feed

Um deine Flugelemente auf Facebook zu bewerben, musst du Facebook Informationen zu deinen Flügen mitteilen. Hierfür erstellst du einen Flugkatalog und trägst Flüge ein. Es gibt drei Möglichkeiten, den Katalog zu füllen und aktuell zu halten.

1. CSV- oder XML-Dateien für Flug-Feeds mit deinen Flugelementen hochladen
2. Event-Aktivitäten nutzen, um den Katalog automatisch zu füllen
3. Flug-Feed mit automatisch generierten Flügen kombinieren

Du kannst deine Flugkataloge in deinem Commerce Manager erstellen und verwalten:

1. Flugkatalog erstellen
2. Feed auf Facebook hochladen
3. Produktpaletten aus dem Flugkatalog erstellen
4. Katalog deinen Event-Quellen zuordnen

Flug-Feed – Hochladen deiner Flüge auf Facebook

Ein Flug-Feed ist eine Datei, die deine Flugelemente enthält. Hierbei steht jede Zeile bzw. jedes Element in der Datei für eine Route. Du kannst einen oder mehrere Flug-Feeds verwenden, solange alle Feeds gemeinsam alle Flugelemente enthalten.

Unterstützte Formate für Flug-Feeds

CSV > Beispiel – Beschreibung

CSV-Beispiel | TSV-Beispiel (Flat File)

• Die erste Zeile muss die gewählten Feldnamen in der Reihenfolge enthalten, in der die Werte angegeben werden. Die darauffolgenden Zeilen geben dann die jeweiligen Werte für jeden Flug an.
• Felder mit Leerzeichen oder Kommas sollten in "doppelte Anführungszeichen" gesetzt werden.
• Verschachtelte Felder oder Felder mit mehreren Werten, wie z. B. 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. image[0].url, image[0].tag[0] oder image[0].tag[1], gekennzeichnet wurden. Du kannst beide Konventionen in einer Datei verwenden.

XML > Beispiel – Beschreibung

XML-Beispiel

• Ein <listings>-XML-Stamm-Node umfasst eine Gruppe von <listing>-Nodes, von denen jeder für einen Flug steht.
• Die Datei muss mit einem gültigen <?xml-Deklarations-Tag beginnen.

Unterstützte Felder – Flight Ads

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

Lokalisierte Kataloge findest du in den unterstützten Feldern für Flights Ads.

Parameter des Objekts „image“

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.

Flüge automatisch generieren – Routen mithilfe von Event-Aktivitäten automatisch zum Katalog hinzufügen

Facebook kann Routen basierend auf Pixel- und App-Event-Aktivitäten automatisch zu deinem Katalog hinzufügen. Hierbei wird jedes Mal, wenn ein Event mit einer Route eingeht, die noch nicht im Katalog enthalten ist, die entsprechende Route automatisch hinzugefügt. So kannst du Fluganzeigen für alle Flüge verwenden, ohne dich um Flug-Feeds kümmern zu müssen.

Um diese Funktion zu aktivieren, sende eine POST-Anfrage an deinen Flugkatalog und setze generate_items_from_events auf true.

curl \
  -F 'flight_catalog_settings={generate_items_from_events:1}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

Automatisch hinzugefügte Routen verfügen über kein Bild, das in der Werbeanzeige angezeigt werden könnte. Deshalb musst du ein allgemeines Bild angeben, das für automatisch generierte Routen verwendet werden kann.

curl \
  -F 'fallback_image_url=http://example.com/some.image_1.jpg' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<VERSION>/<CATALOG_ID>

Sobald dein Katalog mit einem Pixel und/oder einer App verknüpft ist und Events für Fluganzeigen empfängt, wird dein Katalog gefüllt. Du kannst diesen Vorgang überprüfen, indem du den Katalog abfragst.

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights

Kombiniert – Flug-Feeds mit automatisch generierten Flügen nutzen

Du kannst manuell hochgeladene Flug-Feeds mit automatisch generierten Routen kombinieren. Hierdurch kannst du Fluganzeigen für all deine Flüge verwenden und trotzdem über einen Flug-Feed individuelle Bilder für die wichtigsten Routen bereitstellen.

Wenn du beide Optionen nutzen möchtest, kombiniere einfach die Schritte zum Hochladen eines Flug-Feeds mit den Schritten zum automatischen Füllen deines Katalogs.

Die folgenden Abschnitte sind nur relevant, wenn du deine Kataloge mithilfe dieser API verwalten möchtest.

Flugkatalog mit der API erstellen

Ein Flugkatalog ist ein Container für deine Flugelemente. 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 Flugkatalog für Flight Ads zu erstellen, setze vertical auf flights:

curl -X POST \
  -F 'name="Test Flight Catalog"' \
  -F 'vertical="flights"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/{business-id}/owned_product_catalogs

Flug-Feeds über die API hochladen

Sobald du den Katalog erstellt hast, musst du deine(n) Flug-Feed(s) 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.

Flugkatalog zu Flugauswahl filtern

Eine Flugauswahl ist eine Untergruppe deines Katalogs. Um Fluganzeigen einzurichten, musst du mindestens eine Flugauswahl erstellen.

Flugauswahlen werden durch Filter definiert, die auf den Flugkatalog angewendet werden. Du kannst beispielsweise eine Flugauswahl mit allen Routen erstellen, die in London starten. Du kannst auch ohne Filter eine Flugauswahl erstellen. In diesem Fall enthält die Flugauswahl alle Flüge deines Katalogs.

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

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

$flight_set->setData(array(
  ProductSetFields::NAME => 'Test Flight Set',
  ProductSetFields::FILTER => array(
    'origin_airport' => array(
      'eq' => 'LHR',
    ),
  ),
));

$flight_set->create();

from facebookads.adobjects.productset import ProductSet

flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
    'origin_airport': {
        'eq': 'SFO',
    },
}

flight_set.remote_create()

curl \
  -F 'name=Test Flight Set' \
  -F 'filter={"origin_airport":{"eq":"LHR"}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets

Der filter-Parameter besteht aus folgenden Operatoren und Daten: