Google Ads API 26.2 aduce controale video și raportare extinsă a audienței

Google a lansat pe 11 noiembrie actualizarea 26.2 a Google Ads API, cu funcții pentru reclamele video Demand Gen, ajustări sezoniere și raportarea audienței. Versiunea include și erori noi pentru operațiunile care necesită aprobarea mai multor administratori. Este o actualizare minoră a familiei 26, fără modificări clasificate de Google drept incompatibile cu versiunea majoră.

Schimbările privesc aplicațiile care administrează conturi și rapoarte prin API. Una dintre noutăți este controlul suprapunerii textului peste materialele video. O alta extinde accesul la datele despre persoane unice atinse de reclame, inclusiv la nivelul contului. Funcțiile au însă domenii diferite de aplicare, după tipul anunțului, campanie și indicatorul solicitat.

Textul din anunț poate fi suprapus peste videoclip

Controlul OVERLAY_TEXT_ON_VIDEOS folosește texte deja asociate anunțului, precum titlurile, și le suprapune peste materialele video. Documentația îl asociază formatului DemandGenVideoResponsiveAd. În familia API 26, automatizarea este activată implicit pentru anunțurile noi de acest tip. Identificatorul tehnic denumește o operație precisă asupra elementelor existente ale reclamei.

Google separă automatizările aplicate întregii campanii de cele configurate pentru un singur anunț. Suprapunerea textului aparține celei de-a doua categorii. Setarea are un tip, care identifică funcția, și o stare, care arată dacă funcția este activată sau dezactivată. Celelalte automatizări video, precum scurtarea materialelor sau adaptarea orientării, au controale și tipuri proprii.

Documentația păstrează și distincția dintre formatele Demand Gen. Automatizările pentru crearea videoclipurilor din alte elemente ale reclamei sunt asociate formatului cu mai multe tipuri de materiale, iar suprapunerea textului este asociată formatului video responsive. Această diferență stabilește unde poate fi folosit fiecare control în aplicațiile care creează și gestionează reclamele.

Ajustările sezoniere ajung în Demand Gen în stadiu beta

Actualizarea adaugă, în beta, ajustări sezoniere pentru Demand Gen. Potrivit Google, suportul acoperă inventarul YouTube, Display, Gmail și Maps; ajustările nu au efect pe Discover. Stadiul beta și această delimitare a canalelor fac parte din condițiile publicate pentru funcție. Anunțul nu transformă toate suprafețele Demand Gen într-un singur inventar cu același comportament.

Ajustările sezoniere transmit către Smart Bidding schimbări anticipate ale ratei de conversie pentru evenimente viitoare. Google le descrie ca instrument destinat unor intervale scurte, de regulă între una și șapte zile. Resursa tehnică include începutul, sfârșitul și un multiplicator al ratei de conversie, cu valorile temporale interpretate în fusul orar al contului.

Intervalul permis pentru multiplicator este între 0,1 și 10, iar valoarea 1 indică absența unei ajustări. Resursa impune o perioadă mai mare de zero și de cel mult 14 zile. Modificatorul reprezintă variația estimată a ratei de conversie pentru acel interval; cifra introdusă nu este raportată drept o creștere deja obținută a vânzărilor.

Aplicarea poate viza campanii nominalizate sau campanii dintr-un anumit tip de canal. În primul caz, lista poate include până la 2.000 de campanii pentru aceeași ajustare. Există și o selecție opțională a dispozitivelor; dacă aceasta lipsește, ajustarea include toate tipurile de dispozitive. Aceste proprietăți descriu întinderea regulii programate, separat de perioada sa de valabilitate.

Acoperirea poate fi analizată și la nivelul contului

Raportarea acoperirii unice permite consultarea numărului de persoane care au văzut o reclamă într-un interval ales. Indicatorul de bază măsoară persoanele expuse cel puțin o dată. Indicatorii de frecvență urmăresc persoane expuse de cel puțin două ori, trei ori și până la zece ori. Sunt praguri cumulative de expunere, nu grupe independente care pot fi însumate.

Documentația actualizată permite interogarea acoperirii pe resursele campaign și customer. La nivelul contului, datele elimină dublarea persoanelor între tipurile de campanii acceptate. Raportarea pe formate și raportarea pe rețele au combinații distincte de segmente: un rezultat poate fi detaliat după format sau după rețea, dar cele două familii nu se combină în aceeași interogare.

Ferestrele de timp diferă între indicatori. Acoperirea unică de bază acceptă intervale de până la 92 de zile, în timp ce pragurile cumulative de frecvență acceptă până la 31 de zile. Pentru frecvența medie per utilizator, resursa acceptată rămâne campania. Aceste diferențe împiedică tratarea tuturor coloanelor despre audiență ca indicatori identici la nivel de cont.

O valoare numerică are și informație despre starea măsurării. Google documentează situații în care datele sunt reținute pentru protecția vieții private, pentru cerințe de calitate sau pentru depășirea perioadei de păstrare. Există și starea în care valoarea este calculată, dar are calitate scăzută. Metadatele asociate disting aceste cazuri de o acoperire egală efectiv cu zero.

Indicatorul de acoperire de bază este acceptat pentru campanii Display, Video, Demand Gen și App. Pragurile de frecvență se aplică însă campaniilor Video. Datele de acoperire au o perioadă de păstrare de trei ani. Alegerea tipului de campanie, a perioadei și a metadatelor de stare definește astfel populația pe care o descrie raportul.

Două erori noi pentru aprobările sensibile

Google Ads folosește aprobarea unui al doilea administrator pentru acțiuni sensibile, inclusiv invitarea unui utilizator, schimbarea nivelului său de acces și eliminarea accesului. În API există operațiuni pentru aprobarea, respingerea sau revocarea cererilor. Administratorul autorizat care aprobă o solicitare trebuie să fie altă persoană decât inițiatorul ei, iar cererile neprocesate expiră după 20 de zile.

Prima eroare nouă identifică o combinație de resurse incompatibilă cu aprobarea multiplă într-o operațiune de modificare. A doua identifică o cerere de aprobare devenită neactuală, deoarece resursa vizată a fost modificată sau ștearsă după crearea solicitării. Răspunsurile descriu două cauze diferite: compoziția operațiunii și schimbarea obiectului pentru care fusese cerută aprobarea.