Creare e gestire i segmenti di pubblico

Un Audience è una raccolta riutilizzabile di segmenti mirati, targeting demografico ed esclusioni. Il targeting per pubblico è supportato per le campagne Performance Max, Demand Gen e app. Se vuoi scegliere come target i segmenti di pubblico direttamente in una campagna display, sulla rete di ricerca, video, per hotel o Shopping standard, consulta Segmenti di pubblico.

Crea segmenti di pubblico

Crea e aggiorna un segmento di pubblico utilizzando AudienceService. Ogni Audience deve avere un nome univoco. Questo segmento di pubblico riutilizzabile consente una combinazione di più dimensioni del pubblico:

Ispeziona MutateAudienceResult per audience_id

Quando crei un segmento di pubblico con AudienceService.MutateAudiences, ogni operazione restituisce un MutateAudienceResult. Puoi ispezionare MutateAudienceResult per ottenere audience_id analizzando resource_name restituito e puoi ispezionare i campi modificabili (ad esempio name) nell'oggetto audience restituito quando response_content_type è impostato su MUTABLE_RESOURCE:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

Recuperare i segmenti di pubblico

Come per le altre risorse, puoi utilizzare GoogleAdsService.SearchStream per recuperare gli attributi dei segmenti di pubblico.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Pubblico di destinazione

I segmenti di pubblico possono essere scelti come target in diversi modi, a seconda del tipo di campagna.

Indicatori del gruppo di asset

Le campagne Performance Max utilizzano un AssetGroupSignal per scegliere come target i segmenti di pubblico. Consulta la guida Indicatori del gruppo di asset per scoprire come scegliere come target i segmenti di pubblico utilizzando gli indicatori del gruppo di asset.

Criterio del gruppo di annunci

Le campagne Demand Gen e per app supportano l'aggiunta di un criterio del gruppo di annunci per il pubblico utilizzando AdGroupCriterion per scegliere come target i segmenti di pubblico o fornire indicatori del pubblico. Puoi scegliere come target i segmenti di pubblico a livello di gruppo di annunci utilizzando i criteri AudienceInfo su AdGroupCriterion.audience impostando il campo AudienceInfo.audience (ad_group_criterion.audience.audience) sul nome della risorsa del segmento di pubblico.

Ecco i passaggi per configurare il targeting per pubblico:

Attiva il targeting per segmenti di pubblico in AdGroup

Devi attivare il targeting per pubblico in AdGroup impostando use_audience_grouped su true al momento della creazione del gruppo di annunci. Questa impostazione non può essere modificata dopo la creazione del gruppo di annunci.

In questo modo puoi aggiungere AdGroupCriterion con i segmenti di pubblico. Se questo valore non è impostato su true, la tua successiva richiesta di targeting del pubblico non andrà a buon fine.

Crea un AdGroupCriterion

Crea un AdGroupCriterion e imposta il campo AudienceInfo.audience in AdGroupCriterion.audience sul nome della risorsa del segmento di pubblico creato in Crea segmenti di pubblico.

(Facoltativo) Attiva il targeting per pubblico in Campaign

Puoi impostare facoltativamente use_audience_grouped su true al momento della creazione della campagna. Con questa impostazione, ricevi un errore se provi ad aggiungere criteri che escluderebbero segmenti e dati demografici a livello di campagna.

Best practice

  • Utilizza i segmenti di pubblico per creare le buyer persona. I segmenti di pubblico vengono utilizzati al meglio nelle campagne Performance Max, Demand Gen e per app, in cui vuoi sovrapporre più segmenti e criteri demografici per scegliere come target una persona specifica.
  • Utilizza i segmenti di pubblico per il targeting diretto. Per le campagne display, sulla rete di ricerca, video, per hotel e Shopping standard o quando devi scegliere come target un singolo segmento (ad esempio un elenco per il remarketing), utilizza Segmenti di pubblico anziché Pubblici.

Errori comuni

Quando crei o aggiorni un Audience, l'API Google Ads convalida la richiesta e restituisce errori dall'enumerazione AudienceError se la convalida non va a buon fine.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Riepilogo Un segmento di pubblico nella richiesta non è stato trovato.
Cause comuni Riferimento a un ID segmento che non esiste o non è accessibile.
Come gestirla Assicurati che tutti gli ID segmento esistano e siano accessibili prima di creare o aggiornare un pubblico.
Suggerimenti per la prevenzione Convalida gli ID segmento prima di includerli in un pubblico.
DIMENSION_INVALID
Riepilogo Una dimensione del segmento di pubblico non è valida.
Cause comuni Inclusi detailed_demographic in exclusion_dimension.
Come gestirla Utilizza solo user_list per le esclusioni in exclusion_dimension.
Suggerimenti per la prevenzione Assicurati che in exclusion_dimension venga utilizzato solo user_list quando crei o aggiorni un segmento di pubblico.
DUPLICATE_AUDIENCE_SEGMENT
Riepilogo Il pubblico contiene segmenti duplicati.
Cause comuni Aggiunta dello stesso segmento più volte allo stesso pubblico.
Come gestirla Rimuovi i segmenti duplicati dalla definizione di segmento di pubblico.
Suggerimenti per la prevenzione Assicurati che tutti i segmenti di un segmento di pubblico siano univoci.
NAME_ALREADY_IN_USE
Riepilogo Il nome del pubblico è già in uso.
Cause comuni Tentativo di creare più segmenti di pubblico con lo stesso nome.
Come gestirla Utilizza un nome univoco quando crei un segmento di pubblico.
Suggerimenti per la prevenzione Controlla i nomi dei segmenti di pubblico esistenti prima di crearne uno nuovo.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Riepilogo Il segmento di pubblico contiene troppe dimensioni dello stesso tipo.
Cause comuni Includere più dimensioni dello stesso tipo (ad esempio, più dimensioni di età) in un unico segmento di pubblico.
Come gestirla Assicurati che la definizione di segmento di pubblico contenga una sola dimensione di ogni tipo.
Suggerimenti per la prevenzione Esamina la definizione di segmento di pubblico per assicurarti che non siano inclusi tipi di dimensioni duplicati.
TOO_MANY_SEGMENTS
Riepilogo Il segmento di pubblico contiene troppi segmenti.
Cause comuni Superamento del numero massimo consentito di segmenti in un segmento di pubblico.
Come gestirla Riduci il numero di segmenti nella definizione del segmento di pubblico.
Suggerimenti per la prevenzione Consulta la documentazione per i limiti al numero di segmenti per pubblico.
Indietro
Panoramica
Avanti
Iniziare a utilizzare i segmenti di pubblico