PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Propriétés spécifiques à la description des variables de type gglAdWAnnonceLocalisée
  • Codes des pays
  • Codes des régions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
gglAdWAnnonceLocalisée (Type de variable)
En anglais : gglAdWLocaLBusinessAd (Type of variable)
Avertissement
A partir de la version 17, cette fonctionnalité n'est plus disponible. Pour utiliser Google AdWords, consultez l'API Google correspondante : https://developers.google.com/adwords/api/docs/guides/start
Le type gglAdWAnnonceLocalisée permet de décrire une annonce publicitaire Google AdWords de type "Annonce localisée". Les annonces localisées sont des annonces AdWords associées à des adresses commerciales spécifiques. Elles s'affichent sur Google, Google Maps ainsi que sur l'ensemble du réseau publicitaire Google.
Les caractéristiques de cette annonce localisée peuvent être définies et modifiées à l'aide de différentes propriétés WLangage.
Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
Exemple
// Connexion à Google AdWords
Cnx est un gglAdWConnexion
Cnx..Email = "balthazar@gmail.com"
Cnx..MotDePasse = "azerty"
Cnx..AgentUtilisateur = "MonAppli-01"
Cnx..JetonDéveloppeur = "ABcdeFGH93KL-NOPQ_STUv"
Cnx..JetonApplication = "ZYXwvu-TSR123_456ABCDE"
Cnx..ModeBacASable = Vrai

// Récupération d'une annonce à partir de son identifiant
MonVariant est un Variant
MonVariant = GglAdWRécupèreAnnonce(Cnx, "5544")
MonAnnonce est un gglAdWAnnonceLocalisée = MonVariant

// Modification de l'annonce
MonAnnonce..URLDestination = "http://nouvelleurl.com"
// Application des changements sur le serveur
MonTableau est un tableau de Variant
Ajoute(MonTableau, MonAnnonce)
GglEcrit(Cnx, MonTableau)
Remarques

Propriétés spécifiques à la description des variables de type gglAdWAnnonceLocalisée

Les propriétés suivantes peuvent être utilisées pour manipuler une annonce publicitaire Google AdWords de type "Annonce localisée" :
Nom Type manipulé Effet
AdresseChaîne de caractèresAdresse postale de l'annonce. Cette propriété est optionnelle.
Si cette propriété est spécifiée, elle doit correspondre à l'adresse de l'entreprise identifiée par la propriété CléEntreprise.
CléEntrepriseChaîne de caractèresClé correspondante à l'entreprise ciblé. Cette propriété doit être renseignée uniquement lors de la création de l'annonce (cette propriété n'est pas renseignée lors de la modification d'une annonce existante).
Les clés d'entreprise peuvent être obtenues grâce à la fonction GglAdWListeEntreprise.
CodePaysChaîne de caractèresPays de l'annonce. Cette propriété est obligatoire : elle doit correspondre au pays de l'entreprise identifiée par la propriété CléEntreprise.
CodePostalChaîne de caractèresCode postal de l'annonce. Cette propriété est optionnelle.
Si cette propriété est spécifiée, elle doit correspondre au code postal de l'entreprise identifiée par la propriété CléEntreprise.
DemandeExceptionChaîne de caractèresTexte permettant d'expliquer pourquoi l'annonce viole les conditions d'utilisation du service (300 caractères maximum). Ce texte permet également de demander une exception à cette violation.
DésapprouvéeBooléen
  • Vrai si l'annonce a été désapprouvée par Google,
  • Faux dans le cas contraire. Cette propriété est disponible en lecture uniquement.
DescriptionLigne1Chaîne de caractèresPremière ligne du texte de l'annonce (35 caractères maximum).
DescriptionLigne2Chaîne de caractèresSeconde ligne du texte de l'annonce (35 caractères maximum).
EtatConstante de type chaîneEtat courant de l'annonce.
Les valeurs disponibles sont :
  • gglActif : Annonce active.
  • gglEnPause : Annonce en pause.
  • gglEffacé : Annonce effacée.
IcônePersogglAdWImageCaractéristiques de l'icône personnalisée associée à l'annonce. Cette icône correspond à une image 16x16 pixels.
Cette propriété est utilisée uniquement lors de la création d'une nouvelle annonce. Pour modifier cette icône, il faut supprimer l'annonce puis la recréer.
IcônePrédéfinieChaîne de caractèresIndique l'icône prédéfinie à utiliser dans l'annonce.
Les valeurs possibles sont :

