이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Vertex AI에서 이미지를 생성하여 Google Ads에 업로드하는 방법

1. 소개

빌드할 항목

이 Codelab에서는 Vertex AI를 사용하여 이미지를 생성하고 Google Ads로 전송하여 캠페인에서 확장 소재로 사용할 수 있도록 하는 방법을 알아봅니다.

학습할 내용

GCP, Vertex AI에서 이미지를 생성하는 방법
Google Ads에 이미지를 업로드하는 방법
Google Ads에서 사용하는 방법

필요한 항목

Google Ads 계정
GCP 계정

2. Google Ads 사용자 인증 정보 가져오기

이 부분은 Google Ads에서 이미지 확장 소재를 가져오는 데 필요합니다. Colab에서 Google Ads에 액세스하려면 적절한 사용자 인증 정보가 필요합니다.

사용자 인증 정보 만들기 -> 'OAuth 클라이언트 ID' 만들기 -> 웹 애플리케이션

Google Ads에 연결하기 위해 적절한 사용자 인증 정보를 받으려면 Cloud 사용자 인증 정보에 액세스해야 합니다.

동의 화면을 구성하지 않은 경우 먼저 동의 화면을 설정하세요.

사용자 유형: 외부
게시 상태: 프로덕션 단계

'승인된 리디렉션 URI'에 다음 URI를 추가합니다.

아래 스크린샷과 같이 URI 아래에 배치합니다.

https://developers.google.com/oauthplayground

클라이언트 ID 및 클라이언트 비밀번호 복사

클라이언트 ID와 클라이언트 보안 비밀번호를 가져올 수 있습니다.

3. 갱신 토큰 생성

OAuth 플레이그라운드에 액세스

OAuth Playground에서 임시 갱신 토큰을 쉽게 발급할 수 있습니다.

설정으로 이동하여 '자체 OAuth 사용자 인증 정보 사용'을 확인합니다. 이전 장에서 확인한 OAuth 클라이언트 ID와 클라이언트 비밀번호를 가져온 후 해당 텍스트 상자에 입력할 수 있습니다.

범위 추가

아래 영역에 https://www.googleapis.com/auth/adwords 범위를 추가할 수 있습니다.

API 승인을 클릭하면 다음 화면이 표시됩니다.

갱신 토큰 생성

'Exchange Authorization code for 토큰'을 클릭하면 갱신 토큰이 표시됩니다.

4. 코드 실행을 위해 Colab 준비

Colab은 Python과 함께 제공되는 편리한 코드 노트북입니다. 기본 옵션은 상당한 컴퓨팅 성능을 제공합니다. 원하는 플랫폼을 사용하여 Google Cloud Vertex AI의 REST API를 호출할 수도 있습니다.

사용하려면 https://colab.research.google.com/으로 이동하세요.

[파일 → 새 메모] 로 이동하여 새 코드를 작성합니다.

새 노트북을 클릭하면 새 시트가 준비된 것을 볼 수 있습니다.

5. Google Cloud Vertex AI를 통해 이미지 생성

라이브러리 가져오기

!pip install requests google-ads

먼저 Google Ads 및 API 요청을 위한 라이브러리를 설치합니다. 라이브러리를 설치한 후 런타임을 다시 시작해야 합니다.

필수 라이브러리를 로드할 수도 있습니다.

import requests
import json
import base64

from google.ads import googleads
from google.colab import auth
from IPython.display import display, Image

인증 가져오기

Google 계정을 승인하라는 메시지가 표시됩니다.

auth.authenticate_user()

access_token = !gcloud auth print-access-token
access_token = access_token[0]

본인을 승인하면 Google Cloud API를 호출할 수 있습니다.

6. Vertex AI에서 이미지 생성

프롬프트 및 POST 요청 준비

먼저 Google Cloud 프로젝트 ID가 있어야 합니다. Google Cloud에서 가져올 수 있습니다. 텍스트 프롬프트가 필요하며 필요한 이미지 수를 설정할 수도 있습니다. 더 많은 옵션은 공식 문서를 참고하세요.

PROJECT_ID = 'abcdefg' # Your GCP project ID

TEXT_PROMPT = 'cat computer' # Your prompt goes here.
IMAGE_COUNT = 4 # You will get 4 images as a result.

