<!-- Copyright 2023 Google LLC Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->

<img align="left" width="150" src="assets/images/logo.png" alt="adios logo" /><br />

Adios: One-stop solution for Google Ads image assets management

https://github.com/google-marketing-solutions/adios/assets/3335483/71be79f8-8393-444f-961a-ced8316df6d2

Overview

Adios is the open-source solution that streamlines your image asset management. Effortlessly upload your existing images in bulk and link them directly to relevant ad groups. Don't have images? No problem! Adios harnesses the power of AI to generate personalized, high-quality images tailored to your specific ad group context, boosting your campaign's visual appeal and performance.

To generate images Adios uses the recent Imagen model on Google Cloud's Vertex AI platform.

Case Study

You can find Adios case study in German (or you can try Google Translate version, just select your preferred language in the top menu).

The Challenge

Google Ads customers with extensive ad group structures often face challenges in managing image assets effectively. Maintaining high-quality, relevant images for thousands, or even millions, of niche ad groups can be a daunting task. The current Google Ads UI lacks the tools to streamline bulk image uploads and management, making the process time-consuming and inefficient. This can hinder marketers' efforts to personalize image extensions and optimize their campaigns at scale.

The Approach

In close collaboration with several advertisers, our team developed a custom solution to address these challenges: Adios.

The Solution

Here are some of Adios's powerful features:

• Generate at scale: Leverage the power of Generative AI on Google Cloud to create thousands or even millions of images tailored to your ad groups. With minimal code adjustments, you can integrate almost any Generative AI API for unparalleled flexibility.
• Automate asset management: Effortlessly upload and manage your image assets in Google Ads, whether you've generated them with Adios or already have them on hand.
• Optional manual validation: Ensure optimal quality by manually reviewing generated images before they go live in your campaigns.
• Seamless A/B testing: Easily create Google Ads experiments to compare the performance of your new image assets against your existing setup, optimizing click-through rates and campaign success.

Releases & features

Adios v1.3

Features:

• Increased configuration flexibility in the 'Config' sheet. Now you can easily change AI models, GCP region, and other settings without editing the code.
• Improved the stability and reliability of Gen API interactions. The tool now automatically retries failed requests, ensuring a smoother and more robust user experience.
• Improved documentation in the Config sheet and on GitHub (README) to provide clearer guidance and support.

Adios v1.2

Features:

• Enhanced Triggers: Optimized how long-running services operate, addressing execution time limits for large-scale ad group processing. (See Google Apps Script quotas for details).
• Google Ads API Mocks: Experiment with Adios features and functionality without needing a Google Ads account.
• Text-to-Image prompt generation has been switched to Gemini 1.5 Flash.
• The Google Ads API has been upgraded to version 17.

Adios v1.1

https://github.com/google-marketing-solutions/adios/assets/3335483/9be71a1a-43da-49ba-b203-598e797f1d64

Features:

• Automatic, AI (Gemini) based image policy validation. Now you can write your brand, company, you name it ads policies as a text and the generated image will be validated against those policies.
• Ad Group names translations. Now you can translate your ad group names (or parts of them) e.g. into better text-to-image prompts.
• Keyword based image generation. Previously you could generate images only based on the ad group names.

Adios v1.0

Features:

• Generate image assets (ad group level) based on the ad group names
• Image validation UI (validate manually generated images before uploading to Google Ads).
• Upload generated assets to the Google Ads assets library.
• Link uploaded assets to the respective ad groups.
• One click creation of the Google Ads experiments to test performance of the uploaded assets.

Note: these features can be used separately, e.g. you can just upload images to the assets library (if you don't want to generate images, but only to sync your existing assets with your Google Ads account).

Installation Guide

https://github.com/google-marketing-solutions/adios/assets/3335483/f22172d3-38f1-4fdb-b366-67a33700180e

1. Make a copy of the template Spreadsheet: Adios v1.3 (in the main menu File > Make a copy). Earlier versions:

   • Adios v1.2
   • Adios v1.1
   • Adios 1.0

2. Create or use an existing Google Cloud Platform (GCP) project

   • Ensure that billing is enabled on the project
   • Enable the Google Ads API
   • Enable the Cloud Storage API
   • Configure OAuth consent (if you haven't done before for this project)
   • If you would like to generate images, make sure that you have access to the Vertex AI API

3. On the copied Spreadsheet, open Extensions > Apps Script

4. Go to Project Settings and change the GCP project. Learn how to determine the project number

5. Fill in the required configuration in the Spreadsheet, as instructed in the comments

6. Now you can run or schedule the Adios services using the Adios menu

Configuration

Adios' configuration parameters are primarily located in the default "Config" sheet of the template spreadsheet. It is essential to complete the configuration before using Adios.

Mandatory fields:

• GCP Project Specific Parameters
  • GCP Project
  • GCS Bucket
• Google Ads Specific Parameters (in case you use Mocks, this is not required)
  • Google Ads API Key (aka "developer token")
  • Account ID, Manager Account ID, Campaign IDs

Other Parameters:

• Preset Parameters: Several parameters in the "Config" sheet come with preset values. You can modify these if needed based on your specific requirements.
• Optional Parameters: Adios offers additional optional parameters to fine-tune its behavior.

Assets generation

Notes:

• this step is not required if you already have the assets.
• starting from Adios v1.1 you can generate assets based on ad group keywords (check this video).

https://github.com/google-marketing-solutions/adios/assets/3335483/72db55da-7ed1-47bb-8daf-b61d50fb1ea7

Google Ads API Mocks

Want to try out image generation without real ad groups? Simulate them easily with a spreadsheet:

• Configure Adios: In the "Config" sheet, add a variable named "Google Ads Mock Sheet". Choose a name for your mock sheet (e.g., "Mock") and set it as the value for this variable.
• Create Your Mock Data: Create a new sheet with the name you chose (e.g., "Mock"). Make sure it has two columns:
  • "Ad Group Name": Enter a name for each simulated ad group.
  • "Keywo