Passer au contenu principal
POST
Configurez d’abord le suivi des conversions. Performance Max utilise vos conversions pour décider où diffuser les annonces et combien enchérir. Ayrshare ne bloque pas une campagne qui n’en dispose pas, mais Google peut limiter ses dépenses tant que le suivi des conversions n’est pas configuré dans votre compte Google Ads. Ayrshare ne le configure pas pour vous. Lorsque le compte n’en a pas, la réponse de création inclut une entrée warnings qui le signale.
Créez une campagne Google Ads Performance Max en une seule requête. Vous envoyez des textes et des URL d’images ; Google les combine en annonces sur Search, YouTube, Display, Discover, Gmail et Maps. Ayrshare crée ensemble le budget, la campagne, un groupe d’assets et tous ses assets. Si Google refuse l’un de ces éléments, rien n’est créé. La requête utilise la structure commune décrite dans Campagnes publicitaires. La consultation et la modification d’une campagne, les insights et les erreurs fonctionnent comme pour les campagnes Google sur le Réseau de Recherche. Cette page présente ce qui diffère.
  • Les annonces Google sont activées compte par compte. Contactez-nous pour les activer.
  • Les nouvelles campagnes démarrent en paused sauf si vous envoyez status: "active".
  • Le budget est quotidien, dans la devise du compte publicitaire, et n’est jamais partagé avec d’autres campagnes.
  • Les dépenses dans une autre devise sont converties en USD pour la facturation au taux de change du jour fourni par Open Exchange Rates. Un compte dans une devise qui ne peut pas être convertie renvoie code: 101 avant que quoi que ce soit ne soit créé.
  • La vidéo n’est pas prise en charge. Google peut créer des vidéos à partir de vos images.

Paramètres d’en-tête

string
requis
Une nouvelle valeur unique, comme un UUID, pour chaque nouvelle campagne. Répéter une requête avec la même clé renvoie la première réponse. Lorsqu’une création échoue avant qu’Ayrshare n’envoie la campagne à Google (par exemple, une image qui n’a pas la bonne taille), la clé est libérée : vous pouvez donc corriger la requête et réessayer avec la même clé.

Paramètres du corps

string
requis
performanceMax.
object
requis
Performance Max n’accepte que ces stratégies. Toute autre valeur renvoie code: 101.
  • maximizeConversions : obtenir le plus de conversions possible pour le budget.
  • targetCpa avec targetCpa : la même chose, en visant ce coût par conversion.
  • maximizeConversionValue : obtenir la plus grande valeur de conversion possible pour le budget.
  • targetRoas avec targetRoas : la même chose, en visant ce retour sur les dépenses publicitaires, par exemple 3.5 pour 350 %.
boolean
requis
Google exige cette déclaration pour chaque campagne.
string[]
Les ID de zones géographiques Google, par exemple 2840 pour les États-Unis. Omettez ce champ pour cibler toutes les zones géographiques.
object
requis

Images

Ayrshare télécharge chaque image depuis son URL et la vérifie avant d’envoyer quoi que ce soit à Google :
  • GIF, JPG ou PNG, jusqu’à 5120 Ko chacune.
  • Au moins la taille minimale indiquée ci-dessus, avec le format de son champ (à 1 % près).
  • Toutes les images ensemble jusqu’à 45 Mo.
  • L’URL doit être publique. Les adresses privées sont refusées.
Une image non conforme renvoie code: 101 en la nommant, par exemple platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.