This article has been updated in alignment with upcoming changes to Audience Solutions.
To adhere to the EU user consent policy and continue creating audience segments globally, publishers using batch upload must make updates to pass the required consent signals to Ad Manager by March 2024.
게시자 지원팀 또는 영업팀에 문의하여 잠재고객 솔루션을 활성화해야 합니다. 제공된 목록에 대한 활성화가 이루어져야 하므로 게시자가 잠재고객 세그먼트를 보게 될 때까지 지연이 발생하게 됩니다.
식별자 파일을 만들고 Google Cloud를 통해 Google Ad Manager에 업로드할 수 있습니다. 업로드할 수 있는 ID나 식별자로는 쿠키, 모바일 광고 ID(광고 ID 또는 IDFA), PPID 등이 있습니다. Google Cloud를 통해 ID를 업로드하면 한 번에 여러 ID를 추가해야 하는 경우 시간을 절약할 수 있습니다.
쿠키, PPID 및 기기 광고 ID는 Ad Manager 광고 요청에 포함되어 있어야 세그먼트에 추가될 수 있습니다. 데이터 전송 보고서(Google Ad Manager 360만 해당)의 암호화된 식별자 목록을 다운로드하거나 다른 시스템의 원시 식별자(예: 모바일 애플리케이션 로그의 원시 기기 광고 ID)를 가져올 수 있습니다.
일괄 업로드를 위한 PPID의 최대 수명은 마지막 사용자 활동 후 180일(또는 마지막으로 게재된 시간)입니다. 기기 ID의 경우 최댓값은 생성 후 540일(즉, 기기가 게재에 처음 표시된 후 540일)입니다.
이벤트-핑 기반 채우기 메서드(예: 이벤트 등록, 자동 입력) 및 쿠키-업로드 기반 채우기 메서드(즉, 제공된 CSV 목록)를 모두 사용하면 삭제된 PPID가 완전히 제외된 것으로 나타나지 않는 충돌이 발생할 수 있습니다.
이 도움말에서는 다음 주제에 대해 설명합니다.
사전 준비사항
식별자를 업로드하려면 먼저 계정 관리자와 함께 다음을 완료하세요.
- 네트워크 코드를 찾아서 제출합니다. Ad Manager의 관리, 전체 설정, 네트워크 코드에서 네트워크 코드를 찾습니다.
- 식별자를 연결하려는 활성 퍼스트 파티 잠재고객 세그먼트를 만들었는지 확인합니다. 이 세그먼트가 내 인벤토리를 사용하여 사용자를 수집하지 않도록 하려면 채우기 메서드로 '게시자 관리'를 선택하세요.
세그먼트 생성 시점부터 일괄 업로드를 수행할 수 있는 시점까지 최대 24시간까지 기다려야 합니다. - 파일을 업로드하고 조회할 수 있는 권한이 부여될 모든 Google 계정이 포함된 Google 그룹을 생성합니다.
계정 관리자가 설정을 완료하면 업로드하고 싶은 식별자 파일을 생성할 수 있습니다.
.fail 파일에 다음과 같은 메시지가 표시됩니다. '서버에서
<type of identifier>를 찾을 수 없습니다. 재시도가 도움이 되지 않습니다'업로드 파일 만들기
필수 동의 태그
모든 게시자는 필수 동의 신호를 Ad Manager에 전달하도록 업데이트해야 합니다.
동의가 수집되었는지 확인하려면 업로드된 파일의 헤더에 process_consent 태그를 추가합니다. 행에 이 헤더 열의 값이 포함되어야 CSV 표준을 준수하지만, 처리에는 영향을 미치지 않으므로 빈 문자열을 사용하는 것이 좋습니다. 이 구문이 없는 파일은 사용자의 적절한 동의를 얻지 못한 것으로 간주되며 Google에서 처리되지 않습니다.
이 업데이트는 필수입니다.
- 위치와 관계없이 모든 사용자에게 적용되는 기술 요구사항입니다.
- EU/EEA 사용자의 경우 EU 사용자 동의 정책을 준수하고 유럽 경제 지역(EEA) 사용자에 대한 잠재고객 세그먼트를 계속 생성합니다.
식별자 정보
일괄 업로드 프로세스에서는 다양한 유형의 식별자를 지원합니다. 식별자 유형이 올바른 업로드 파일 형식으로 세그먼트에 업로드되는 것이 중요합니다. 이러한 식별자는 다음과 같은 두 개의 카테고리로 분류됩니다.
- 암호화된 식별자: Google 시스템에서 가져온 모든 식별자
- 원시 식별자: 외부 시스템 또는 소스에서 가져온 식별자
암호화된 식별자는 모두 cookie_encrypted 파일 형식으로 업로드되지만 원시 식별자는 유형별 업로드 파일 형식으로 업로드됩니다.
암호화된 식별자와 PPID는 네트워크에 따라 다르므로 특정 네트워크에서 가져온 PPID 또는 암호화된 식별자의 일괄 업로드는 다른 네트워크에 업로드할 수 없습니다. 즉, 네트워크 A의 데이터 전송 보고서에서 가져온 사용자 식별자를 네트워크 B에 일괄 업로드할 수 없습니다. 반면 기기 식별자는 네트워크별로 다르지 않습니다.
다음 표에는 사용 가능한 식별자와 업로드 방식이 요약되어 있습니다.
| 식별자 | 설명 | 소스 | 업로드 형식 |
|---|---|---|---|
| 쿠키 | 쿠키 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | 사용 불가(쿠키를 업로드하려면 암호화해야 함) | ||
| PPID | 게시자 제공 식별자 | 데이터 전송PublisherProvidedID |
cookie_encrypted |
| 원시(외부 소스) | ppid |
||
| IDFA | 광고 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | cookie_idfa |
||
| 광고 ID | Android TV 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | cookie_adid |
||
| Roku ID | Roku 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | cookie_rida |
||
| tvOS ID | Apple TV 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | cookie_tvos |
||
| Vizio IFA | Vizio 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | cookie_vida |
||
| 삼성 TIFA | 삼성 식별자 | 데이터 전송UserId |
cookie_encrypted |
| 원시(외부 소스) | cookie_tifa |
텍스트 편집기를 사용해 일반 텍스트 파일을 만든 뒤 원하는 이름으로 파일을 저장합니다. 파일을 저장할 때 어떤 파일 확장자든 사용할 수 있으며 확장자를 사용하지 않을 수도 있습니다.
Google Cloud 파일 이름은 공개적으로 표시되므로 파일 이름에 기밀 정보를 포함하면 안 됩니다.
파일 콘텐츠 요구사항
- 파일의 콘텐츠는 쉼표로 구분되어야 합니다.
- 첫 번째 줄은 다음과 같이 표시되어야 합니다.
- 데이터 전송 보고서(Google Ad Manager 360만 해당)에서 가져온 암호화된 쿠키 및 암호화된 식별자:
cookie_encrypted,list_id,process_consent - 원시 Apple IDFA:
cookie_idfa,list_id,process_consent - 원시 Android AdID:
cookie_adid,list_id,process_consent - 원시 PPID:
ppid,list_id,process_consent - 원시 Roku ID:
cookie_rida,list_id,process_consent - 원시 tvOS ID:
cookie_tvos,list_id,process_consent
- 데이터 전송 보고서(Google Ad Manager 360만 해당)에서 가져온 암호화된 쿠키 및 암호화된 식별자:
- 이후 행에는 각각 식별자, 쉼표 그리고 식별자가 연결될 잠재고객 세그먼트의 ID가 포함되어야 합니다.
- 각 행은 UNIX 행 종료 유형 라인피드(
LF)로 끝나야 하며, 캐리지 리턴(CR)으로 끝나면 안 됩니다. 행 종료 유형은 업로드 파일 생성에 사용하는 방법에 따라 텍스트 편집기 또는 파일을 생성하는 프로그램에서 설정됩니다. - 암호화된 식별자는 데이터 전송 보고서(Google Ad Manager 360만 해당)를 통해 게시자에게 제공됩니다. 잠재고객 세그먼트 ID를 확인하려면 Google Ad Manager 계정에 로그인한 다음 인벤토리, 잠재고객 세그먼트를 선택하세요.
- 'process_consent' 열은 업로드 파일의 마지막 열이어야 합니다.
- 'process_consent' 열의 셀은 비워 둘 수 있습니다. 그러나 'process_consent' 값이 헤더로 설정된 열을 포함해야 합니다.
- 일괄 업로드 파일의 크기는 1GB 이하여야 합니다. 파일이 이 한도를 초과하면 제대로 처리되지 못할 수 있습니다.
암호화된 쿠키 ID 파일 콘텐츠의 예:
cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,
원시 광고 ID 파일 콘텐츠의 예:
cookie_encrypted,list_id,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,
w2gsrUcwxF-OiJTRmQswQA,3153490,
식별자 일괄 삭제
삭제 열을 추가하면 같은 업로드 파일을 사용하여 식별자를 일괄 삭제할 수 있습니다. 세그먼트에서 삭제하려는 각 식별자에 대해서는 삭제 열에 1을 입력하고, 세그먼트에 유지하려는 각 ID에 대해서는 삭제 열에 0을 입력합니다.
1 또는 0이 포함되어 있어야 합니다. 그렇지 않으면 업로드되지 않습니다.아래 예에서 첫 번째 쿠키는 세그먼트에 남아 있지만 두 번째 쿠키는 ID가 3153490인 세그먼트와의 연결이 해제됩니다.
cookie_encrypted,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,0,
w2gsrUcwxF-OiJTRmQswQA,3153490,1,
다음 예에서 첫 번째 IDFA는 세그먼트와의 연결이 해제되지만 두 번째 IDFA는 세그먼트에 남아 있습니다.
cookie_idfa,list_id,delete,process_consent
ScpJKu-yV8je93qkd32MOA,3153490,1,
w2gsrUcwxF-OiJTRmQswQA,3153490,0,
각 행에는 쉼표로 구분된 입력란이 헤더에 표시된 것과 같은 수만큼 포함되어 있어야 합니다. 식별자에는 CSV 형식과 일치하지 않는 쉼표나 기타 문자가 포함되지 않습니다.
식별자를 추가하거나 삭제할 때 Ad Manager가 식별자 업로드를 처리하는 데 몇 시간이 걸릴 수 있습니다. 일단 식별자를 추가하면 식별자 처리가 완료되어야만 다른 식별자를 업로드하여 추가한 식별자를 삭제할 수 있습니다.
파일 업로드
파일을 만들고 나면 Google Storage 버킷에 업로드해야 합니다(하위 폴더 허용됨). Ad Manager Cloud Storage 버킷에 액세스할 수 있는 세 가지 방법이 있습니다. 방법을 복잡한 순으로 나열하면 다음과 같습니다.
- 웹:
https://console.developers.google.com/storage/browser/gdfp_cookieupload_[Ad Manager 네트워크 코드]/로 이동합니다. - gsutil은 저장소 버킷과의 상호작용을 위해 Unix와 유사한 명령어를 제공하는 Python 기반 명령줄 도구입니다. 버킷 인증이 자동으로 추출되어 처리됩니다.
- Google Cloud Storage API는 저장소 버킷 조작을 위한 모든 기능을 갖춘 API로, JSON 또는 XML RESTful 웹 인터페이스를 통해 사용할 수 있습니다. API 클라이언트 라이브러리는 다양한 프로그래밍 환경(예: 자바, 자바스크립트, Python, Objective-C)에서 사용할 수 있습니다. 이러한 방식은 사용자가 Google App Engine 앱이나 자바 웹 앱과 프로그래밍 방식으로 통합하는 저장소 버킷을 조작해야 하는 경우 유용합니다.
24시간 이내에 Google Storage 계정에 파일과 이름이 같고 파일의 모든 식별자가 성공적으로 처리되었는지 여부를 나타내는 접미사가 포함된 로그 파일이 생성됩니다.
예를 들어 파일 이름이 1234_20130115_1인 경우 생성된 파일의 이름은 1234_20130115_1.success 또는 1234_20130115_1.fail입니다. 여기에는 성공적으로 처리된 식별자 수 및 처리되지 못한 식별자에 대한 자세한 오류 메시지가 표시됩니다. 자세한 상태 정보를 보려면 이 로그 파일을 다운로드하세요.
결과적인 파일 이름은 Google Storage 계정의 다음 폴더에 표시됩니다.
https://console.developers.google.com/storage/gdfp_cookieupload_result_[Ad Manager 네트워크 코드]/
업로드 후 파일에서 성공적으로 처리된 식별자는 인벤토리를 타겟팅할 때 관련 세그먼트의 회원으로 처리됩니다.
.fail 또는 .success 파일은 파일이 성공적으로 파싱되었는지 여부만 나타내며 목록 크기의 순 증가/감소와 관련된 중요한 정보는 제공하지 않습니다. 모든 단일 식별자가 성공적으로 업로드되면 파일의 이름은 .success가 됩니다. 그러나 대부분의 경우 실패가 하나 이상 발생하므로 출력 파일에는 접미사 .fail이 포함됩니다.
일괄 업로드된 식별자 만료
일괄 업로드 작업의 일부로 업로드된 식별자는 Ad Manager UI를 통해 잠재고객 세그먼트에 설정된 만료 설정을 준수합니다.
잠재고객 세그먼트에 설정된 만료 값이 X일이고 식별자가 업로드 후 X일 이내에 세그먼트 회원 자격 기준을 충족하지 못하면 식별자는 X일 후에 잠재고객 세그먼트에서 만료됩니다. 각 업로드 작업에서는 업로드된 식별자에 대한 세그먼트 회원 자격과 만료 카운트다운을 재설정합니다.
일괄 업로드에 관한 권장사항
파일 구조
업로드에 사용된 파일 수를 최소화하세요. 목록 ID가 파일의 각 행에 지정되므로 식별자를 여러 목록에 업로드하는 데 하나의 파일이 사용될 수 있습니다.
업로드 처리량
파일을 업로드할 때는 다음 한도를 준수해 주시기 바랍니다.
- 24시간당 500개 이하의 파일 업로드
- 일괄 업로드 파일의 크기는 최대 1GB
- 24시간당 총 일괄 업로드 파일의 크기는 최대 5GB
단계적 업로드와 완료 업로드
- 불필요한 처리를 방지하기 위해 식별자의 단계적(델타) 업로드를 일상적으로 사용하는 것이 좋습니다. 전체 세그먼트 식별자 목록을 업로드하기 보다는 마지막 업데이트 이후 세그먼트의 회원 자격이 변경된 식별자만 추가하거나 삭제해야 합니다.
- 간헐적으로(일주일에 1회 이하, 위의 업로드 처리량 한도 준수) 모든 세그먼트 식별자 데이터의 전체 업로드를 실행할 수 있습니다. 이 전체 업로드는 이전에 잠재고객 세그먼트에서 오래되어 사라진 모든 회원의 세그먼트 회원 자격을 새로고침합니다.
- 식별자의 '최신성'을 일부 다른 시스템을 통해 추적하고 있어야 합니다. 또한 이러한 식별자가 사용되지 않는 경우 식별자를 새로고침 업로드에서 제외할 수 있는 방법이 있어야 합니다.
처리 시간
일괄 업로드 시간부터 모든 일괄 변경사항이 게재에 반영되는 시간까지 최대 24시간을 기다려야 할 수 있습니다. 즉, 세그먼트가 게재되어야 하는 시간보다 적어도 24시간 전에 파일을 업로드해야 합니다.
또한 일괄 업로드 시점부터 최대 48시간이 지나야 Ad Manager 사용자 인터페이스에 변경사항이 표시됩니다.
