Regole per i valori di conversione

Le regole per i valori di conversione ti consentono di definire azioni che modificheranno il valore di una conversione in base alla categoria di ConversionAction e alle seguenti dimensioni di un'impressione:

• Appartenenza al segmento di pubblico
• Posizione fisica o località di interesse
• Dispositivo

Puoi utilizzare l'API Google Ads per definire le regole per i valori di conversione, combinarle in un insieme di regole per i valori di conversione e poi applicarle all'intero account Google Ads o a una campagna specifica. I segmenti nei report dell'API Google Ads forniscono suddivisioni che consentono di confrontare le parti originali, non corrette e rettificate dei valori di conversione.

Creare le regole

Il primo passaggio per utilizzare le regole per i valori di conversione è creare almeno un ConversionValueRule, che consiste in:

• Le condizioni che determinano quando viene applicata la regola
• L'azione da eseguire quando viene applicata la regola

Condizioni delle regole

Definisci le condizioni di un oggetto ConversionValueRule con i seguenti campi:

audience_condition

Applica la regola alle impressioni associate a uno o più segmenti di pubblico. Specifica i nomi delle risorse per ogni elenco di utenti o interesse degli utenti con i campi user_lists o user_interests. Per recuperare i nomi delle risorse degli elenchi di utenti o degli interessi degli utenti disponibili, invia una richiesta searchStream o search per GoogleAdsService in cui la clausola FROM della query è rispettivamente user_list o user_interest.

Se un audience_condition contiene più elenchi di utenti o interessi degli utenti, un'impressione corrisponderà alla regola se l'impressione è associata a uno degli elenchi di utenti o agli interessi degli utenti.

device_condition

Applica la regola se il dispositivo dell'impressione corrisponde a uno qualsiasi dei device_types specificati. Sono consentiti solo i tipi di dispositivi in ValueRuleDeviceType.

geo_location_condition

Applica la regola alle impressioni in cui le informazioni sulla località corrispondono a uno qualsiasi dei geo_target_constants specificati per geo_match_type e non corrisponde a nessuna delle excluded_geo_target_constants per excluded_geo_match_type. Consulta la guida al targeting per località per informazioni su come recuperare i nomi delle risorse di località.

Puoi specificare al massimo due tra audience_condition, device_condition o geo_location_condition per ogni ConversionValueRule.

Una regola senza condizioni specificate viene applicata alle impressioni che non soddisfano le condizioni di una regola più specifica nello stesso set di regole.

Azione della regola

Una regola deve avere un singolo elemento action, composto da operation e value. L'azione definisce come aggiustare il valore di conversione di una conversione che soddisfa le condizioni della regola. Le operazioni disponibili sono le seguenti.

ADD

Aggiunge value al valore originale della conversione. Il valore value deve essere maggiore di 0.

MULTIPLY

Moltiplica il valore originale della conversione per il valore value specificato. Il valore value deve essere maggiore o uguale a 0.5 e minore o uguale a 10.

SET

Imposta il valore di conversione sul value specificato. Il valore value deve essere maggiore di 0.

Puoi utilizzare una regola con l'azione SET solo in una serie di regole che soddisfa le condizioni descritte nella sezione sulla creazione di una serie di regole riportata di seguito.

Altri attributi delle regole

Oltre alle condizioni e a un'azione, ConversionValueRule ha i seguenti attributi.

owner_customer

Il nome della risorsa dell'elemento Customer proprietario della regola. Consente di determinare se una regola è definita all'interno dell'account o di uno dei suoi account amministratore.

status

Lo stato della regola. Puoi mettere in pausa una regola impostando questo campo su PAUSED e attivare una regola in pausa impostando questo campo su ENABLED.

Creazione di una serie di regole

Dopo aver ottenuto almeno un ConversionValueRule, puoi creare un ConversionValueRuleSet, costituito da:

conversion_action_categories

Un elenco di categorie di azioni di conversione a cui si applica questa serie di regole. Se l'elenco è vuoto, la serie di regole si applica a tutte le categorie. Se l'elenco non è vuoto, deve contenere una singola voce STORE_VISIT o STORE_SALE.

Puoi impostare l'elenco di categorie di azioni di conversione solo durante la creazione del insieme di regole.

conversion_value_rules

I nomi delle risorse delle regole da includere nel set.

Questo elenco può contenere una regola che utilizza l'azione SET solo se viene soddisfatta una delle seguenti condizioni:

