문제해결

Search Ads 360 API를 사용하는 동안 문제가 발생하면 이 문제 해결 섹션을 살펴보세요.

이 사이트의 리소스를 읽은 후에도 해결할 수 없는 문제가 있다면 지원팀에 문의하고 다음 정보를 준비해 둡니다.

  • 액세스하려는 Search Ads 360 대행사 ID 및 광고주 ID

  • Google API 콘솔의 프로젝트 번호

  • API에 액세스하는 데 사용 중인 Google 계정의 사용자 이름입니다.
    이 계정은 Search Ads 360 액세스 권한이 부여된 계정이며 승인을 설정할 때 사용하는 계정과 동일합니다.

  • 요청의 코드 스니펫

  • JSON 응답
    응답이 오류인 경우 숫자 오류 코드만이 아닌 오류 메시지를 포함해야 합니다.

인증 오류

다음은 몇 가지 일반적인 승인 오류입니다.

메시지 설명

Access Not Configured. Please use Google API Console to activate the API for your project.

이 오류는 계정에 Search Ads 360 API를 사용 설정하지 않은 경우에 발생합니다. 다음을 완료했는지 확인합니다.

  1. Google API 콘솔로 이동합니다.

  2. 프로젝트를 선택합니다. 아직 프로젝트를 만들지 않은 경우 클라이언트를 위한 프로젝트 만들기를 참조하세요.

  3. 왼쪽 사이드바에서 API 및 인증을 펼칩니다. 그런 다음 API를 클릭합니다. API 목록에서 Search Ads 360 API의 상태가 사용으로 되어 있는지 확인합니다.

Invalid grant

이 오류는 갱신 토큰이 유효하지 않은 경우에 발생합니다. 다음과 같이 Search Ads 360 유틸리티 스크립트를 호출하여 갱신 토큰을 얻을 수 있습니다.

sa360Api.py --login

권장되는 승인 워크플로에 대해 자세히 알아보세요.

Invalid client
no application name

이 오류는 Google API 콘솔에서 프로젝트를 설정할 때 제품 이름을 지정하지 않은 경우에 발생합니다. 이 오류를 수정하려면 Google API 콘솔의 동의 화면에 제품 이름을 입력하세요.

기타 유형의 승인 오류

Google API 콘솔에 로그인하여 클라이언트 ID와 클라이언트 보안 비밀번호를 검색할 때, 그리고 갱신 토큰을 얻을 때는 Search Ads 360 액세스 권한이 부여된 Google 계정을 사용해야 합니다.

전환 업로드 오류

다음 표에는 전환을 업로드할 때 발생할 수 있는 오류가 나와 있습니다. 16진수 오류 코드는 변경할 수 없으므로 자체 스크립트에서 사용하여 오류를 식별할 수 있습니다.

오류 코드 메시지 설명
0x00000101

Click ID '{ID}' is not found

update 요청에 지정한 클릭 ID가 잘못되었습니다. 다음을 완료한 후 전환을 다시 업로드하세요.

  • 전환이 업로드되기 4시간 전에 클릭 ID가 생성되었음을 확인했습니다.

  • API 변환 서비스를 활성화했습니다.

  • 특정 방문에 전환이 발생한 경우 전환을 업로드하기 전에 방문 후 30분 이상 기다려야 합니다. 방문 후 30분 이내에 업로드하는 경우 Search Ads 360에서 방문의 클릭 ID를 인식하지 못할 수 있습니다. 드물지만 Search Ads 360에서 clickId를 인식하기까지 최대 4시간이 걸릴 수도 있습니다.

  • 클릭이 gclsrc 매개변수에 의해 표시된 유효한 소스에서 발생한 것을 확인했습니다.

  • 광고주 ID 열에 올바른 광고주를 지정했음을 확인했습니다.

  • 지난 90일 내에 클릭 ID가 생성되었음을 확인했습니다.

0x0000010E Floodlight activity name '{name}' is not found

segmentationName 열에 지정된 플러드라이트 활동의 이름이 잘못되었거나 아직 사용할 수 없습니다. 이 오류가 표시되면 다음과 같은 일반적인 문제를 확인합니다.

  • 이름은 대소문자를 구분하므로 요청이 대소문자와 정확하게 일치해야 합니다.
  • 플러드라이트 활동 이름에 인쇄할 수 없는 유니코드 문자 또는 이중 공백을 포함하지 않았는지 확인합니다.
  • 플러드라이트 열이 아닌 플러드라이트 활동의 이름을 지정해야 합니다.
  • advertiserId 열에 지정한 광고주의 플러드라이트 활동이 있는지 확인하세요. 잘못된 광고주를 지정했을 수 있습니다.
  • 플러드라이트 활동을 만들거나 수정한 후 몇 시간 후에 해당 활동의 전환을 업로드합니다.
0x00000115 Custom dimension '{name}' is not found

지정된 맞춤 플러드라이트 변수가 전환에 기여한 clickId, criterionId 또는 productGroupId와 연결된 광고주의 측정기준(측정항목이 아님)으로 설정되었는지 확인하세요.

0x00000116 Custom metric '{name}' is not found

지정된 맞춤 플러드라이트 변수가 전환에 기여한 clickId, criterionId 또는 productGroupId와 연결된 광고주에 대해 측정항목(측정기준 아님)으로 설정되었는지 확인하세요.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

다른 사용자가 이미 conversionId 열에 지정된 것과 동일한 범위 및 광고주 전환 ID의 전환을 업로드했습니다.

'광고주 전환 ID'는 광고주가 생성한 ID입니다. Search Ads 360에서는 지정된 ID에 고유 ID를 지정해야 합니다. Search Ads 360 전환 ID는 Search Ads 360에서 생성되며 고유함을 보장합니다.

0x0000011B Advertiser conversion ID '{ID}' is not found

update 요청에서 존재하지 않는 광고주 전환 ID를 업데이트하려고 했습니다. 올바른 ID를 지정했는지 확인하세요.

0x0000011D User does not have permission to view advertiser {advertiser ID}

클라이언트가 사용 중인 Google 계정에 요청에 지정된 광고주를 볼 권한이 없습니다.

Google API 콘솔에 로그인하여 클라이언트 ID와 클라이언트 보안 비밀을 가져오고 갱신 토큰을 받으면 지정한 광고주에 액세스 권한을 부여한 Google 계정을 사용해야 합니다.

0x0000011F Advertiser conversion ID is already specified in this request

요청에서 2개 이상의 전환이 동일한 범위와 광고주 전환 ID를 지정합니다.

광고주 전환 ID는 conversionId 열에서 생성하고 지정하는 ID입니다. Search Ads 360에서는 ID가 특정 범위에서 고유해야 합니다.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

입력한 플러드라이트 활동 ID 또는 이름이 지정한 전환 유형과 일치하지 않습니다.

응답 코드 및 오류 메시지 보고

보고서를 요청하고 응답이 오류 메시지인 경우 Search Ads 360 API의 응답 코드 및 오류에 대한 자세한 내용은 표준 오류 응답을 참조하세요.

Search Ads 360 UI의 데이터가 API에서 반환된 보고서와 일치하지 않음

Search Ads 360 UI의 데이터는 기본적으로 API에서 반환한 데이터와 일치해야 합니다. 보고서 요청에서 includeRemovedEntitiestrue로 설정하는 경우 UI에서 삭제된 항목 표시 체크박스도 선택해야 합니다.