텍스트 프롬프트 내에 원하는 내용을 작성할 수 있습니다. 여기서는 고양이와 컴퓨터가 함께 있는 이미지를 하나의 사진에 생성하려고 합니다.

url = f"https://us-central1-aiplatform.googleapis.com/v1/projects/{PROJECT_ID}/locations/us-central1/publishers/google/models/imagegeneration:predict"

headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json; charset=utf-8"
}

data = {
    "instances": [
        {
            "prompt": TEXT_PROMPT
        }
    ],
    "parameters": {
        "sampleCount": IMAGE_COUNT
    }
}

이미지 생성 요청

JSON 준비가 완료되면 이제 이미지 생성을 요청할 수 있습니다. 다음은 일반적인 http 요청입니다.

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    response_data = response.json()

    for prediction in response_data.get('predictions', []):
        image_data = base64.b64decode(prediction['bytesBase64Encoded'])
        display(Image(data=image_data))
else:
    print("Request failed:", response.status_code, response.text)

몇 초 동안 기다리면 결과를 얻을 수 있습니다. 아주 간단합니다.

7. Google Ads에 연결하기

Google Ads 계정에 연결하기

Google Ads 개발자 토큰이 필요합니다. 기본 또는 표준 개발자 토큰을 신청할 수 있지만 테스트 목적으로는 테스트 토큰도 제공됩니다. MCC 계정으로 이동합니다. 도구 및 설정 탭에 API 센터가 표시됩니다. API 섹션에서 토큰을 찾을 수 있습니다.

이전 장에 클라이언트 ID, 클라이언트 비밀번호 및 갱신 토큰이 준비되어 있어야 합니다.

credentials = {
    "developer_token": "ABCDEFG",
    "client_id": "123456789012-abcd1234.apps.googleusercontent.com",
    "client_secret": "GOCSPX-abcd1234-abcd1234-abcd1234",
    "refresh_token": "1//abcdefghijklmnopqrstuvwxyz",
    "use_proto_plus": True
}

사용자 인증 정보를 설정한 후 GoogleAdsService API를 로드할 수 있습니다. 고객 ID는 보통 xxx-xxxx-xxx 형식이지만 '-'를 삭제해야 합니다.

client = googleads.client.GoogleAdsClient.load_from_dict(credentials, version='v13')
googleads_service = client.get_service("GoogleAdsService")
customer_id = "1234567890"

Google Ads 계정 쿼리하기

이제 googleads_service를 사용하여 테스트할 수 있습니다. Google Ads 계정에 어떤 종류의 애셋이 있는지 쿼리해 보겠습니다.

query = (
'''
SELECT
    ad_group_ad.ad.id,
    ad_group_ad.ad.app_ad.headlines,
    ad_group_ad.ad.app_ad.descriptions,
    ad_group_ad.ad.app_ad.images
FROM ad_group_ad
''')
response = googleads_service.search(customer_id=customer_id, query=query)
for googleads_row in response:
    print(googleads_row)

Google Ads 계정에 JSON 형식으로 애셋 목록이 표시됩니다. 만약

ad_group_ad {

`images { asset: "customers/1234567890/assets/09876543210" }`

}

8. Google Ads에 이미지 확장 소재 업로드

업로드

마지막 단계에서는 생성된 애셋을 Google Ads에 업로드합니다.

for prediction in response_data.get('predictions', []):
    image_base64 = prediction['bytesBase64Encoded']

    image_bytes = base64.b64decode(image_base64)

    asset_service = client.get_service('AssetService')
    asset_operation = client.get_type('AssetOperation')

    asset = asset_operation.create
    asset.type_ = client.enums.AssetTypeEnum.IMAGE
    asset.image_asset.data = image_bytes
    asset.name = "cats"

    asset_service.mutate_assets(customer_id=customer_id, operations=[asset_operation])

몇 초 후 Google Ads 프런트엔드를 통해 업로드된 애셋을 확인할 수 있습니다. 다음은 샘플 스크린샷입니다.

9. 축하합니다

축하합니다. 기존 이미지로 멋진 이미지 확장 소재를 생성했습니다.

학습한 내용

생성형 AI (Vertex AI)를 통해 이미지 확장 소재를 생성하는 방법
Google Ads에 이미지를 업로드하고 이미지 확장 소재로 사용하는 방법