Remarque : Pour identifier l'annonce sur une carte, il est nécessaire d'indiquer une des trois propriétés suivantes : IcônePrédéfinie, IcônePerso et IdentifiantIcônePerso. Ces trois propriétés sont exclusives : une seule des trois propriétés doit être indiquée.
IdentifiantChaîne de caractèresIdentifiant de l'annonce. Cet identifiant est associé à l'annonce par le service d'annonces Google AdWords lors de la création de l'annonce. Cette propriété est disponible en lecture uniquement.
IdentifiantGroupeChaîne de caractèresIdentifiant du groupe d'annonces auquel appartient l'annonce. Cette propriété est utilisable en écriture uniquement lors de la création de l'annonce. Dans les autres cas, cette propriété est disponible en lecture uniquement.
IdentifiantIcônePersoChaîne de caractèresIdentifiant de l'icône personnalisée.
Lors de la création d'une nouvelle annonce, cette propriété peut être utilisée pour spécifier une image existante associée au compte Google AdWords.
Lors de la modification d'une annonce, cette propriété correspond à l'identifiant que le service des publicités Google a fourni à l'icône personnalisée (si une icône personnalisée est utilisée).
ImageEntreprisegglAdWImageCaractéristiques de l'image associée à l'entreprise dans l'annonce. La taille maximale de cette image est 125 x 125 pixels.
LatitudeRéelLatitude de l'adresse de la société exprimée en degrés. Cette propriété est disponible en lecture uniquement.
LongitudeRéelLongitude de l'adresse de la société exprimée en degrés. Cette propriété est disponible en lecture uniquement.
NomEntrepriseChaîne de caractèresNom de l'entreprise concernée par l'annonce (25 caractères maximum). Cette propriété est optionnelle.
Si cette propriété est spécifiée, elle doit correspondre au nom de l'entreprise identifiée par la propriété CléEntreprise.
NomEntrepriseCompletChaîne de caractèresNom complet de l'entreprise, qui a été éventuellement tronqué dans la propriété NomEntreprise. Cette propriété est disponible en lecture uniquement.
RayonCiblageRéelRayon de ciblage de l'annonce. Ce rayon est exprimé en kilomètres et doit être compris entre 16,09344 et 160,9344.
RégionChaîne de caractèresRégion de l'annonce. Cette propriété est optionnelle.
Si cette propriété est spécifiée, elle doit correspondre à la région de l'entreprise identifiée par la propriété CléEntreprise.
TéléphoneChaîne de caractèresNuméro de téléphone associé à l'annonce. Cette propriété est optionnelle.
TypeChaîne de caractèresType de l'annonce. Cette propriété est disponible en lecture uniquement.
Une annonce localisée est de type "LocalBusinessAd".
URLAffichéeChaîne de caractèresURL affichée dans l'annonce (35 caractères maximum). Dans cette URL, il n'est pas obligatoire d'indiquer "http://". Par exemple : "monsite.com".
URLDestinationChaîne de caractèresURL associée à l'annonce (1024 caractères maximum). Cette URL doit utiliser le format suivant : http://Nom-du-domaine. Par exemple : "http://www.monsite.com". En cliquant sur l'URL, la page correspondante sera affichée dans le navigateur de l'internaute.
VilleChaîne de caractèresVille de l'entreprise. Cette propriété est optionnelle.
Si cette propriété est spécifiée, elle doit correspondre à la ville de l'entreprise identifiée par la propriété CléEntreprise.
Remarque : Ces propriétés peuvent être utilisées en utilisant une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>

Codes des pays

