Ölçüm Yöneticisi
public
class
MeasurementManager
extends Object
java.lang.Object | |
→ Yönergeler | android.adservices.measurement.MeasurementManager |
MeasurementManager, kaynak ve tetikleyici kayıtlarını yönetmek için API'ler sağlar.
Özet
Sabitler | |
---|---|
int |
MEASUREMENT_API_STATE_DISABLED
Bu durum, Ölçüm API'lerinin kullanılamadığını gösterir. |
int |
MEASUREMENT_API_STATE_ENABLED
Bu durum, Ölçüm API'lerinin etkin olduğunu gösterir. |
Herkese açık yöntemler | |
---|---|
void
|
deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)
Önceki kayıtları silin. |
static
MeasurementManager
|
get(Context context)
MeasurementManager örneği oluşturma için fabrika yöntemi. |
void
|
getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)
Measurement API durumunu öğrenin. |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Bir ilişkilendirme kaynağını kaydedin (tıklayın veya görüntüleyin). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Bir uygulama bağlamından ilişkilendirme kaynaklarını kaydetme(tıklama veya görüntüleme). |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Bir tetikleyici (dönüşüm) kaydedin. |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Web bağlamından bir ilişkilendirme kaynağı kaydedin(tıklayın veya görüntüleyin). |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Web bağlamından bir ilişkilendirme tetikleyicisi kaydedin(tıklama veya görüntüleme). |
Devralınan yöntemler | |
---|---|
Sabitler
MEASUREMENT_API_STATE_DEVRE DIŞI
public static final int MEASUREMENT_API_STATE_DISABLED
Bu durum, Ölçüm API'lerinin kullanılamadığını gösterir. Bunların çağrılması UnsupportedOperationException
sonucunu verir.
Sabit Değer: 0 (0x00000000)
MEASUREMENT_API_STATE_ETKİN
public static final int MEASUREMENT_API_STATE_ENABLED
Bu durum, Ölçüm API'lerinin etkin olduğunu gösterir.
Sabit Değer: 1 (0x00000001)
Herkese açık yöntemler
deleteRegistrations
public void deleteRegistrations (DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)
Önceki kayıtları silin. Silme işlemi başarılı olursa geri çağırmanın OutcomeReceiver.onResult(R)
değeri null ile çağrılır. Başarısız olması durumunda, geri çağırmanın OutcomeReceiver#onError
üzerinden Exception
gönderilir. Hem başarılı hem de başarısız geri bildirimi sağlanan Executor
üzerinde yürütülür.
Parametreler | |
---|---|
deletionRequest |
DeletionRequest : Veri silme isteği.
Bu değer null olamaz. |
executor |
Executor : Geri çağırmayı çalıştıracak yürütücü.
Bu değer null olamaz.
Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz.
Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için kullanılır.
Bu değer null olamaz. |
get
public static MeasurementManager get (Context context)
MeasurementManager örneği oluşturma için fabrika yöntemi.
Parametreler | |
---|---|
context |
Context : Kullanılacak Context değeri, null olamaz. |
İlerlemeler | |
---|---|
MeasurementManager |
MeasurementManager örneği
Bu değer null olamaz. |
getMeasurementApiStatus
public void getMeasurementApiStatus (Executor executor, OutcomeReceiver<Integer, Exception> callback)
Measurement API durumunu öğrenin.
Geri çağırmanın Integer
değeri MeasurementApiState
değerlerinden biridir.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
gerektirir
Parametreler | |
---|---|
executor |
Executor : Sonuçları dağıtmak için geri çağırma tarafından kullanılır.
Bu değer null olamaz.
Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz.
Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için kullanılır.
Bu değer null olamaz. |
kayıtKaynağı
public void registerSource (Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Bir ilişkilendirme kaynağını kaydedin (tıklayın veya görüntüleyin).
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
gerektirir
Parametreler | |
---|---|
attributionSource |
Uri : Platform, ilişkilendirme kaynağıyla ilişkili meta verileri getirmek için bu URI'ye bir istek gönderir. Kaynak meta verileri cihazda depolanır ve gelecekteki tetikleyicilerle eşleştirilebilir.
Bu değer null olamaz. |
inputEvent |
InputEvent : InputEvent nesnesi (bir tıklama etkinliği için) veya null (görüntüleme etkinliği için). |
executor |
Executor : Sonuçları dağıtmak için geri çağırma tarafından kullanılır.
Bu değer null olabilir.
Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz.
Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için kullanılır.
Bu değer null olabilir. |
Dekoratif yastıklar | |
---|---|
IllegalArgumentException |
attributionSource şeması HTTPS değilse |
kayıtKaynağı
public void registerSource (SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Bir uygulama bağlamından ilişkilendirme kaynaklarını kaydetme(tıklama veya görüntüleme). Bu API, yönlendirmeleri işlemez, istekle birlikte tüm kayıt URL'leri sağlanmalıdır.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
gerektirir
Parametreler | |
---|---|
request |
SourceRegistrationRequest : Uygulama kaynağı kayıt isteği
Bu değer null olamaz. |
executor |
Executor : Sonuçları dağıtmak için geri çağırma tarafından kullanılır
Bu değer, null olabilir.
Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz.
Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için tasarlanmıştır.
Bu değer, null olabilir. |
kayıt tetikleyicisi
public void registerTrigger (Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Bir tetikleyici (dönüşüm) kaydedin.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
gerektirir
Parametreler | |
---|---|
trigger |
Uri : API, tetikleyiciyle ilişkili meta verileri getirmek için bu URI'ye bir istek gönderir. Tetikleyici meta verileri cihazda depolanır ve ilişkilendirme işlemi sırasında kaynaklarla eşleştirilmeye uygundur.
Bu değer null olamaz. |
executor |
Executor : Sonuçları dağıtmak için geri çağırma tarafından kullanılır.
Bu değer null olabilir.
Geri çağırma ve işleyici etkinlikleri, hangi iş parçacığının kullanıldığını kontrol etmek için kolay bir yol sağlayan bu Executor aracılığıyla gönderilir. Etkinlikleri uygulamanızın ana iş parçacığı üzerinden göndermek için Context.getMainExecutor() kullanabilirsiniz.
Aksi takdirde, uygun iş parçacığına gönderim yapan bir Executor sağlayın. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için kullanılır.
Bu değer null olabilir. |
Dekoratif yastıklar | |
---|---|
IllegalArgumentException |
trigger şeması HTTPS değilse |
kayıtWebKaynağı
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Web bağlamından bir ilişkilendirme kaynağı kaydedin(tıklayın veya görüntüleyin). Bu API, yönlendirmeleri işlemez, istekle birlikte tüm kayıt URL'leri sağlanmalıdır. appDestination veya webDestination parametrelerinden en az birinin sağlanması gerekir. Kayıt başarılı olursa callback
OutcomeReceiver#onResult
öğesi null ile çağrılır. Başarısız olması durumunda callback
OutcomeReceiver.onError(E)
üzerinden Exception
gönderilir. Hem başarı hem de başarısız geri bildirimi sağlanan Executor
üzerinde yürütülür.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
gerektirir
Parametreler | |
---|---|
request |
WebSourceRegistrationRequest : Kaynak kayıt isteği
Bu değer null olamaz. |
executor |
Executor : Sonuçları dağıtmak için geri çağırma tarafından kullanılır.
Bu değer null olabilir. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için kullanılır.
Bu değer null olabilir. |
kayıtWebTetikleyicisi
public void registerWebTrigger (WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Web bağlamından bir ilişkilendirme tetikleyicisi kaydedin(tıklama veya görüntüleme). Bu API, yönlendirmeleri işlemez, istekle birlikte tüm kayıt URL'leri sağlanmalıdır. Kayıt başarılı olursa callback
OutcomeReceiver#onResult
öğesi null ile çağrılır. Başarısız olması durumunda callback
OutcomeReceiver.onError(E)
üzerinden Exception
gönderilir. Hem başarı hem de başarısız geri bildirimi sağlanan Executor
üzerinde yürütülür.
AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
gerektirir
Parametreler | |
---|---|
request |
WebTriggerRegistrationRequest : Tetikleyici kayıt isteği
Bu değer null olamaz. |
executor |
Executor : Sonuçları dağıtmak için geri çağırma tarafından kullanılır
Bu değer, null olabilir. |
callback |
OutcomeReceiver : API sonucunu eşzamansız olarak bildirmek için tasarlanmıştır.
Bu değer, null olabilir. |