문제 해결

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 Console에서 프로젝트를 설정할 때 제품 이름을 지정하지 않은 경우 발생합니다. 이 오류를 해결하려면 Google API 콘솔의 동의 화면에 제품 이름을 입력하세요.

기타 유형의 승인 오류

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

전환 업로드 오류

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

오류 코드 메시지 설명
0x00000101

Click ID '{ID}' is not found

update 요청에 지정한 클릭 ID가 유효하지 않습니다. 다음을 완료한 후 전환을 다시 업로드합니다.

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

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

  • 특정 방문에 전환 기여도를 부여하는 경우 방문 후 최소 6시간이 지난 후에 전환을 업로드하세요. 방문 후 6시간 이내에 업로드하면 Search Ads 360에서 방문의 clickID를 인식하지 못할 수 있습니다. 드물지만 Search Ads 360에서 clickId를 인식하기까지 최대 24시간이 걸릴 수 있습니다.

  • gclsrc 매개변수에 표시된 대로 클릭이 유효한 소스에서 발생한 것으로 확인되었습니다.

  • advertiserId 열에 올바른 광고주가 지정되었는지 확인했습니다.

  • 클릭 ID가 지난 90일 이내에 생성되었음을 확인했습니다.
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를 사용해야 합니다. 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 또는 이름이 지정한 전환 유형과 일치하지 않습니다.
0x00000126 Service internal error

잠시 후 요청을 다시 시도해 주세요. 일시적인 오류일 가능성이 높습니다. 이 오류가 계속되면 SA360 지원팀에 문의하세요.

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

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

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

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