일괄 업로드

Google Ads 스크립트를 사용하면 CSV 형식의 데이터를 업로드하여 계정을 일괄 변경할 수 있습니다. Google에서 CSV 파일의 데이터를 업로드할 수 있습니다. Drive, Google 스프레드시트, Microsoft Excel 스프레드시트를 사용하거나 일괄로 구성하세요. 런타임 시 스크립트에서 업로드 요청을 수행합니다. 이 가이드에서는 스크립트에서 이 기능을 사용하는 방법을 설명합니다.

사용

일괄 업로드를 사용하면 캠페인 관리나 오프라인 전환 업로드와 같이 Google Ads 스크립트에서 직접 지원하지 않는 특정 유형의 변경사항을 적용할 수 있습니다.

Google Drive에서 일괄 업로드 만들기

일괄 업로드 기능을 사용하는 가장 간단한 방법은 Google Drive로 이동하고 Google Ads 스크립트를 사용하여 이 파일을 Google Ads에 업로드합니다.

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

이렇게 하면 계정의 도구 및 설정 > 일괄 작업 > 업로드에 일괄 업로드 미리보기 항목이 생성됩니다.

미리보기 링크를 클릭하여 변경사항을 확인합니다.

계정에 변경사항을 적용하려면 변경사항 적용 버튼을 클릭하고 세부정보 페이지로 이동합니다. 업로드한 파일에 오류가 있거나 미리보기 삭제 버튼을 클릭하여 변경사항을 삭제합니다.

스크립트가 올바르게 작동하는지 확인하고 나면 미리보기를 건너뛸 수 있습니다. 스크립트에서 바로 변경사항을 스테이징하고 적용할 수 있습니다. 이렇게 하려면 preview() 메서드 대신 일괄 업로드 인스턴스의 apply() 메서드를 호출하면 됩니다.

일괄 업로드 처음부터 만들기

다음과 같이 처음부터 일괄 업로드 작업을 만들 수 있습니다.

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

통화 단위 설정

기본적으로 일괄 업로드 금액은 통화 금액입니다. 마이크로를 사용하려면 moneyInMicros 옵션을 true로 설정합니다. 예를 들어 €2.34는 2340000으로 입력).

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

파일 언어 설정

기본적으로 CSV 파일 콘텐츠는 미국 영어 언어(en_US)로 해석됩니다. 아래와 같이 fileLocale 옵션을 사용하여 다른 언어를 지정할 수 있습니다.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

언어를 지정할 때 en_US로 열 헤더를 제공할 수 있습니다. 또는 fileLocale 속성에서 지정한 언어로 번역합니다.

시간대 설정

기본적으로 파일의 시간 항목은 America/Los_Angeles로 해석됩니다. timeZone 옵션을 사용하여 다른 시간대를 지정할 수 있습니다. 시간 지정 TZ 데이터베이스의 영역 형식을 참고하세요.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

오프라인 전환을 업로드할 때는 시간대를 설정하는 것이 유용할 수 있습니다.

일괄 업로드용 스프레드시트 템플릿

일괄 업로드를 위한 스프레드시트 템플릿을 만드는 가장 쉬운 방법은 Google Ads UI

  • Google Ads 계정에 로그인합니다.
  • 도구 및 설정 > 일괄 작업 > 업로드를 클릭합니다.
  • + 버튼을 클릭하여 새 업로드를 시작합니다.
  • 그러면 선택할 수 있는 다양한 템플릿이 포함된 섹션이 표시됩니다.

고객센터에서 다양한 템플릿을 다운로드할 수도 있습니다.