Aperçu
Même si les SDK du lecteur natif n'effectuent pas de remplacement de macro côté client, vous pouvez ajouter manuellement des paramètres de chaîne de requête pour le ciblage publicitaire. Cela peut être fait pour les annonces côté client ou côté serveur.
Pour en savoir plus sur les paramètres d'URL, consultez le Variables publicitaires section du document de l'API Video Cloud SSAI Ad Config.
Annonces côté client
Vous pouvez fournir des valeurs personnalisées via des paramètres d'URL ajoutés à l'URL VMAP.
Implémentation Android
Les paires clé/valeur de ciblage des annonces peuvent être ajoutées à l'URL de votre tag d'emplacement publicitaire de deux manières :
-
Ajoutez vos paires clé/valeur directement à l'URL du tag d'emplacement publicitaire. Google IMA permet l'ajout de paires clé/valeur de ciblage publicitaire à l'aide de la
cust_params
paramètre. Pour plus de détails, voir Google Ajouter des valeurs-clés à un tag de redirection vidéo maître document. -
Appliquez une carte de valeurs à l'URL du tag d'emplacement publicitaire à l'aide de la
updateAdTargetingValues
méthode pour leGoogleIMAComponent
.
Quelle que soit l'approche, les paires clé/valeur sont ajoutées à l'URL du tag d'emplacement publicitaire dans le ADS_REQUEST_FOR_VIDEO
écouteur d'événement. L'exemple de code ci-dessous ajoute les paires clé/valeur en utilisant le updateAdTargetingValues
méthode pour le GoogleIMAComponent
.
Voici le code pour créer une carte de paires clé/valeur, en utilisant la CUSTOM_FIELDS
propriété de la propriété Video
objet de l' ADS_REQUEST_FOR_VIDEO
événement :
Voici un exemple de code complet pour le ADS_REQUEST_FOR_VIDEO
l'écouteur d'événement, qui est ajouté à la méthode de configuration du plug-in Google IMA :
Implémentation iOS
Pour ajouter des paramètres de requête publicitaire avec le SDK natif pour iOS, procédez comme suit :
-
Commencez avec l'un des exemples de code côté client pour la publicité IMA avec le Brightcove Native SDK :
-
Ajoutez les paramètres de requête d'URL à l'URL VMAP avant d'appeler le plug-in IMA. Cela peut être fait avant les méthodes suivantes :
Annonces côté serveur
Pour fournir des valeurs personnalisées via les paramètres d'URL ajoutés à l'URL VMAP, procédez comme suit :
-
Avec un identifiant de configuration d'annonce SSAI, récupérez un objet vidéo du catalogue Brightcove (API de lecture). Découvrez comment créer une configuration d'annonce avec le Implémentation des publicités côté serveur avec les SDK Native Player document.
Voici un exemple de configuration d'annonce :
-
Dans le jsonResponse de l'appel à l'API de lecture, examinez les sources de l'objet vidéo. Chaque objet source contiendra une propriété VMAP et une URL VMAP. Sélectionnez et extrayez l'URL VMAP.
-
Imaginons que l'URL de votre annonce ressemble à ceci :
Si votre URL d'annonce contient les macros d'annonces ci-dessus, vous ajouterez ces paramètres de requête aux URL VMAP avec les valeurs appropriées.
-
Ajoutez les paramètres de requête à l'URL VMAP. Dans cet exemple, la
macro figurant dans l'URL de l'annonce est remplacée par la valeur
discos-enabled
, et lamacro est remplacée par la valeur de l'identifiant de la vidéo.
- Traitez la vidéo avec le plugin SSAI.
-
Pour plus de détails sur le développement, voir ce qui suit :
Implémentation Android
À partir de la réponse de l'API de lecture, vous pouvez extraire l'URL source VMAP appropriée et ajouter vos paramètres de requête. Pour ce faire, procédez comme suit :
- Avec un identifiant de configuration d'annonce SSAI, récupérez un objet vidéo du catalogue Brightcove (API de lecture). Pour plus de détails, consultez le Implémentation Android section du document Implémentation des publicités côté serveur avec les SDK du lecteur natif.
-
Dans le
Catalog
'sonVideo
méthode de rappel, sélectionnez et extrayez l'URL VMAP appropriée duVideo
la source par défaut de l'objet, en utilisant leSSAISourceSelector
. L'objet source renvoyé doit avoir une propriété URL VMAP. -
Ajoutez vos paramètres de requête à l'URL VMAP :
-
Traiter la mise à jour
Video
object avec le plugin SSAI comme suit :
Voici un exemple de code complet :
Implémentation iOS
À partir de la réponse de l'API de lecture, vous pouvez extraire l'URL source VMAP appropriée et ajouter vos paramètres de requête. Pour ce faire, procédez comme suit :
- Avec un identifiant de configuration d'annonce SSAI, récupérez un objet vidéo du catalogue Brightcove (API de lecture). Pour plus de détails, consultez le Implémentation iOS section du document Implémentation des publicités côté serveur avec les SDK du lecteur natif.
-
À partir de l'objet vidéo, sélectionnez et extrayez le manifeste ou l'URL VMAP approprié. À partir de la réponse du service de lecture, le jsonResponse (NSDictionary) contient le BCOVVidéo objet, qui inclut les sources qui contiennent l'URL du document VMAP. Votre code peut ressembler à ceci :
-
Ajoutez les paramètres de requête à l'URL VMAP.
-
Traitez l'URL modifiée avec le plug-in SSAI comme suit :