Show Menu
TÓPICOS×

Usar a busca prévia para encontrar conteúdos em oferta no Android

O recurso de busca prévia do Adobe Target usa o SDK móvel do Android para buscar conteúdo de oferta a menor quantidade de vezes possível, armazenando as respostas do servidor em cache.
A funcionalidade de busca prévia no SDK móvel para Android não é compatível com os tipos de atividades de Destino automático, Alocação automática e Personalização automatizada no Adobe Target.
Esse processo reduz o tempo de carregamento, previne várias chamadas de rede e permite que o Adobe Target seja notificado sobre que mbox foi visitada pelo usuário do aplicativo móvel. Todo o conteúdo será recuperado e armazenado em cache durante a chamada da busca prévia, e esse conteúdo será recuperado do cache em todas as chamadas futuras que contenham conteúdo armazenado em cache para o nome da mbox especificado.
O conteúdo da busca prévia não persiste entre inicializações. O conteúdo da busca prévia é armazenado em cache enquanto o aplicativo estiver executando ou até que o método clearPrefetchCache() seja chamado.
As APIs de busca prévia do Target estão disponíveis desde a versão 4.14.0 do SDK. Para obter mais informações sobre as limitações de parâmetros, consulte Batch-input-parameters .
No SDK de versão 4.14 ou posterior, se especificado, a environmentId``ADBMobileConfig.json é extraída do arquivo ao iniciar uma chamada v2 batch mbox TnT. Caso nenhuma environmentId esteja especificada nesse arquivo, nenhum parâmetro de ambiente é enviado pela chamada TNT batch mbox, e a oferta é entregue ao ambiente padrão.
Por exemplo: 
if (MobileConfig.getInstance().mobileUsingTarget()){ 
            long environmentID = MobileConfig.getInstance().getEnvironmentID(); 
            if(environmentID != 0L){ 
                parametersJson.put(TargetJson.ENVIRONMENT_ID, environmentID); 
            } 
        }

Métodos de busca prévia

Estes são os métodos que você pode usar para realizar uma busca prévia no Android:
  • prefetchContent
    Envia uma solicitação de busca prévia com uma matriz de localizações para o servidor do Target configurado e retorna o status da solicitação na chamada de retorno fornecida.
    • Esta é a sintaxe para este método: 
      public static void prefetchContent(
final List<TargetPrefetchObject> targetPrefetchArray,
final Map<String, Object> profileParameters,
final TargetCallback<Boolean> callback)
    • Estes são os parâmetros para este método:
      • targetPrefetchArray
        Matriz de TargetPrefetchObjects que contém o nome e os mboxParameters para cada localização do Target na qual se deve realizar uma busca prévia.
      • profileParameters
        Contém as chaves e os valores dos parâmetros de perfil a ser usados com cada localização de busca prévia nesta solicitação.
      • callback
        Invocado quando a busca prévia está concluída. Retorna true se a busca prévia foi bem-sucedida, e false caso contrário.
  • loadRequests
    Executa uma solicitação em lote em várias localizações de mbox especificadas no vetor de solicitações.  Cada objeto na matriz contém uma função de chamada de retorno, que será invocada quando o conteúdo estiver disponível na localização da mbox fornecida.
    Se o conteúdo das localizações solicitadas já estiver armazenado em cache, ele será retornado imediatamente na chamada de retorno fornecida. Caso contrário, o SDK enviará uma solicitação de rede para que os servidores do Target recuperem o conteúdo.
    • Esta é a sintaxe para este método: 
      public static void loadRequests( final List<TargetRequestObject> requestArray,  final Map<String, Object> profileParameters)
    • Estes são os parâmetros para este método:
      • requestArray
        Matriz de TargetRequestObjects que contém o nome, o conteúdo padrão, os parâmetros e a função de chamada de retorno para cada localização a ser recuperada.
      • profileParameters
        Contém as chaves e os valores dos parâmetros de perfil a ser usados com cada localização de busca prévia nesta solicitação.
  • clearPrefetchCache
    Limpa os dados armazenados em cache pela busca prévia do Target.
    • Esta é a sintaxe para este método: 
      public static void clearPrefetchCache();
    • Não há parâmetros para este método.
  • createTargetRequestObject
    Cria e retorna uma instância de TargetRequestObject com os dados fornecidos.
    • Esta é a sintaxe para este método: 
      public static TargetPrefetchObject createTargetRequestObject( 
final String mboxName,
final String defaultContent, 
final Map<String, Object> mboxParams, 
final Map<String, Object> orderParams, 
final Map<String, Object> productParams, 
final Target.TargetCallback<String> callback)
  • createTargetPrefetchObject
    Cria e retorna uma instância de TargetPrefetchObject com os dados fornecidos.
    • Esta é a sintaxe para este método: 
      public static TargetPrefetchObject createTargetPrefetchObject( 
final String mboxName, 
final Map<String, Object> mboxParams) 
final Map<String, Object> orderParams, 
final Map<String, Object> productParams)

