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 per app. Se vuoi scegliere come target direttamente i segmenti di pubblico 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 di combinare più dimensioni del segmento di pubblico:

Controlla 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 l'oggetto resource_name restituito e puoi ispezionare i campi modificabili (come name) sull'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}")

Recupera 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 dei gruppi di asset

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

Criterio del gruppo di annunci

Le campagne per app e Demand Gen supportano l'aggiunta di un criterio per il gruppo di annunci del segmento di pubblico utilizzando AdGroupCriterion per scegliere i segmenti di pubblico di destinazione o fornire indicatori dei segmenti di pubblico. Puoi scegliere come target i pubblici di destinazione 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 pubblico di destinazione.

Ecco i passaggi per configurare il targeting per pubblico:

Attiva il targeting per pubblico in AdGroup

Devi attivare il targeting per pubblico in AdGroup impostando use_audience_grouped su true quando viene creato il 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 richiesta successiva di scegliere come target il segmento di 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

Se vuoi, puoi impostare use_audience_grouped su true quando viene creata la campagna. Con questa impostazione, ricevi un errore se provi ad aggiungere criteri che escludono segmenti e dati demografici a livello di campagna.

Best practice

  • Utilizza i segmenti di pubblico per creare buyer persona. I segmenti di pubblico sono ideali per le campagne Performance Max, Demand Gen e per app in cui vuoi stratificare più segmenti e criteri demografici per scegliere come target un utente tipo specifico.
  • 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 solo segmento (ad esempio un elenco per il remarketing), utilizza i segmenti di pubblico anziché i segmenti di pubblico.

Errori comuni

Quando crei o aggiorni un Audience, l'API Google Ads convalida la richiesta e restituisce errori dall'enum 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 segmento di pubblico.
Suggerimenti per la prevenzione Convalida gli ID segmento prima di includerli in un segmento di pubblico.
DIMENSION_INVALID
Riepilogo Una dimensione del segmento di pubblico non è valida.
Cause comuni Incluso detailed_demographic in exclusion_dimension.
Come gestirla Utilizza solo user_list per le esclusioni in exclusion_dimension.
Suggerimenti per la prevenzione Assicurati che venga utilizzato solo user_list in exclusion_dimension durante la creazione o l'aggiornamento di un segmento di pubblico.
DUPLICATE_AUDIENCE_SEGMENT
Riepilogo Il segmento di pubblico contiene segmenti duplicati.
Cause comuni Aggiunta dello stesso segmento più volte allo stesso segmento di 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 segmento di 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 segmento di pubblico.
Come gestirla Assicurati che la definizione del 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 di segmento di pubblico.
Suggerimenti per la prevenzione Consulta la documentazione per i limiti relativi al numero di segmenti per pubblico.