애셋

실적 최대화 캠페인을 만들기 전에 캠페인에 사용할 모든 확장 소재를 가져오는 것이 중요합니다. 나중에 언제든지 돌아와서 확장 소재를 추가할 수 있지만 시작하려면 확장 소재가 필요합니다.

캠페인을 계획할 때 실적 최대화 캠페인의 확장 소재 및 확장 소재 요구사항을 알아보세요.

텍스트 확장 소재와 이미지 확장 소재가 기본적으로 필요한 확장 소재 유형이므로 이 가이드에서는 각각의 확장 소재를 업로드하는 방법을 설명합니다. 이러한 원칙은 다른 확장 소재 유형에도 적용할 수 있습니다. 어떤 유형의 애셋을 만들든 AssetOperation를 사용하여 만듭니다.

애셋은 mutate를 사용하지 않고 AdsApp를 사용하여 만들 수 있지만 일관성을 위해 이 가이드에서는 나머지 모든 작업과 동일한 방식으로 만듭니다. 이미 사용 가능한 확장 소재가 있는 경우 이를 재사용할 수 있고 재사용해야 합니다. 따라서 실적 최대화 캠페인을 만들려면 확장 소재가 있어야 하지만 캠페인 생성 과정에서 확장 소재를 만들지 않아도 됩니다.

텍스트 애셋

텍스트 애셋은 다른 작업과 마찬가지로 작동합니다. 캠페인 생성 프로세스의 일부로 확장 소재를 업로드하는 경우 임시 ID를 사용하세요. 그렇지 않으면 나중에 애셋을 참조하여 애셋 그룹에 추가해야 할 때 사용할 반환된 리소스 이름을 기록해 둡니다.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

이미지 애셋

이미지 확장 소재는 base-64로 인코딩된 형식으로 업로드됩니다. 이미지를 Google Ads 스크립트에 직접 업로드할 수 없으므로 이미지 데이터를 가져와 업로드할 수 있도록 인코딩하는 두 가지 접근 방식 중에서 선택할 수 있습니다.

Google Drive에서 이미지를 가져오려면 먼저 이미지를 고유하게 식별하는 가장 좋은 방법인 ID가 필요합니다. ID를 가져오는 한 가지 방법은 Google Drive UI에서 공유 가능한 링크를 복사하고 ID를 추출하는 것입니다. 일련의 파일을 프로그래매틱 방식으로 가져와 업로드할 파일을 선택할 수도 있습니다. 이 코드는 알려진 ID가 있는 단일 이미지를 업로드하는 방법을 보여줍니다.

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

또는 UrlFetchApp를 사용하여 웹 서버에 호스팅된 이미지를 URL로 가져올 수 있습니다.

const file = UrlFetchApp.fetch(imageUrl);

그런 다음 Drive 파일에서와 마찬가지로 이 파일에서 getBlob를 호출할 수 있으므로 작업 구성은 Google Drive 파일의 단계와 동일합니다.