Regole per i valori di conversione

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

• Appartenenza al 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 una serie di regole per i valori di conversione e poi applicare la serie di regole 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 rettificate e rettificate dei valori di conversione.

Creare le regole

Il primo passaggio per utilizzare le regole per i valori di conversione consiste nel creare almeno una 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 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 di ciascun 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 di 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 è associata a uno degli elenchi di utenti o degli interessi degli utenti.

device_condition

Applica la regola se il dispositivo dell'impressione corrisponde a uno degli 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 un valore geo_target_constants specificato per geo_match_type e non corrispondono a nessun valore excluded_geo_target_constants per excluded_geo_match_type. Consulta la guida al targeting per località per scoprire come recuperare i nomi delle risorse per località.

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

Una regola senza condizioni specificate si applica alle impressioni che non soddisfano le condizioni di una regola più specifica nella stessa serie di regole.

Azione regola

Una regola deve avere un singolo action, composto da un operation e da un value. L'azione definisce la modalità di aggiustamento del 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. value deve essere maggiore o uguale a 0.5 e minore o uguale a 10.

SET

Imposta il valore di conversione sul valore 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 soddisfi le condizioni descritte nella sezione Creazione di una serie di regole di seguito.

Altri attributi delle regole

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

owner_customer

Il nome della risorsa del Customer proprietario della regola. Utilizza questo campo per 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

Quando hai almeno un ConversionValueRule, puoi creare una ConversionValueRuleSet, composta 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 di STORE_VISIT o STORE_SALE.

Puoi impostare l'elenco delle categorie delle azioni di conversione solo quando crei il set 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 è inserito nella lista consentita e il valore conversion_action_categories del set di regole è vuoto.
• conversion_action_categories del set contiene una sola 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 insieme di regole per i valori di conversione. Se conversion_value_rules contiene il nome della risorsa di una regola presente nel conversion_value_rules di un altro set di regole con status di ENABLED o PAUSED, l'operazione non riuscirà e verrà generato un errore DATA_CONSTRAINT_VIOLATION.

dimensions

Un elenco di valori enu 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 l'elenco contiene una voce per NO_CONDITION:

• NO_CONDITION deve essere l'unica voce dell'elenco.
• L'elenco di conversion_action_categories del set deve contenere solo una singola voce di STORE_VISIT o STORE_SALE.
• L'elenco di conversion_value_rules non può contenere alcuna regola in cui è impostata audience_condition, device_condition o geo_location_condition.

La prima voce in 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 o 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, una serie 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 relative regole, come descritto di seguito:

• Se ogni regola a cui fa riferimento conversion_value_rules ha un valore status di PAUSED, il set 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 si fa riferimento in conversion_value_rules di un PAUSED o di un ConversionValueRuleSet ENABLED non riuscirà.

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

• Una volta rimosso un ConversionValueRuleSet, le richieste search e searchStream per la risorsa conversion_value_rule_set non restituiranno più il set rimosso.

Precedenza di regole e serie di regole

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

1. Determina il attachment_type di serie di regole da considerare. Se per la campagna associata all'impressione sono impostati set di regole con attachment_type = CAMPAIGN e campaign, considera solo le serie di regole a livello di campagna. In caso contrario, considera solo le serie di regole a livello di cliente.

2. Tra le serie di regole da considerare, scegli quella in cui conversion_action_categories non è vuoto e contiene la categoria dell'azione di conversione della conversione, se esistente. In caso contrario, scegli la serie di regole in cui il campo 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 corrispondono all'impressione.

Reporting

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 delle conversioni a cui non è stata applicata alcuna regola.

ORIGINAL

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

GEO_LOCATION, DEVICE, AUDIENCE o NO_CONDITION

Il valore delle conversioni dopo l'applicazione di una regola, raggruppate in base alla prima voce nella raccolta dimensions della serie di regole.