Effectuer le suivi des publicités sur iOS track-ads-on-ios
Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x.
Constantes de suivi des publicités
ADBMediaHeartbeatEventAdBreakStartADBMediaHeartbeatEventAdBreakCompleteADBMediaHeartbeatEventAdStartADBMediaHeartbeatEventAdCompleteADBMediaHeartbeatEventAdSkipProcédure de mise en œuvre
-
Identifiez le moment où la limite de coupure publicitaire commence, y compris preroll, et créez un
AdBreakObjectà l’aide des informations de coupure publicitaire.Référence
AdBreakObject:table 0-row-3 1-row-3 2-row-3 3-row-3 3-align-center 7-align-center 11-align-center 15-align-center Nom de variable Description Obligatoire nameNom de la coupure publicitaire tel que pre-roll, mid-roll et post-roll. Oui positionPosition du numéro de la coupure publicitaire dans le contenu, en commençant par 1. Oui startTimeValeur du curseur de lecture au début de la coupure publicitaire. Oui Création d’objet de coupure publicitaire :
code language-none id adBreakObject = [ADBMediaHeartbeat createAdBreakObjectWithName:[ADBREAK_NAME] position:[POSITION] startTime:[START_TIME]]; -
Appelez
trackEvent()avecAdBreakStartdans l’instanceMediaHeartbeatpour commencer le suivi de la coupure publicitaire :code language-none - (void)onAdBreakStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakStart mediaObject:adBreakObject data:nil]; } -
Déterminez le moment où la publicité commence, puis créez une instance
AdObjectà l’aide des informations sur la publicité.Référence
AdObject:table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center Nom de variable Description Obligatoire nameNom convivial de la publicité. Oui adIdIdentifiant unique de la publicité. Oui positionPosition du numéro de la publicité dans la coupure publicitaire, en commençant par 1. Oui lengthLongueur de la publicité Oui Création d’objet publicitaire :
code language-none id adObject = [ADBMediaHeartbeat createAdObjectWithName:[AD_NAME] adId:[AD_ID] position:[POSITION] length:[LENGTH]]; -
Vous pouvez joindre des métadonnées standard et/ou de publicité à la session de suivi multimédia par le biais de variables de données contextuelles.
-
Métadonnées de publicité personnalisées - Pour les métadonnées personnalisées, créez un objet de variable pour les variables de données personnalisées et renseignez les données de la publicité actuelle :
code language-none NSMutableDictionary *adDictionary = [[NSMutableDictionary alloc] init]; [adDictionary setObject:@"Sample affiliate" forKey:@"affiliate"]; [adDictionary setObject:@"Sample campaign" forKey:@"campaign"]; [adDictionary setObject:@"Sample creative" forKey:@"creative"];
-
Appelez
trackEvent()avec l’événementAdStartdans l’instanceMediaHeartbeatpour commencer le suivi de la lecture de publicité.Incluez une référence à votre variable de métadonnées personnalisées (ou un objet vide) comme troisième paramètre dans l’appel d’événement :
code language-none - (void)onAdStart:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdStart mediaObject:adObject data:adDictionary]; } -
Lorsque la lecture de la publicité atteint la fin de la publicité, appelez
trackEvent()avec l’événementAdComplete.code language-none - (void)onAdComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdComplete mediaObject:nil data:nil]; } -
Si la lecture de la publicité ne s’est pas terminée car l’utilisateur a choisi d’ignorer la publicité, effectuez le suivi de l’événement
AdSkip.code language-none - (void)onAdSkip:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdSkip mediaObject:nil data:nil]; } -
S’il existe d’autres publicités dans le même
AdBreak, répétez les étapes 3 à 7. -
Lorsque la coupure publicitaire est terminée, utilisez l’événement
AdBreakCompletepour en effectuer le suivi :code language-none - (void)onAdBreakComplete:(NSNotification *)notification { [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventAdBreakComplete mediaObject:nil data:nil]; }
Consultez le scénario de suivi Lecture VOD avec publicités preroll pour en savoir plus.