Ads Generator

Templates

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

Template Mini Docs

Campaign template

id: mx_default
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
  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
label: Mexico RSA templates
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

mx_default

Ad Templates

mx