Iônico
- Tópicos:
- Marketing para dispositivos móveis
Criado para:
- Administrador
Este tópico descreve como integrar o plug-in Cordova do Marketo. Não há suporte atualmente para o capacitor Ionic.
Pré-requisitos
- Adicione um aplicativo ao Administrador do Marketo (obtenha a Chave Secreta e a ID do Munchkin do aplicativo).
- Configurar notificações por push (iOS | Android ).
- Instale o Ionic e a CLI do Cordova.
Instruções de instalação
Configurar o plug-in Ionic do Marketo
-
Supondo que a CLI do Cordova esteja instalada, vá para o diretório de aplicativos Ionic e execute o seguinte comando para adicionar o Plug-in Marketo ao aplicativo:
$ ionic plugin add https://github.com/Marketo/PhoneGapPlugin.git --variable APPLICATION_SECRET_KEY="YOUR_APPLICATION_SECRET"
-
Para confirmar que o plug-in foi adicionado ao aplicativo, execute o seguinte comando:
$ ionic plugin list com.marketo.plugin 0.X.0 "MarketoPlugin"
Migrar para a versão mais recente (opcional)
-
Para remover um plug-in existente, execute o seguinte comando:
$ ionic plugin remove com.marketo.plugin
-
Para ler o plug-in, execute o seguinte comando:
$ ionic plugin add https://github.com/Marketo/PhoneGapPlugin.git --variable APPLICATION_SECRET_KEY="YOUR_APPLICATION_SECRET"
Ativar notificações por push no xCode
- Ative o recurso de notificação por push no projeto xCode.
Rastrear notificações por push
Cole o código a seguir dentro da função application:didFinishLaunchingWithOptions:
.
Marketo *sharedInstance = [Marketo sharedInstance];
[sharedInstance trackPushNotification:launchOptions];
let sharedInstance: Marketo = Marketo.sharedInstance()
sharedInstance.trackPushNotfication(launchOptions)
Inicializar a estrutura do Marketo
Para garantir que a estrutura do Marketo seja iniciada na inicialização do aplicativo, adicione o seguinte código na função onDeviceReady
no arquivo JavaScript principal.
Você deve passar ionicCordova
como tipo de estrutura para Ionic Aplicativos Cordova.
Sintaxe
// This method will Initialize the Marketo Framework using Your MunchkinId and Secret Key
marketo.initialize(
function() { console.log("MarketoSDK Init done."); },
function(error) { console.log("an error occurred:" + error); },
'YOUR_MUNCHKIN_ID',
'YOUR_SECRET_KEY',
'FRAMEWORK_TYPE'
);
// For session tracking, add following.
marketo.onStart(
function(){ console.log("onStart."); },
function(error){ console.log("Failed to report onStart." + error); }
);
Parâmetros
- Retorno de Chamada com Êxito : função a ser executada se a estrutura do Marketo for inicializada com êxito.
- Retorno de Chamada de Falha : função a ser executada se a estrutura do Marketo falhar ao inicializar.
- MUNCHKIN ID : Munchkin ID recebida do Marketo no momento do registro.
- CHAVE SECRETA : chave secreta recebida do Marketo no momento do registro.
Inicializar notificação por push do Marketo
Para garantir que a notificação por push do Marketo seja iniciada, adicione o seguinte código após a função inicializada no arquivo JavaScript principal.
Sintaxe
// This function will Enable user notifications (prompts the user to accept push notifications in iOS)
marketo.initializeMarketoPush(
function() { console.log("Marketo push successfully initialized."); },
function(error) { console.log("an error occurred:" + error); },
'YOUR_GCM_PROJECT_ID' // This is required for Android and will be ignored in iOS
);
Parâmetros
- Retorno de Chamada com Êxito : função a ser executada se a notificação por push do Marketo for inicializada com êxito.
- Retorno de Chamada de Falha : função a ser executada se a notificação por push do Marketo falhar ao inicializar.
- GCM_PROJECT_ID : ID do projeto GCM encontrada no Console de desenvolvedores do Google após a criação do aplicativo.
O token também pode ser cancelado no logout.
marketo.uninitializeMarketoPush(
function() { console.log("Marketo push successfully uninitialized."); } ,
function(error) { console.log("an error occurred:" + error); }
);
Associar lead
Você pode criar um cliente potencial do Marketo chamando a função associateLead.
Sintaxe
marketo.associateLead(
function(){ console.log("MarketoSDK : Lead Added"); },
function(error){ console.log("an error occurred:" + error); },
'Lead_Data_JSON_String'
);
Parâmetros
- Retorno de Chamada com Êxito : função a ser executada se o Marketo framework associar o lead com êxito.
- Retorno de Chamada de Falha : função a ser executada se o Marketo framework falhar ao associar o lead.
- Dados de Cliente Potencial : dados de cliente potencial no formato de cadeia de caracteres JSON.
Exemplo
// First create a lead as shown below
var lead = {};
lead[marketo.KEY_FIRST_NAME] = "Ionic";
lead[marketo.KEY_LAST_NAME] = "App";
lead[marketo.KEY_EMAIL] = email;
lead[marketo.KEY_ADDRESS] = "demo address";
lead[marketo.KEY_CITY] = "city";
lead[marketo.KEY_STATE] = "state";
lead[marketo.KEY_COUNTRY] = "country";
lead[marketo.KEY_POSTAL_CODE] = "postalCode";
lead[marketo.KEY_GENDER] = "gender";
// Use associateLead function to associate it.
marketo.associateLead(
function() { console.log("MarketoSDK : Lead Associated"); },
function(error) { console.log("an error occurred:" + error); },
JSON.stringify(lead)
);
Ação do relatório
Você pode relatar qualquer ação realizada pelo usuário chamando a função reportaction
.
Sintaxe
marketo.reportaction(
function(){ console.log("MarketoSDK : New event sent "); },
function(error){ console.log("an error occurred:" + error); },
'Action_Name',
'Action_Data_JSON_String'
);
Parâmetros
- Retorno de Chamada com Êxito : função a ser executada se a estrutura do Marketo relatar ação com êxito.
- Retorno de Chamada de Falha : função a ser executada se a estrutura do Marketo falhar ao relatar a ação.
- Nome da Ação : nome da ação.
- Dados de Ação : dados de ação no formato de sequência JSON.
Exemplo
// First create an event as below
var event = {
"Action Type":"Add To Cart",
"Action Details":"Adding Product in cart",
"Action Metric":"10",
"Action Length":"1"
}
marketo.reportaction(
function(){ console.log("Reported action successfully."); },
function(error){ console.log("Failed to report action." + error); },
"Add To Cart",
JSON.stringify(event)
);
Relatório da sessão
Vincule os tipos de evento "pausar" e "retomar" conforme mostrado abaixo para relatar eventos Start e Stop. Isso é usado para rastrear o tempo gasto no aplicativo móvel. Observação: isso é necessário no Android.
//Add the following code in your www/js/index.js
bindEvents: function() {
document.addEventListener('pause', this.onStop, false);
document.addEventListener('resume', this.onStart, false);
},
onStop: function() {
marketo.onStop(
function(){ console.log("onStop"); },
function(error){ console.log("Failed to report onStop." + error); }
);
},
onStart: function() {
marketo.onStart(
function(){ console.log("onStart."); },
function(error){console.log( "Failed to report onStart." + error); }
);
},
Criação de clientes em potencial
Há três maneiras de criar leads a partir de um aplicativo híbrido:
- MARKETO MME SDK
- API REST DO MARKETO
- Envio de formulários
Dependendo do método usado, um lead recém-criado é reconhecido por acionadores e filtros diferentes. Os clientes em potencial criados usando o SDK do MME ou a API REST aparecem nos acionadores e filtros "Criados por clientes potenciais". Os clientes em potencial criados por envios de formulários aparecem nos acionadores e filtros "Preencher formulário".
A prática recomendada é manter a consistência com o método usado pelo aplicativo web ao criar leads. Se você já tiver um aplicativo Web que usa o envio de formulários como o mecanismo para criar clientes potenciais, use o mesmo mecanismo ao criar clientes potenciais no aplicativo híbrido. Se você já tiver um aplicativo Web que usa nossa API REST como o mecanismo para criar leads, use esse mesmo mecanismo ao criar leads no aplicativo híbrido. Nos casos em que você não usa o envio de formulários nem a API REST como um mecanismo para criar clientes em potencial no aplicativo Web, é possível considerar o uso do SDK do MME para criar clientes em potencial no Marketo.