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 a un segmento di pubblico
  • Località fisica o località di interesse
  • Dispositivo
  • Itinerario di viaggio

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

Crea regole

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

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

Ad esempio, il seguente payload JSON per ConversionValueRuleService.MutateConversionValueRules crea una regola che moltiplica i valori di conversione per 1.5 per le impressioni mobile:

{
  "operations": [
    {
      "create": {
        "action": {
          "operation": "MULTIPLY",
          "value": 1.5
        },
        "deviceCondition": {
          "deviceTypes": ["MOBILE"]
        }
      }
    }
  ]
}

Condizioni della regola

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 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 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 dei device_types specificati. Sono consentiti solo i tipi di dispositivi in ValueRuleDeviceType.
geo_location_condition
Applica la regola alle impressioni in cui i dati sulla posizione corrispondono a uno qualsiasi dei geo_target_constants specificati per geo_match_type e non corrispondono a nessuno dei excluded_geo_target_constants per excluded_geo_match_type. Consulta la guida al targeting per località per scoprire come recuperare i nomi delle risorse di località.
itinerary_condition
Applica la regola alle impressioni in cui i termini di ricerca includono informazioni specifiche sull'itinerario, come la finestra di prenotazione, la durata del viaggio o il giorno di inizio del viaggio. Consulta ValueRuleItineraryCondition per ulteriori dettagli sulle condizioni disponibili.

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

Una regola senza condizioni specificate si applica 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 action, composto da un operation e un 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. 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. value deve essere maggiore di 0.

Puoi utilizzare una regola con l'azione SET solo in un set di regole che soddisfa le condizioni descritte in Creazione di un set di regole.

Altri attributi delle regole

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

owner_customer
Il nome della risorsa Customer proprietaria della regola. Utilizza questa opzione 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.

Crea set di regole

Una volta ottenuto almeno un ConversionValueRule, puoi creare un ConversionValueRuleSet, che è composto da:

conversion_action_categories

Un elenco di categorie di azioni di conversione a cui si applica questo set di regole. Se l'elenco è vuoto, il set 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 di azioni di conversione solo durante la creazione del set di regole.

conversion_value_rules

I nomi delle risorse delle regole da includere nel set.

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

  • Il tuo account è nella lista consentita e il campo conversion_action_categories del set di regole è vuoto.
  • conversion_action_categories dell'insieme contiene una sola voce di STORE_VISIT o STORE_SALE, dimensions dell'insieme contiene solo una voce per NO_CONDITION e nessuno dei campi delle condizioni della regola è impostato.
dimensions

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

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

La prima voce di questo elenco determina il valore visualizzato per segments.conversion_value_rule_primary_dimension nelle metriche.

Se questo elenco contiene una voce per NO_CONDITION:

  • NO_CONDITION deve essere l'unica voce nell'elenco.
  • L'elenco di conversion_action_categories dell'insieme deve contenere solo una singola voce di STORE_VISIT o STORE_SALE.
  • L'elenco di conversion_value_rules non può contenere regole in cui è impostato audience_condition, device_condition o geo_location_condition.
attachment_type

Imposta questo valore su CUSTOMER per creare un set di regole che si applica all'intero account o su CAMPAIGN per creare un set di regole per una campagna specifica.

campaign

Se il attachment_type del set di regole è CAMPAIGN, impostalo sul nome della risorsa a cui si applica il set di regole.

Analogamente alle regole, anche un set di regole ha un owner_customer e un status. Tuttavia, il campo status di un set di regole è di sola lettura e viene derivato dalle regole come segue:

  • Se ogni regola a cui fa riferimento conversion_value_rules ha un 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.

Rimuovi regole e set 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 nel conversion_value_rules di un PAUSED o ENABLED ConversionValueRuleSet non andrà a buon fine.

  • La rimozione di un ConversionValueRuleSet non modifica il status di ogni ConversionValueRule a cui fa riferimento il set.

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

Precedenza delle regole e dei set di regole

Google Ads utilizza la seguente logica per selezionare e applicare al massimo una regola a ogni conversione. Per saperne di più su queste regole, consulta il Centro assistenza Google Ads:

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

  2. Tra i set di regole da considerare, scegli quello in cui conversion_action_categories non è vuoto e contiene la categoria dell'azione di conversione della conversione, se esiste un set di regole di questo tipo. In caso contrario, scegli il set di regole in cui conversion_action_categories è vuoto.

  3. Valuta le regole nel set di regole scelto nell'ordine in cui vengono visualizzate in conversion_value_rules e seleziona la prima regola con condizioni che corrispondono all'impressione.

  4. Per più condizioni di geolocalizzazione corrispondenti, viene applicata la località più precisa. Ad esempio, se un'impressione corrisponde alle condizioni Stati Uniti e California, verrà applicata la California perché è una località più precisa.

  5. Per più condizioni di pubblico corrispondenti, verrà applicata la gerarchia di attribuzione dei segmenti di pubblico esistente. In caso di parità tra due regole di un set, viene selezionata una regola di tipo "Moltiplica" prima di una di tipo "Aggiungi". Se è ancora presente una condizione di parità (ovvero ci sono più regole di tipo "Moltiplica"), viene selezionata la regola con il moltiplicatore di aggiustamento più alto.

  6. Non possono essere presenti più condizioni di corrispondenza dei dispositivi, perché le categorie di dispositivi si escludono a vicenda.

  7. Per le condizioni dell'itinerario di viaggio, viene applicata la regola dell'itinerario più specifica. Ciò significa che se più regole corrispondono a una determinata conversione, viene utilizzata la regola con il maggior numero di opzioni di itinerario definite, ad esempio "Finestra per prenotazione anticipata" o "Durata del viaggio".

Metriche

I campi metrics.conversions_value e metrics.all_conversions_value, nonché i campi derivati da queste metriche, riflettono le modifiche apportate dai set 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 questo segmento sono:

NO_RULE_APPLIED
Valori per le 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, raggruppato in base alla prima voce della raccolta dimensions del set di regole.