Strategia di modifica

Questa guida verrà presentata per creare un'analogia esatta con le guide Performance Max esistenti, che presuppongono che tu stia creando l'intera campagna in un'unica richiesta atomica, anziché creare ogni entità singolarmente in richieste separate. Ciò significa che dovrai utilizzare ID provvisori per collegare le risorse tra loro, poiché non conoscerai i nomi completi delle risorse finché non riceverai la risposta dell'API.

Per farlo, dovrai scrivere del codice per assicurarti di non creare ID temporanei duplicati:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

Ogni chiamata successiva a getNextTempId restituirà un numero inferiore di uno rispetto al precedente. Poiché tutti gli ID temporanei devono essere negativi, inizia da -1.

A questo punto, puoi creare un array per contenere tutte le operazioni:

const operations = [];

Dovrai spesso utilizzare l'ID cliente per il cliente per cui stai creando la campagna, poiché è obbligatorio in ogni nome della risorsa.

const customerId = AdsApp.currentAccount().getCustomerId();

Ogni volta che vuoi creare una nuova operazione, utilizzerai l'ID temporaneo successivo nel nome della risorsa, in modo da poter fare riferimento a questo oggetto in un secondo momento e inserirlo nell'array:

const newOperation = {
    [OPERATION_TYPE_VARIES]: {
        create: {
            resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
            // Other fields, relevant to the resource being created.
        }
    }
}
operations.push(newOperation);

Per saperne di più e visualizzare un'operazione di esempio, consulta la documentazione sull'API Google Ads REST per le operazioni di mutazione.

Dopo aver costruito tutte le operazioni, eseguile in un unico batch:

AdsApp.mutateAll(operations);