الأسئلة الشائعة

هل هناك أي قيود على ما يمكنني تحميله؟

في ما يلي بعض القيود التي يجب الانتباه إليها:

  • تقتصر طلبات batchinsert وbatchupdate الفردية على 1,000 إحالة ناجحة.
  • لا يمكن أن يتجاوز الطابع الزمني للإحالة الناجحة 28 يومًا كحدّ أقصى من وقت الإرسال.
  • يمكنك إرسال الإحالات الناجحة فقط إلى إعدادات Floodlight التي يمكن لملف المستخدم الشخصي في "مدير الحملة 360" الوصول إليها.
هل يجب استخدام "مدير الحملة 360" أو "إعلانات شبكة البحث 360" لتحميل الإحالات الناجحة؟

يُرجى الرجوع إلى مركز مساعدة "إعلانات شبكة البحث 360" للاطّلاع على مقارنة تفصيلية للميزات التي يقدّمها كلا المنتجَين.

ماذا يحدث إذا أدرجتُ الإحالة الناجحة نفسها في كلّ من "مدير الحملة 360" و"إعلانات شبكة البحث 360"؟

إذا أدخلت الإحالة الناجحة نفسها في كلّ من "مدير الحملة 360" و"إعلانات شبكة البحث 360"، لن تتم إزالة الإدخالات المكرّرة. استخدِم أنشطة Floodlight منفصلة في هذه الحالة.

ما هي واجهة برمجة التطبيقات التي يجب استخدامها لتحميل الإحالات الناجحة غير الإلكترونية؟

ننصحك باستخدام Data Manager API للحصول على تجربة أفضل للمطوّرين والاستفادة من ميزات إضافية.

ما هي القيمة الترتيبية وكيف يتم استخدامها؟

تتحكّم القيم الترتيبية في كيفية معالجة الإحالات الناجحة المكرّرة. إذا تم إدراج إحالات ناجحة متعددة باستخدام نشاط Floodlight ومعرّف إعدادات Floodlight ومعرّف المستخدم والطابع الزمني للإحالة الناجحة نفسها، يتم استخدام الترتيب لتحديد ما يلي:

  • تتم إزالة الإحالات الناجحة المكرّرة ويتم الاحتفاظ بإحالة ناجحة واحدة فقط. يحدث ذلك إذا كانت جميع الإحالات الناجحة لها نفس القيمة الترتيبية.
  • تتم معالجة الإحالات الناجحة بشكل فردي ويتم الاحتفاظ بها جميعًا. يحدث ذلك إذا كانت جميع الإحالات الناجحة لها قيمة ترتيبية مختلفة.

ولا يلزم أن تكون القيم نفسها ذات معنى. بشكل عام، سيؤدي استخدام قيمة ثابتة (مثل 1) لجميع الإحالات الناجحة إلى تفعيل إزالة التكرار. وسيؤدي استخدام قيمة عشوائية أو فريدة لكل إحالة ناجحة إلى إيقافها.

كيف يمكنني معالجة الأخطاء في الردّ من واجهة برمجة التطبيقات، وما هي الأخطاء التي يجب إعادة محاولة إرسالها؟

