Pour promouvoir vos offres de vols sur Facebook, vous devez partager les informations concernant vos vols avec Facebook. Pour ce faire, vous devez créer un catalogue de vols, puis le remplir avec des itinéraires de vol. Vous pouvez remplir votre catalogue et le mettre à jour de trois manières différentes.
Vous pouvez créer et gérer vos catalogues de vols dans votre Gestionnaire des ventes :
Un flux de vols est un fichier contenant vos offres de vol. Chaque ligne ou élément du fichier représente un itinéraire unique. Vous pouvez utiliser un ou plusieurs flux de vols, tant que tous les flux réunis contiennent l’ensemble de vos offres de vols.
Exemple de fichier CSV | Exemple de fichier TSV (simplifié)
"
guillemets"
. image
, peuvent être représentés à l’aide de valeurs encodées au format JSON ou par un ensemble de colonnes en texte brut "simplifié" désignées au moyen de la syntaxe d’un chemin d’accès JSON (par exemple, image[0].url
, image[0].tag[0]
, image[0].tag[1]
). Les deux conventions peuvent être utilisées de manière interchangeable dans le même fichier.<listings>
racine renferme un ensemble de nœuds <listing>
, dont chacun représente un vol.<?xml
valide.L’analyseur de fil détecte automatiquement les encodages de texte UTF8
, UTF16
ou UTF32
et il est défini sur LATIN1
par défaut s’il rencontre une séquence d’octets inattendue. Vous pouvez fournir du texte dans n’importe quelle langue dans les valeurs de champ. Toutefois, les noms de champs doivent être attribués exactement comme suit, en anglais.
Les champs pris en charge mentionnés ci-dessous se rapportent aux éléments que vous ajoutez dans votre catalogue produits.
S’il s’agit de catalogues localisés, consultez les champs pris en charge pour les publicités pour les vols.
Champ et type | Description |
---|---|
type : chaîne | Obligatoire. Code IATA de l’aéroport de départ. Prend en charge le code IATA de l’aéroport et de la ville. Utilisez la recherche de code IATA pour valider vos codes IATA. Conseil : pour de meilleures performances, évitez les espaces dans le champ de cet identifiant unique. Exemple : |
type : chaîne | Obligatoire. Code IATA de l’aéroport de destination. Prend en charge le code IATA de l’aéroport et de la ville. Utilisez la recherche de code IATA pour valider vos codes IATA. Conseil : pour de meilleures performances, évitez les espaces dans le champ de cet identifiant unique. Exemple : |
type : objet | Obligatoire. Nombre d’éléments max. : 20 Données d’image pour ce vol. Vous pouvez fournir jusqu’à 20 images pour le vol. Chaque image contient deux champs : Consultez Paramètres de l’objet image. |
type : chaîne | Obligatoire. Taille max. : 5 000 Brève description de l’itinéraire. |
type : chaîne | Obligatoire uniquement si vous ne spécifiez pas de lien profond au niveau de la publicité. Vous pouvez utiliser le champ Lien vers le site externe sur lequel vous pouvez afficher le vol. Si un lien profond est précisé au niveau de la publicité, il prévaudra. |
type : chaîne | Nom de la ville de départ. Exemple : |
type : chaîne | Nom de la ville de destination. Exemple : |
type : chaîne | Prix du vol. Vous devez spécifier le montant et la devise. Exemple : |
type : élément | Ajoutez un lien profond direct vers la page de détails du vol dans votre application à l’aide des App Links. Vous pouvez préciser des liens profonds (dans l’ordre de prévalence, du plus élevé au plus bas) :
|
type : chaîne | Prix du vol (aller simple). Vous devez spécifier le montant et la devise. Exemple : |
type : nombre entier | Priorité du vol. Valeur de 0 (priorité la moins élevée) à 5 (priorité la plus élevée). Un vol sans cette valeur aura la priorité = 0. Exemple : |
type : chaîne | Détermine si un article est actif ou archivé dans votre catalogue. Seuls les articles actifs peuvent être vus par les internautes dans vos publicités, vos boutiques ou tout autre moyen de communication. Valeurs prises en charge : Exemple : Remarque : certaines plateformes partenaires comme Shopify peuvent synchroniser des articles dans votre catalogue avec le statut staging, qui est équivalent au statut Ce champ était auparavant appelé |
Nom du champ et type | Description |
---|---|
type : chaîne | Obligatoire. URL correspondant à l’image du vol. Suivez les spécifications suivantes pour les images :
|
type : chaîne | Chaîne représentant ce que contient l’image. Plusieurs tags peuvent être associés à une image. Exemples :
Facultatif. |
Si vous possédez des applications distinctes pour iPhone et iPad, précisez les informations propres à chacun de ces deux supports. Sinon, précisez uniquement les informations relatives à iOS.
Nom du champ et type | Description |
---|---|
type : chaîne | Un jeu personnalisé pour l’application iOS. Exemple : |
type : chaîne | L’identifiant d’application pour la boutique d’applications. Exemple : 1234 |
type : chaîne | Le nom de l’application (adapté à l’affichage). Exemple : |
type : chaîne | Un jeu personnalisé pour l’application iPhone. Exemple : |
type : chaîne | L’identifiant d’application pour la boutique d’applications. Exemple : |
type : chaîne | Le nom de l’application (adapté à l’affichage). Exemple : |
type : chaîne | Un jeu personnalisé pour l’application iPhone. Exemple : |
type : chaîne | L’identifiant d’application pour la boutique d’applications. Exemple : |
type : chaîne | Le nom de l’application (adapté à l’affichage). Exemple : |
type : chaîne | Un jeu personnalisé pour l’application Android. Exemple : |
type : chaîne | Un nom de lot entièrement qualifié pour la génération d’intentions. Exemple : |
type : chaîne | Un nom de classe d’activité entièrement qualifié pour la génération d’intentions. Exemple : |
type : chaîne | Le nom de l’application (adapté à l’affichage). Exemple : |
Suivez la spécification des App Links ci-dessous pour fournir des liens profonds dans le flux. Les informations des liens profonds prévalent sur les informations collectées par Facebook avec son robot d’indexation via les métadonnées des App Links.
Si vous possédez déjà les informations des liens profonds via les App Links, vous n’avez pas besoin de spécifier ceci. Facebook utilise les informations provenant d’App Links pour afficher le lien profond correct. Pour afficher les liens profonds dans vos publicités, consultez la section Publicités de catalogue Advantage+, Modèle de publicité.
Facebook peut ajouter automatiquement des itinéraires à votre catalogue en fonction du pixel et du module App Event. Chaque fois qu’un évènement est reçu avec un itinéraire qui n’existe pas dans le catalogue, il peut être ajouté automatiquement. Cela vous permet d’utiliser des publicités pour les vols pour tous vos vols sans avoir à gérer les flux de vols.
Pour ce faire, envoyez une demande POST
à votre catalogue de vol, et définissez generate_items_from_events
sur true
.
curl \ -F 'flight_catalog_settings={generate_items_from_events:1}' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Les itinéraires ajoutés automatiquement ne comportent pas d’image (à afficher dans la publicité). Vous devez donc fournir une image générique à utiliser pour tous les itinéraires générés automatiquement.
curl \ -F 'fallback_image_url=http://example.com/some.image_1.jpg' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Dès que votre catalogue sera associé à un pixel et/ou une application, et que des évènements pour des publicités de vol seront diffusés, votre catalogue sera rempli. Vous pouvez le vérifier en interrogeant le catalogue.
curl \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights
Vous pouvez associer l’importation d’un flux de vols à des itinéraires générés automatiquement. L’association de ces options vous permet d’exploiter les publicités pour les vols pour tous vos vols, tout en fournissant des images sur mesure pour vos itinéraires les plus importants à l’aide d’un flux de vols.
Pour ce faire, combinez simplement l’étape d’importation d’un flux de vols avec l’étape de remplissage automatique de votre catalogue.
Les sections suivantes ne sont pertinentes que si vous souhaitez gérer vos catalogues à l’aide de cette API.
Un catalogue de vols est un contenant pour vos offres de vols. Pour utiliser l’API Catalog, vérifiez que vous disposez du niveau d’accès adéquat à l’API Marketing et que vous avez accepté les conditions de service en créant votre premier catalogue à l’aide de Business Manager.
Pour créer un catalogue de vols pour vos publicités pour les vols, définissez vertical
sur 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
Une fois que vous avez créé le catalogue, vous devez importer votre ou vos flux de vol sur Facebook. Utilisez l’API pour créer un objet de fil pour chaque fil que vous souhaitez importer. Les importations planifiées et directes sont acceptées.
Un ensemble de vols est un sous-ensemble de votre catalogue. Pour configurer des publicités pour les vols, vous devez créer au moins un ensemble de vols.
Les ensembles de vols sont définis par des filtres appliqués au catalogue de vols. Par exemple, vous pouvez créer un ensemble de vols avec tous les itinéraires au départ de Londres. Veuillez noter que vous pouvez également créer un ensemble de vols sans aucun filtre. Dans ce cas, l’ensemble de vols contiendra tous les vols de votre catalogue.
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
Le paramètre filter
est composé des opérateurs et données suivants :
Opérateurs | Le type de filtre |
---|---|
| Contient une sous-chaîne. L’opérateur n’est pas sensible à la casse. |
| Ne contient pas de sous-chaîne. L’opérateur n’est pas sensible à la casse. |
| Contient une sous-chaîne. L’opérateur n’est pas sensible à la casse. |
| Ne contient pas de sous-chaîne. L’opérateur n’est pas sensible à la casse. |
| Égal à. L’opérateur n’est pas sensible à la casse. |
| Non égal à. L’opérateur n’est pas sensible à la casse. |
| Inférieur à. Pour les champs numériques uniquement. |
| Inférieur ou égal à. Pour les champs numériques uniquement. |
| Supérieur à. Pour les champs numériques uniquement. |
| Supérieur ou égal à. Pour les champs numériques uniquement. |
Données | Les données filtrées |
---|---|
| Code IATA de l’aéroport de départ. |
| Code IATA de l’aéroport de destination. |
| Prix du vol. Le prix est en cents. |
| Brève description de l’itinéraire. |