- 업로드할 수 있는 항목에 제한이 있나요?
다음과 같은 몇 가지 제한사항이 있습니다.
- 개별
batchinsert및batchupdate요청은 변환 1,000개로 제한됩니다. - 전환의 타임스탬프는 제출 시점으로부터 최대 28일입니다.
- Campaign Manager 360 사용자 프로필에 액세스할 수 있는 플러드라이트 구성에만 전환을 제출할 수 있습니다.
- 개별
- 전환을 업로드하려면 Campaign Manager 360과 Search Ads 360 중 무엇을 사용해야 하나요?
두 제품에서 제공하는 기능을 자세히 비교하려면 Search Ads 360 고객센터를 참조하세요.
- Campaign Manager 360과 Search Ads 360에 동일한 전환을 삽입하면 어떻게 되나요?
Campaign Manager 360과 Search Ads 360 모두에 동일한 전환을 삽입하면 항목이 중복 삭제되지 않습니다. 이 경우 별도의 플러드라이트 활동을 사용하세요.
- 오프라인 전환을 업로드하려면 어떤 API를 사용해야 하나요?
개발자 환경을 개선하고 추가 기능을 이용하려면 Data Manager API를 사용하는 것이 좋습니다.
- 서수 값이란 무엇이며 어떻게 사용되나요?
순서 값은 중복 전환이 처리되는 방식을 제어합니다. 동일한 플러드라이트 활동, 플러드라이트 구성 ID, 사용자 식별자, 전환 타임스탬프를 사용하여 여러 전환이 삽입되는 경우 서수는 다음을 결정하는 데 사용됩니다.
- 전환은 중복 삭제되고 하나만 남습니다. 모든 전환의 순서 값이 동일한 경우에 발생합니다.
- 전환은 개별적으로 처리되며 모두 유지됩니다. 이는 모든 전환의 서수 값이 서로 다른 경우에 발생합니다.
값 자체는 의미가 없어도 됩니다. 일반적으로 모든 전환에 고정 값 (예:
1)을 사용하면 중복 삭제가 사용 설정됩니다. 각 전환에 무작위 또는 고유한 값을 사용하면 이 기능이 사용 중지됩니다.- API 응답의 오류를 어떻게 처리해야 하며 어떤 오류를 다시 시도해야 하나요?
batchinsert및batchupdate는 최선의 방식으로 전환을 처리합니다. 일괄 요청은 HTTP200 OK응답을 반환할 수 있지만 일괄 내의 개별 전환은 실패합니다. 항상 응답에서hasFailures를 확인하고 각ConversionStatus객체의errors[]목록을 검사합니다.INTERNAL(다시 시도): 전환을 처리하는 동안 Google 시스템 내에서 일시적인 오류가 발생했습니다. 전환이 삽입되거나 업데이트되지 않았습니다. 지수 백오프를 사용하여 실패한 전환을 다시 시도합니다(예: 몇 분 후에 시작하고 몇 시간 동안 다시 시도). 이때 정확히 동일한ordinal,timestampMicros,floodlightActivityId, 사용자 또는 클릭 식별자를 유지합니다.NOT_FOUND(지연 후 재시도): 식별자 (gclid,dclid,matchId또는mobileDeviceId) 또는 수정 중인 기존 전환을 아직 찾을 수 없습니다. 온라인 클릭, 플러드라이트 태그, 전환을 처리하고 색인을 생성하는 데 1~2시간이 걸릴 수 있으므로NOT_FOUND전환을 주기적으로 다시 시도하세요 (예: 1~3시간마다, 최대 6시간 동안). 6시간 후에도NOT_FOUND가 지속되면 다음 섹션에서 식별자 유형별 일반적인 원인을 참조하세요.INVALID_ARGUMENT및PERMISSION_DENIED(다시 시도하지 않음): 전환 데이터가 잘못되었거나 (예: 28일이 지난 전환 타임스탬프 또는 잘못된 형식의 필드) 사용자 프로필에 대상 플러드라이트 구성에 대한 권한이 없습니다. 근본적인 문제를 해결하지 않은 상태로 이러한 변환을 다시 시도하지 마세요.
전체 HTTP 요청이
5xx서버 오류 또는429할당량/비율 제한 오류로 실패하면 지수 백오프를 사용하여 요청을 다시 시도합니다.안전한 재시도 및 중복 삭제:
INTERNAL또는NOT_FOUND로 인해 실패한 전환을 재시도할 때 (또는 결과를 알 수 없는 HTTP5xx시간 초과 후) 항상 정확히 동일한ordinal및timestampMicros를 전송합니다. 전환이 이미 기록된 경우 Campaign Manager 360은ordinal, 사용자 식별자, 플러드라이트 활동, 전환 날짜를 기반으로 전환을 자동으로 중복 삭제합니다.NOT_FOUND오류로 인해mobileDeviceId업로드가 실패하면 어떻게 되나요?이 오류가 발생하는 가장 일반적인 원인은 다음과 같습니다.
mobileDeviceId가 잘못되었습니다.mobileDeviceId은 Search Ads 360에서 알 수 없습니다. 즉, Campaign Manager 360에서 아직 기기에 광고를 게재하지 않았습니다.
NOT_FOUND오류로 인해gclid업로드가 실패하면 어떻게 되나요?이 오류가 발생하는 가장 일반적인 원인은 다음과 같습니다.
gclid가 잘못되었습니다.gclid가 Search Ads 360 캠페인 또는 Display & Video 360 YouTube 광고 항목과 연결되어 있지 않습니다. 이는 Search Ads 360을 통과하지 않은 Google Ads 클릭 리디렉션 (예: 위치 광고 확장 클릭)에서gclid가 수집되었거나 Display & Video 360 YouTube 광고 항목과 연결되지 않은 YouTube 광고 클릭 리디렉션에서 수집된 경우에 발생할 수 있습니다.gclid와(과) 관련된 클릭이 너무 오래전에 발생했습니다. 전환은 최대 60일 전의 클릭에 대해서만 삽입할 수 있습니다.gclid와(과) 연결된 클릭이 너무 최근에 발생했습니다.gclid가 처리되고 일치에 사용할 수 있도록gclid기반 전환 업로드를 1시간 지연하는 것이 좋습니다.
NOT_FOUND오류로 인해dclid업로드가 실패하면 어떻게 되나요?이 오류가 발생하는 가장 일반적인 원인은 다음과 같습니다.
dclid가 잘못되었습니다.dclid와(과) 관련된 클릭이 너무 오래전에 발생했습니다. 전환은 최대 60일 전의 클릭에 대해서만 삽입할 수 있습니다.dclid와(과) 연결된 클릭이 너무 최근에 발생했습니다.dclid가 처리되고 일치에 사용할 수 있도록dclid기반 전환 업로드를 1시간 지연하는 것이 좋습니다.
NOT_FOUND오류로 인해matchId업로드가 실패하면 어떻게 되나요?이 오류가 발생하는 가장 일반적인 원인은 다음과 같습니다.
matchId은 Campaign Manager 360에 알려지지 않았습니다. 이는 Campaign Manager 360을 제대로 통과하지 못한 플러드라이트 호출에서matchId가 수집된 경우에 발생할 수 있습니다 (matchId태그 매개변수를 포함하여 플러드라이트 호출이 올바르게 작동하는지 확인하세요).matchId와 연결된 플러드라이트 호출에 쿠키가 포함되어 있지 않습니다. Campaign Manager 360에서matchId를 올바르게 저장하려면 플러드라이트 호출에 쿠키 / 식별자가 포함되어야 합니다 (예: 사용자가 쿠키를 차단했거나 선택 해제했을 수 있음).matchId와 연결된 플러드라이트 호출이 너무 오래전에 발생했습니다. 오프라인 전환 업로드는matchId가 포함된 플러드라이트 호출 후 60일 이내에 이루어져야 합니다.matchId와(과) 연결된 플러드라이트 호출이 너무 최근에 발생했습니다.matchId가 처리되고 일치에 사용할 수 있도록matchId기반 전환 업로드를 2시간 지연하는 것이 좋습니다.
- 플러드라이트 활동 생성 전의 타임스탬프가 있는 오프라인 전환이 보고서에 포함되나요?
플러드라이트 활동 생성 전의 타임스탬프가 있는 오프라인 전환 업로드는 제출 시점으로부터 최대 28일 전까지 플러드라이트 노출 및 기여도가 부여되지 않은/기여도가 부여된 전환으로 보고될 수 있습니다. 하지만 이 동작은 보장되지 않으며 이 동작에 의존해서는 안 됩니다. 가장 좋은 방법은 오프라인 전환의 가장 이른 타임스탬프 이전에 플러드라이트 활동을 만드는 것입니다.
- 잠재고객 목록 생성에 오프라인 전환 삽입을 사용하려면 어떤 동의가 필요한가요?
광고 사용자 데이터 동의 외에도 잠재고객 목록 생성을 사용 설정하려면
nonPersonalizedAd필드를 명시적으로false로 설정해야 합니다.