Les codes des pays sont les suivants (norme ISO 3166-1) :
Identifiant - PaysIdentifiant - PaysIdentifiant - Pays
AD - AndorreAE - Émirats Arabes UnisAF - Afghanistan
AG - Antigua et BarbudaAI - AnguillaAL - Albanie
AM - ArménieAN - Antilles NéerlandaisesAO - Angola
AQ - AntarctiqueAR - ArgentineAS - Iles Samoa Américaines
AT - AutricheAU - AustralieAW - Aruba
AZ - AzerbaïdjanBA - Bosnie-HerzégovineBB - La Barbade
BD - BangladeshBE - BelgiqueBF - Burkina Faso
BG - BulgarieBH - BahreïnBI - Burundi
BJ - BéninBM - Les BermudesBN - Brunei
BO - BolivieBR - BrésilBS - Les Bahamas
BT - BhoutanBV - Ile BouvetBW - Botswana
BY - BiélorussieBZ - BelizeCA - Canada
CC - Ile CocosCD - République démocratique du CongoCF - République Centre Afrique
CG - CongoCH - SuisseCI - Côte d'ivoire
CK - Iles CookCL - ChiliCM - Cameroun
CN - ChineCO - ColombieCR - Costa Rica
CS - Serbie et MonténégroCV - Cap VertCX - Ile Christmas
CY - ChypreCZ - TchéquieDE - Allemagne
DJ - DjiboutiDK - DanemarkDM - Dominique
DO - République DominicaineDZ - AlgérieEC - Equateur
EE - EstonieEG - EgypteEH - Ouest Saharien
ER - ErythréeES - EspagneET - Ethiopie
FI - FinlandeFJ - FidjiFK - Iles Malouines
FM - MicronésieFO - Iles FéroéFR - France
GA - GabonGB - Grande BretagneGD - Grenade
GE - GéorgieGF - Guinée FrançaiseGH - Ghana
GI - GibraltarGL - GroenlandGM - Gambie
GN - GuinéeGP - GuadeloupeGQ - Guinée Equatoriale
GR - GrèceGS - Géorgie du sud et les iles Sandwich du sudGT - Guatemala
GU - GuamGW - Guinée BissauGY - Guyane
HK - Hong KongHM - Iles Heard et MacDonaldHN - Honduras
HR - CroatieHT - HaïtiHU - Hongrie
ID - IndonésieIE - IrlandeIL - Israël
IN - IndeIO - British Indian Ocean TerritoryIQ - Irak
IS - IslandeIT - ItalieJM - Jamaïque
JO - JordanieJP - JaponKE - Kenya
KG - KyrgyzstanKH - CambodgeKI - Kiribati
KM - Les ComoresKN - Saint Kitts et NevisKR - Corée du sud
KW - KoweïtKY - Iles CaymanKZ - Kazakhstan
LA - République Démocratique du LaosLB - LibanLC - Sainte Lucie
LI - LiechtensteinLK - Sri LankaLR - Libéria
LS - LesothoLT - LituanieLU - Luxembourg
LV - LettonieLY - LibyeMA - Maroc
MC - MonacoMD - MoldavieMG - Madagascar
MH - Iles MarshallMK - MacédoineML - Mali
MO - MacaoMP - Iles Marianne du nordMQ - Martinique
MR - MauritanieMS - MontserratMT - Malte
MU - Ile MauriceMV - MaldivesMW- Malawi
MX - MexiqueMY - MalaisieMZ - Mozambique
NA - NamibieNC - Nouvelle CalédonieNE - Niger
NF - Iles NorfolkNG - NigériaNI - Nicaragua
NL - Pays-BasNO - NorvègeNP - Népal
NR - NauruNU - NiueNZ - Nouvelle-Zélande
OM - OmanPA - PanamaPE - Pérou
PF - Polynésie FrançaisePG - Papouasie Nouvelle GuinéePH - Philippines
PK - PakistanPL - PolognePM - Saint Pierre et Miquelon
PN - Iles PitcairnPR - Porto RicoPS - Territoire Palestinien
PT - PortugalPW - PalauPY - Paraguay
QA - QatarRE - Ile de la RéunionRO - Roumanie
RU - RussieRW - RwandaSA - Arabie Saoudite
SB - Iles SalomonSC - SeychellesSE - Suède
SG - SingapourSH - Sainte HélèneSI - Slovénie
SJ - Iles Svalbard et Jan MayenSK - SlovaquieSL - Sierra Leone
SM - San MarinSN - SénégalSO - Somalie
SR - SurinamST - Sao Tome et PrincipeSV - Salvador
SZ - SwazilandTC - Iles Turques et CaïquesTD - Tchad
TF - Territoires Français du sudTG - TogoTH - Thaïlande
TJ - TadjikistanTK - TokelauTL - Est Timor
TM - TurkménistanTN - TunisieTO - Tonga
TR - TurquieTT - Trinidad et TobagoTV - Tuvalu
TW - TaiwanTZ - TanzanieUA - Ukraine
UG - OugandaUM - United States Minor Outlying IslandsUS - Etats-Unis
UY - UruguayUZ - OuzbékistanVA - Vatican
VC - Saint Vincent et GrenadinesVE - VenezuelaVG - Iles vierges britanniques
VI - Iles Vierges USVN - VietnamVU - Ile Vanuatu
WF - Wallis et FutunaWS - SamoaYE - Yémen
YT - MayotteZA - Afrique du sudZM - Zambie
ZW - Zimbabwe
Cette liste est celle gérée à la date de rédaction de cette documentation. Pour connaître la liste exhaustive des pays gérés, consultez la page http://code.google.com/intl/fr/apis/adwords/docs/developer/adwords_api_countries.html.

Codes des régions

Pour connaître la liste exhaustive des régions gérées, consultez la page http://code.google.com/intl/fr/apis/adwords/docs/developer/adwords_api_regions.html.
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire