- 업로드할 수 있는 항목에 제한이 있나요?
다음과 같은 몇 가지 제한사항이 있습니다.
- 개별
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에 동일한 전환을 삽입하면 항목이 중복 삭제되지 않습니다. 이 경우 별도의 플러드라이트 활동을 사용하세요.
- 순서 값이란 무엇이며 어떻게 사용되나요?
순서 값은 중복 전환이 처리되는 방식을 제어합니다. 동일한 플러드라이트 값, 사용자 식별자, 전환 날짜로 여러 전환이 삽입된 경우 서열을 사용하여 다음을 결정합니다.
- 전환이 중복 삭제되고 하나만 남습니다. 이는 모든 전환의 순서 값이 동일한 경우에 발생합니다.
- 전환은 개별적으로 처리되며 모두 유지됩니다. 이는 모든 전환의 서수 값이 다르면 발생합니다.
값 자체는 의미가 있을 필요가 없습니다. 일반적으로 모든 전환에 고정 값 (예:
1
)을 사용하면 중복 삭제가 사용 설정됩니다. 전환마다 임의의 값이나 고유한 값을 사용하면 이 기능이 사용 중지됩니다.NOT_FOUND
오류로 인해mobileDeviceId
업로드가 실패하면 어떻게 되나요?이 오류의 가장 일반적인 원인은 다음과 같습니다.
mobileDeviceId
가 잘못되었습니다.- Search Ads 360에서
mobileDeviceId
를 알 수 없습니다. 즉, 기기에 아직 Campaign Manager 360에서 광고가 게재되지 않았습니다.
NOT_FOUND
오류로 인해gclid
업로드에 실패하면 어떻게 되나요?이 오류의 가장 일반적인 원인은 다음과 같습니다.
gclid
가 잘못되었습니다.gclid
는 Search Ads 360 캠페인 또는 Display & Video 360 YouTube 광고 항목과 연결되어 있지 않습니다. 이는gclid
가 Search Ads 360을 통과하지 않은 Google Ads 클릭 리디렉션 (예: 위치 확장 소재 클릭)에서 수집되었거나 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에 알려지지 않았습니다. 이는matchId
가 Campaign Manager 360을 제대로 통과하지 않은 플러드라이트 호출에서 수집된 경우 발생할 수 있습니다.matchId
태그 매개변수를 포함하여 플러드라이트 호출이 올바르게 작동하는지 확인하세요.matchId
와 연결된 플러드라이트 호출에 쿠키가 포함되지 않았습니다. 플러드라이트 호출에는 Campaign Manager 360이matchId
를 올바르게 저장할 수 있는 쿠키 / 식별자가 포함되어야 합니다 (예: 사용자가 쿠키를 차단했거나 선택 해제했을 수 있음).matchId
와 연결된 플러드라이트 호출이 너무 오래 전에 발생했습니다. 오프라인 전환 업로드는matchId
가 포함된 플러드라이트 호출 후 60일 이내에 이루어져야 합니다.matchId
와 연결된 플러드라이트 호출이 너무 최근에 발생했습니다.matchId
가 처리되고 일치에 사용할 수 있도록matchId
기반 전환 업로드를 2시간 지연하는 것이 좋습니다.
- 플러드라이트 활동을 만들기 이전의 타임스탬프가 있는 오프라인 전환이 보고서에 포함되나요?
플러드라이트 활동을 만들기 전에 타임스탬프가 있는 오프라인 전환을 업로드하면 제출 시점으로부터 최대 28일 전까지 플러드라이트 노출수 및 기여도가 없는/기여도가 있는 전환으로 보고될 수 있습니다. 그러나 이 동작은 보장되지 않으며 이에 의존해서는 안 됩니다. 오프라인 전환의 가장 빠른 타임스탬프 전에 플러드라이트 활동을 만드는 것이 좋습니다.
- 잠재고객 목록 생성에 오프라인 전환 삽입을 사용하려면 어떤 동의가 필요한가요?
잠재고객 목록 생성을 사용 설정하려면 광고 사용자 데이터 동의 외에도
nonPersonalizedAd
필드를 명시적으로false
로 설정해야 합니다.
자주 묻는 질문(FAQ)
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eConversion uploads are restricted by quantity (1,000 per request), recency (28 days old maximum), and user profile access.\u003c/p\u003e\n"],["\u003cp\u003eDuplicate conversions can be controlled using ordinal values; identical values deduplicate, while unique values allow all conversions.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eNOT_FOUND\u003c/code\u003e errors for identifiers (\u003ccode\u003emobileDeviceId\u003c/code\u003e, \u003ccode\u003egclid\u003c/code\u003e, \u003ccode\u003ematchId\u003c/code\u003e) often indicate invalid IDs, unknown IDs to the system, or timing issues.\u003c/p\u003e\n"],["\u003cp\u003eAlthough conversions with timestamps before a Floodlight Activity's creation might be reported, it's best to create the activity beforehand for reliable reporting.\u003c/p\u003e\n"]]],[],null,["# Frequently asked questions\n\nAre there any restrictions on what I can upload?\n\n: There are a few restrictions to be aware of:\n\n - Individual `batchinsert` and `batchupdate` requests are limited to 1,000 conversions.\n - The timestamp of a conversion can be **at most** 28 days old from the time of submission.\n - You can only submit conversions to a Floodlight configuration to which your Campaign Manager 360 user profile has access.\n\nShould I use Campaign Manager 360 or Search Ads 360 to upload conversions?\n\n: Refer to the [Search Ads 360 help center](//support.google.com/searchads/answer/7384231) for a detailed\n comparison of features offered by both products.\n\nWhat if I insert the same conversion to both Campaign Manager 360 and Search Ads 360?\n\n: If you insert the same conversion to both Campaign Manager 360 and Search Ads\n 360, the entries will not be deduplicated. Please use separate Floodlight\n activities in this case.\n\nWhat is an ordinal value and how is it used?\n\n: Ordinal values control how duplicate conversions are processed. If multiple\n conversions are inserted with the same Floodlight values, user identifier, and\n conversion date, the ordinal is used to determine whether:\n\n - The conversions are deduplicated and only one survives. This happens if all conversions have the **same** ordinal value.\n - The conversions are processed individually and all survive. This happens if all conversions have a **different** ordinal value.\n\n The values themselves don't need to be meaningful. In general, using a fixed\n value (such as `1`) for all conversions will enable deduplication.\n Using a random or unique value for each conversion will disable it.\n\nWhat does it mean when a `mobileDeviceId` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `mobileDeviceId` is invalid.\n - The `mobileDeviceId` is unknown to Search Ads 360. This means that the device has yet to be served an ad by Campaign Manager 360.\n\nWhat does it mean when a `gclid` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `gclid` is invalid.\n - The `gclid` is not associated with a Search Ads 360 campaign or a Display \\& Video 360 YouTube line item. This may occur if the `gclid` was collected from a Google Ads click redirect which did not pass through Search Ads 360 (e.g., clicks on location extensions) or collected from a YouTube ad click redirect not associated with a Display \\& Video 360 YouTube line item.\n - The click associated with the `gclid` occurred too far in the past. Conversions may only be inserted for clicks up to 60 days old.\n - The click associated with the `gclid` occurred too recently. We recommend delaying `gclid`-based conversion uploads by 1 hour to ensure that the `gclid` is processed and available for matching.\n\nWhat does it mean when a `dclid` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `dclid` is invalid.\n - The click associated with the `dclid` occurred too far in the past. Conversions may only be inserted for clicks up to 60 days old.\n - The click associated with the `dclid` occurred too recently. We recommend delaying `dclid`-based conversion uploads by 1 hour to ensure that the `dclid` is processed and available for matching.\n\nWhat does it mean when a `matchId` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `matchId` is unknown to Campaign Manager 360. This may occur if the `matchId` was collected from a Floodlight call which did not properly pass through Campaign Manager 360 (make sure your Floodlight calls are working correctly including the `matchId` tag parameter).\n - The Floodlight call associated with the `matchId` didn't contain a cookie. The Floodlight call must contain a cookie / identifier for Campaign Manager 360 to store the `matchId` correctly (ie. user may have blocked cookies or opted out).\n - The Floodligh call associated with the `matchId` occurred too far in the past. Offline Conversion uploads must be made within 60 days of the Floodlight call containing the `matchId`.\n - The Floodlight call associated with the `matchId` occurred too recently. We recommend delaying `matchId`-based conversion uploads by 2 hours to ensure that the `matchId` is processed and available for matching.\n\nAre offline conversions with a timestamp prior to the creation of the Floodlight Activity included in reports?\n\n: The upload of offline conversions with a timestamp prior to the creation of\n the Floodlight Activity could be reported as Floodlight impressions and as\n unattributed/attributed conversions, up to 28 days prior from the time of\n submission. However, this behavior is not guaranteed and shouldn't be relied\n upon. The best practice is to create Floodlight Activities before the earliest\n timestamp of an offline conversion.\n\nWhat consent is necessary to use Offline Conversion Insertion for audience list creation?\n\n: In addition to ad user data consent, the `nonPersonalizedAd` field must be\n explicitly set to `false` to enable audience list creation."]]