Ads Generator

Templates

Campaign templates define structure. Ad templates define market RSA ads and fallback assets.

Template Mini Docs

Campaign template

id: mx_airlines
label: MX Default
campaign:
  name: "[campaign_name:top_exact]"
adgroup:
  single_name: "[adgroup_name:official_site]"

Campaign templates define campaign names, ad group structure, keyword sources, negatives, campaign defaults and account-level assets.

Market columns

[market_col:keyword]
[market_col:final_url]
[market_col:subdomain_url]
[market_col:buy_keywords_dataforseo]
[market_col:top_converters]
[market_col:destinations_keywords_dataforseo]

Use [market_col:...] when the column depends on preset market_code. Use [col:official_website] for global columns without a market suffix.

Ad groups

adgroups:
  - id: exact
    name: "[col:airline_name] [Exact]"
    always_create: true
    keywords:
      - source: "[market_col:keyword]"
        match_type: Exact
  - id: phrase
    create_if_any:
      - "[market_col:top_converters]"

always_create creates the ad group even when keyword columns are empty. create_if_any creates it only when at least one source has values.

single_keyword_adgroup.name is the template fallback for one-group mode. Preset field adgroup_settings.ad_group_name can override it.

Keywords

keywords:
  - source: "[market_col:keyword]"
    match_type: Exact
    status: Enabled
  - source: "[col:official_website]"
    match_type: Exact

Keyword sources can be scalar or list macros. Sheet values can be comma-separated or newline-separated.

Negatives

cross_negatives:
  enabled: true
  mode: other_adgroups
negatives:
  - source: "jobs, careers"
    match_type: Negative Phrase
    scope: campaign

Cross-negatives currently use only Exact source keywords. Select single_adgroup_no_negatives in preset/generator to disable negatives for one-group exports.

Ads section

ads:
  use_market_templates: mx_ads_airlines
  final_url: "[market_col:final_url]"
  path_mode: blank
  business_name: eDestinos
  account_level_sitelinks: true

use_market_templates points to an Ad Template ID below. path_mode: blank, columns, iata.

Ad template

id: mx_ads_airlines
label: MX Ads Airlines
max_ads: 3
templates:
  - label: ADS no1
    headlines:
      - "[col:airline_name]"
    descriptions:
      - "Reserva vuelos [col:airline_name] online."

Ad templates define RSA headline/description variants. The generator fits headlines to 30 characters and descriptions to 90 characters.

Fallbacks

fallbacks:
  headlines:
    - "Vuelos Baratos"
    - "Reserva Ahora"
  descriptions:
    - "Encuentra vuelos baratos y reserva online."

Fallback assets are used when generated headline/description text is too long or empty.

Path fallbacks

path_fallbacks:
  - path1: vuelos
    path2: baratos
  - path1: boletos
    path2: online

Used when Generator Path mode is fallback. Each pair maps first value to Path 1 and second value to Path 2. Selection is deterministic per campaign/ad group/ad label.

Copy Template

ba_airlines

ba_competitors

ba_destinations

ba_general

ba_routes

co_airlines

co_competitors

co_destinations

co_routes

gr_airlines

gr_competitors

gr_destinations

gr_general

gr_routes

hr_airlines

hr_competitors

hr_destinations

hr_general

hr_packages

hr_routes

mx_airlines

mx_competitors

mx_destinations

mx_general

mx_routes

pt_airlines

pt_competitors

pt_destinations

pt_general

pt_routes

rs_airlines

rs_competitors

rs_destinations

rs_general

rs_routes

se_airlines

se_competitors

se_destinations

se_general

se_routes

Ad Templates

Copy Ad Template

ba_ads_airlines

ba_ads_competitors

ba_ads_destinations

ba_ads_general

ba_ads_routes

br_ads_competitors

co_ads_airlines

co_ads_competitors

co_ads_destinations

co_ads_routes

gr_ads_airlines

gr_ads_competitors

gr_ads_destinations

gr_ads_general

gr_ads_routes

hr_ads_airlines

hr_ads_competitors

hr_ads_destinations

hr_ads_general

hr_ads_packages

hr_ads_routes

mx_ads_airlines

mx_ads_competitors

mx_ads_destinations

mx_ads_general

mx_ads_routes

pt_ads_airlines

pt_ads_competitors

pt_ads_destinations

pt_ads_general

pt_ads_routes

pt_br_ads_general

rs_ads_airlines

rs_ads_competitors

rs_ads_destinations

rs_ads_general

rs_ads_routes

se_ads_airlines

se_ads_competitors

se_ads_destinations

se_ads_general

se_ads_routes