É possível usar os métodos de plug-in do iOS PhoneGap para executar várias tarefas.
Nos arquivos html
em que deseja usar o rastreamento, adicione o código a seguir na guia <head>
:
<script type="text/javascript" charset="utf-8" src="ADB_Helper.js"></script>
getPrivacyStatus
Retorna o status de privacidade do usuário atual. Estes são os status disponíveis:
ADB.optedIn
, em que as ocorrências são enviadas imediatamente.
ADB.optedOut
, em que as ocorrências são descartadas.
ADB.optUnknown
Se o conjunto de relatórios estiver habilitado para mostrar o carimbo de data e hora, as ocorrências serão salvas até o status de privacidade ser alterado para aceitar (as ocorrências são enviadas) ou rejeitar (as ocorrências são descartadas). Se o conjunto de relatórios não tiver carimbo de hora e data, as ocorrências são descartadas até o status de privacidade ser alterado para opt in.
O valor padrão está definido no arquivo ADBMobileConfig.json
.
Esta é a amostra de código para este método:
getPrivacyStatus(function (value){myTempVal = value;},function(){myTempVal = null;});
setPrivacyStatus
Define o de privacidade do usuário atual como status
status. Você pode definir um dos seguintes estados:
ADB.optedIn
, em que as ocorrências são enviadas imediatamente.
ADB.optedOut
, em que as ocorrências são descartadas.
ADB.optUnknown
- Se o conjunto de relatórios estiver habilitado para mostrar o carimbo de data e hora, as ocorrências serão salvas até o status de privacidade ser alterado para aceitar (as ocorrências são enviadas) ou rejeitar (as ocorrências são descartadas).
Se o conjunto de relatórios não tiver carimbo de hora e data, as ocorrências são descartadas até o status de privacidade ser alterado para opt in.
Esta é a amostra de código para este método:
ADB.setPrivacyStatus('ADB.optedIn');
getLifetimeValue
Retorna o valor do tempo de vida do usuário atual. O valor padrão é 0.
Esta é a amostra de código para este método:
ADB.getLifetimeValue(function(value){myTempVal = value;},function(){myTempVal = null;});
setDebugLogging
Ativa (true
) ou desativa (false
) na exibição de informações de depuração. Por padrão, essa variável é false
.
Esta é a amostra de código para este método:
ADB.setDebugLogging(true);
getVersion
Obtém a versão da biblioteca.
Esta é a amostra de código para este método:
ADB.getVersion(function(value){versionNum = value;},function(){versionNum=1.0;});
trackingIdentifier
Retorna o identificador de visitante gerado automaticamente. Esta é uma ID de visitante exclusiva específica do aplicativo gerada quando ele é iniciado pela primeira vez e é armazenada e usada a partir desse ponto. Essa ID é preservada entre as atualizações do aplicativo e é removida quando o aplicativo é desinstalado.
Se o aplicativo for atualizado do SDK 3.x da Experience Cloud para o 4.x, a ID anterior de visitante (personalizada ou gerada automaticamente) será recuperada e armazenada como identificador de usuário personalizado (consulte getUserIdentifier
abaixo). Isso preserva os dados do visitante entre as atualizações de SDK. Para novas instalações no SDK 4.x, o identificador do usuário é null
, e o identificador de rastreamento é usado.
Esta é a amostra de código para este método:
ADB.trackingIdentifier(function(value){myTempVal = value;},function(){myTempVal = null;});
getUserIdentifier
Retorna o identificador do usuário personalizado se algum identificador personalizado estiver configurado e retorna null
se nenhum estiver configurado. O valor padrão é null
.
Esta é a amostra de código para este método:
getUserIdentifier(function(value){myTempVal = value;},function(){myTempVal = null;});
setUserIdentifier
Define o identificador do usuário para identifier
.
Esta é a amostra de código para este método:
ADB.setUserIdentifier('testUser');
setPushIdentifier
Define o token do dispositivo para notificações por push.
Esta é a sintaxe para este método:
ADB.setPushIdentifier(pushIdentifier,success,fail);
Esta é a amostra de código para este método:
ADB.setPushIdentifier('test_push_identifier',function(value){alert('success');},function(value){alert('fail');
keepLifecycleSessionAlive
Define a preferência manter vivo da sessão de ciclo de vida.
Chamar keepLifecycleSessionAlive
impede que seu aplicativo inicie uma nova sessão na próxima vez que for retomado a partir do segundo plano. Você só deve usar esse método se o seu aplicativo se registrar para notificações em segundo plano.
Esta é a amostra de código para este método:
ADB.keepLifecycleSessionAlive();
trackingSendQueuedHits
Força a biblioteca a enviar todas as ocorrências na fila, independentemente das opções de agrupamento atuais.
Esta é a amostra de código para este método:
ADB.trackingSendQueuedHits();
trackingGetQueueSize
Obtém ou define o número de chamadas de rastreamento armazenadas na fila offline.
Esta é a amostra de código para este método:
ADB.trackingGetQueueSize(function(value){myTempVal = value;},function(){myTempVal = null;});
trackingClearQueue
Remove todo o número de chamadas de rastreamento armazenadas da fila offline.
Cuidado ao limpar a fila manualmente; o resultado não pode ser revertido.
Esta é a amostra de código para este método:
ADB.trackingClearQueue(function(value){myTempVal = value;},function(){myTempVal = null;});
keepLifecycleSessionAlive
Indica ao SDK que o próximo resumo em segundo plano não deve iniciar uma nova sessão, independentemente do tempo limite de valor da sessão do ciclo de vida presente no arquivo de configuração.
Importante: este método é destinado a aplicativos que realizam registros para receber notificações enquanto são executados em segundo plano e só deve ser chamado a partir do código executado enquanto o aplicativo está funcionando em segundo plano.
Esta é a amostra de código para este método:
ADB.keepLifecycleSessionAlive();
collectLifecycleData
Indica ao SDK que os dados do ciclo de vida devem ser coletados para uso em todas as soluções no SDK. Para obter mais informações, consulte Medições de ciclo de vida.
Esta é a amostra de código para este método:
ADB.collectLifecycleData();
collectPII
Envia uma solicitação de coleta de PII.
Esta é a sintaxe para este método:
ADB.collectPII(piiData,success,fail);
Esta é a amostra de código para este método:
ADB.collectPII({'k1':'v1','k2':'v2','k3':'v3'}, function (value) { alert('success'); },function (value) { alert('fail'); });
trackAdobeDeepLink
Rastreia os cliques em deep links da Adobe.
Se a chamada de Ciclo de vida for um evento de inicialização, os dados do Adobe Link serão anexados, caso contrário, uma chamada extra será enviada.
Esta é a sintaxe para este método:
ADB.trackAdobeDeepLink(deeplinkURL,success,fail);
Esta é a amostra de código para este método:
ADB.trackAdobeDeepLink('xyz-deeplink-url',function(value){alert('success');},function(value){alert('fail');});
trackPushMessageClickthrough
Rastreia um clique na mensagem por push.
Esta é a sintaxe para este método:
ADB.trackPushMessageClickthrough(userInfo,success,fail);
Esta é a amostra de código para este método:
ADB.trackPushMessageClickthrough({'k1':'v1','k2':'v2','k3':'v3'},function(value){alert('success');},function(value){alert('fail');});
trackLocalNotificationClickThrough
Rastreia um clique na mensagem de notificação local.
Esta é a sintaxe para este método:
ADB.trackLocalNotificationClickThrough(userInfo,success,fail);
Esta é a amostra de código para este método:
ADB.trackLocalNotificationClickThrough({'k1':'v1','k2':'v2','k3':'v3'},function(value){alert('success');},function(value){alert('fail');});
trackState
Rastreia um estado de aplicativo com dados de contexto opcionais. Os estados são as exibições disponíveis no aplicativo, como home dashboard
, app settings
, cart
, 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. cData é um objeto JSON com pares de valor-chave para enviar dados de contexto.
Esta é a sintaxe para este método:
ADB.trackState(stringstateName[,JSONcData]);
Estas são as amostras de código para este método:
ADB.trackState("loginpage");
ADB.trackState("loginpage",{"user":"john","remember":"true"});
trackAction
Rastreia uma ação no seu aplicativo. As ações são coisas que ocorrem no seu aplicativo e que você deseja medir, incluindo logins
, banner taps
, feed subscriptions
e outras métricas.
Esta é a sintaxe para este método:
ADB.trackAction(stringaction[,JSONcData]);
Estas são as amostras de código para este método:
ADB.trackAction("login");
ADB.trackAction("login",{"user":"john","remember":"true"})
trackActionFromBackground
Rastreia uma ação que ocorreu em segundo plano. Impede que os eventos do ciclo de vida sejam acionados em determinados cenários.
Esta é a sintaxe para este método:
ADB.trackActionFromBackground(stringaction[,JSONcData]);
Estas são as amostras de código para este método:
ADB.trackActionFromBackground("login");
ADB.trackActionFromBackground("login",{"user":"john","remember":"true"});
trackLocation
Envia as coordenadas x e y atuais. Também usa os pontos de interesse definidos no arquivo ADBMobileConfig.json
a fim de determinar se o local fornecido como parâmetro está em qualquer um dos POIs. 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:
ADB.trackLocation(x,y[,JSONcData]);
Esta é a amostra de código para este método:
ADB.trackLocation('40.431596','-111.893713');
trackLifetimeValueIncrease
Adiciona uma amount
ao valor do ciclo de vida do usuário.
Esta é a sintaxe para este método:
ADB.trackLifetimeValueIncrease(amount[,JSONcData]);
Esta é a amostra de código para este método:
ADB.trackLifetimeValueIncrease('10.01');
trackTimedActionStart
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:
ADB.trackTimedActionStart(action[,JSONcData]);
Esta é a amostra de código para este método:
ADB.trackTimedActionStart("cartToCheckout");
trackTimedActionUpdate
Transmite cData
para atualizar os dados de contexto associados à action
. Os cData
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:
ADB.trackTimedActionUpdate(Stringaction[,JSONcData]);
Esta é a amostra de código para este método:
ADB.trackTimedActionUpdate("cartToCheckout",{'SampleContextDataKey3':'SampleContextDataVal3','SampleContextDataKey4':'SampleContextDataVal4'});
trackTimedActionEnd
Encerra uma ação programada.
Esta é a amostra de código para este método:
ADB.trackTimedActionEnd("cartToCheckout");
trackingTimedActionExists
Retorna se uma ação programada está em andamento ou não.
Esta é a sintaxe para este método:
ADB.trackingTimedActionExists(function(value){myTempVal = value;},function(){myTempVal = null;});
targetLoadRequest
Envia a solicitação para o servidor do Target
configurado e retorna o valor da cadeia de caracteres da oferta.
Esta é a sintaxe para este método:
ADB.targetLoadRequest(success,fail,name,defaultContent,parameters);
Esta é a amostra de código para este método:
ADB.targetLoadRequest(function (value)
{myTempVal = value;},function() {myTempVal = null;},'bannerOffer','none',{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'});
targetLoadOrderConfirmRequest
Envia uma solicitação para o servidor Target configurado.
Esta é a sintaxe para este método:
ADB.targetLoadOrderConfirmRequest(success,fail,name,orderId,orderTotal,productPurchaseId,parameters);
Esta é a amostra de código para este método:
ADB.targetLoadRequest(function(value){myTempVal=value;}
,function()
{myTempVal = null; }
,'name','orderId','total','purchaseId'
,{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'}
);
targetClearCookies
Limpa os cookies do Target do armazenamento compartilhado de cookies.
Esta é a amostra de código para este método:
ADB.targetClearCookies();
targetLoadRequestWithNameWithLocationParameters
Processa uma solicitação de serviço do Target.
Esta é a sintaxe para este método:
ADB.targetLoadRequestWithNameWithLocationParameters(success,fail,name,defaultContent,profileParameters,orderParameters,mboxParameters,requestLocationParameters
);
Esta é a amostra de código para este método:
ADB.targetLoadRequestWithNameWithLocationParameters(function(){alert('success');},function(){alert('fail');},'bannerOffer','none',{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'});
targetLoadRequestWithName
Processa uma solicitação de serviço do Target.
Esta é a sintaxe para este método:
ADB.targetLoadRequestWithRequestName(success, fail, name, defaultContent, profileParameters, orderParameters, mboxParameters);
Esta é a amostra de código para este método:
ADB.targetLoadRequestWithName(
function (value){ // handle target success} ,
function() { // handle target failure },
"mboxName",
"defaultContent",
{"profileParameters":"profileParametervalues"}
{"orderId" : "32FGJ4XK" , "orderTotal" : "123.33" , "purchasedProductIds":"[46,34]" }
{"mboxParameters":"mboxParametersvalues"}
);
targetSessionID
Obtém o valor do cookie SessionID
retornado para este visitante pelo servidor Target.
Esta é a sintaxe para este método:
ADB.targetSessionID(success,fail);
Esta é a amostra de código para este método:
ADB.targetSessionID(function(value){alert(value);},function(value){alert('fail');});
targetPcID
Obtém o valor do cookie PcID
retornado para este visitante pelo servidor Target.
Esta é a sintaxe para este método:
ADB.targetPcID(success,fail);
Esta é a amostra de código para este método:
ADB.targetPcID(function(value){alert(value);},function(value){alert('fail');});
targetSetThirdPartyID
Define a ID de visitante personalizada para o Target.
Esta é a sintaxe para este método:
ADB.targetSetThirdPartyID(thirdPartyID,success,fail);
Esta é a amostra de código para este grupo:
ADB.targetSetThirdPartyID('test-third-party-id',function(value){alert('success');},function(value){alert('fail');});
targetThirdPartyID
Obtém a ID de visitante personalizada para o Target.
Esta é a sintaxe para este método:
ADB.targetThirdPartyID(success,fail);
Esta é a amostra de código para este método:
ADB.targetThirdPartyID(function(value){alert(value);},function(value){alert('fail');});
acquisitionCampaignStartForApp
Permite aos desenvolvedores iniciar uma campanha de aquisição de aplicativo como se o usuário tivesse clicado em um link. Isso é útil para criar links de aquisição manuais e gerenciar o redirecionamento da loja de aplicativos por conta própria (como com um SKStoreView
).
Esta é a sintaxe para este método:
ADB.acquisitionCampaignStartForApp(appId,data,success,fail);
Esta é a amostra de código para este método:
ADB.acquisitionCampaignStartForApp('0652024f-adcd-49f9-9bd7-2552a4564d2f',{'extraDataKey':'extraDataValue'},success,fail);
No AppDelegate
gerado pelo Cordova, chame [ADBMobile setAdvertisingIdentifier:]
no método delegado application:didFinishLaunchingWithOptions:
. Para obter mais informações, consulte Métodos de configuração.
audienceGetVisitorProfile
Obtém o perfil do visitante.
Esta é a sintaxe para este método:
ADB.audienceGetVisitorProfile();
Esta é a amostra de código para este método:
ADB.audienceGetVisitorProfile(function(value){profile = value;},function(){profile = null;});
audienceGetDpuuid
Retorna DPUUID.
Esta é a sintaxe para este método:
ADB.audienceGetDpuuid(success,fail);
Esta é a amostra de código para este método:
ADB.audienceGetDpuuid(function(value){dpuuid=value;},function(){dpuuid=null;});
audienceGetDpid
Retorna DPID.
Esta é a sintaxe para este método:
ADB.audienceGetDpid(success,fail);
Esta é a amostra de código para este método:
ADB.audienceGetDpid(function(value){dpid = value;},function(){dpid = null;});
audienceSetDpidAndDpuuid
Define a DPID e a DPUUID.
Esta é a sintaxe para este método:
ADB.audienceSetDpidAndDpuuid(dpid,dpuuid,success,fail);
Estas são as amostras de código para este método:
ADB.audienceSetDpidAndDpuuid(‘dpid’,‘dpuuid’,function(){…},function(){…});
ADB.audienceSetDpidAndDpuuid(‘dpid’,‘dpuuid’);
audienceSignalWithData
Processa uma solicitação de serviço do Audience Manager.
Esta é a sintaxe para este método:
ADB.audienceSignalWithData(success,fail,data);
Estas são as amostras de código para este método:
ADB.audienceSignalWithData(function(){},function(){},{‘key1’:’value1’,‘key2’:‘value2’});
ADB.audienceSignalWithData({‘key1’:’value1’,‘key2’:‘value2’});
audienceReset
Redefine a UUID do Audience Manager e limpa o perfil de visitante atual.
Esta é a amostra de código para este método:
ADB.audienceReset();
visitorGetMarketingCloudId
Retorna a Experience Cloud ID do Serviço de ID.
Esta é a sintaxe para este método:
ADB.visitorGetMarketingCloudId(success,fail);
Esta é a amostra de código para este método:
ADB.visitorGetMarketingCloudId(function(value){mcid=value;},function(){mcid=null;});
visitorSyncIdentifiers
Sincroniza os identificadores fornecidos com o serviço de ID.
Esta é a sintaxe para este método:
ADB.visitorSyncIdentifiers(identifiers,success,fail);
Estas são as amostras de código para este método:
ADB.visitorSyncIdentifiers({‘key_id_1’:’value_id_1’},function(){…},function(){…}))
ADB.visitorSyncIdentifiers({‘key_id_1’:‘value_id_1’});
visitorSyncIdentifiersWithAuthenticationState
Sincroniza os identificadores fornecidos ao serviço de ID do visitante.
Esta é a sintaxe para este método:
ADB.visitorSyncIdentifiersWithAuthenticationState(identifiers,authenticationState,success,fail);
Esta é a amostra de código para este método:
ADB.visitorSyncIdentifiersWithAuthenticationState({'k1':'v1','k2':'v2','k3':'v3'},ADB.mobileVisitorAuthenticationStateAuthenticated,function(value){alert('success');},function(value){alert('fail');});
visitorSyncIdentifierWithType
Sincroniza o identificador fornecido ao serviço de ID do visitante.
Esta é a sintaxe para este método:
ADB.visitorSyncIdentifierWithType(identifierType,identifier,authenticationState,success,fail);
Esta é a amostra de código para este método:
ADB.visitorSyncIdentifierWithType('test-identifier-type','test-identifier',ADB.mobileVisitorAuthenticationStateAuthenticated,function(value){alert('success');},function(value){alert('fail');});
visitorAppendToURL
Adiciona identificadores de visitantes ao URL fornecido.
Esta é a sintaxe para este método:
ADB.visitorAppendToURL(urlToAppend,success,fail);
Esta é a amostra de código para este método:
ADB.visitorAppendToURL('test_visitor_url',function(value){alert(value);},'');
visitorGetIDs
Retorna todas as visitorIDs
que foram sincronizadas.
Esta é a sintaxe para este método:
ADB.visitorGetIDs(success,fail)
Esta é a amostra de código para este método:
ADB.visitorGetIDs(function(value){alert(value);},function(value){alert('fail');});