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 des paramètres de coupure publicitaire. Cela améliore la précision du ciblage des annonces et l'intégration aux ad servers.

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 l'emplacement 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'annonce 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 point d'insertion 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 balises d'annonce au format %%DAI_PATTERN:MACRO_NAME%%. Le nom du 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 le tag d'annonce d'un 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.

Google DAI 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 la balise publicitaire principale.

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 avec les données SCTE-35 incluses 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 des 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
          …
        }
      }
    ]
  }
}

Google DAI résout le tag d'emplacement publicitaire avec la macro SCTE-35 comme suit :

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