비용 가져오기 가이드

광고 지출 CSV 파일 형식, 스키마 및 유효성 검사 규칙이 여기에 자세히 설명되어 있습니다. Excel 또는 Google 시트를 사용하여 파일을 만드는 경우 Excel 서식 지정 지침이 표시되어야 합니다.  

샘플 파일을 참조하십시오.

다음을 읽기 전에 다음 스크린샷과 같이 CSV 파일을 준비할 때 발생하는 가장 일반적인 오류를 기록해 둡니다.  

광고 지출 CSV 파일 형식, 스키마 및 유효성 검사 규칙은 다음 섹션에 자세히 설명되어 있습니다. Excel 또는 Google 시트를 사용하여 파일을 만드는 경우 Excel 서식 지정 지침이 표시되어야 합니다. 

광고 지출 CSV 파일의 콘텐츠 규칙 및 스키마

광고 비용 CSV 스키마

광고 지출 토큰은 이메일 발신자가 비용 가져오기 파일을 제출할 권한이 있는지 확인하는 데 사용됩니다. 광고주와 애드 네트워크 토큰은 다릅니다. 

• 광고주 토큰:
  • 동일한 토큰이 계정의 모든 앱에 유효합니다.
  • 모든 계정 사용자가 광고 지출 토큰을 검색할 수 있습니다.
• 애드 네트워크 토큰:
  • 모든 광고주에게 동일한 토큰이 사용됩니다. 
  • 또한 광고주는 애드 네트워크에 가져오기 파일을 제출할 수 있는 권한을 부여해야 합니다. 

광고 비용 토큰을 검색하려면:

1. 앱스플라이어의 사이드 메뉴에서 설정 > 비용 가져오기를 선택합니다.
2. 페이지 오른쪽 상단에서 광고 지출 토큰 보기를 클릭합니다.
   광고 지출 토큰이 표시됩니다.  
3. 광고 비용 토큰을 복사하여 저장합니다.

광고 네트워크 비용 가져오기 권한을 부여합니다:

1. 앱스플라이어에서 광고주는 사이드 메뉴로 이동하여 연동> 활성 통합을 선택합니다. 
   통합 파트너 페이지가 표시됩니다.
2. 연동 파트너를 선택합니다.
3. 권한 탭으로 이동합니다. 
   
4. 아직 이렇게 하지 않은 경우 애드 네트워크 권한을 사용 가능으로 설정하십시오.
5. (선택사항) 계정 사용자를 추가하십시오.
6. 지출 가져오기 허용을 활성화합니다.
   

이메일 선행조건:

• 광고주:
  • 광고 지출 토큰이 필요합니다.
  • 발신자 이메일은 등록된 앱스플라이어 사용자의 이메일이어야 합니다.
• 애드 네트워크:
  
  • 광고 지출 토큰이 필요합니다.
  • 발신자 이메일은 등록된 앱스플라이어 사용자의 이메일이어야 합니다.
  • 광고주는 파트너 (애드 네트워크)에 비용 가져오기 권한을 부여해야 합니다. 

광고 지출 파일을 이메일로 보내려면:

1. 이메일 주소 필드를 작성합니다.  
   • 받는 사람:adspend-upload@appsflyer.com
   • CC: 자동 피드백을 받아야 하는 사용자
   • 제목: 제목 필드에 광고 지출 토큰을 붙여넣습니다. 
   • 첨부: CSV 파일에 데이터를 저장합니다.
2. 이메일을 보냅니다.
   • 처리가 완료되면 업로드가 요약되고, 처리 중에 발견된 문제나 오류가 자세히 설명된 상태 이메일이 전송됩니다. 이메일은 제출 이메일과 광고주 관리에 대한 모든 당사자에게 발송됩니다. 오류가 식별되는 경우 수정 조치를 취해야 합니다. 참고: 상태 메일이 수신되지 않은 경우 여기를 참조하세요.
   • 비용 가져오기 페이지에서 제출된 파일의 상태를 확인할 수 있습니다.

광고 비용 파일을 업로드하는 방법:

1. 앱스플라이어의 사이드 메뉴에서 설정 > 비용 가져오기를 선택합니다.
   비용 가져오기 페이지가 표시됩니다. 
2. + 광고 지출 파일 가져오기를 클릭합니다.
   광고 지출 가져오기 창이 열립니다.
   
3. CSV 파일을 광고 지출 파일 가져오기 창으로 드래그합니다.
   파일 처리 중 메시지가 표시됩니다.
4. 업로드 중에 오류 메시지가 표시되는 경우: 오류를 수정하고 관련 단계를 반복합니다.  
5. 비용 가져오기: 파일 요약 창이 열립니다.

   

6. 다음 중 하나를 수행합니다.
   • 업로드를 중단하고 가져오기 취소를 클릭합니다.  
   • 가져오기 프로세스를 완료하고 파일 가져오기를 클릭합니다.
     "모든 설정 완료!"가 메시지가 표시됩니다.
7. 다른 파일 가져오기 또는 완료를 클릭합니다.

파일 수준에서 가져오기 상태 보는 방법:

