Objet de données de planification - Gestion des campagnes

Définit les plages de dates de début et de fin pour la planification des extensions publicitaires.

Utilisez les éléments StartDate et EndDate pour la planification au niveau du calendrier, puis utilisez DayTimeRanges pour limiter la planification par jour de la semaine, heure et minute.

Syntaxe

XML

<xs:complexType name="Schedule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="DayTimeRanges" nillable="true" type="tns:ArrayOfDayTime" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="UseSearcherTimeZone" nillable="true" type="xs:boolean" />
  </xs:sequence>
</xs:complexType>

JSON

{
  "DayTimeRanges": [
    {
      "Day": "ValueHere",
      "EndHour": IntValueHere,
      "EndMinute": "ValueHere",
      "StartHour": IntValueHere,
      "StartMinute": "ValueHere"
    }
  ],
  "EndDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "StartDate": {
    "Day": IntValueHere,
    "Month": IntValueHere,
    "Year": IntValueHere
  },
  "UseSearcherTimeZone": "ValueHere"
}

Éléments

L’objet Schedule contient les éléments suivants : DayTimeRanges, EndDate, StartDate, UseSearcherTimeZone.

Élément	Description	Type de données
DayTimeRanges	Liste des plages de jours et de temps. Chaque jour et intervalle de temps inclut le jour de la semaine, l’heure de début/fin et la minute de début/fin planifiée. Ajouter: Optionnel. Si vous définissez cet élément sur null, les extensions publicitaires sont éligibles pour la planification à tout moment pendant les dates de début et de fin du calendrier. Mettre à jour: Optionnel. Les objets DayTime individuels ne peuvent pas être mis à jour. Vous pouvez mettre à jour efficacement les plages de jours et de temps en envoyant une nouvelle liste de tous les paramètres DayTime qui doivent remplacer l’ensemble précédent. Si vous définissez cet élément sur null, vous supprimez efficacement toutes les plages de jours et de temps existantes.	Tableau DayTime
EndDate	Date de fin planifiée. La date de fin est incluse. Par exemple, si vous définissez EndDate sur 31/12/2020, les extensions d’annonce cesseront d’être affichées à 23h59 le 31/12/2020. Ajouter: Obligatoire avec un FlyerAdExtension ; Facultatif pour les autres types d’extension d’annonce. Pour la plupart des types d’extensions publicitaires, si vous ne spécifiez pas de date de fin, les extensions publicitaires continueront d’être remises, sauf si vous suspendez les campagnes, groupes d’annonces ou annonces associés. Mettre à jour: Optionnel. Pour la plupart des types d’extension d’annonce, la date de fin peut être raccourcie ou prolongée, tant que la date de début est null ou se produit avant la nouvelle date de fin. Si vous définissez la date de fin sur Null, vous supprimez effectivement la date de fin et les extensions publicitaires continueront d’être remises, sauf si vous suspendez les campagnes, groupes d’annonces ou annonces associés. Avec un FlyerAdExtension , vous ne pouvez pas supprimer la date de fin. La date de fin peut être raccourcie ou prolongée, à condition que la date de début se produise jusqu’à 30 jours avant la nouvelle date de fin.	Date
StartDate	Date de début planifiée. La date de début est incluse. Par exemple, si vous définissez StartDate sur 5/5/2020, les extensions publicitaires commenceront à s’afficher à 12:00 le 5/5/2020. Ajouter: Obligatoire avec un FlyerAdExtension ; Facultatif pour les autres types d’extension d’annonce. Si vous ne spécifiez pas de date de début, les extensions d’annonce sont immédiatement éligibles pour être planifiées pendant la journée et les intervalles de temps. Mettre à jour: Optionnel. Pour la plupart des types d’extension d’annonce, la date de début peut être raccourcie ou prolongée, tant que la date de fin est null ou se produit après la nouvelle date de début. Si vous définissez la date de début sur null, vous supprimez effectivement la date de début et les extensions publicitaires sont immédiatement éligibles pour être planifiées pendant les intervalles de jour et de temps. Avec un FlyerAdExtension , vous ne pouvez pas supprimer la date de début. La date de début peut être raccourcie ou prolongée, à condition que la date de fin se produise jusqu’à 30 jours après la nouvelle date de début.	Date
UseSearcherTimeZone	Détermine s’il faut utiliser le fuseau horaire du compte ou le fuseau horaire de l’utilisateur de recherche où les publicités peuvent être remises. Affectez à cette propriété la valeur true si vous souhaitez que les extensions publicitaires s’affichent dans le fuseau horaire de l’utilisateur de recherche et définissez-la sur false. Ajouter: Optionnel. Si vous ne spécifiez pas cet élément ou laissez-le null, la valeur par défaut false est définie et le fuseau horaire du compte est utilisé. Mettre à jour: Lorsque vous mettez à jour une planification, les paramètres existants sont remplacés par le nouveau paramètre. Par conséquent, si vous mettez à jour une planification et laissez cet élément null, vous réinitialisez la valeur par défaut false.	boolean

Configuration requise

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

Utilisé par

AdExtension