Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4

Responsable des mesures

public class MeasurementManager
extends Object

java.lang.Object
   ↳ android.adservices.measurement.MeasurementManager


MeasurementManager fournit des API pour gérer l'enregistrement de sources et de déclencheurs.

Résumé

Constantes

int MEASUREMENT_API_STATE_DISABLED

Cet état indique que les API de mesure ne sont pas disponibles.

int MEASUREMENT_API_STATE_ENABLED

Cet état indique que les API de mesure sont activées.

Méthodes publiques

void deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<ObjectException> callback)

Supprimer les enregistrements précédents.

static MeasurementManager get(Context context)

Méthode par défaut permettant de créer une instance de MeasurementManager.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<IntegerException> callback)

Obtenez l'état de l'API Measurement.

void registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<ObjectException> callback)

Enregistre une source d'attribution (clic ou vue).

void registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

Enregistrez des sources d'attribution(clic ou vue) à partir d'un contexte d'application.

void registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<ObjectException> callback)

Enregistre un déclencheur (conversion).

void registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

Enregistre une source d'attribution(clic ou vue) à partir du contexte Web.

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

Enregistre un déclencheur d'attribution(clic ou vue) à partir du contexte Web.

Méthodes héritées

Constantes

MEASUREMENT_API_STATE_DISABLED (État de l'API de mesure désactivé)

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public static final int MEASUREMENT_API_STATE_DISABLED

Cet état indique que les API de mesure ne sont pas disponibles. Leur appel entraîne un UnsupportedOperationException

Valeur constante : 0 (0x00000000)

MEASUREMENT_API_STATE_ACTIVÉ

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public static final int MEASUREMENT_API_STATE_ENABLED

Cet état indique que les API de mesure sont activées.

Valeur constante: 1 fois (0x00000001)

Méthodes publiques

deleteRegistrations

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Supprimer les enregistrements précédents. Si la suppression aboutit, la méthode OutcomeReceiver.onResult(R) du rappel est appelée avec une valeur nulle. En cas d'échec, une Exception est envoyé via le OutcomeReceiver#onError du rappel. Réussite et échec les commentaires sont exécutés sur le Executor fourni.

Paramètres
deletionRequest DeletionRequest: requête de suppression des données. Cette valeur ne peut pas être null.

executor Executor: exécuteur pour exécuter le rappel. Cette valeur ne peut pas être null. Les événements de rappel et d'écouteur sont envoyés via Executor, ce qui permet de contrôler facilement le thread qui est utilisé. Pour envoyer des événements via le thread principal de votre vous pouvez utiliser Context.getMainExecutor() Sinon, fournissez un Executor qui sera envoyé à un thread approprié.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur ne peut pas être null.

get

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 6
public static MeasurementManager get (Context context)

Méthode par défaut permettant de créer une instance de MeasurementManager.

Paramètres
context Context: Context à utiliser Cette valeur ne peut pas être null.

Renvoie
MeasurementManager Une instance MeasurementManager Cette valeur ne peut pas être null.

getMeasurementApiStatus

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

Obtenez l'état de l'API Measurement.

La valeur Integer du rappel est l'une des valeurs MeasurementApiState.
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Paramètres
executor Executor: utilisé par le rappel pour envoyer les résultats. Cette valeur ne peut pas être null. Les événements de rappel et d'écouteur sont envoyés via Executor, ce qui permet de contrôler facilement le thread qui est utilisé. Pour envoyer des événements via le thread principal de votre vous pouvez utiliser Context.getMainExecutor() Sinon, fournissez un Executor qui sera envoyé à un thread approprié.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur ne peut pas être null.

RegisterSource

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Enregistre une source d'attribution (clic ou vue).
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Paramètres
attributionSource Uri: la plate-forme envoie une requête à cet URI afin de récupérer les métadonnées. associée à la source d'attribution. Les métadonnées de la source sont stockées sur l'appareil, ce qui il peut être mis en correspondance avec de futurs déclencheurs. Cette valeur ne peut pas être null.

inputEvent InputEvent: objet InputEvent (pour un événement de clic) ou nul (pour une vue) ).

