Utiliser les paramètres de coupure publicitaire

L'API Ad Break vous permet de définir les paramètres du tag d'emplacement publicitaire à l'aide de paramètres de coupure publicitaire. Vous pouvez ainsi améliorer la précision du ciblage des annonces et l'intégration aux serveurs publicitaires.

Remplacer les paramètres du tag d'emplacement publicitaire

Pour remplacer les paramètres du tag d'emplacement publicitaire du flux Google DAI, définissez le champ breakParams.adTagParams de la coupure publicitaire. Pour en savoir plus, consultez Indiquer des paramètres de ciblage dans votre flux et Tous les paramètres du tag d'emplacement publicitaire VAST.

L'exemple suivant montre un tag d'emplacement publicitaire de flux DAI contenant le paramètre de requête mridx (numéro de mid-roll) :

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&...

L'exemple de requête suivant crée un emplacement publicitaire qui remplace la valeur de ciblage mridx :

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakParams": {
      "adTagParams": [{"key": "mridx", "value": "7"}]
    }
  }'

Remplacez les éléments suivants :

Développer un tag d'emplacement publicitaire avec des macros d'insertion dynamique d'annonce

L'insertion dynamique d'annonces Google est compatible avec les macros de tags d'emplacement publicitaire au format %%DAI_PATTERN:MACRO_NAME%%. Le nom de la macro doit être au format UPPER_CASE et ne contenir que des lettres majuscules, des chiffres et des traits de soulignement.

Vous pouvez insérer ces macros dans le tag d'emplacement publicitaire du flux Google DAI ou dans la demande de flux DAI pour définir les macros avec les valeurs de votre champ breakParams.macros.

L'exemple suivant montre un tag d'emplacement publicitaire de flux Google DAI contenant une macro BREAK_TYPE :

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&...

La requête suivante met à jour une coupure publicitaire et définit la valeur de la macro BREAK_TYPE :

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
    "name": "networks/.../assets/.../adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:10:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakState": "BREAK_STATE_SCHEDULED",
    "breakParams": {
      "macros": [{"key": "BREAK_TYPE", "value": "national"}]
    }
  }'

Remplacez AD_BREAK_ID par l'ID de votre coupure publicitaire.

L'insertion dynamique d'annonces Google résout le tag d'emplacement publicitaire avec la macro comme suit :

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&...

Développer un tag d'emplacement publicitaire avec des macros SCTE-35

Lorsque vous configurez votre événement de diffusion en direct Google DAI, vous pouvez placer des macros SCTE-35 dans le tag d'emplacement publicitaire principal.

Lorsque l'événement en direct commence, vous pouvez insérer des données SCTE-35 dans le fichier manifeste du contenu ou appeler l'API DAI Ad Break en incluant les données SCTE-35 dans le paramètre scte35CueOut. Google DAI utilise les données décodées pour remplir les macros SCTE-35 dans le tag d'emplacement publicitaire.

L'exemple suivant utilise la macro %%TIME_SIGNAL_UPID_RAW%% :

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&...

L'exemple suivant utilise JSON pour illustrer les données de signal temporel SCTE-35 :

{
  "splice_info_section": {
    ...
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        ...
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          ...
        }
      }
    ]
  }
}

L'insertion dynamique d'annonces Google résout la balise d'annonce avec la macro SCTE-35 comme suit :

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&...