REST Resource: networks.sources.content.adBreaks

string

Uniquement en sortie. Nom de ressource de la coupure publicitaire. Ce champ se présente au format "networks//assets//adBreaks/".

network_code correspond au code réseau dans Google Ad Manager auquel appartient ce contenu.

asset_key correspond à la clé de l'événement de diffusion en direct dans Google Ad Manager sous lequel l'insertion publicitaire a été créée.

adBreakId est la clé de la coupure publicitaire. SORTIE UNIQUEMENT.

string (Timestamp format)

Uniquement en sortie. Date et heure de création de la coupure publicitaire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Duration format)

Obligatoire. Durée de la pause attendue.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string

Facultatif. Paires clé-valeur à inclure dans les demandes d'annonces liées à cette coupure publicitaire pour le ciblage par critères personnalisés dans Ad Manager. Exemple : "key1=value&key2=value2,value22" Obsolète : veuillez définir cust_params dans breakParams.ad_tag_params à l'aide de la clé "cust_params".

string

Facultatif. Données encodées en base64 à partir du point de sortie scte35. La commande splice_insert() ou time_signal() peut être incluse. Exemples : - avec time_signal() : "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" - avec splice_insert() : "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="

string

Facultatif. Nom du modèle de série d'annonces Google Ad Manager. Obsolète : veuillez définir cust_params dans breakParams.ad_tag_params à l'aide de la clé "ptpln".

enum (BreakState)

Uniquement en sortie. État actuel de la coupure publicitaire.

string (Timestamp format)

Facultatif. Heure de début prévue de la coupure publicitaire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

string (Duration format)

Facultatif. La coupure publicitaire expire à expectedStartTime + expireDuration. Si expectedStartTime n'est pas défini, le bloc d'annonces expirera expireDuration après le début de la prise de décision. Par défaut : 30 min Minimum : 5 min Maximum : 6 h

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

string (int64 format)

Uniquement en sortie. ID de la séquence mid-roll de la coupure publicitaire. Plusieurs pauses publicitaires peuvent avoir la même valeur breakSequence si elle est spécifiée explicitement via breakParams.ad_tag_params avec la clé mridx. Cela permet d'associer deux coupures publicitaires GAM.

object (BreakParams)

Facultatif. Paramètres de coupure à inclure dans les demandes d'annonces pour cette coupure.

object (MatchParams)

Facultatif. Utilisé pour l'insertion dynamique d'annonces assemblées afin de déterminer comment un emplacement publicitaire créé via l'API est associé à un emplacement publicitaire dans le fichier manifeste. Lorsqu'une nouvelle coupure est détectée, une fonction de correspondance est exécutée sur toutes les coupures publicitaires d'un événement dont la valeur breakState est SCHEDULED ou DECISIONED pour vérifier si tous les paramètres définis dans matchParams d'une coupure publicitaire correspondent à la coupure détectée. Une correspondance est établie si l'une des conditions suivantes est remplie : 1. L'insertion publicitaire comporte un champ "matchParams", et tous les paramètres qui y sont définis correspondent à la nouvelle insertion. 2. La coupure publicitaire est DECISIONED et ne comporte pas de champ matchParams.

Pour éviter tout comportement "tout correspond" accidentel (qui se produirait avec un matchParams vide, mais présent), matchParams ne peut pas être vide s'il est défini. Si le champ est présent dans une requête, au moins l'un de ses propres champs doit être défini.

Les coupures publicitaires sont vérifiées dans cet ordre : 1. avec matchParams, classées par ordre croissant de expectedStartTime, puis de createTime, où les coupures publicitaires sans expectedStartTime sont prioritaires lors du tri ; 2. sans matchParams, classées par ordre croissant de expectedStartTime, puis de createTime, où les coupures publicitaires sans expectedStartTime sont prioritaires lors du tri.

Si toutes les EABN en attente ne correspondent pas, la DAI reviendra au comportement de décision JIT en utilisant le prochain index de mid-roll disponible.

object (ServedBreak)

Uniquement en sortie. Cela reflète les informations réelles de la coupure publicitaire diffusée. Défini uniquement pour les coupures publicitaires avec un COMPLETE breakState.