Guida per gli sviluppatori dei segmenti di pubblico per il remarketing

Questo documento descrive come utilizzare l'API di gestione per gestire i segmenti di pubblico per il remarketing di Google Analytics.

Nota: se utilizzi questa API, devi rispettare le norme relative alle funzionalità pubblicitarie di Google Analytics, incluse le regole sulle categorie sensibili.

Introduzione

L'API di gestione consente di create, get, delete, list, update e patch segmenti di pubblico per il remarketing per una proprietà Google Analytics. Per ulteriori informazioni sul funzionamento dei segmenti di pubblico per il remarketing, consulta l'articolo del Centro assistenza Informazioni sui segmenti di pubblico per il remarketing in Analytics.

casi d'uso

La risorsa Segmento di pubblico per il remarketing supporta get, delete, list, patch e update, ma i principali casi d'uso sono:

• Elenca i segmenti di pubblico per il remarketing.
• Crea un nuovo segmento di pubblico per il remarketing.
• Aggiornare un segmento di pubblico per il remarketing esistente.

Nota: i tuoi segmenti di pubblico per il remarketing rimarranno vuoti e le tue campagne di remarketing potrebbero non essere pubblicate se non attivi il tag per raccogliere i dati appropriati. Per iniziare, attiva le funzionalità pubblicitarie nelle impostazioni della proprietà Google Analytics.

Elenca i segmenti di pubblico per il remarketing

Per elencare tutti i segmenti di pubblico per il remarketing per una proprietà:

1. Utilizza l'API di gestione o Esplora account per recuperare accountId e webPropertyId.
2. Esegui il metodo list della risorsa Segmenti di pubblico per il remarketing.

Per i dettagli sul metodo list per la risorsa remarketing audience, consulta il riferimento dell'API.

Creazione di un nuovo segmento di pubblico per il remarketing

Per creare un nuovo segmento di pubblico per il remarketing per una proprietà:

1. Utilizza l'API di gestione o Esplora account per recuperare accountId e webPropertyId.
2. Utilizza l'API di gestione o Esplora account per recuperare l'ID vista (profilo) per la proprietà linkedViews [].
3. Utilizza la raccolta Collegamenti Google Ads per recuperare un ID account Google Ads per linkedAdAccounts.linkedAccountId.
   • Al momento la proprietà linkedAdAccounts[] è limitata a un solo linkedForeignAccount.
   • linkedAdAccounts[].type può essere impostato su ADWORDS_LINKS, DBM_LINKS, MCC_LINKS o OPTIMIZE.
4. Utilizza la raccolta Segmenti per le opzioni di impostazione della proprietà segment di includeConditions e, se crei un segmento di pubblico basato sullo stato, procedi nello stesso modo per excludeConditions. Consulta anche il riferimento sui segmenti per definire un segmento.
   • includeConditions può facoltativamente avere valori per membershipDurationDays e daysToLookBack
   • excludeConditions.exclusionDuration può facoltativamente essere impostato su PERMANENT.
5. Esegui il metodo insert della risorsa Segmento di pubblico per il remarketing.

L'API consente di creare due tipi di segmenti di pubblico: SIMPLE e STATE_BASED. Per i segmenti di pubblico SIMPLE devi creare audienceDefinition solo con un segment positivo, senza un operatore NOT (il carattere !). Se vuoi includere una condizione di esclusione, devi definire un valore statebasedDefinition. Per saperne di più, consulta Segmenti di pubblico basati sullo stato. Per informazioni dettagliate, vedi l'esempio di riferimento.

Nota: puoi definire un audienceDefinition o un stateBasedAudienceDefinition e impostare audienceType sul valore corrispondente. Inoltre,esiste un limite di 2000 segmenti di pubblico per il remarketing. Fai attenzione quando automatizza la creazione dei segmenti di pubblico per il remarketing.

Aggiornare un segmento di pubblico per il remarketing esistente

Per aggiornare un segmento di pubblico per il remarketing esistente per una proprietà:

1. Se disponi già dell'ID segmento di pubblico per il remarketing, puoi chiamare get, altrimenti puoi chiamare il list e selezionare il segmento di pubblico da aggiornare.
2. Aggiorna uno dei campi scrivibili e chiama update che trasmette l'oggetto Audience aggiornato.

Nota: una volta creato un segmento di pubblico, non puoi modificarne il audienceType. In altre parole, se un segmento di pubblico aveva un valore per audienceDefinition non puoi chiamare l'aggiornamento con un valore per stateBasedAudienceDefinition. Per saperne di più, consulta Segmenti di pubblico basati sullo stato. Per informazioni dettagliate, consulta l'esempio di riferimento.