애셋

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

캠페인을 계획할 때 실적 최대화 캠페인의 애셋 및 애셋 요구사항을 읽어보세요.

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

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는 이미지를 고유하게 식별하는 가장 좋은 방법입니다. 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())
      }
    }
  }
}
operations.push(imageAsset);

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

const file = UrlFetchApp.fetch(imageUrl);

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