يعالج batchinsert وbatchupdate الإحالات الناجحة على أساس بذل أفضل جهد: يمكن أن يعرض طلب الدفعة استجابة HTTP 200 OK بينما تفشل الإحالات الناجحة الفردية داخل الدفعة. تحقَّق دائمًا من hasFailures في الردّ وافحص قائمة errors[] في كل عنصر ConversionStatus:

  • ‫INTERNAL (إعادة المحاولة): حدث خطأ عابر داخل أنظمة Google أثناء معالجة الإحالة الناجحة. لم يتم إدراج الإحالة الناجحة أو تعديلها. أعِد محاولة الإحالات الناجحة التي تعذّر إجراؤها باستخدام خوارزمية الرقود الأسي الثنائي (على سبيل المثال، البدء بعد بضع دقائق وإعادة المحاولة على مدار عدة ساعات)، مع الاحتفاظ بالقيم نفسها لكل من ordinal وtimestampMicros وfloodlightActivityId ومعرّف المستخدم أو النقرة.
  • NOT_FOUND (إعادة المحاولة مع تأخير): تعذّر العثور على المعرّف (gclid أو dclid أو matchId أو mobileDeviceId) أو الإحالة الناجحة الحالية التي يتم تعديلها. بما أنّ معالجة وفهرسة النقرات على الإنترنت وعلامات Floodlight والإحالات الناجحة يمكن أن تستغرق من ساعة إلى ساعتَين، يُرجى إعادة محاولة إرسال إحالات NOT_FOUND الناجحة بشكل دوري (على سبيل المثال، كل ساعة إلى 3 ساعات، لمدة تصل إلى 6 ساعات). إذا استمر ظهور الخطأ NOT_FOUND بعد 6 ساعات، يُرجى الاطّلاع على الأقسام التالية لمعرفة الأسباب الشائعة حسب نوع المعرّف.
  • ‫INVALID_ARGUMENT وPERMISSION_DENIED (لا تُعِد المحاولة): بيانات الإحالة الناجحة غير صالحة (على سبيل المثال، طابع زمني للإحالة الناجحة أقدم من 28 يومًا أو حقل غير صحيح) أو لا يملك ملف المستخدم الشخصي الإذن اللازم لإعداد Floodlight المستهدَف. يُرجى عدم إعادة محاولة إجراء هذه الإحالات الناجحة بدون حلّ المشكلة الأساسية.

إذا تعذّر تنفيذ طلب HTTP بالكامل بسبب خطأ في الخادم 5xx أو خطأ في الحصة أو الحد الأقصى للمعدّل 429، أعِد محاولة تنفيذ الطلب باستخدام التراجع الأسي.

إعادة المحاولة الآمنة وإزالة التكرار: عند إعادة محاولة إجراء إحالة ناجحة تعذّر إكمالها بسبب الخطأ INTERNAL أو NOT_FOUND (أو بعد انتهاء مهلة HTTP 5xx عندما تكون النتيجة غير معروفة)، يجب دائمًا إرسال ordinal وtimestampMicros نفسهما بالضبط. إذا سبق أن تم تسجيل إحالة ناجحة، يزيل "مدير الحملة 360" التكرار تلقائيًا استنادًا إلى ordinal ومعرّف المستخدم ونشاط Floodlight وتاريخ الإحالة الناجحة.

ماذا يعني تعذُّر تحميل 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 بشكل صحيح (أي قد يكون المستخدم قد حظر ملفات تعريف الارتباط أو أوقفها).
  • حدثت مكالمة Floodlight المرتبطة بـ matchId في وقت بعيد جدًا في الماضي. يجب تحميل الإحالات الناجحة غير الإلكترونية خلال 60 يومًا من طلب Floodlight الذي يتضمّن matchId.
  • حدثت مكالمة Floodlight المرتبطة بـ "matchId" مؤخرًا جدًا. ننصحك بتأخير عمليات تحميل الإحالات الناجحة المستندة إلى matchId لمدة ساعتَين لضمان معالجة matchId وإتاحتها للمطابقة.
هل يتم تضمين الإحالات الناجحة غير الإلكترونية التي تحمل طابعًا زمنيًا قبل إنشاء نشاط Floodlight في التقارير؟

يمكن تسجيل الإحالات الناجحة غير الإلكترونية التي تم تحميلها بطابع زمني يسبق إنشاء نشاط Floodlight على أنّها مرّات ظهور في Floodlight وإحالات ناجحة محدّدة المصدر أو غير محدّدة المصدر، وذلك لمدّة تصل إلى 28 يومًا قبل وقت الإرسال. ومع ذلك، لا يمكن ضمان هذا السلوك ولا ينبغي الاعتماد عليه. أفضل الممارسات هي إنشاء أنشطة Floodlight قبل أقرب طابع زمني لإحالة ناجحة غير إلكترونية.

ما هي الموافقة اللازمة لاستخدام ميزة "إدراج الإحالات الناجحة غير الإلكترونية" لإنشاء قوائم المستخدمين؟

بالإضافة إلى الموافقة على بيانات مستخدمي الإعلانات، يجب ضبط الحقل nonPersonalizedAd بشكل صريح على false لإتاحة إنشاء قوائم المستخدمين.