DocumentazioneGuida per gli sviluppatori di Target

Targeting del pubblico

Last update: Thu Jul 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer

Panoramica

I tipi di pubblico possono essere utilizzati per eseguire il targeting delle attività di sperimentazione e personalizzazione. Adobe Target supporta una miriade di potenti funzionalità di targeting del pubblico pronte all’uso. I seguenti attributi sono disponibili per targeting di pubblico:

Target Libreria

Per ulteriori informazioni, consulta Target Libreria. ​

  • Referrer da Bing
  • Browser Chrome
  • Browser Firefox
  • Referrer da Google
  • Internet Explorer
  • Sistema operativo Linux
  • Sistema operativo Mac OS
  • Visitatori nuovi
  • Visitatori di ritorno
  • Browser Safari
  • Dispositivo tablet
  • Sistema operativo Windows
  • Referrer da Yahoo

Geo

Per ulteriori informazioni, consulta Geo.
​​

  • Paese/Area geografica
  • Stato
  • Città
  • Codice postale
  • Latitudine
  • Longitudine
  • DMA
  • Gestore di telefonia mobile

Rete

Per ulteriori informazioni, consulta Rete.

  • ISP
  • Nome di dominio
  • Velocità di connessione

Dispositivi mobili

Per ulteriori informazioni, consulta Mobile.

  • Nome marketing del dispositivo
  • Modello dispositivo
  • Produttore dispositivo
  • È un dispositivo mobile
  • È un telefono cellulare
  • È un tablet
  • Sistema operativo
  • Altezza schermo (px)
  • Larghezza schermo (px)

Personalizzato

Per ulteriori informazioni, consulta Parametri personalizzati.

  • qualsiasi coppia chiave/valore

Sistema operativo

Per ulteriori informazioni, consulta Sistema operativo.

  • Linux
  • Macintosh
  • Windows

Pagine del sito

Per ulteriori informazioni, consulta Pagine del sito.

  • Pagina corrente
  • Pagina precedente
  • Pagina di destinazione
  • Intestazione HTTP

Browser

Per ulteriori informazioni, consulta Browser.

  • Tipo
  • Lingua
  • Versione

Profilo visitatore

Per ulteriori informazioni, consulta Profilo visitatore.

  • qualsiasi coppia chiave/valore, che viene mantenuta

Origini del traffico

Per ulteriori informazioni, consulta Sorgenti di traffico.

  • Da Baidu
  • Da Bing
  • Da Google
  • Da Yahoo
  • Pagina di destinazione di riferimento: URL
  • Pagina di destinazione di riferimento: dominio
  • Pagina di destinazione di riferimento: query

Arco temporale

Per ulteriori informazioni, consulta Arco temporale.

  • Data inizio / Data fine

Client Hints

Adobe Target richiede Client Hints per la segmentazione corretta degli attributi di browser, sistema operativo e pubblico mobile, nonché alcune istanze degli script di profilo. Per ulteriori informazioni, consulta User Agent e Client Hints.

Come trasmettere gli Client Hints ad Adobe Target

A partire da Node.js SDK v2.4.0 e Java SDK v2.3.0, gli Client Hints possono essere inviati a Target tramite getOffers() chiamate. Gli Client Hints devono essere inclusi nel request.context insieme all'agente utente.

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

Decisioning sul dispositivo

La tabella seguente indica quali regole per il pubblico sono supportate o meno per le decisioni su dispositivo.

Regola pubblico
Decisioning sul dispositivo
Geo
Sì
Rete
No
Mobile
No
Parametri personalizzati
Sì
Sistema operativo
Sì
Pagine del sito
Sì
Browser
Sì
Profilo visitatore
No
Origini del traffico
No
Arco temporale
Sì
Tipi di pubblico di Experience Cloud (Tipi di pubblico da Adobe Audience Manager, Adobe Analytics e Adobe Experience Manager
No

Geotargeting per le decisioni su dispositivo

Al fine di mantenere una latenza prossima allo zero per le attività di decisioning sul dispositivo con un pubblico basato su geotargeting, l’Adobe consiglia di fornire autonomamente i valori geografici nella chiamata a getOffers. A tale scopo, impostare Geo oggetto in Context della richiesta. Ciò significa che il server dovrà essere in grado di determinare la posizione di ciascun utente finale. Ad esempio, il server potrebbe eseguire una ricerca IP-to-Geo utilizzando un servizio configurato. Alcuni provider di hosting, come Google Cloud, forniscono questa funzionalità tramite intestazioni personalizzate in ogni HttpServletRequest.

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

Tuttavia, se non hai la possibilità di eseguire ricerche IP-to-Geo sul server, ma desideri comunque eseguire decisioni su dispositivo per getOffers sono supportate anche le richieste che contengono tipi di pubblico basati su geotargeting. Il lato negativo di questo approccio è che utilizzerà una ricerca remota IP-to-Geo, che aggiungerà latenza a ogni getOffers chiamare. Questa latenza deve essere inferiore a un getOffers , poiché raggiunge una rete CDN situata vicino al server. Devi solo fornire ipAddress campo in Geo oggetto in Context della richiesta, affinché l’SDK possa recuperare la geolocalizzazione dell’indirizzo IP dell’utente. Se sono presenti altri campi oltre a ipAddress viene fornito, il Target L’SDK non recupererà i metadati di geolocalizzazione per la risoluzione.

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

}

Decisioning lato server

La tabella seguente indica quali regole per il pubblico sono supportate o meno per le decisioni lato server.

Regola pubblico
Decisioning lato server
Geo
Sì
Rete
Sì
Mobile
Sì
Parametri personalizzati
Sì
Sistema operativo
Sì
Pagine del sito
Sì
Browser
Sì
Profilo visitatore
Sì
Origini del traffico
Sì
Arco temporale
Sì
Tipi di pubblico di Experience Cloud (Tipi di pubblico da Adobe Audience Manager, Adobe Analytics e Adobe Experience Manager
Sì
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3