Classes públicas

Estas são as classes públicas que oferecem suporte para busca prévia no Android:

Referência da classe: TargetPrefetchObject

Encapsula o nome e os parâmetros da mbox usados na busca prévia da mbox.
  • name
    Nome da localização onde será realizada a busca prévia.
    • Tipo : String
  • mboxParameters
    Coleção de pares de chave-valor que serão anexados como mboxParameters nessa solicitação do TargetPrefetchObject .
    • Tipo : mapa <String, Object>
  • orderParameters
    Coleção de pares de chave-valor que serão anexados a mbox atual no nó ordem.
    • Tipo : mapa <String, Object>
  • productParameters
    Coleção de pares de chave-valor que serão anexados a mbox atual no nó produtos.
    • Tipo : mapa <String, Object>

Referência de classe: TargetRequestObject

Essa classe encapsula o nome da mbox, o conteúdo padrão, os parâmetros da mbox e a função de retorno usada nas solicitações de localização do Target.
  • mboxName
    Nome da localização solicitada.
    • Tipo : String
  • mboxParameters
    Coleção de pares de chave-valor que serão anexados como mboxParameters nesse TargetRequestObject .
    • Tipo: mapa <String, Object>
  • orderParameters
    Coleção de pares de chave-valor que serão anexados a mbox atual no nó ordem.
    • Tipo : mapa <String, Object>
  • productParameters
    Coleção de pares de chave-valor que serão anexados a mbox atual no nó produtos.
    • Tipo : mapa <String, Object>
  • defaultContent
    Valor da string retornada pela função de retorno se o SDK não for capaz de recuperar o conteúdo dos servidores do Target.
    • Tipo : String
  • callback
    Ponteiro para a função a ser chamada quando o conteúdo de um dado TargetRequestObject estiver disponível.
    • Tipo : Target.TargetCallback <String>

Amostra de código

Este é um exemplo de como fazer uma busca prévia de conteúdo por meio dos SDKs do Android: 
// When your app launches, prefetch the content for a list of locations. 
// Define the list of mboxes that you want to prefetch. 
List<TargetPrefetchObject> prefetchMboxesList = new ArrayList<>(); 
  
Map<String, Object> mboxParameters1 = new HashMap<>(); 
mboxParameters1.put("status", "platinum"); 
prefetchMboxesList.add(Target.createTargetPrefetchObject("mboxName1", mboxParameters1));

Map<String, Object> mboxParameters2 = new HashMap<>(); 
mboxParameters2.put("userType", "paid"); 
 
List<String> purchasedIds = new ArrayList<String>(); 
purchasedIds.add("34"); 
purchasedIds.add("125");  
Map<String, Object> orderParameters2 = new HashMap<>(); 
orderParameters2.put("id", "ADCKKIM"); 
orderParameters2.put("total", "344.30"); 
orderParameters2.put("purchasedProductIds",  purchasedIds); 
  
Map<String, Object> productParameters2 = new HashMap<>(); 
productParameters2.put("id", "24D3412"); 
productParameters2.put("categoryId","Books"); 
  
prefetchMboxesList.add(Target.createTargetPrefetchObject("mboxName2", mboxParameters2, orderParameters2, productParameters2));

// Define the profile parameters map. 
Map<String, Object> profileParameters = new HashMap<>(); 
profileParameters.put("ageGroup", "20-32");

// Define the target callback for the prefetch call status. 
Target.TargetCallback<Boolean> prefetchStatusCallback = new Target.TargetCallback<Boolean>() { 
    @Override 
    public void call(final Boolean status) { 
        // check the returned status for the prefetch call 
    }};

// Call the prefetchContent API. 
Target.prefetchContent(prefetchMboxesList, profileParameters, prefetchStatusCallback);

// When the content is required, you can initiate the locations request. 
// Define the list of target request objects. 
List<TargetRequestObject> locationRequests = new ArrayList<>(); 
  
Target.TargetCallback<String> callback1 = new Target.TargetCallback<String>() { 
    @Override 
    public void call(final String content) { 
        // check the returned content for mboxName1. 
    }}; 
  
locationRequests.add(Target.createTargetRequestObject("mboxName1", "defaultContent1", mboxParameters1, callback1));

Target.TargetCallback<String> callback2 = new Target.TargetCallback<String>() { 
    @Override 
    public void call(final String content) { 
        // check the returned content for mboxName2. 
    }}; 
  
locationRequests.add(Target.createTargetRequestObject("mboxName2", "defaultContent2", mboxParameters2, orderParameters2, productParameters2, callback2)); 
  
// Call the loadRequests API. 
Target.loadRequests(locationRequests, profileParameters);

Informações adicionais

Estas são algumas informações adicionais sobre essas amostras:
  • ProductParameters permite somente as seguintes chaves:
    • id
    • categoryId
  • OrderParameters permite somente as seguintes chaves:
    • id
    • total
    • purchasedProductIds
  • purchasedProducts aceita uma ArrayList de strings.