FACEBOOK et INSTAGRAM.
Chaque opération appelle le point de terminaison REST d’annonces correspondant et renvoie sa réponse telle quelle. L’authentification et les limites sont identiques à REST. Un appel en échec renvoie une erreur GraphQL : extensions.status contient le statut REST, et extensions.code le code d’erreur Ayrshare lorsque l’erreur REST en comporte un. Consultez Erreurs. Les opérations d’annonces nécessitent le module complémentaire Ads. Sans lui, chaque appel renvoie une erreur avec extensions.status 403 et extensions.code 399.
Opérations
Chaque opération accepte également un
profileKey facultatif pour agir sur un User Profile (profil utilisateur). Toutes renvoient la réponse REST sous forme de JSON : elles n’acceptent donc aucune sélection de champs.
Lister les comptes publicitaires
Commencez ici. Utilisez les valeursaccountId de la réponse partout où une opération demande un accountId.
Rechercher des options de ciblage
kind détermine la recherche : INTERESTS pour le ciblage d’audience, REGIONS ou CITIES pour les zones géographiques. Chaque type n’accepte que ses propres arguments. Par exemple, countryCode et regionId ne fonctionnent qu’avec CITIES, et INTERESTS nécessite search.
Lister les annonces
Transmettez au moins l’un des argumentscampaignId, accountId, adId, postId ou socialPostId. socialPostId est l’identifiant de publication propre au réseau, pour les publications qui n’ont pas été publiées via Ayrshare.
Voir ce qu’une annonce a coûté
Mettre en pause ou réactiver une annonce
updateAd modifie des dépenses publicitaires réelles. PAUSED arrête les dépenses, ACTIVE les reprend, et DELETED ou ARCHIVED retire l’annonce. Le même statut est également appliqué à l’ensemble d’annonces et à la campagne de l’annonce : toutes les autres annonces de cet ensemble d’annonces ou de cette campagne sont donc modifiées en même temps.
Les opérations propres à chaque plateforme, comme
facebookAdAccounts et instagramAds, fonctionnent toujours et restent inchangées.