• Il tuo account è incluso nella lista consentita e il valore conversion_action_categories del insieme di regole è vuoto.
• conversion_action_categories del set contiene solo una singola voce di STORE_VISIT o STORE_SALE, dimensions del set contiene solo una voce per NO_CONDITION e nessuno dei campi di condizione della regola è impostato.

Importante: puoi includere ogni regola per i valori di conversione solo in un set di regole per i valori di conversione. Se conversion_value_rules contiene il nome della risorsa di una regola che si trova in conversion_value_rules di un altro set di regole con status di ENABLED o PAUSED, l'operazione non andrà a buon fine con un errore DATA_CONSTRAINT_VIOLATION.

dimensions

Un elenco di valori di enum di ValueRuleSetDimension che indica le condizioni che possono essere utilizzate dalle regole nel set. Ad esempio, se dimensions contiene GEO_LOCATION e DEVICE, puoi aggiungere regole con geo_location_condition o device_condition al set, ma non puoi aggiungere una regola con audience_condition.

Questo elenco non può essere vuoto e può contenere al massimo due voci.

Se questo elenco contiene una voce per NO_CONDITION:

• NO_CONDITION deve essere l'unica voce nell'elenco.
• L'elenco conversion_action_categories del set deve contenere solo una singola voce STORE_VISIT o STORE_SALE.
• L'elenco conversion_value_rules non può contenere regole in cui sono impostate audience_condition, device_condition o geo_location_condition.

La prima voce di questo elenco determina il valore visualizzato per segments.conversion_value_rule_primary_dimension nei report.

attachment_type

Imposta questo valore su CUSTOMER per creare una serie di regole applicabile all'intero account oppure su CAMPAIGN per creare una serie di regole per una campagna specifica.

campaign

Se il valore attachment_type della serie di regole è CAMPAIGN, impostalo sul nome della risorsa a cui si applica la serie di regole.

Analogamente alle regole, un insieme di regole ha anche un owner_customer e un status. Tuttavia, il valore status di una serie di regole è di sola lettura e deriva dalle sue regole nel seguente modo:

• Se ogni regola a cui fa riferimento conversion_value_rules ha un valore status pari a PAUSED, l'insieme di regole per i valori di conversione status sarà PAUSED.
• In caso contrario, il set di regole per i valori di conversione status sarà ENABLED.

Rimozione di regole e serie di regole

• Un ConversionValueRuleSet deve avere almeno una regola per i valori di conversione che sia PAUSED o ENABLED.

• La rimozione di un ConversionValueRule a cui viene fatto riferimento nell'elemento conversion_value_rules di un ConversionValueRuleSet PAUSED o ENABLED non andrà a buon fine.

• La rimozione di un ConversionValueRuleSet non modifica il valore status di ogni ConversionValueRule a cui fa riferimento l'insieme.

• Una volta rimosso un elemento ConversionValueRuleSet, le richieste search e searchStream per la risorsa conversion_value_rule_set non restituiranno più l'insieme rimosso.

Precedenza di regole e serie di regole

Google Ads utilizza la seguente logica per selezionare e applicare al massimo una regola a ogni conversione:

1. Determinare il attachment_type delle serie di regole da considerare. Se è presente qualsiasi insieme di regole con attachment_type = CAMPAIGN e campaign impostato sulla campagna associata all'impressione, prendi in considerazione solo gli insiemi di regole a livello di campagna. In caso contrario, considerare solo le serie di regole a livello di cliente.

2. Tra le serie di regole da considerare, scegli la serie di regole in cui conversion_action_categories non è vuoto e contiene la categoria dell'azione di conversione della conversione, se esiste una serie di regole di questo tipo. In caso contrario, scegli la serie di regole in cui conversion_action_categories è vuoto.

3. Valuta le regole nella serie di regole scelta nell'ordine in cui vengono visualizzate in conversion_value_rules e seleziona la prima regola con condizioni che soddisfano l'impressione.

Report

I campi metrics.conversions_value e metrics.all_conversions_value, nonché i campi derivati da queste metriche, riflettono le modifiche apportate dalle serie di regole per i valori di conversione. Inoltre, puoi includere segments.conversion_value_rule_primary_dimension nella query per ulteriori informazioni su come sono state applicate le regole. I valori possibili per tale segmento sono i seguenti:

NO_RULE_APPLIED

Valori per le conversioni in cui non è stata applicata alcuna regola.

ORIGINAL

Il valore originale delle conversioni in cui è stata applicata una regola.

GEO_LOCATION, DEVICE, AUDIENCE o NO_CONDITION

Il valore delle conversioni dopo l'applicazione di una regola, raggruppato per la prima voce nella raccolta dimensions del set di regole.