Wat de knop Run Query van Temu Connector for Odoo doet

Wanneer hij verschijnt en wie erbij kan

De knop Run Query staat op het scherm Research Queries. De voorwaarde in de weergave verbergt hem niet: in Odoo 17, 18 en 19 zie je hem altijd. Wat beperkt, is de route naar het scherm: de formulieren open je via het menu Temu › Market Intelligence › Market Research, en de onderdelen Market Intelligence en Market Research vragen het recht Temu Research & DSA. Heb je dat niet, dan zie je dat deel van het menu niet.

De knop heet Run Query: de module heeft hiervoor geen Nederlandse vertaling, dus ook met Odoo in het Nederlands zie je deze Engelse naam.

Een voorbeeld om het aan het werk te zien

Voorbeeld Fictief geval: het bedrijf en de cijfers zijn verzonnen om de werkwijze uit te leggen.

Casa Alba Textil is een verzonnen winkel die op Temu verkoopt en de advertentiebibliotheek wil raadplegen. Marta, die de e-commerce doet en het recht Temu Research & DSA heeft, gaat naar Temu › Market Intelligence › Market Research en opent een query in Research Queries. In de groep Ads Library Params laat ze Ads Query Type op Product Name staan en klikt ze op Run Query.

Eerste poging: Odoo toont Research & DSA UI is currently disabled for this Odoo database. Enable it from the Temu instance before using this option. Dat is het eerste wat de knop controleert, voordat hij de query aanraakt, dus de uitvoering stopt en er wordt niets opgeslagen.

Tweede poging: met de functie nu ingeschakeld vanuit de instantie klikt Marta opnieuw. Nu gaat de knop door, vraagt de gegevens op bij Temu en zet de query na afloop op uitgevoerd.

Wat de knop doet, op volgorde

1. Hij controleert of de onderzoeksfunctie is ingeschakeld in de Temu-instantie van de query. Zo niet, dan stopt hij met de melding uit het voorbeeld.
2. Hij controleert de toegangsmodus van de query: deze bewerking gebruikt de Temu-API en laat alleen de openbare onderzoekstoegang van artikel 40(12) toe.
3. Afhankelijk van het querytype eist hij bepaalde gegevens: voor SOR de begin- en einddatum van het verzoek; voor winkelinformatie en winkelproducten de naam van de winkel en de landcode; voor productbeoordelingen die twee en de productidentificatie. De query voor de advertentiebibliotheek vraagt er geen van deze.
4. Hij vraagt de gegevens op bij Temu en haalt de rijen uit het antwoord.
5. Als alles goed is gegaan, zet hij de query op uitgevoerd en slaat hij het resultaat op (volgende sectie).

Wat er verandert na afloop

Als de query goed afloopt, zet de knop de query op uitgevoerd en slaat hij de gebruikte methode op met de verstuurde parameters, het antwoord van Temu, het aantal resultaten en de datum en tijd van de laatste uitvoering. Ook wist hij de eerdere foutmelding. Het aantal resultaten is het aantal rijen in het antwoord; bij andere typen dan de advertentiebibliotheek telt het als één wanneer er geen lijst met rijen is maar het antwoord wel inhoud heeft.

Als er iets misgaat binnen de query, zet de knop haar in de status fout, slaat hij de tekst van de fout en de datum van de laatste uitvoering op en gooit hij de fout opnieuw zodat je hem ziet.

Advertentiebibliotheek: meerdere pagina's met één klik

Dit type query heeft zijn eigen verloop. Onder de parameters, op het formulier van Research Queries, groep Ads Library Params, staan deze:

• Ads Query Type, met de waarden Product Name, Advertiser en Ad Payer; standaard gebruikt de code Product Name.
• Category.
• Ad Publish Start Ts, waarvan de hulptekst zegt: «Milliseconds timestamp for ads library start filter.».
• Ad Publish End Ts, waarvan de hulptekst zegt: «Milliseconds timestamp for ads library end filter.».

Bij het uitvoeren genereert de knop, als de query geen lijst- en zoekidentificaties heeft, er een paar en slaat die erop op. Als de taal leeg is, gebruikt hij Engels; het minimale paginanummer is één; de paginagrootte is twintig als er niets is opgegeven en gaat nooit boven vijftig.

Als de query is gemarkeerd om alle pagina's op te halen, herhaalt de knop het verzoek pagina na pagina; zo niet, dan blijft hij bij de eerste. Hij stopt bij het maximum aantal pagina's van de instantie (twintig als er geen waarde is), bij een lege pagina, bij het totaal dat Temu meldt, wanneer het antwoord aangeeft dat er geen pagina's meer zijn of, als het niets aangeeft, wanneer er een pagina komt met minder rijen dan de paginagrootte. Aan het eind slaat hij een samenvatting op met de opgevraagde pagina's, de reden van stoppen, het totaal aan verzamelde rijen en de gebruikte methoden.

Wat je uit het voorbeeld meeneemt

• De melding over uitgeschakeld onderzoek gaat niet over je query: ze komt voordat er iets van gecontroleerd wordt en verandert niets.
• De knop wordt niet verborgen (in Odoo 17, 18 en 19); wat bepaalt of je erbij kunt, is het recht Temu Research & DSA.
• Controleer voor je klikt bij een query voor de advertentiebibliotheek de velden van de groep Ads Library Params, waaronder Ads Query Type, Category en de twee tijdstempelvelden, want die bepalen wat er wordt opgevraagd.
• Om de query opnieuw te starten volstaat het nogmaals op de knop te klikken; elke geslaagde uitvoering overschrijft het opgeslagen resultaat en wist de eerdere fout.

Hoe FlexigoTech helpt

FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Wil je de module bekijken, dan staat die op zijn pagina op flexigotech.com.

Lees verder

Gecontroleerd in de broncode van de connector (versie 19.0) en in de gelinkte bronnen

Bronnen

• Broncode van de module: flexigobe_temu_connector 19.0 (455b3f0f): views/temu_ads_views.xml
• Broncode van de module: flexigobe_temu_connector 19.0 (455b3f0f): models/temu_ads.py
• flexigotech.com/en/services.html