- هل هناك أي قيود على المحتوى الذي يمكنني تحميله؟
هناك بعض القيود التي يجب أخذها في الاعتبار:
- تقتصر طلبات
batchinsert
وbatchupdate
الفردية على 1,000 إحالة ناجحة. - يمكن أن يكون الطابع الزمني للإحالة الناجحة على الأكثر 28 يومًا من وقت الإرسال.
- لا يمكنك إرسال الإحالات الناجحة إلّا إلى إعدادات Floodlight التي يمكن لملفّك الشخصي على "مدير الحملة 360" الوصول إليها.
- تقتصر طلبات
- هل يجب استخدام "مدير الحملة 360" أو "إعلانات شبكة البحث 360" لتحميل الإحالات الناجحة؟
يُرجى الرجوع إلى مركز مساعدة "إعلانات شبكة البحث 360" للاطّلاع على مقارنة تفصيلية بالميزات التي يوفّرها كلا المنتجَين.
- ماذا لو أدرجت الإحالة الناجحة نفسها في كلّ من "مدير الحملة 360" و"إعلانات شبكة البحث 360"؟
في حال إدراج الإحالة الناجحة نفسها في كلّ من "مدير الحملة 360" و"إعلانات شبكة البحث 360"، لن تتمّ إزالة تكرار الإدخالات. يُرجى استخدام أنشطة Floodlight منفصلة في هذه الحالة.
- ما هي القيمة التسلسلية وكيف يتم استخدامها؟
تتحكّم القيم الترتيبية في كيفية معالجة الإحالات الناجحة المكرّرة. في حال إدراج عدّة إحالات ناجحة باستخدام قيم Floodlight ومعرّف المستخدِم و تاريخ الإحالة الناجحة نفسهما، يتم استخدام الترتيب لتحديد ما إذا كان:
- تتم إزالة تكرار الإحالات الناجحة وتبقى إحالة ناجحة واحدة فقط. يحدث ذلك إذا كانت كل الإحالات الناجحة لها القيمة الترتيبية نفسها.
- تتم معالجة الإحالات الناجحة بشكلٍ فردي، ولا يتم حذف أيّ منها. يحدث ذلك إذا كانت جميع الإحالات الناجحة لها قيمة ترتيبية مختلفة.
ولا يلزم أن تكون القيم ذات معنى. بشكل عام، سيؤدي استخدام قيمة ثابتة (مثل
1
) لجميع الإحالات الناجحة إلى تفعيل إزالة التكرار. سيؤدي استخدام قيمة عشوائية أو فريدة لكل إحالة ناجحة إلى إيقافها.- ماذا يعني تعذُّر تحميل
mobileDeviceId
بسبب خطأNOT_FOUND
؟ في ما يلي الأسباب الأكثر شيوعًا لهذا الخطأ:
mobileDeviceId
غير صالح.mobileDeviceId
غير معروف لخدمة "إعلانات شبكة البحث 360". وهذا يعني أنّه لم يتم عرض إعلان على الجهاز من خلال "مدير الحملة 360" إلى الآن.
- ماذا يعني تعذُّر تحميل
gclid
بسبب خطأNOT_FOUND
؟ في ما يلي الأسباب الأكثر شيوعًا لهذا الخطأ:
gclid
غير صالح.- لا يكون الرمز
gclid
مرتبطًا بحملة على "إعلانات شبكة البحث 360" أو بعنصر على YouTube في "مساحة العرض & الفيديو 360". قد يحدث ذلك إذا تم جمعgclid
من إعادة توجيه نقرة على "إعلانات Google" لم تمرّ من "إعلانات شبكة البحث 360" (مثل النقرات على إضافات المواقع الجغرافية) أو تم جمعها من إعادة توجيه نقرة على إعلان على YouTube غير مرتبطة بعنصر YouTube في "مساحة العرض والفيديو 360". - حدثت النقرة المرتبطة بـ
gclid
في فترة بعيدة جدًا في الماضي. لا يمكن إدراج الإحالات الناجحة إلا للنقرات التي لم يمرّ على إنشائها أكثر من 60 يومًا. - تم تسجيل النقرة المرتبطة بالاستجابة
gclid
قبل وقت قصير جدًا. ننصحك بتأخير عمليات تحميل الإحالات الناجحة المستندة إلىgclid
لمدة ساعة واحدة لضمان معالجةgclid
وتوفيرها للمطابقة.
- ماذا يعني تعذُّر تحميل
dclid
بسبب خطأNOT_FOUND
؟ في ما يلي الأسباب الأكثر شيوعًا لهذا الخطأ:
dclid
غير صالح.- حدثت النقرة المرتبطة بالصفحة
dclid
في وقت بعيد جدًا في الماضي. لا يمكن إدراج الإحالات الناجحة إلا للنقرات التي لم يمرّ على إنشائها أكثر من 60 يومًا. - تم تسجيل النقرة المرتبطة بالاستجابة
dclid
قبل وقت قصير جدًا. ننصحك بتأخير عمليات تحميل الإحالات الناجحة المستندة إلىdclid
لمدة ساعة واحدة لضمان معالجةdclid
وتوفيرها للمطابقة.
- ماذا يعني تعذُّر تحميل
matchId
بسبب خطأNOT_FOUND
؟ في ما يلي الأسباب الأكثر شيوعًا لهذا الخطأ:
matchId
غير معروف لخدمة "مدير الحملة 360". قد يحدث ذلك إذا تم جمعmatchId
من طلب Floodlight لم يتم تمريره بشكلٍ سليم من خلال "مدير الحملة 360" (تأكّد من أنّ طلبات Floodlight تعمل بشكلٍ صحيح، بما في ذلك مَعلمة علامةmatchId
).- لم يحتوي طلب Floodlight المرتبط بـ
matchId
على ملف تعريف ارتباط. يجب أن يحتوي طلب Floodlight على ملفّ تعريف ارتباط أو معرّف لأجل "مدير الحملة 360" لتخزينmatchId
بشكلٍ صحيح (أي قد يكون المستخدِم قد حظر ملفات تعريف الارتباط أو أوقفها). - حدثت مكالمة Floodligh المرتبطة بالملف التجاري
matchId
في وقت سابق جدًا. يجب إجراء عمليات تحميل الإحالات الناجحة بلا إنترنت في غضون 60 يومًا من طلب Floodlight الذي يحتوي علىmatchId
. - حدثت مكالمة Floodlight المرتبطة بـ
matchId
مؤخرًا جدًا. ننصحك بتأخير عمليات تحميل الإحالات الناجحة المستندة إلىmatchId
لمدة ساعتَين ل ضمان معالجةmatchId
وإتاحتها للمطابقة.
- هل يتم تضمين الإحالات الناجحة بلا إنترنت التي لها طابع زمني قبل إنشاء نشاط Floodlight في التقارير؟
يمكن تحميل الإحالات الناجحة بلا إنترنت التي لها طابع زمني قبل إنشاء نشاط Floodlight، ويمكن الإبلاغ عنها على أنّها مرّات ظهور في Floodlight و/أو إحالات ناجحة غير منسوبة/منسوبة، وذلك قبل 28 يومًا كحدّ أقصى من وقت الإرسال. ومع ذلك، لا يمكن ضمان هذا السلوك ولا يجب الاعتماد عليه. من أفضل الممارسات إنشاء أنشطة Floodlight قبل أقدم الطابع الزمني للإحالة الناجحة بلا إنترنت.
- ما هي الموافقة اللازمة لاستخدام ميزة "إدراج الإحالات الناجحة بلا إنترنت" لإنشاء قوائم المستخدِمين؟
بالإضافة إلى الموافقة على بيانات مستخدِمي الإعلانات، يجب تحديد الحقل
nonPersonalizedAd
بوضوح علىfalse
لتفعيل إنشاء قائمة المستخدِمين.
الأسئلة الشائعة
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]