executor Executor: utilisé par le rappel pour envoyer les résultats. Cette valeur peut être null. Les événements de rappel et d'écouteur sont envoyés via Executor, ce qui permet de contrôler facilement le thread qui est utilisé. Pour envoyer des événements via le thread principal de votre vous pouvez utiliser Context.getMainExecutor() Sinon, fournissez un Executor qui sera envoyé à un thread approprié.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur peut être null.

Génère
IllegalArgumentException si le scheme de attributionSource n'est pas HTTPS

RegisterSource

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Enregistrez des sources d'attribution(clic ou vue) à partir d'un contexte d'application. Cette API ne traitera pas toute redirection, toutes les URL d'enregistrement doivent être fournies avec la requête.
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Paramètres
request SourceRegistrationRequest: requête d'enregistrement de la source d'application Cette valeur ne peut pas être null.

executor Executor: utilisé par le rappel pour envoyer les résultats Cette valeur peut être null. Les événements de rappel et d'écouteur sont envoyés via Executor, ce qui permet de contrôler facilement le thread qui est utilisé. Pour envoyer des événements via le thread principal de votre vous pouvez utiliser Context.getMainExecutor() Sinon, fournissez un Executor qui sera envoyé à un thread approprié.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur peut être null.

RegisterTrigger

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Enregistre un déclencheur (conversion).
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Paramètres
trigger Uri: l'API envoie une requête à cet URI pour récupérer les métadonnées associées à ou un déclencheur spécifique. Les métadonnées du déclencheur sont stockées sur l'appareil et peuvent être mises en correspondance avec sources pendant le processus d'attribution. Cette valeur ne peut pas être null.

executor Executor: utilisé par le rappel pour envoyer les résultats. Cette valeur peut être null. Les événements de rappel et d'écouteur sont envoyés via Executor, ce qui permet de contrôler facilement le thread qui est utilisé. Pour envoyer des événements via le thread principal de votre vous pouvez utiliser Context.getMainExecutor() Sinon, fournissez un Executor qui sera envoyé à un thread approprié.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur peut être null.

Génère
IllegalArgumentException si le scheme de trigger n'est pas HTTPS

RegisterWebSource

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Enregistre une source d'attribution(clic ou vue) à partir du contexte Web. Cette API ne traite aucune redirections, toutes les URL d'enregistrement doivent être fournies avec la demande. Au moins l'une des valeurs suivantes : Vous devez fournir les paramètres appDestination ou webDestination. Si l'enregistrement l'opération réussit, la méthode OutcomeReceiver#onResult de callback est appelée avec la valeur null. Dans en cas d'échec, une Exception est envoyée via le OutcomeReceiver.onError(E) de callback. Les commentaires de réussite et d'échec sont exécutés sur les Executor
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Paramètres
request WebSourceRegistrationRequest: requête d'enregistrement de la source Cette valeur ne peut pas être null.

executor Executor: utilisé par le rappel pour envoyer les résultats. Cette valeur peut être null.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur peut être null.

RegisterWebTrigger

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Enregistre un déclencheur d'attribution(clic ou vue) à partir du contexte Web. Cette API ne traitera pas toute redirection, toutes les URL d'enregistrement doivent être fournies avec la requête. Si l'enregistrement l'opération réussit, la méthode OutcomeReceiver#onResult de callback est appelée avec la valeur null. Dans en cas d'échec, une Exception est envoyée via le OutcomeReceiver.onError(E) de callback. Les commentaires de réussite et d'échec sont exécutés sur les Executor
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Paramètres
request WebTriggerRegistrationRequest: requête d'enregistrement du déclencheur Cette valeur ne peut pas être null.

executor Executor: utilisé par le rappel pour envoyer les résultats Cette valeur peut être null.

callback OutcomeReceiver: destiné à notifier le résultat de l'API de manière asynchrone. Cette valeur peut être null.