Publicités pour des destinations – Catalogue et flux de produits

Pour promouvoir des destinations sur Facebook, vous devez partager les informations les concernant avec Facebook. Pour ce faire, vous devez créer un catalogue de destinations, puis le remplir avec des destinations.

Importer des fichiers CSV ou XML pour les flux de destinations contenant les destinations que vous souhaitez promouvoir

Vous pouvez créer et gérer vos catalogues de destinations dans votre gestionnaire des ventes.

Si vous souhaitez utiliser l’API pour gérer votre catalogue, procédez comme suit :

1. Créez un catalogue de destinations
2. Importez votre flux dans Facebook
3. Créez des ensembles de produits à partir de votre catalogue de destinations
4. Associez le catalogue à vos sources d’évènements

Flux de destinations : importer les destinations dans Facebook

Un flux de destinations est un fichier contenant les destinations que vous souhaitez promouvoir. Chaque ligne ou élément du fichier représente une destination unique. Vous pouvez utiliser un ou plusieurs flux de destinations, tant que tous les flux regroupés contiennent l’ensemble des destinations que vous voulez promouvoir.

Formats de flux de destinations acceptés

CSV – Exemple et description

Exemple de fichier CSV | Exemple de fichier TSV (simplifié) | Exemple de fichier TSV (type JSON)

• La première ligne doit énumérer les noms des champs choisis dans l’ordre où les valeurs seront données. Les lignes suivantes fournissent ensuite les valeurs correspondantes pour chaque destination.
• Les champs contenant des espaces blancs ou des virgules doivent être placés entre "guillemets".
• Les champs imbriqués ou à valeurs multiples, tels que address, neighborhood ou 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 par une syntaxe au format de chemin JSON, notamment address.city, neighborhood[0], 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.

XML – Exemple et description

Exemple de fichier XML

• Un nœud XML racine <listings> renferme un ensemble de nœuds <listing>, dont chacun représente une destination.
• Le fichier doit commencer par une balise de déclaration <?xml valide.

Champs acceptés pour les destinations

Les champs pris en charge mentionnés ci-dessous se rapportent aux éléments que vous ajoutez dans votre catalogue produits.

Pour les catalogues localisés, consultez les champs acceptés pour les destinations.

Liens profonds vers des produits

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é.

Paramètres de l’objet image

Paramètres de l’objet adresse

Les sections suivantes ne sont pertinentes que si vous gérez vos catalogues à l’aide de cette API.

Créer un catalogue de destinations à l’aide de l’API

Un catalogue de destinations est un contenant pour les destinations que vous voulez promouvoir. 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 destinations pour les publicités de destinations, définissez vertical sur destinations :

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

Importer les flux de destinations via l’API

Une fois que vous avez créé le catalogue, vous devez importer votre ou vos flux de destinations sur Facebook. Utilisez l’API pour créer un objet de flux pour chaque flux que vous souhaitez importer. Les importations planifiées et directes sont acceptées.

Filtrer le catalogue de destinations pour afficher les ensembles de destinations

Un ensemble de destinations est un sous-ensemble de votre catalogue. Pour configurer des publicités pour les destinations, vous avez besoin d’un ensemble de destinations. Vous devez donc en créer au moins un.

Les ensembles de destinations sont définis par des filtres appliqués au catalogue de destinations. Par exemple, vous pouvez créer un ensemble de destinations composé de toutes les destinations dont le prix a fait l’objet d’une importante baisse. Veuillez noter que vous pouvez également créer un ensemble de destinations sans aucun filtre. Dans ce cas, l’ensemble de destinations contiendra toutes les destinations de votre catalogue.

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

Le paramètre filter est composé des opérateurs et données suivants :