DocumentaçãoGuia do desenvolvedor do Target

Direcionamento de público

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

Visão geral

Os públicos podem ser usados para direcionar suas atividades de experimentação e personalização. O Adobe Target oferece suporte a uma variedade de recursos avançados de direcionamento de público pronto para uso. Os seguintes atributos estão disponíveis para o direcionamento de público:

Biblioteca Target

Para obter mais informações, consulte Target Biblioteca.
​

  • Referenciado do Bing
  • Chrome
  • Firefox
  • Referenciado do Google
  • Internet Explorer
  • Sistema operacional Linux
  • Sistema operacional Mac OS
  • Novos visitantes
  • Visitantes que retornam
  • Safari
  • Dispositivo tablet
  • Sistema operacional Windows
  • Referenciado do Yahoo

Geografia

Para obter mais informações, consulte Geo.
​​

  • País/Região
  • Estado
  • Cidade
  • Código Postal
  • Latitude
  • Longitude
  • DMA
  • Operadora de celular

Rede

Para obter mais informações, consulte Rede.

  • ISP
  • Nome do Domínio
  • Velocidade de conexão

Dispositivo móvel

Para obter mais informações, consulte Dispositivo móvel.

  • Nome de marketing do dispositivo
  • Modelo do dispositivo
  • Fornecedor do dispositivo
  • É dispositivo móvel
  • É celular
  • É tablet
  • SO
  • Altura de tela (px)
  • Largura de tela (px)

Personalizado

Para obter mais informações, consulte Parâmetros personalizados.

  • qualquer par de chave/valor

Sistema operacional

Para obter mais informações, consulte Sistema Operacional.

  • Linux
  • Macintosh
  • Windows

Páginas do site

Para obter mais informações, consulte Páginas do site.

  • Página atual
  • Página anterior
  • Página de aterrissagem
  • Cabeçalho HTTP

Para obter mais informações, consulte Navegador.

  • Tipo
  • Idioma
  • Versão

Perfil do visitante

Para obter mais informações, consulte Perfil do visitante.

  • qualquer par de chave/valor, que seja persistente

Fontes de tráfego

Para obter mais informações, consulte Fontes de tráfego.

  • Do Baidu
  • Do Bing
  • Do Google
  • Do Yahoo
  • Página de aterrissagem de referência: URL
  • Página de aterrissagem de referência: domínio
  • Página de aterrissagem de referência: consulta

Intervalo de tempo

Para obter mais informações, consulte Intervalo de tempo.

  • Data de Início / Data Final

Client Hints

O Adobe Target requer Client Hints para a segmentação correta de atributos de Navegador, Sistema Operacional e Público-alvo móvel, bem como determinadas instâncias de Scripts de Perfil. Para obter mais informações de plano de fundo, consulte User Agent e Client Hints.

Como passar as Client Hints para o Adobe Target

A partir do Node.js SDK v2.4.0 e do Java SDK v2.3.0, as Client Hints podem ser enviadas para Target por meio de chamadas getOffers(). As Client Hints devem ser incluídas no objeto request.context, juntamente com o Agente do Usuário.

SDK do Node.js
code language-js line-numbers 
targetClient.getOffers({
    request: {
        context: {
            channel: "mobile"
            userAgent: "Mozilla/5.0 (Linux; Android 12; Pixel 4a) AppleWebKit/537.36 (KHTML, like Gecko) Mobile Safari/537.36",
            clientHints: {
                mobile: "true",
                platform: "Linux",
                platformVersion: "12.1",
                model: "Pixel 4a",
                browserUAWithMajorVersion: "\"Not A;Brand\";v=\"98\", \"Chromium\";v=\"98\", \"Google Chrome\";v=\"98\"",
                browserUAWithFullVersion: "\" Not A;Brand\";v=\"98.0.0.0\", \"Chromium\";v=\"98.0.4844.83\", \"Google Chrome\";v=\"98.0.4758.101\"",
                bitness: "64",
                architecture: "x86"
            }
        },
        execute: {
            mboxes: [{
                name: "home",
                index: 1
            }]
        }
    }
});
SDK Java
code language-javascript line-numbers 
import com.adobe.target.delivery.v1.model.ClientHints;
import com.adobe.target.delivery.v1.model.Context;
import com.adobe.target.delivery.v1.model.ExecuteRequest;
import com.adobe.target.edge.client.model.TargetDeliveryRequest;


ClientHints clientHints = new ClientHints();
clientHints.setMobile(true);
clientHints.setPlatform("macOS");
clientHints.setArchitecture("x86");
clientHints.setPlatformVersion("11.3.1");
clientHints.setBrowserUAWithMajorVersion(
  "\" Not A;Brand\";v=\"99\", \"Chromium\";v=\"99\", \"Google Chrome\";v=\"99\"");
