AdSelectionManager.ReportImpression Méthode

[Android.Runtime.Register("reportImpression", "(Landroid/adservices/adselection/ReportImpressionRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetReportImpression_Landroid_adservices_adselection_ReportImpressionRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)]
public virtual void ReportImpression(Android.AdServices.AdSelection.ReportImpressionRequest request, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);

[<Android.Runtime.Register("reportImpression", "(Landroid/adservices/adselection/ReportImpressionRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetReportImpression_Landroid_adservices_adselection_ReportImpressionRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)>]
abstract member ReportImpression : Android.AdServices.AdSelection.ReportImpressionRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.ReportImpression : Android.AdServices.AdSelection.ReportImpressionRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

Paramètres

Attributs

RegisterAttribute

Remarques

Avertit le service qu’il y a une nouvelle impression de signaler la publicité sélectionnée par l’exécution de sélection de publicité identifiée par adSelectionId. Il n’y a aucune garantie quant au moment où l’impression sera signalée. Les rapports d’impression peuvent être retardés et les rapports peuvent être traités par lots.

Pour calculer l’URL de création de rapports du vendeur gagnant, le service extrait la logique JavaScript du vendeur à partir de l’URL AdSelectionConfig#getDecisionLogicUri() trouvée à l’adresse ReportImpressionRequest#getAdSelectionConfig(). Ensuite, le service exécute l’une des fonctions trouvées dans le JS vendeur appelé reportResult, fournissant des signaux sur l’appareil ainsi que des ReportImpressionRequest#getAdSelectionConfig() paramètres d’entrée.

La définition de la fonction est reportResult la suivante :

function reportResult(ad_selection_config, render_url, bid, contextual_signals) { return { 'status': status, 'results': {'signals_for_buyer': signals_for_buyer, 'reporting_url': reporting_url}; }}

Pour calculer l’URL de création de rapports de l’acheteur gagnant, le service extrait la logique JavaScript de l’acheteur gagnant qui est extraite par le biais de android.adservices.customaudience.CustomAudience#getBiddingLogicUri()l’acheteur. Ensuite, le service exécute l’une des fonctions trouvées dans le JS acheteur appelé reportWin, fournissant des signaux sur l’appareil, signals_for_buyer calculés par reportResultet des champs spécifiques à partir des ReportImpressionRequest#getAdSelectionConfig() paramètres d’entrée.

La définition de la fonction est reportWin la suivante :

function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer, contextual_signals, custom_audience_reporting_signals) { return {'status': 0, 'results': {'reporting_url': reporting_url}; }}

En outre, les acheteurs et les vendeurs ont la possibilité de s’inscrire pour recevoir des rapports sur des événements publicitaires spécifiques. Pour ce faire, ils peuvent appeler la plateforme fournie registerAdBeacon fonction à l’intérieur reportWin et reportResult pour les acheteurs et les vendeurs, respectivement.

La définition de la fonction est registerBeacon la suivante :

function registerAdBeacon(beacons), où beacons est une dictée de chaîne en paires de chaînes

Pour chaque événement publicitaire pour lequel un acheteur/vendeur est intéressé par les rapports, ils ajouteraient une event_keypaire : event_reporting_uri à la beacons dictée, où event_key est un identificateur pour cet événement spécifique. Cela event_key doit correspondre ReportEventRequest#getKey() lorsque le KIT de développement logiciel (SDK) appelle #reportEvent. En outre, chacun event_reporting_uri doit analyser correctement dans un android.net.Uri. Il s’agit du android.net.Uri rapport auquel le SDK appelle #reportEvent.

Lorsque l’acheteur/vendeur a ajouté tous les jumelages pour lesquels ils veulent recevoir des événements, ils peuvent appeler registerAdBeacon(beacons), où beacons est le nom de la dictée auquel ils ont ajouté les paires.

registerAdBeacon lève une TypeError exception dans ces situations :

<ol><li>registerAdBeaconest appelé plus d’une fois. Si cette erreur est interceptée dans reportWin/reportResult, l’ensemble d’origine de jumelages est inscrit <li>registerAdBeacon n’a pas exactement 1 argument de dict. <li>Le contenu de l’argument dicté 1 ne sont pas tous String: String des jumelages. </ol>

La sortie est passée par le receiver, qui retourne un vide Object pour une exécution réussie, ou inclut Exception le type de l’exception levée et le message d’erreur correspondant.

Si la IllegalArgumentException valeur est levée, elle est due à l’argument d’entrée non valide reçu par l’API reçue pour signaler l’impression.

Si le IllegalStateException message d’erreur « Échec des services AdSelection » est déclenché par une défaillance interne du service de sélection de publicité.

Si la LimitExceededException valeur est levée, elle est provoquée lorsque le package appelant dépasse les limites de débit autorisées et est limitée.

Si la SecurityException valeur est levée, elle est provoquée lorsque l’appelant n’est pas autorisé ou que l’autorisation n’est pas demandée.

Les impressions seront signalées au plus une fois comme une tentative de meilleur effort.

Java documentation pour android.adservices.adselection.AdSelectionManager.reportImpression(android.adservices.adselection.ReportImpressionRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver<java.lang.Object, java.lang.Exception>).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.