Účel
Po prečítaní tohto článku by ste mali porozumieť:
- kategóriám chýb šablón,
- pravdepodobným príčinám chýb.
Môžu existovať aj iné príčiny chýb. Tento dokument uvádza najpravdepodobnejšie situácie.
- Ako vyriešiť chyby
Môžu existovať aj iné spôsoby riešenia chýb. Správne riešenie sa líši podľa spôsobu implementácie šablón.
Všeobecné informácie
Šablóny automaticky vytvárajú a spravujú kampane vo veľkom (oproti ich manuálnemu vytváraniu), preto funkcia Templates (Šablóny) nemôže skontrolovať každé pole.
Chyby šablón:
- Poskytujú informácie, kde budete zrejme musieť spresniť feed, vzorce alebo iné konfigurácie šablón, aby ste maximalizovali výstup a efektivitu šablón.
- Zobrazujú počet kampaní, reklamných skupín, zacielenia a kreatív, ktoré šablóna nemohla vygenerovať ani aktualizovať, pretože pri hodnotení šablóny sa vyskytli chyby.
- Pomáhajú iterovať konfigurácie šablón, aby boli efektívnejšie. Vzhľadom na flexibilitu šablón môže ich konfigurácia pre každý prípad použitia vyžadovať iteráciu.
Text je príliš krátky
Vo väčšine prípadov táto chyba znamená, že šablóna nevygenerovala žiadny text pre pole s touto chybou, pretože väčšina textových polí akceptuje iba jednu.
Potenciálne chyby
Typ šablóny | Chyba |
Kampaň | Field is too short: Campaign name (Pole je príliš krátke: názov kampane) |
Reklamná skupina | Field is too short: Ad group name (Pole je príliš krátke: názov reklamnej skupiny) |
Responzívna reklama vo vyhľadávaní | Field is too short: Unknown field (Pole je príliš krátke: neznáme pole) |
Keyword | Keyword text is invalid: Keyword text (Text kľúčového slova je neplatný: text kľúčového slova) |
Potenciálne príčiny
Vzorce šablón generujú textu polí pomocou údajov feedov. Medzi príklady patria názov kampane či reklamnej skupiny, nadpisy a opisy.
- Stĺpce feedov použité vo vzorcoch musia obsahovať údaje alebo byť vložené vo funkciách
if_error(value, error_value)
, inak nebudú vzorce úspešne overené.
Poznámka: Akvalue
vygeneruje chybu, vyhodnotí a vrátiť alternatívu definovanú vo funkciierror_value
. V opačnom prípade vráti príslušnú hodnotu. - Ak chýbajú údaje, vzorec bude nefunkčný, takže čiastočne presné hodnoty sa nevytvoria. Funkcia
if_error()
umožňuje šablónam ďalej vytvárať hodnoty, aj keď niektoré požadované stĺpce nemajú hodnoty.
Vzorový príklad
Názov feedu: Feed A
Údaje feedu
Doklad totožnosti | Značka | Kategória |
1 | Alfa | Obuv |
2 | Beta | |
3 | Karol | Oblečenie |
Nasledujúci vzorec sa automaticky snaží vytvoriť kampaň pre každú jedinečnú kombináciu hodnôt Brand (Značka) a Category (Kategória): "Campaign: " & f:"Brand" & " " & f:"Category"
.
Očakávaný výstup:
Prvá kampaň = „Kampaň: Alfa obuv“
Druhá kampaň = „Kampaň: Beta“
Tretia kampaň = “„Kampaň: Oblečenie od Karola“
Skutočný výstup:
Prvá kampaň = „Kampaň: Alfa obuv“
Druhá kampaň = „“
Tretia kampaň = “„Kampaň: Oblečenie od Karola“
Druhá kampaň je prázdna, preto zobrazí sa nasledujúca chyba: Field is too short: Campaign name (Pole je príliš krátke: názov kampane)
Príklad riešenia
V závislosti od poľa:
- Použite alternatívy s inými vzorcami alebo statickým textom.
- Pomocou funkcií
if()
v kombinácii s funkciamilength()
zistite, či sa vyskytnú problémy s dĺžkou, a poskytnite alternatívy. - Pomocou textových funkcií môžete zostrihať a spresniť údaje feedu, čím ich pripravíte na použitie v textových poliach.
- Upravte údaje feedu tak, aby zahŕňali iba údaje, ktoré spĺňajú požiadavky na textové polia reklamnej platformy.
Dátum spustenia musí byť po dnešnom dátume
Šablóny nemôžu po uplynutí staticky definovaného dátumu generovať kampane ani reklamné skupiny.
Potenciálne chyby
Typ šablóny | Chyba |
Reklamná skupina | The AdGroup Start Date should be after current date (Dátum spustenia reklamnej skupiny musí byť po dnešnom dátume) |
Kampaň | CAMPAIGN_ERROR_CANNOT_SET_DATE_TO_PAST: Start date (CAMPAIGN_ERROR_CANNOT_SET_DATE_TO_PAST: dátum spustenia) |
Potenciálne príčiny
Dátum spustenia šablóny bol definovaný ako konkrétny dátum, ktorý uplynul ešte predtým, ako sa šablóna pokúsila vytvoriť štruktúru, zacielenie alebo kreatívy dotyčnej kampane.
Vzorový príklad
Dátum spustenia šablóny: 31. 10. 2022
Modelová situácia: feed sa aktualizuje pomocou nových hodnôt 11. 11. 2022, čím sa spustí pokus šablóny vytvoriť nové kampane alebo reklamné skupiny.
Výstup: nové kampane a reklamné skupiny sa nedajú vytvoriť, pretože dátum spustenia šablóny (31. 10. 2022) je v minulosti.
Príklady riešení
Ak je potrebné riešenie, postupujte takto:
- Zmeňte dátum spustenia na taký, ktorý je v budúcnosti.
- Ak chcete nastaviť dátum spustenia ako dátum vytvorenia kampane alebo reklamnej skupiny, použite možnosť As soon as campaigns are created (Ihneď po vytvorení kampaní).
- Definujte statický počet dní po vytvorení kampaní alebo reklamných skupín ako dátum spustenia (napríklad „dnes +1“).
Text obsahuje neplatné znaky
Vygenerovaný text zahŕňal znaky, ktoré nie sú v prípade dotyčného poľa povolené. Chyby sa zvyčajne generujú, pretože sa používajú špeciálne znaky, medzi ktoré okrem iného patria: !, @, #, $, %, -, (, ) a /.
Potenciálne chyby
Typ šablóny | Chyba |
Keyword | Invalid characters in keyword text: Keyword text (Neplatné znaky v texte kľúčového slova: text kľúčového slova) |
responzívna reklama vo vyhľadávaní | STRING_ERROR_ILLEGAL_CHARS: Display Path 2 (STRING_ERROR_ILLEGAL_CHARS: druhá zobrazená cesta) |
responzívna reklama vo vyhľadávaní | STRING_ERROR_ILLEGAL_CHARS |
responzívna reklama vo vyhľadávaní | STRING_ERROR_ILLEGAL_CHARS: Display Path 1 (STRING_ERROR_ILLEGAL_CHARS: prvá zobrazená cesta) |
Potenciálne príčiny
Možné príčiny tejto chyby:
- údaje feedu obsahujú znaky, ktoré nie sú v prípade dotyčného poľa povolené,
- vzorec v šablóne obsahuje statický text so znakmi, ktoré nie sú v prípade dotyčného oľa povolené.
Vzorový príklad
Názov feedu: Feed B
Údaje feedu
Doklad totožnosti | Pole A |
1 | Alfa/beta |
2 | Karol |
3 | Delta |
Modelová situácia: nasledujúci vzorec sa používa, keď chcete vyplniť pole A, ktoré nepodporuje znak „/“: f:"Field A" & " / "
Očakávaný výstup:
„Alfa/beta / “
„Karol /“
„Delta /“
Skutočný výstup:
Nevygenerujú sa žiadne hodnoty, pretože všetky inštancie očakávaného výstupu by obsahovali znak „/“, ktorý nie je podporovaný. Jedna z hodnôt poľa A „Alfa/beta“ obsahuje znak „/“ a vzorec ho pridáva ako statický text.
Príklady riešení
Nižšie uvádzame všeobecné pokyny, ako odstrániť tieto chyby:
- Aktualizujte údaje feedu a skontrolujte, či neobsahujú špeciálne znaky.
- Použite alternatívy.
- Vo funkcii Templates (Šablóny) odstráňte špeciálne znaky pomocou funkcií, ako sú
clean_keyword()
aleboregex_extract()
. V tomto príklade funkcia odstráni špeciálne znaky z údajov stĺpca identifikátora výrobku feedu:[TRIM(CLEAN_KEYWORD(PRODUCT_ID, " "))]
. Ak je napríklad identifikátor výrobku vo feede „Bolt (10x)“, funkcia vráti „Bolt 10x“.
Porušenia pravidiel reklamnej platformy
Text vygenerovaný šablónou nespĺňa požiadavky pravidiel reklamnej platformy.
Potenciálne chyby
Typ šablóny | Chyba |
Keyword | POLICY_ERROR_POLICY_VIOLATION: Keyword text (POLICY_ERROR_POLICY_VIOLATION: text kľúčového slova) |
Potenciálne príčiny
Možné príčiny tejto chyby:
- Údaje feedu nespĺňajú požiadavky pravidiel reklamnej platformy.
- Kombinácia údajov feedov a statického textu vytvoreného vzorcom v šablóne generuje text, ktorý nespĺňa požiadavky pravidiel reklamnej platformy..
Vzorový príklad
Názov feedu: Feed B
Údaje feedu
Doklad totožnosti | Vlastné |
1 | Alfa |
2 | Beta |
3 | Karol |
Modelová situácia: hodnota „Alfa“ v stĺpci Custom (Vlastné) nespĺňa pravidlá pre kľúčové slová cieľovej reklamnej platformy.
Vzorec kľúčového slova: f:"Custom"
Očakávaný výstup:
Prvé kľúčové slovo = „Alfa“
Druhé kľúčové slovo = „Beta“
Tretie kľúčové slovo = „Karol“
Skutočný výstup:
Druhé kľúčové slovo = „Beta“
Tretie kľúčové slovo = „Karol“
Hodnotu „Alpha“ nie je možné vytvoriť, pretože v tomto príklade sa hodnota „Alpha“ nezhoduje s pravidlami pre kľúčové slová reklamnej platformy. Zobrazí sa chyba šablóny.
Príklad riešenia
Upravte údaje feedu tak, aby boli údaje textového poľa v súlade s požiadavkami pravidiel reklamnej platformy.
Advertising platform count limit exceeded (Bol prekročený limit počtu v reklamnej platforme)
Každá reklamná platforma stanovuje limity počtu kampaní na účet, počtu reklamných skupín na kampaň, počtu reklám na reklamnú skupinu a ďalších položiek. Chyby limitu reklamnej platformy sa vyskytujú vo funkcii Templates (Šablóny) v službe Search Ads 360, keď sa konfigurácia šablóny pokúsi vytvoriť viac štruktúr, cieľov a kreatív kampane, než povoľujú reklamné platformy.
Potenciálne chyby
Typ šablóny | Chyba |
responzívna reklama vo vyhľadávaní | Advertising platform count limit exceeded (Bol prekročený limit počtu v reklamnej platforme) |
Potenciálne príčiny
Možné príčiny tejto chyby:
- Výsledkom použitia násobiteľa alebo skupiny stĺpcov, pomocou ktorej šablóna vytvára štruktúru, zacielenie alebo kreatívy kampane, je viac kombinácií, než umožňuje limit reklamnej platformy.
- Počet šablón, ktoré vytvárajú reklamné skupiny, zacielenie alebo kreatívy pre konkrétnu kampaň či reklamnú skupinu, prekračuje limity reklamnej platformy.
Vzorové situácie
1. príklad
- Modelová situácia: šablóna reklamnej skupiny má priamo alebo implicitne definovaný tento násobiteľ na základe názvu reklamnej skupiny:
f:”Product_ID”
. Pre konkrétnu kampaň sa vytvorí viac identifikátorov výrobkov reklamy, než povoľuje reklamná platforma. - Výstup: šablóna reklamnej skupiny vytvorí maximálny povolený počet reklamných skupín pre každú kampaň. Zostávajúce identifikátory výrobkov sa budú v šablóne zobrazovať ako chyby limitu.
2. príklad
- Modelová situácia: šablóna reklamnej skupiny má priamo alebo implicitne definovaný tento násobiteľ na základe názvu reklamnej skupiny:
f:”Product_ID”
. Reklamná platforma obmedzuje počet reklám na reklamu na tri. Používateľ potom vytvorí pre šablónu reklamnej skupiny štyri alebo viac šablón responzívnych reklám vo vyhľadávaní, čo spôsobí, že počet responzívnych reklám vo vyhľadávaní na reklamnú skupinu prekročí limity reklamnej platformy. - Výstup: šablóna reklamnej skupiny vytvorí maximálny povolený počet reklamných skupín pre každú kampaň. Zostávajúce identifikátory výrobkov sa budú v šablóne zobrazovať ako chyby limitu.
Príklady riešení
1. príklad
- Zmeňte násobiteľ v šablóne reklamnej skupiny, aby sa vygenerovalo menej reklamných skupín, použitím ľubovoľného stĺpca feedu alebo kombinácie stĺpcov feedu, ktoré generujú menej jedinečných hodnôt na kampaň.
- Zmeňte násobiteľ v šablóne kampane, aby sa vygenerovalo menej kampaní, takže sa pre každú kampaň bude vyžadovať menej reklamných skupín.
2. príklad
- Znížte počet šablón, ktoré vytvárajú reklamy v rámci reklamnej skupiny.
- Aktualizujte násobiteľ šablóny reklamnej skupiny tak, aby generoval viac reklamných skupín a na jednu reklamnú skupinu bolo potrebných menej šablón reklám.
Prázdne pole prvej cesty responzívnych reklám vo vyhľadávaní
Text vygenerovaný šablónou pre pole prvej cesty bol prázdny, ale pole druhej cesty má hodnotu. Prvá aj druhá cesta musia mať hodnoty, inak sa vygenerujú chyby.
Potenciálne chyby
Typ šablóny | Chyba |
responzívna reklama vo vyhľadávaní | FIELD_ERROR_VALUE_MUST_BE_UNSET: Display Path 2 (FIELD_ERROR_VALUE_MUST_BE_UNSET: druhá zobrazená cesta) |
Potenciálne príčiny
Možné príčiny tejto chyby:
- Prvá cesta je prázdna, pretože text je príliš krátky.
- Prvá cesta nebola v šablóne nakonfigurovaná, ale druhá cesta bola nakonfigurovaná.
Vzorový príklad
Prvá cesta neexistuje, takže druhá cesta musí obsahovať chybu. Pozrite si sekciu Text je príliš krátky v tomto článku.
Príklad riešenia
Skontrolujte prvú cestu, či nemá chyby, a v šablóne reklamy aktualizujte prvú cestu.
Duplicitné podklady
Nadpisy a opisy každej reklamy vygenerovanej šablónou musia byť jedinečné. Ak sa vzorce šablóny pokúsia vygenerovať duplicitné nadpisy a opisy reklám, zobrazí sa chyba.
Potenciálne chyby
Typ šablóny | Chyba |
responzívna reklama vo vyhľadávaní | ASSET_ERROR_DUPLICATE_ASSET |
Potenciálne príčiny
Možné príčiny tejto chyby:
- Údaje feedu sú rovnaké vo viacerých stĺpcoch feedu, na ktoré odkazujú rôzne polia nadpisu alebo opisu.
- Výsledkom kombinácie údajov feedu a statického textu vytvorenej vzorocom budú duplicitné nadpisy alebo opisy.
- Rovnaká alternatíva sa používa pre viacero nadpisov alebo opisov. Na vygenerovanie reklamy sú potrebné aspoň dve tieto alternatívy.
Vzorový príklad
Názov feedu: Feed B
Údaje feedu
Doklad totožnosti | Značka | Kategória |
1 | Alfa | Zbierka padajúcich hviezd |
2 | Obuv | Obuv |
3 | Karol | Oblečenie |
Modelová situácia: šablóna reklamy má tieto dva vzorce, ktoré vedú k rovnakému výstupu:
Nadpis: f:"Brand"
Nadpis: f:"Category"
Pravdepodobný očakávaný výstup:
Prvá reklama = „Alfa. Zbierka padajúcich hviezd.“
Druhá reklama = „Obuv. Obuv.“
Tretia reklama = „Karol. Oblečenie.“
Skutočný výstup:
Prvá reklama = „Alfa. Zbierka padajúcich hviezd.“
Tretia reklama = „Karol. Oblečenie.“
Druhá reklama sa nedá vygenerovať, pretože dva nadpisy majú rovnakú hodnotu „Obuv“, čo reklamná platforma nepovoľuje.
Príklady riešení
Ak chcete túto chybu odstrániť, vykonajte jeden alebo viacero z nasledujúcich krokov:
- Pre každý nadpis alebo opis použite odlišné alternatívy.
- Upravte údaje feedu tak, aby ste sa vyhli duplicitným hodnotám v stĺpcoch nadpisu a opisu.
- Zabráňte duplicitným údajom pomocou logických funkcií, ako je
if()
.
Aktualizácia nespravovaných nastavení prostredníctvom hromadných úprav
Ak vaša šablóna generuje položku (napr. reklamnú skupinu) s nastaveniami v rozpore so súvisiacimi položkami (napríklad ak šablóna vygeneruje reklamnú skupinu, ktorej max. CZK je nižšia než minimálna hodnota potrebná pre súvisiace Nákupné kampane Microsoft) a toto nastavenie nie je spravované šablónou, môžete použiť hromadnú úpravu a aktualizovať príslušné nastavenie (napríklad zvýšiť max. CZK tak, aby spĺňala minimálnu požiadavku pre Nákupné kampane Microsoft).