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