Version API Marketing

Documentation de référence sur les API Marketing

Vous trouverez ci-après une liste complète des nœuds racines pour les API Marketing de Facebook, avec des liens vers les documents de référence pour chacun. Les arêtes disponibles figurent de manière distincte. Pour plus d’informations de fond sur la manière dont l’architecture de l’API appelle les nœuds racines et leurs arêtes, consultez la rubrique Utilisation de l’API Graph.

Les nœuds racines principaux sont les suivants :

Nœud racine Représente

/{USER}

Une personne qui crée des publicités sur Facebook. Chaque utilisateur de publicités peut avoir un rôle sur plusieurs comptes publicitaires.

/act_{AD_ACCOUNT_ID}

Représente l’entreprise qui gère les publicités.

/{CAMPAIGN_ID}

Définit l’objectif de votre campagne publicitaire. Contient un ou plusieurs ensembles de publicités.

/{AD_SET_ID}

Contient toutes les publicités partageant les mêmes budget, calendrier, enchères et ciblage.

/{AD_ID}

Contient les informations d’une publicité, comme les éléments créatifs et les données de mesure.

Utilisateur

Arêtes

Arête Représente

/adaccountgroups

Groupe de comptes publicitaires associés à cette personne.

/adaccounts

Tous les comptes publicitaires associés à cette personne.

/accounts

Toutes les Pages et les emplacements pour lesquels cette personne est administrateur.

/promotable_events

Tous les évènements pouvant être promus que vous avez crées ou les évènements de Page pouvant être promus qui appartiennent aux Pages dont vous êtes administrateur.

/promotable_domains

Tous les domaines susceptibles d’être promus par cette personne.

Compte publicitaire

Toutes les collections d’objets publicitaires figurant dans les API Marketing appartiennent à un compte publicitaire.

Arêtes

Arête Représente

/campaigns

Définit l’objectif de votre campagne et contient un ou plusieurs ensembles de publicités.

/adsets

Contient toutes les publicités partageant les mêmes budget, calendrier, enchères et ciblage.

/ads

Les données d’une publicité, comme les éléments créatifs et les informations de mesure.

/adcreatives

Définit l’apparence et le contenu de votre publicité.

/adimages

Bibliothèque d’images à utiliser dans les contenus créatifs publicitaires. Peut être importée et gérée de manière indépendante.

/advideos

Bibliothèque de vidéos à utiliser dans les contenus créatifs publicitaires. Peut être importée et gérée de manière indépendante.

/activities

Journal des actions effectuées sur le compte publicitaire.

/adtags

Ensemble de tags du compte publicitaire. Utilisé pour identifier les campagnes, ensembles de publicités ou publicités similaires.

/adcampaignconversions

Données de conversion regroupées en fonction des ensembles de publicités dans le compte publicitaire.

/adgroupconversions

Données de conversion regroupées en fonction des publicités dans le compte publicitaire.

/customaudiences

Audiences personnalisées du compte publicitaire. Ces dernières vous aident à cibler vos publicités sur les personnes entretenant déjà une relation avec votre entreprise.

/generatepreviews

Génère un aperçu de la publicité.

/offsitepixels

Pixels associés à ce compte.

/reachestimate

Génère la portée estimée d’une publicité au sein d’une spécification de ciblage donnée.

/reportstats

L’API Reporting récupère les données du compte publicitaire et programme des rapports.

/adcampaignstats

Ensemble de statistiques regroupées en fonction des ensembles de publicités dans le compte publicitaire.

/adgroupstats

Ensemble de statistiques regroupées en fonction des publicités dans le compte publicitaire.

/targetingsentencelines

Génère une description du ciblage de l’ensemble de publicités dans un format lisible.

/users

Liste des personnes associées à un compte publicitaire.

/insights

Interface des insights. Déduplique les résultats des objets enfants, permet le tri et les rapports asynchrones.

Campagne publicitaire

Arêtes

Arête Représente

/adsets

Contient toutes les publicités partageant les mêmes budget, calendrier, enchères et ciblage.

/ads

Les données nécessaires à une publicité, comme les éléments créatifs et les informations de mesure.

/adtags

Tags pour vos campagnes. À utiliser pour identifier les campagnes similaires.

Renvoie un ensemble de statistiques unique regroupé en fonction des campagnes.

/insights

Interface des insights. Les fonctionnalités comprennent la déduplication des objets enfants, le tri et les rapports asynchrones

Ensemble de publicités

Arêtes

Arête Représente

/ads

Les données nécessaires à une publicité, comme les éléments créatifs et les informations de mesure.

/adcreatives

Définit le contenu et l’apparence de votre publicité.

/activities

Journal des actions effectuées sur l’ensemble de publicités.

/adtags

Tags pour vos ensembles de publicités. À utiliser pour identifier les ensembles de publicités similaires.

/conversions

Données de conversion pour l’ensemble de publicités.

/insights

Interfaces des insights. Les fonctionnalités comprennent la déduplication des objets enfants, le tri et les rapports asynchrones

Arêtes

Arête Représente

/adcreatives

Définit l’apparence et le contenu de votre publicité.

/adtags

Tags pour vos publicités. À utiliser pour identifier les publicités similaires.

/conversions

Données de conversion pour la publicité.

/keywordstats

Renvoie des statistiques en fonction du mot-clé ciblé dans une publicité.

/previews

Génère des aperçus de la publicité à partir d’une publicité existante.

/reachestimate

Obtient la portée estimée d’une publicité.

Ensemble de statistiques de votre publicité.

/targetingsentencelines

Obtient une description du ciblage de l’ensemble de publicités dans un format lisible.

/trackingtag

Attribue des tags de clic à une publicité. À l’aide des tags de suivi des clics, indiquez une URL qui se déclenche lorsqu’une personne clique sur une publicité.

/insights

Interface des insights. Les fonctionnalités comprennent la déduplication des objets enfants, le tri et les rapports asynchrones

Contenu créatif

Arêtes

Arête Représente

/previews

Génère des aperçus de la publicité à partir d’un objet de contenu créatif publicitaire existant.