• 앱스플라이어의 사이드 메뉴에서 설정 > 비용 가져오기를 선택합니다.
  비용 가져오기 페이지에 업로드된 파일 목록이 표시됩니다.
• 파일에 포함된 모든 앱에 대한 권한이 있는 경우 액션 명령을 사용하여 다음을 수행하세요.
  
  • CSV 파일 다운로드: 업로드한 CSV 파일의 사본입니다.
  • 파일의 모든 앱에 대해 일치하지 않는 리포트를 다운로드합니다.

앱 수준에서 가져오기 상태 보는 방법:

• 파일을 선택합니다.
  앱 수준 페이지가 표시됩니다. 광고 지출 파일에 있는 앱 목록이 표시됩니다.

  

• 여기에 설명된 대로 파일 수준 또는 앱 수준 작업을 수행합니다.
• 파일 수준: 파일에 포함된 모든 앱에 대한 앱 권한이 있는 경우 페이지 오른쪽 상단에 있는 컨트롤을 사용하여 다음과 같이 할 수 있습니다. 
  • 파일에 있는 모든 앱의 비용 가져오기를 되돌리기 (취소)합니다. 
  • 제출된 CSV 파일의 사본을 다운로드합니다.  
• 앱 수준: 특정 앱에 대한 앱 권한이 있는 경우 액션 명령을 사용하여 이를 수행할 수 있습니다.
  • 앱 데이터를 다운로드합니다.
  • 앱에 대해 일치하지 않는 리포트를 다운로드합니다.
  • 선택한 앱의 비용 가져오기를 되돌리기 (취소)합니다. 

행 매칭은 가져오기 메커니즘이 가져오기를 통해 보고된 광고 지출 행을 대시보드에 기록된 어트리뷰션 데이터와 일치시키는 프로세스입니다. 이 작업은 파일의 스키마에서 사용 가능한 모든 차원(예: 미디어소스, 캠페인, 광고 세트, 광고 등)을 사용하여 수행됩니다. 모두 일치하는 경우, 행은 is-matching=TRUE로 지정됩니다.  

이름 대 ID

비용 가져오기는 캠페인, 광고 세트 또는 광고와 같은 차원을 ID 없이 이름으로 식별합니다. 현재 비용 가져오기는 ID만 사용한 지출 보고를 지원하지 않습니다.

주의: 일치 상태와 관계없이 지출이 기록됩니다.

일치하는 행의 백분율이 가져오기 페이지에 표시됩니다.

일치하지 않는 행이 예기치 않은 경우 일치하지 않는 리포트를 다운로드하여 원인을 조사합니다. 필요한 경우 가져오기를 되돌려 취소합니다.

일치하지 않는 리포트에는 값이 TRUE(일치됨) 또는 FALSE(일치하지 않음) 행 값이 있을 수 있는 열 is-matched가 있습니다.

일치하는 행의 백분율을 표시하는 비용 가져오기 페이지

이전에 가져온 광고 지출은 이전에 가져온 데이터와 동일한 키의 데이터가 포함된 CSV 파일을 사용하여 덮어쓸 수 있습니다.

키는 날짜, 미디어 소스 및 캠페인 필드로 구성됩니다. 키가 일치하면 마지막으로 가져온 데이터가 이전에 가져온 데이터를 덮어씁니다.

다음 예시는 광고 비용 덮어쓰기를 보여줍니다.

다음 표에는 가능한 모든 비용 가져오기 오류 메시지와 해당 해결 방법이 나와 있습니다. 

증상 1: 가져오기에 성공한 후 비용 데이터가 표시되지 않음

1. 대시보드에서 캠페인 이름이 두 번 이상 표시되는지 확인합니다.
2. 그런 경우, 캠페인 ID가 비어 있는 행을 찾으십시오.
   캠페인 ID가 비어 있는 행에는 비용이 포함되어 있습니다. 

증상 2: 가져온 비용은 성능(설치) 데이터 없이 별도의 행(추가 행)에 표시됩니다. 행의 캠페인 ID가 비어 있습니다.

원인: 어트리뷰션 데이터에 캠페인 ID와 캠페인 이름이 모두 존재하는 경우, 앱스플라이어가 비용 데이터와 정확하게 일치하고 별도의 항목을 피하려면 CSV에 두 가지가 모두 포함되어야 합니다.

Excel/Google 시트를 사용하여 CSV 파일을 만드는 경우 파일을 CSV 파일로 저장하기 전에 날짜 및 지출 열의 형식을 올바르게 지정해야 합니다. 다음 절차에 따라 날짜 및 지출 필드의 서식을 올바르게 지정합니다. 

CSV 파일을 저장한 후 콘텐츠의 형식이 올바른지 확인합니다. 주의: 확인을 위해 Excel을 사용하지 말고 편집기를 사용하세요. 

Excel에서 날짜 셀 서식 지정

Excel에서 날짜 셀의 서식을 YYYY-MM-DD 형식으로 지정하려면:

