Référence

Publication

Point de terminaisonDescription

/{ad-account-id}/ads

Créer une publicité.

/{agreement-request-id}

Approuver ou refuser une demande d’accord d’entreprise en attente.

/{business-creative-folder-id}

Créer et mettre à jour un dossier créatif professionnel.

/{business-id}/creative_folders

Fournir un dossier créatif professionnel.

/{business-id}/images

Importer des images dans un dossier créatif.

/{business-id}/videos

Importer des vidéos dans un dossier créatif.

/{business-creative-folder-id}/agencies

Ajouter un partenaire à un dossier créatif.

/{business-creative-folder-id}/assigned_users

Obtenir la liste des personnes autorisées à accéder au dossier créatif professionnel.

Consultation

Point de terminaisonDescription

/{business-creative-folder-id}

Obtenir des informations sur un dossier créatif professionnel.

/{business-id}/creative_folders

Obtenir la liste des dossiers créatifs professionnels auxquels une entreprise a accès.

/{business-id}/creatives

Obtenir des images et des vidéos de l’entreprise.

/{business-id}/initiated_sharing_agreement

Obtenir la liste des demandes d’accord en attente.


Ce point de terminaison a été réintroduit en mai 2020. Auparavant, /initiated_sharing_agreement avait été abandonné avec le lancement de l’API Graph V6.0.

/{business-image-id}

Obtenir des informations sur une image.

/{business-image-id}/insights

Obtenir des insights sur une image partagée.

/{business-video-id}

Obtenir des informations sur la vidéo partagée.

/{business-video-id}/insights

Obtenir des insights sur la vidéo partagée.

/{business-creative-folder-id}/agencies

Obtenir la liste des entreprises autorisées à accéder à votre dossier créatif.

/{business-creative-folder-id}/assigned_users

Obtenir la liste des personnes autorisées à accéder à votre dossier créatif.

Suppression

Point de terminaisonDescription
/{business-creative-folder-id}

Supprimer un dossier créatif.

/{business-creative-folder-id}/agencies

Supprimer un partenaire du dossier créatif.

/{business-creative-folder-id}/assigned_users

Supprimer un·e utilisateur·ice du dossier créatif.

/{business-image-id}

Supprimer une image partagée.

/{business-video-id}

Supprimer une vidéo partagée.

Tâches autorisées

Tâche autorisée pour l’utilisateur·ice professionnel·leDescription

CREATE_CONTENT

Cet utilisateur ou cette utilisatrice peut créer des dossiers.

MANAGE_CONTENT

Cet utilisateur ou cette utilisatrice peut gérer les éléments du dossier créatif.

MANAGE_PERMISSIONS

Cet utilisateur ou cette utilisatrice peut gérer les autorisations associées au dossier créatif professionnel.

VIEW_CONTENT

Cet utilisateur ou cette utilisatrice peut afficher les éléments d’un dossier créatif.

VIEW_INSIGHTS

Cet utilisateur ou cette utilisatrice peut consulter les insights d’un élément créatif.

Insights

Ces indicateurs sont en cours de développement.

Nom de l’indicateurDescription
impressions

Nombre de fois que votre image ou votre vidéo est apparue dans une publicité.

inline_link_clicks

Nombre de clics effectués sur les liens contenus dans votre publicité. Les clics sur les liens en ligne utilisent une fenêtre d’attribution fixe de 1 jour.

video_play_actions

Nombre de fois que votre vidéo est lancée. Cet indicateur est pris en compte pour chaque impression vidéo, hors relectures.

actions

Nombre total d’actions entreprises en lien avec vos publicités. Il peut s’agir d’interactions, de clics ou de conversions. Pour obtenir la liste complète des types pris en charge, consultez ce document.

video_thruplay_watched_actions

Nombre de fois que votre vidéo a été lue jusqu’au bout, ou pendant au moins 15 secondes.

quality_ranking

Classement de la qualité de votre publicité telle qu’elle est perçue. La qualité est mesurée d’après les commentaires laissés sur vos publicités et l’expérience post-clic. Les publicités sont classées d’après les autres publicités en concurrence pour une même audience.


Valeurs possibles :

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN, en cas d’informations insuffisantes sur la publicité.

Cet indicateur est lié au diagnostic de pertinence des publicités.

Les répartitions suivantes sont disponibles :

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal