TÓPICOS×
Métodos do plug-in PhoneGap
É 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>
Métodos de configuração
- getPrivacyStatusRetorna 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;});
- setPrivacyStatusDefine 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');
- getLifetimeValueRetorna 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;});
- setDebugLoggingAtiva ( 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);
- getVersionObté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;});
- trackingIdentifierRetorna o identificador de visitante gerado automaticamente. Esta é uma ID de visitante único e específica do aplicativo, gerada quando o aplicativo é inicializado e é armazenada e usada deste ponto em diante. Essa ID é preservada entre as atualizações de aplicativos 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;});
- getUserIdentifierRetorna 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;});
- setUserIdentifierDefine o identificador do usuário para identifier .
- Esta é a amostra de código para este método:
ADB.setUserIdentifier('testUser');
- setPushIdentifierDefine 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');
- keepLifecycleSessionAliveDefine 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();
- trackingSendQueuedHitsForç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();
- trackingGetQueueSizeObté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;});
- trackingClearQueueRemove 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;});
- keepLifecycleSessionAliveIndica 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();
- collectLifecycleDataIndica 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();
Métodos PII
- collectPIIEnvia 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'); });
Métodos de rastreamento
- trackAdobeDeepLinkRastreia 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');});
- trackPushMessageClickthroughRastreia 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');});
- trackLocalNotificationClickThroughRastreia 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');});
- trackStateRastreia 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"});
- trackActionRastreia 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"})
- trackActionFromBackgroundRastreia uma ação que ocorreu em segundo plano. Isso impede que os eventos do ciclo de vida sejam acionados em cenários específicos.
- 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"});
- trackLocationEnvia 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');
- trackLifetimeValueIncreaseAdiciona 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');
- trackTimedActionStartInicia 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");
- trackTimedActionUpdateTransmite 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'});
- trackTimedActionEndEncerra uma ação programada.
- Esta é a amostra de código para este método:
ADB.trackTimedActionEnd("cartToCheckout");
- trackingTimedActionExistsRetorna 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;});
Métodos do Target
- targetLoadRequestEnvia 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'});
- targetLoadOrderConfirmRequestEnvia 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'} );
- targetClearCookiesLimpa os cookies do Target do armazenamento compartilhado de cookies.
- Esta é a amostra de código para este método:
ADB.targetClearCookies();
- targetLoadRequestWithNameWithLocationParametersProcessa 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'});
- targetLoadRequestWithNameProcessa 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"} );
- targetSessionIDObté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');});
- targetPcIDObté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');});
- targetSetThirdPartyIDDefine 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');});
- targetThirdPartyIDObté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');});
Métodos de aquisição
- acquisitionCampaignStartForAppPermite 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);
Identificador de publicidade
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
.
Métodos do Audience Manager
- audienceGetVisitorProfileObté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;});
- audienceGetDpuuidRetorna 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;});
- audienceGetDpidRetorna 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;});
- audienceSetDpidAndDpuuidDefine 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’);
- audienceSignalWithDataProcessa 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’});
- audienceResetRedefine a UUID do Audience Manager e limpa o perfil de visitante atual.
- Esta é a amostra de código para este método:
ADB.audienceReset();
Métodos do serviço de ID
- visitorGetMarketingCloudIdRetorna 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;});
- visitorSyncIdentifiersSincroniza 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’});
- visitorSyncIdentifiersWithAuthenticationStateSincroniza 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');});
- visitorSyncIdentifierWithTypeSincroniza 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');});
- visitorAppendToURLAdiciona 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);},'');
- visitorGetIDsRetorna 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');});