애셋

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

캠페인을 계획하는 동안 애셋 및 애셋 요구사항을 실적 최대화 캠페인에 대해 읽어보세요.

텍스트 애셋과 이미지 애셋은 기본적으로 필요한 애셋 유형이므로 이 가이드에서는 이러한 애셋을 각각 업로드하는 방법을 보여줍니다. 이러한 원칙은 다른 애셋 유형에도 적용할 수 있습니다. 만드는 애셋 유형과 관계없이 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())
      }
    }
  }
}
operations.push(imageAsset);

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

const file = UrlFetchApp.fetch(imageUrl);

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