Documentación Guía para desarrolladores de Target

Segmentación de audiencia

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

Temas:

Creado para:

Desarrollador

Información general

Las audiencias se pueden usar para segmentar las actividades de experimentación y personalización. Adobe Target admite innumerables funcionalidades de segmentación de audiencia eficaces de forma predeterminada. Los atributos siguientes están disponibles para segmentación de audiencia:

Biblioteca Target

Para obtener más información, consulte Target Biblioteca.
palo de golf

Conducido por Bing
Explorador Chrome
Explorador Firefox
Conducido por Google
Internet Explorer
Sistema operativo Linux
Sistema operativo Mac OS
Visitantes nuevos
Visitantes habituales
Explorador Safari
Dispositivo de tableta
Sistema operativo Windows
Conducido por Yahoo

Geografía

Para obtener más información, consulte Información geográfica.
escafandra

País/región
Estado
Ciudad
Código postal
Latitud
Longitud
DMA
Operador de telefonía móvil

Red

Para obtener más información, consulte Red.

ISP
Nombre de dominio
Velocidad de conexión

Móvil

Para obtener más información, consulte Móvil.

Nombre de marketing del dispositivo
Modelo de dispositivo
Proveedor de dispositivo
Es dispositivo móvil
Es un teléfono móvil
Es una tableta
Sistema operativo
Altura de la pantalla (px)
Anchura de la pantalla (px)

Personalizado

Para obtener más información, vea Parámetros personalizados.

cualquier par clave/valor

Sistema operativo

Para obtener más información, consulte Sistema operativo.

Linux
Macintosh
Windows

Páginas del sitio

Para obtener más información, consulte Páginas de sitio.

Página actual
Página anterior
Página de aterrizaje
Encabezado HTTP

Explorador

Para obtener más información, consulte Explorador.

Tipo
Idioma
Versión

Perfil del visitante

Para obtener más información, consulte Perfil del visitante.

cualquier par clave/valor que se mantenga.

Informe de

Para obtener más información, consulte Fuentes de tráfico.

Desde Baidu
Desde Bing
Desde Google
Desde Yahoo
Página de aterrizaje que deriva: dirección URL
Página de aterrizaje que deriva: dominio
Página de aterrizaje que deriva: consulta

Periodo de tiempo

Para obtener más información, consulte Periodo de tiempo.

Fecha inicial / Fecha final

Client Hints

Adobe Target requiere Client Hints para la segmentación correcta de los atributos de audiencia del explorador, sistema operativo y móvil, así como ciertas instancias de scripts de perfil. Para obtener más información, consulte User Agent y Client Hints.

Cómo pasar Client Hints a Adobe Target

A partir del SDK v2.4.0 de Node.js y el SDK v2.3.0 de Java, las Client Hints se pueden enviar a Target mediante llamadas getOffers(). Las Client Hints deben incluirse en el objeto request.context, junto con el agente de usuario.

SDK de Node.js

code language-js line-numbers

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 }] } } });

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 de Java

code language-javascript line-numbers

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();

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();

Toma de decisiones en el dispositivo

La siguiente tabla indica qué reglas de audiencia son compatibles o no con la toma de decisiones en el dispositivo.

Regla de audiencia

Toma de decisiones en el dispositivo

Ubicación geográfica

Sí

Red

Mobile

Parámetros personalizados

Sí

Sí

Sí

Sí

Sí

Audiencias de Experience Cloud (Audiencias de Adobe Audience Manager, Adobe Analytics y Adobe Experience Manager

Segmentación geográfica para la toma de decisiones en el dispositivo

Para mantener una latencia cercana a cero en las actividades de toma de decisiones en el dispositivo con audiencias basadas en regiones geográficas, Adobe recomienda que proporcione los valores geográficos usted mismo en la llamada a getOffers. Para ello, configure el objeto Geo en Context de la solicitud. Esto significa que el servidor necesitará una forma de determinar la ubicación de cada usuario final. Por ejemplo, el servidor puede realizar una búsqueda de IP a geografía mediante un servicio que configure. Algunos proveedores de alojamiento, como Google Cloud, proporcionan esta funcionalidad mediante encabezados personalizados en cada HttpServletRequest.

SDK de Node.js

code language-js line-numbers

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: {} } } })`

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 de Java

code language-javascript line-numbers

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()); } }`

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());
    }
}

Sin embargo, si no tiene la capacidad de realizar búsquedas de IP a geografía en el servidor, pero desea realizar la toma de decisiones en el dispositivo para getOffers solicitudes que contienen audiencias basadas en regiones geográficas, esto también se admite. La desventaja de este enfoque es que usará una búsqueda remota de IP a geografía, que agregará latencia a cada llamada de getOffers. Esta latencia debe ser menor que una llamada a getOffers remota, ya que entra en una red de distribución de contenido (CDN) ubicada cerca del servidor. Debe solamente proporcionar el campo ipAddress en el objeto Geo en Context de su solicitud, a fin de que el SDK recupere la ubicación geográfica de la dirección IP del usuario. Si se proporciona cualquier otro campo además de ipAddress, el SDK de Target no recuperará los metadatos de ubicación geográfica para la resolución.

SDK de Node.js

code language-js line-numbers

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: {} } } })`

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 de Java

code language-javascript line-numbers

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; } }`

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;
    }

}