Partager via


Objet de données de fréquence - Gestion des campagnes

Détermine si un travail d’importation doit être exécuté une seule fois ou planifié sur une base périodique.

Vous pouvez planifier une importation périodique, par exemple, « Tous les dimanches à 16h00 » ou vous pouvez exécuter l’importation une seule fois.

  • Automatique : Microsoft Advertising exécutera des importations selon une planification variable qui optimisera au mieux vos campagnes.
  • Maintenant : importez une fois dès que vous appelez l’opération AddImportJobs .
  • Une fois : importez une fois à l’heure que vous spécifiez.
  • Quotidienne : importez une fois par jour à l’heure que vous spécifiez.
  • Hebdomadaire : importez une fois par semaine à l’heure que vous spécifiez.
  • Monthly : importez une fois par mois à l’heure que vous spécifiez.

Pour exécuter l’importation « now », vous pouvez laisser l’élément Frequency du travail d’importation Google zéro ou vide. Pour toutes les autres options de planification, définissez les valeurs Type de fréquence et Cron . Pour plus d’informations sur les valeurs de fréquence prises en charge, consultez les remarques ci-dessous.

Syntaxe

<xs:complexType name="Frequency" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Cron" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet Frequency contient les éléments suivants : Cron, TimeZone, Type.

Élément Description Type de données
Cron Représente une implémentation simplifiée de la fréquence Cron.

Par exemple, définissez la chaîne sur « 0 16 * * 3 * » si vous souhaitez que l’importation s’exécute chaque semaine, tous les mercredis à 16h00.

Pour plus d’informations sur les valeurs de fréquence prises en charge, consultez les remarques.

Ajouter: Obligatoire si le type est défini sur « Planification » et que, sinon, la valeur cron est ignorée.
chaîne
Fuseau horaire Fuseau horaire utilisé pour la planification de l’importation.

Pour connaître les valeurs possibles, consultez Fuseaux horaires.

Ajouter: Optionnel. Si vous ne définissez pas cet élément, « GreenwichMeanTimeDublinEdinburghLisbonLondon » (UTC+0) sera utilisé par défaut.
chaîne
Type Type de fréquence de planification.

Définissez cet élément sur « Planification » si vous souhaitez choisir une valeur Cron spécifique, que le travail d’importation s’exécute une seule fois ou de façon périodique.

Définissez cet élément sur « Auto » si vous souhaitez que Microsoft Advertising exécute des importations selon une planification variable qui optimisera au mieux vos campagnes.

Si vous souhaitez que l’importation s’exécute maintenant, vous pouvez définir cet élément sur « RunNow » ou ne pas du tout définir l’élément Frequency du travail d’importation Google.

Ajouter: Obligatoire
chaîne

Remarques

Les importations planifiées prennent en charge une implémentation simplifiée de Cron avec jusqu’à six composants commandés.

* * * * * *
- - - - - -
| | | | | | 
| | | | | +----- year (1 - 9999) 
| | | | +----- day of week (0 - 6) (Sunday=0)
| | | +------- month (1 - 12)
| | +--------- day of month (1 - 31)
| +----------- hour (0 - 23)
+------------- min (0)

Voici quelques exemples valides.

Chaîne Cron Fréquence d’importation
"0 2 15 09 * 2020" Exécution une fois le 15 septembre 2020 à 02:00
"0 16 * * * *" Exécution quotidienne à 16h00
"0 16 * * 3 *" Exécution hebdomadaire, tous les mercredis à 16h00
"0 16 1 * * *" Exécution mensuelle, le 1er jour de chaque mois à 16h00

Configuration requise

Service : CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

ImportJob