- آیا محدودیتی در مورد آنچه می توانم آپلود کنم وجود دارد؟
چند محدودیت وجود دارد که باید از آنها آگاه بود:
- درخواستهای انفرادی
batchinsert
وbatchupdate
به 1000 تبدیل محدود میشوند. - مهر زمانی تبدیل می تواند حداکثر 28 روز از زمان ارسال باشد.
- شما فقط میتوانید تبدیلها را به پیکربندی Floodlight ارسال کنید که نمایه کاربری Campaign Manager 360 شما به آن دسترسی دارد.
- درخواستهای انفرادی
- آیا باید از Campaign Manager 360 یا Search Ads 360 برای آپلود تبدیل استفاده کنم؟
برای مقایسه دقیق ویژگی های ارائه شده توسط هر دو محصول، به مرکز راهنمای Search Ads 360 مراجعه کنید.
- اگر همان تبدیل را به Campaign Manager 360 و Search Ads 360 وارد کنم، چه میشود؟
اگر همان تبدیل را به Campaign Manager 360 و Search Ads 360 وارد کنید، ورودیها کپی نمیشوند. لطفاً در این مورد از فعالیت های Floodlight جداگانه استفاده کنید.
- مقدار ترتیبی چیست و چگونه استفاده می شود؟
مقادیر ترتیبی نحوه پردازش تبدیلهای تکراری را کنترل میکنند. اگر چندین تبدیل با مقادیر یکسان Floodlight، شناسه کاربر و تاریخ تبدیل درج شود، از ترتیبی برای تعیین اینکه آیا:
- تبدیل ها کپی شده و تنها یکی زنده می ماند. این در صورتی اتفاق میافتد که همه تبدیلها مقدار ترتیبی یکسانی داشته باشند.
- تبدیل ها به صورت جداگانه پردازش می شوند و همه زنده می مانند. اگر همه تبدیلها مقدار ترتیبی متفاوتی داشته باشند، این اتفاق میافتد.
خود ارزش ها نیازی به معنی دار بودن ندارند. به طور کلی، استفاده از یک مقدار ثابت (مانند
1
) برای همه تبدیلها، کپیسازی را فعال میکند. استفاده از یک مقدار تصادفی یا منحصر به فرد برای هر تبدیل، آن را غیرفعال می کند.- وقتی آپلود
mobileDeviceId
به دلیل خطایNOT_FOUND
با شکست مواجه می شود، به چه معناست؟ شایع ترین دلایل این خطا عبارتند از:
-
mobileDeviceId
نامعتبر است. -
mobileDeviceId
برای Search Ads 360 ناشناخته است. این بدان معناست که هنوز تبلیغاتی توسط Campaign Manager 360 به دستگاه ارائه نشده است.
-
- وقتی آپلود
gclid
به دلیل یک خطایNOT_FOUND
با شکست مواجه می شود به چه معناست؟ شایع ترین دلایل این خطا عبارتند از:
-
gclid
نامعتبر است. -
gclid
با یک کمپین Search Ads 360 یا یک آیتم Display & Video 360 YouTube مرتبط نیست. اگرgclid
از تغییرمسیر کلیک Google Ads جمعآوری شده باشد که از Search Ads 360 عبور نکرده است (مثلاً کلیکها روی پسوندهای مکان) یا از تغییرمسیر کلیک آگهی YouTube که با آیتم Display & Video 360 YouTube مرتبط نیست جمعآوری شده باشد. - کلیک مرتبط با
gclid
در گذشته خیلی دور اتفاق افتاده است. تبدیلها فقط برای کلیکهایی که تا 60 روز قبل انجام میشوند ممکن است درج شوند. - کلیک مرتبط با
gclid
اخیراً رخ داده است. توصیه میکنیم آپلودهای تبدیل مبتنی برgclid
را ۱ ساعت به تأخیر بیندازید تا مطمئن شوید کهgclid
پردازش شده و برای مطابقت در دسترس است.
-
- وقتی آپلود
dclid
به دلیل خطایNOT_FOUND
با شکست مواجه می شود، به چه معناست؟ شایع ترین دلایل این خطا عبارتند از:
-
dclid
نامعتبر است. - کلیک مرتبط با
dclid
در گذشته خیلی دور اتفاق افتاده است. تبدیلها فقط برای کلیکهایی که تا 60 روز قبل انجام میشوند ممکن است درج شوند. - کلیک مرتبط با
dclid
اخیراً رخ داده است. توصیه میکنیم آپلودهای تبدیل مبتنی برdclid
را ۱ ساعت به تأخیر بیندازید تا مطمئن شوید کهdclid
پردازش شده و برای مطابقت در دسترس است.
-
- وقتی آپلود
matchId
به دلیل خطایNOT_FOUND
با شکست مواجه می شود به چه معناست؟ شایع ترین دلایل این خطا عبارتند از:
-
matchId
برای Campaign Manager 360 ناشناخته است. اگرmatchId
از یک تماس Floodlight جمعآوری شده باشد که به درستی از Campaign Manager 360 عبور نکرده است (مطمئن شوید که تماسهای Floodlight شما از جمله پارامتر تگmatchId
به درستی کار میکنند). - تماس Floodlight مرتبط با
matchId
حاوی کوکی نبود. تماس Floodlight باید حاوی یک کوکی / شناسه برای Campaign Manager 360 باشد تاmatchId
را به درستی ذخیره کند (یعنی ممکن است کاربر کوکی ها را مسدود کرده باشد یا انصراف داده باشد). - تماس Floodligh مرتبط با
matchId
در گذشته خیلی دور اتفاق افتاده است. آپلودهای تبدیل آفلاین باید ظرف 60 روز از تماس Floodlight حاویmatchId
انجام شود. - تماس Floodlight مرتبط با
matchId
اخیراً رخ داده است. توصیه میکنیم آپلودهای تبدیل مبتنی برmatchId
را 2 ساعت به تأخیر بیندازید تا اطمینان حاصل شود کهmatchId
پردازش شده و برای مطابقت در دسترس است.
-
- آیا تبدیلهای آفلاین با مهر زمانی قبل از ایجاد فعالیت Floodlight در گزارشها گنجانده شده است؟
آپلود تبدیلهای آفلاین با مهر زمانی قبل از ایجاد فعالیت Floodlight میتواند بهعنوان نمایشهای Floodlight و بهعنوان تبدیلهای منتسب/منتسب، حداکثر ۲۸ روز قبل از زمان ارسال گزارش شود. با این حال، این رفتار تضمین شده نیست و نباید به آن اعتماد کرد. بهترین روش این است که فعالیتهای Floodlight را قبل از اولین مُهر زمانی تبدیل آفلاین ایجاد کنید.
- چه رضایتی برای استفاده از درج تبدیل آفلاین برای ایجاد فهرست مخاطبان لازم است؟
علاوه بر رضایت دادههای کاربر آگهی، قسمت
nonPersonalizedAd
باید صراحتاً رویfalse
تنظیم شود تا ایجاد فهرست مخاطبان فعال شود.
سوالات متداول
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]