Passer au contenu principal
POST
Créez une campagne Google Ads sur le Réseau de Recherche en une seule requête. Ayrshare crée ensemble le budget, la campagne, un groupe d’annonces, vos mots clés, une annonce responsive sur le Réseau de Recherche et le ciblage géographique. 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. Cette page présente ce qui est propre à Google.
  • Les annonces Google sont activées compte par compte. Contactez-nous pour les activer.
  • Associez d’abord Google Ads depuis la page “Social Accounts”. accountId est l’ID client Google Ads à 10 chiffres, avec ou sans tirets (123-456-7890).
  • L’utilisateur Google que vous associez doit avoir un accès direct au compte publicitaire. Les comptes auxquels vous accédez uniquement via un compte administrateur ne sont pas listés et ne peuvent pas encore être utilisés : ajoutez cet utilisateur directement au compte publicitaire. Les comptes administrateur ne sont pas listés non plus : ils ne peuvent pas contenir de campagnes.
  • Les nouvelles campagnes démarrent en paused sauf si vous envoyez status: "active".
  • Le budget est quotidien, dans la devise du compte publicitaire. N’envoyez pas budget.currency : il renvoie code: 101.
  • 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éé.
  • Les annonces sont diffusées uniquement sur Google Search, et non sur les partenaires du Réseau de Recherche ni sur le Réseau Display.
Suivi des conversions. maximizeConversions ne fonctionne que si le suivi des conversions est configuré dans votre compte Google Ads. Ayrshare ne le configure pas pour vous. Sans lui, utilisez maximizeClicks ou manualCpc.

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 et ne crée rien de nouveau. Lorsqu’une création échoue avant qu’Ayrshare n’envoie la campagne à Google, la clé est libérée : vous pouvez donc corriger la requête et réessayer avec la même clé. Cela couvre une valeur refusée par Ayrshare (comme une stratégie d’enchères non prise en charge), un compte dans une devise qui ne peut pas être convertie en USD, et tout échec de la vérification du compte qu’Ayrshare effectue en premier, y compris un refus de Google. Une création qui échoue une fois la campagne envoyée à Google conserve sa réponse : réessayez-la avec une nouvelle clé.

Paramètres du corps

Les champs communs fonctionnent comme décrit dans Campagnes publicitaires. Sur Google :
string
requis
search.
string
requis
maximizeClicks, manualCpc ou maximizeConversions. Toute autre valeur renvoie code: 101.
boolean
requis
Google exige cette déclaration pour chaque campagne. Tant qu’une campagne d’un compte n’est pas déclarée, Google refuse toute modification des campagnes de ce compte.
object
Google planifie des journées entières dans le fuseau horaire du compte publicitaire. start commence à 00:00:00 le jour indiqué et end s’arrête à 23:59:59 le jour indiqué ; l’heure que vous envoyez ne sert qu’à choisir le jour. start peut être aujourd’hui, mais pas un jour antérieur. Pour une campagne d’une seule journée, envoyez la même date pour start et end. Un end tombant un jour antérieur à start renvoie code: 101.
object
Google associe les annonces sur le Réseau de Recherche aux internautes en fonction de la langue du texte de votre annonce : il n’y a donc pas de paramètre de langue. Envoyer targeting.languages renvoie code: 101.
object
requis

Erreurs