1. 서식을 지정할 셀을 선택합니다.
2. 마우스 오른쪽 버튼을 클릭하고 셀 포맷을 선택합니다.
   셀 형식 창이 열립니다.
   

   

3. 사용자 지정을 선택합니다.
4. 유형 필드에 YYYY-MM-DD를 입력합니다
5. 확인을 클릭하세요.
   날짜가 포맷됩니다.

Excel에서 지출 셀 서식 지정

그림에 표시된 대로 Excel은 일반적으로 값 셀을 쉼표로 형식화하여 수천 개로 구분합니다. 이 형식은 광고 지출 가져오기 파일에는 적합하지 않습니다. 

Excel에서 셀 서식을 지정하여 이 문제를 해결할 수 있습니다.  

1000 단위 구분 기호 없이 지출 금액의 형식을 지정하려면:  

1. 서식을 지정할 셀을 선택합니다.
2. 마우스 오른쪽 버튼을 클릭하고 셀 포맷을 선택합니다.
   셀 형식 창이 열립니다.
3. 숫자를 선택합니다.
   

   

1. 1000 단위 구분 기호(,) 사용을 선택 취소합니다.
2. (선택 사항) 소수점 이하 자릿수를 설정합니다. 기본값은 2입니다. 허용되는 최대 개수는 5개입니다. 
3. 확인을 클릭하십시오.
   셀이 올바르게 포맷되었습니다.

CSV 파일의 내용을 검사하려면 편집기를 사용하여 파일을 봅니다.  

• Windows: 메모장, 메모장++
• macOS: TextEdit

다음은 편집기에 표시되는 예제 CSV 파일의 스크린샷입니다.  

편집기 보기

편집기를 사용하여 CSV 파일을 검사합니다. 다음 사항에 특히 주의하십시오.

• 공백: 필드를 구분하는 쉼표의 앞뒤에 공백이 없는지 확인합니다. Excel에서 @trim 명령을 사용하여 공백을 제거합니다.  
• 날짜: 날짜 필드의 형식이 YYYY-MM-DD인지 확인합니다. 
• 지출: 지출 필드에 쉼표가 없는지 확인합니다.
  

   

Excel에서 세미콜론 ";" 또는 다른 문자를 구분 기호로 사용하지만 쉼표는 사용하지 않는 CSV 파일을 만드는 경우:

• 이 문제는 컴퓨터의 국가별 설정이 영어가 아닌 언어/지역으로 설정되어 있을 때 발생합니다.
• 국가별 설정에서 독일어를 선택할 때 특히 자주 발생합니다.
• 해결 방법은 컴퓨터 운영 체제(macOS 또는 Windows)에 따라 다릅니다.
• 이 문제를 해결하려면 Microsoft 또는 다른 포럼에서 시작할 최신 안내를 검색하여 해결하십시오. 다음 검색어를 사용하세요. 운영 체제 (macOS 또는 Windows) Excel에서 CSV 파일의 구분 기호를 변경합니다.

아마 광고 지출 파일이 처리되지 않았기 때문일 것입니다. 다음과 같은 다양한 이유로 이런 일이 생길 수 있습니다.

잘못된 콘텐츠 유형

앱스플라이어는 multipart/mixed 콘텐츠 유형이 있는 메시지만 처리합니다. 다른 유형의 메시지는 처리되지 않으므로 생성되어 다시 전송되는 상태 이메일이 없습니다. 일반적인 경우 첨부 파일이 있는 이메일은 메일 클라이언트에 의해 multipart/mixed 로 자동 설정됩니다.

이메일 메시지 콘텐츠 유형이 multipart/mixed 인지 확인하려면 이메일 헤더에서 콘텐츠 유형 값을 확인합니다.

• Gmail에서 이메일 메시지 헤더를 보려면 Gmail 설명서의 지침을 따르세요.
• Outlook에서 이메일 메시지 헤더를 보려면 Outlook 설명서의 지침을 따르세요.

이메일 메시지 HTML의 형식이 올바르지 않습니다.

HTML 오류로 인해 이메일이 올바르게 처리되지 않을 수 있습니다. 예를 들어 태그가 비어 있거나 누락되었습니다. 스크립트에 HTML 오류가 있는지 확인하세요.

광고주와 에이전시는 CSV 파일을 준비하여 비용 데이터를 업로드하고 수집할 수 있습니다. 이렇게 하려면 CSV 파일에 에이전시 이름이 있는 에이전시 열이 포함되어야 합니다 (에이전시 이름은 af_prt 파라미터의 값임). CSV 스키마 참조

유의사항:

• 하나의 에이전시만 파일에 포함할 수 있습니다. 그리고 해당 에이전시에서 관리하는 캠페인만 파일에 포함할 수 있습니다.
• 행마다 에이전시 이름을 입력해야 합니다. 에이전시 열에는 빈 셀이 허용되지 않습니다.
• 에이전시는 파일에 포함된 모든 앱에 대한 권한이 있어야 합니다.
• 광고주만 파일을 업로드할 수 있습니다. 에이전시는 데이터를 업로드할 수 없습니다. 파일을 준비하고 광고주에게 보내 업로드할 수 있습니다.