Cosa fa il pulsante «Run Query» di Temu Connector for Odoo

Quando compare e chi ci arriva

Il pulsante Run Query si trova nella schermata Research Queries. La condizione della vista non lo nasconde: in Odoo 17, 18 e 19 si vede sempre. Ciò che limita è il percorso fino alla schermata: le schede si aprono dal menu Temu › Market Intelligence › Market Research, e i rami Market Intelligence e Market Research richiedono il permesso Temu Research & DSA. Se non ce l'hai, non vedi quel ramo del menu.

Con Odoo in italiano, il pulsante si chiama Run Query.

Un caso per vederlo in azione

Esempio Caso illustrativo: l'azienda e i suoi dati sono inventati per spiegare il flusso.

Casa Alba Textil è un negozio inventato che vende su Temu e vuole consultare la libreria degli annunci. Marta, che si occupa dell'e-commerce e ha il permesso Temu Research & DSA, entra in Temu › Market Intelligence › Market Research e apre una query in Research Queries. Nel gruppo Ads Library Params lascia Ads Query Type su Product Name e preme Run Query.

Primo tentativo: Odoo le mostra Research & DSA UI is currently disabled for this Odoo database. Enable it from the Temu instance before using this option. È la prima cosa che il pulsante controlla, prima di toccare la query, quindi l'esecuzione si ferma e non viene salvato nulla.

Secondo tentativo: con la funzione ormai abilitata dall'istanza, Marta preme di nuovo. Ora il pulsante va avanti, richiede i dati a Temu e, al termine, la query risulta eseguita.

Cosa fa il pulsante, in ordine

1. Controlla che la funzione di ricerca sia abilitata nell'istanza di Temu della query. Se non lo è, si ferma con il messaggio del caso.
2. Controlla la modalità di accesso della query: questa operazione usa l'API di Temu e ammette solo l'accesso pubblico di ricerca dell'articolo 40(12).
3. In base al tipo di query, richiede alcuni dati: per SOR, le date di inizio e di fine della richiesta; per le informazioni del negozio e per i prodotti del negozio, il nome del negozio e il codice del paese; per le recensioni di prodotto, questi due e l'identificativo del prodotto. La query della libreria degli annunci non ne richiede nessuno.
4. Richiede i dati a Temu ed estrae le righe dalla risposta.
5. Se tutto è andato bene, segna la query come eseguita e salva il risultato (sezione successiva).

Cosa cambia alla fine

Quando la query termina correttamente, il pulsante la segna come eseguita e salva il metodo usato con i parametri inviati, la risposta di Temu, il numero di risultati e la data e l'ora dell'ultima esecuzione. Cancella anche il testo dell'errore precedente. Il numero di risultati è quello delle righe della risposta; nei tipi che non sono libreria degli annunci, se non c'è un elenco di righe ma la risposta contiene qualcosa, conta uno.

Se qualcosa fallisce all'interno della query, il pulsante la lascia in stato di errore, salva il testo dell'errore e la data dell'ultima esecuzione, e rilancia l'errore perché tu lo veda.

Libreria degli annunci: più pagine con una sola pressione

Questo tipo di query ha un percorso proprio. Tra i suoi parametri, nella scheda di Research Queries, gruppo Ads Library Params, ci sono questi:

• Ads Query Type, con i valori Product Name, Advertiser e Ad Payer; per impostazione predefinita il codice usa Product Name.
• Category.
• Ad Publish Start Ts, la cui guida dice: «Milliseconds timestamp for ads library start filter.».
• Ad Publish End Ts, la cui guida dice: «Milliseconds timestamp for ads library end filter.».

Quando esegui, se la query non ha identificativi di elenco e di ricerca, il pulsante ne genera alcuni e li salva nella query. Se la lingua è vuota usa l'inglese; il numero di pagina minimo è uno; la dimensione della pagina è venti se non è indicata e non supera mai cinquanta.

Se la query è impostata per recuperare tutte le pagine, il pulsante ripete la richiesta pagina per pagina; altrimenti si ferma alla prima. Si interrompe al raggiungimento del massimo di pagine dell'istanza (venti se non ha un valore), alla ricezione di una pagina vuota, al raggiungimento del totale indicato da Temu, quando la risposta segnala che non ci sono altre pagine o, se non indica nulla, quando arriva una pagina con meno righe della dimensione della pagina. Alla fine salva un riepilogo con le pagine richieste, il motivo dell'arresto, il totale delle righe raccolte e i metodi usati.

Cosa ricavare dal caso

• Il messaggio di ricerca disattivata non riguarda la tua query: compare prima di controllare qualsiasi cosa e non cambia nulla.
• Il pulsante non si nasconde (in Odoo 17, 18 e 19); ciò che decide se ci arrivi è il permesso Temu Research & DSA.
• Prima di premere su una query della libreria degli annunci, controlla i campi del gruppo Ads Library Params, tra cui Ads Query Type, Category e i due di marca temporale, perché delimitano ciò che viene richiesto.
• Per rilanciare la query basta premere di nuovo il pulsante; ogni esecuzione riuscita sovrascrive il risultato salvato e cancella l'errore precedente.

Come aiuta FlexigoTech

FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura. Se vuoi vedere il modulo, si trova nella sua pagina su flexigotech.com.

Continua a leggere

Verificato nel codice del connettore (versione 19.0) e nelle fonti collegate

Fonti

• Codice del modulo: flexigobe_temu_connector 19.0 (455b3f0f): views/temu_ads_views.xml
• Codice del modulo: flexigobe_temu_connector 19.0 (455b3f0f): models/temu_ads.py
• flexigotech.com/en/services.html