애셋

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

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

텍스트 애셋과 이미지 애셋은 기본 필수 애셋 유형이므로 이 가이드에서는 각 애셋을 업로드하는 방법을 보여줍니다. 이러한 원칙은 다른 확장 소재 유형에도 적용할 수 있습니다. 어떤 유형의 애셋을 만들든 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())
      }
    }
  }
}

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

const file = UrlFetchApp.fetch(imageUrl);

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