Breadcrumbs

Google Ads - Alli Search Automation Sitelinks

This task automates the creation and editing of Sitelinks for both Google Ads and Bing Ads accounts.

In order to use this task: * Make sure you have a sitelink sheet set up and shared with the Alli Foundry Account

Use Cases: * Bulk upload sitelinks to google ads or bing

All documentation of how to setup, use, and maintain the sitelink sheet can be found in the SEM sitelink confluence documentation

Name

Reference

Type

Required

Default

Options

Description

Client

CLIENT

Alphanumeric

✅

-

-

Name of the client or the client slug

Core Reference Tab Name

CORE_REFERENCE_TAB_NAME

Alphanumeric

✅

Reference

-

Name of the 'reference' tab on the Google Sheet.

Sheet ID

SHEET_ID

Alphanumeric

✅

-

-

The ID of the control Google Sheet. Found in the URL of the link of the sheet.

Promos Per Campaign

PROMOS_PER_CAMPAIGN

Integer

✅

10

-

Each account, campaign, or ad group can have up to 20 sitelinks. This number tells Alli how many promo sitelinks to prioritize. The remaining slots will be filled with evergreen sitelinks.

Slack Channel

SLACK_CHANNEL

Alphanumeric

✅

sitelinks-troubleshooting

-

Slack channel name where error notifications and bulk sheets are sent. Recommended to be the client specific search automation alert channel.

People to Tag in Slack

PEOPLE_TO_TAG_IN_SLACK

Alphanumeric

➖

-

-

Enter emails of Slack users to tag (comma-separated).

Notify On Error Only

NOTIFY_ON_ERROR_ONLY

Boolean

✅

-

-

Turn on to suppress successful execution notifications

Generate Bulk Sheet

GENERATE_BULK_SHEET

Boolean

✅

True

-

Check this box to send a .csv file to Slack of all changes that were made for each run

Dry Run

DRY_RUN

Boolean

✅

-

-

Check this box to NOT have changes be sent to platform. Used for practice runs or test runs.

Platform

PLATFORM

Alphanumeric

✅

-

-

The platform this app will upload to (Google or Bing).

Manager Account ID

MANAGER_ACCOUNT_ID

Alphanumeric

➖

-

-

The MCC ID of your Google account, or the manager account ID of your Bing account.

OAuth Code

OAUTH_AUTHORIZATION_CODE

Alphanumeric

✅

-

-

Authorization tokens needed for Google Ads Access. In order to get credentials for OAuth Code, State, and Response, add credentials using the blue "Use Credentials" button at the top and then click on "add credential group". Then follow the instructions, and save credential group to be easily identifiable. The user adding the credential group must HAVE ACCESS to the google ads account.

OAuth State

OAUTH_STATE

Alphanumeric

✅

-

-

OAuth Response

OAUTH_ACCESS_TOKEN_RESPONSE

Alphanumeric

✅

-

-

Below is the YAML template

YAML

source:
  template: Google Ads - Alli Search Automation Sitelinks
  inputs:
    CLIENT:
    CORE_REFERENCE_TAB_NAME: Reference
    SHEET_ID:
    PROMOS_PER_CAMPAIGN: '10'
    SLACK_CHANNEL: sitelinks-troubleshooting
    PEOPLE_TO_TAG_IN_SLACK:
    NOTIFY_ON_ERROR_ONLY:
    GENERATE_BULK_SHEET: true
    DRY_RUN:
    PLATFORM:
    MANAGER_ACCOUNT_ID:
    OAUTH_AUTHORIZATION_CODE:
    OAUTH_STATE:
    OAUTH_ACCESS_TOKEN_RESPONSE:
  type: TEMPLATE
guardrails:
  retry_count: 1
  retry_wait: 0h0m0s
  runtime_cutoff: 1h40m0s
  exclude_exit_code_ranges:
    - 101