String userAgent =
  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Safari/537.36";


TargetDeliveryRequest request = TargetDeliveryRequest.builder()
        .execute(new ExecuteRequest().pageLoad(pageLoad))
        .context(new Context().clientHints(clientHints).userAgent(userAgent))
        .build();

Decisão no dispositivo

A tabela a seguir indica quais regras de público-alvo são ou não compatíveis com a decisão no dispositivo.

Regra de público-alvo
Decisão no dispositivo
Geografia
Sim
Rede
Não
Móvel
Não
Parâmetros personalizados
Sim
Sistema operacional
Sim
Páginas do site
Sim
Navegador
Sim
Perfil do visitante
Não
Fontes de Tráfego
Não
Intervalo de tempo
Sim
Públicos-alvo do Experience Cloud (públicos-alvo do Adobe Audience Manager, Adobe Analytics e Adobe Experience Manager
Não

Direcionamento geográfico para decisão no dispositivo

Para manter uma latência próxima de zero para atividades de decisão no dispositivo com públicos baseados em localização geográfica, a Adobe recomenda que você mesmo forneça os valores geográficos na chamada para getOffers. Faça isso definindo o objeto Geo no Context da solicitação. Isso significa que seu servidor precisará de uma maneira de determinar a localização de cada usuário final. Por exemplo, o servidor pode executar uma pesquisa de IP para Geo usando um serviço configurado por você. Alguns provedores de hospedagem, como a Google Cloud, fornecem essa funcionalidade por meio de cabeçalhos personalizados em cada HttpServletRequest.

SDK do Node.js
code language-js line-numbers 
const CONFIG = {
    client: "acmeclient",
    organizationId: "1234567890@AdobeOrg",
    decisioningMethod: "on-device"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
    request: {
        context: {
            geo: {
                city: "SAN FRANCISCO",
                countryCode: "US",
                stateCode: "CA",
                latitude: 37.75,
                longitude: -122.4
            }
        },
        execute: {
            pageLoad: {}
        }
    }
})
SDK Java
code language-javascript line-numbers 
public class TargetRequestUtils {

    public static Context getContext(HttpServletRequest request) {
        Context context = new Context()
            .geo(ipToGeoLookup(request.getRemoteAddr()))
            .channel(ChannelType.WEB)
            .timeOffsetInMinutes(330.0)
            .address(getAddress(request));
        return context;
    }

    public static Geo ipToGeoLookup(String ip) {
        GeoResult geoResult = geoLookupService.lookup(ip);
        return new Geo()
            .city(geoResult.getCity())
            .stateCode(geoResult.getStateCode())
            .countryCode(geoResult.getCountryCode());
    }
}

No entanto, se você não tiver a capacidade de executar pesquisas de IP para Geografia no servidor, mas ainda quiser executar decisões no dispositivo para solicitações getOffers que contenham públicos com base geográfica, isso também será suportado. A desvantagem dessa abordagem é que ela usará uma pesquisa remota de IP para Geo, o que adicionará latência a cada chamada getOffers. Essa latência deve ser menor que uma chamada remota getOffers, pois atinge um CDN localizado próximo ao seu servidor. Você deve somente fornecer o campo ipAddress no objeto Geo em Context de sua solicitação para que o SDK recupere a localização geográfica do endereço IP de seu usuário. Se qualquer outro campo além de ipAddress for fornecido, o SDK Target não buscará os metadados de localização geográfica para resolução.

SDK do Node.js
code language-js line-numbers 
const CONFIG = {
    client: "acmeclient",
    organizationId: "1234567890@AdobeOrg",
    decisioningMethod: "on-device"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
    request: {
        context: {
            geo: {
                ipAddress: "127.0.0.1"
            }
        },
        execute: {
            pageLoad: {}
        }
    }
})
SDK Java
code language-javascript line-numbers 
public class TargetRequestUtils {

    public static Context getContext(HttpServletRequest request) {
        Context context = new Context()
            .geo(new Geo().ipAddress(request.getRemoteAddr()))
            .channel(ChannelType.WEB)
            .timeOffsetInMinutes(330.0)
            .address(getAddress(request));
        return context;
    }

}

Decisão do lado do servidor

A tabela a seguir indica quais regras de público-alvo são ou não compatíveis com a decisão do lado do servidor.

Regra de público-alvo
Decisão do lado do servidor
Geografia
Sim
Rede
Sim
Móvel
Sim
Parâmetros personalizados
Sim
Sistema operacional
Sim
Páginas do site
Sim
Navegador
Sim
Perfil do visitante
Sim
Fontes de Tráfego
Sim
Intervalo de tempo
Sim
Públicos-alvo do Experience Cloud (públicos-alvo do Adobe Audience Manager, Adobe Analytics e Adobe Experience Manager
Sim
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3