Informações para ajudá-lo a usar o SDK da plataforma Universal Windows com o Adobe Analytics.
O SDK suporta atualmente várias Soluções Adobe Experience Cloud, incluindo Analytics, Público alvo e Audience Manager. Os métodos apresentam prefixos de acordo com a solução. Métodos do Analytics recebem o prefixo "Analytics".
Cada um desses métodos é usado para enviar dados para seu conjunto de relatórios do Adobe Analytics.
Quando você consome winmd
métodos do winJS (JavaScript), todos os métodos têm automaticamente a primeira letra em minúsculas.
TrackState (winJS: trackState)
Rastreia um estado de aplicativo com dados de contexto opcionais. Os estados são as visualizações que estão disponíveis no aplicativo, como "painel inicial", "configurações do aplicativo", "carrinho" e assim por diante. Esses estados são semelhantes às páginas em um site, e as chamadas de TrackState
aumentam as visualizações de página.
If state
is empty, it displays as "app name app version (build)" in reports. If you see this value in reports, make sure you are setting state
in each TrackState
call.
Esta é a única chamada de rastreamento que aumenta as exibições de página.
Esta é a sintaxe para este método:
static void TrackState(Platform::String ^state, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Esta é a amostra de código para este método:
var ADB = ADBMobile
ADB.Analytics.trackState("loginScreen", null);
TrackAction (winJS: trackAction)
Rastreia uma ação no seu aplicativo. As ações são coisas que ocorrem no aplicativo e que você deseja avaliar, como "logons", "toques em banners", "subscrições de feed" e outras métricas.
Esta é a sintaxe para este método:
static void TrackAction(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Esta é a amostra de código para este método:
varADB=ADBMobile;
ADB.Analytics.trackAction("ButtonClick",null);
GetTrackingIdentifierAsync (winJS: getTrackingIdentifierAsync)
Retorna a ID de visitante gerada automaticamente para o Analytics. Esta é uma ID de visitante exclusiva específica do aplicativo que é gerada na primeira inicialização e, em seguida, armazenada e usada a partir desse ponto. Essa ID é preservada entre as atualizações do aplicativo e é removida na desinstalação.
Esta é a sintaxe para este método:
static Windows::Foundation::IAsyncOperation<Platform::String> ^GetTrackingIdentifierAsync();
Esta é a amostra de código para este método:
vartrackingIdentifier;
ADBMobile.Analytics.getTrackingIdentifierAsync().then(function(trackingid){
trackingIdentifier=trackingid;
});
TrackLocation (winJS: trackLocation)
Envia as coordenadas x e y atuais. Também usa pontos de interesse definidos no arquivo ADBMobileConfig.json
a fim de determinar se o local fornecido como parâmetro está dentro do POI. Se as coordenadas atuais estão dentro de um POI definido, uma variável de dados de contexto é preenchida e enviada com a chamada trackLocation
.
Esta é a sintaxe para este método:
static void TrackLocation(double lat, double lon, double accuracy, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Esta é a amostra de código para este método:
varADB=ADBMobile;
ADB.Analytics.trackLocation(47.60621,-122.33207,null);
TrackLifetime ValueIncrease (winJS: trackLifetime ValueIncrease)
Adiciona uma amount
ao valor do ciclo de vida do usuário.
Esta é a sintaxe para este método:
static void TrackLifetimeValueIncrease(float amount, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Esta é a amostra de código para este método:
varADB=ADBMobile;
ADB.Analytics.trackLifetimeValueIncrease(10,null);
TrackTimed ActionStart (winJS: trackTimed ActionStart)
Inicia uma ação programada com a action
de nome. Se você chamar este método para uma ação já iniciada, a ação programada anterior será substituída.
Essa chamada não envia uma ocorrência.
Esta é a sintaxe para este método:
static void TrackTimedActionStart(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData);
Esta é a amostra de código para este método:
varADB=ADBMobile;
ADB.Analytics.trackTimedActionStart("cartToCheckout",null);
TrackTimed ActionUpdate (winJS: trackTimed ActionUpdate)
Transmite contextData
para atualizar os dados de contexto associados à action
. Os data
transmitidos são anexados aos dados atuais para a ação em questão e os substituem se a mesma chave já estiver definida para action
.
Essa chamada não envia uma ocorrência.
Esta é a sintaxe para este método:
static void TrackTimedActionUpdate(Platform::String ^action, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object> ^contextData);
Esta é a amostra de código para este método:
varADB = ADBMobile;
varcontextData = newWindows.Foundation.Collections.PropertySet();
contextData["quantity"]=3;
ADB.Analytics.trackTimedActionUpdate("cartToCheckout",contextData);
TrackTimedActionExistsAsync (winJS: trackTimedActionExistsAsync)
Retorna true se a determinada ação cronometrada existir e false se ela não existir.
Esta é a sintaxe para este método:
static Windows::Foundation::IAsyncOperation<bool> ^TrackTimedActionExistsAsync(Platform::String ^action);
Esta é a amostra de código para este método:
ADBMobile.Analytics.trackTimedActionExistsAsync("signUp").then(function(exists){
actionExists = exists;
});
TrackTimed ActionEnd (winJS: trackTimed ActionEnd)
Encerra uma ação programada.
Esta é a sintaxe para este método:
static void TrackTimedActionEnd(Platform::String ^action);
Esta é a amostra de código para este método:
varADB = ADBMobile;
ADB.Analytics.trackTimedActionEnd("cartToCheckout");
ClearTrackingQueue (winJS: clearTrackingQueue)
Limpa todas as ocorrências armazenadas da fila de rastreamento do Analytics.
Esta é a sintaxe para este método:
static void ClearTrackingQueue();
Esta é a amostra de código para este método:
ADBMobile.Analytics.clearTrackingQueue();
GetQueueSizeAsync (winJS: getQueueSizeAsync)
Retorna o número de ocorrências armazenadas atualmente na fila do Analytics.
Esta é a sintaxe para este método:
static Windows::Foundation::IAsyncOperation<int> ^GetQueueSizeAsync();
Esta é a amostra de código para este método:
varqueueSize;
ADBMobile.Analytics.getQueueSizeAsync().then(function(size){
queueSize=size;
});