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<Object, Exception> 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<Integer, Exception> callback)
Obtenez l'état de l'API Measurement. |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Enregistre une source d'attribution (clic ou vue). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Enregistrez des sources d'attribution(clic ou vue) à partir d'un contexte d'application. |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Enregistre un déclencheur (conversion). |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Enregistre une source d'attribution(clic ou vue) à partir du contexte Web. |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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é)
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É
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
public void deleteRegistrations (DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
É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
public void getMeasurementApiStatus (Executor executor, OutcomeReceiver<Integer, Exception> 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
public void registerSource (Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> 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<Object, Exception> 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
public void registerTrigger (Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> 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
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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
public void registerWebTrigger (WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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 . |