استخدِم طريقة IngestEvents لإجراء تعديلات على الإحالات الناجحة التي تم تسجيلها سابقًا في "إعلانات Google".
في Data Manager API، يمكن أن يعيد التعديل تحديد قيمة إحالة ناجحة أو يضيف بيانات مستخدمين.
إذا كنت بصدد نقل البيانات من Google Ads API، اطّلِع على الترقية من Google Ads API لمقارنة طريقة معالجة التسويات في كل واجهة برمجة تطبيقات.
أنواع الإحالات الناجحة المتوافقة
يمكنك تعديل أنواع الإحالات الناجحة التالية في "إعلانات Google":
- الإحالات الناجحة المتعددة المصادر: هي الإحالات الناجحة التي تسجّلها علامة التتبُّع من Google على موقعك الإلكتروني لإجراء إحالة ناجحة
WEBSITE. - الإحالات الناجحة غير الإلكترونية والإحالات الناجحة المحسّنة للعملاء المحتملين:
أحداث غير إلكترونية تم تحميلها سابقًا لإجراء إحالة ناجحة
UPLOAD_CLICKS.
طريقة عمل التعديلات
ضِمن إجراء الإحالة الناجحة نفسه، تطابِق "إعلانات Google" الأحداث باستخدام
transactionId:
- إذا كانت قيمة
transactionIdتطابق إحالة ناجحة حالية لإجراء الإحالة الناجحة نفسه، ستتعامل Data Manager API مع الطلب على أنّه تعديل على الإحالة الناجحة. - إذا لم يتطابق
transactionIdمع إحالة ناجحة حالية، ستنشئ "إعلانات Google" إحالة ناجحة جديدة. اطّلِع على الأحداث غير المطابِقة.
إرسال تسوية
لتعديل إحالة ناجحة حالية، أرسِل طلب IngestEvents يتضمّن ما يلي:
transactionIdنفسه الذي تم استخدامه في الحدث الأصلي- الوجهة وإجراء الإحالة الناجحة نفسيهما كما في الحدث الأصلي
- القيم المعدَّلة للحقول التي تريد تعديلها
لست بحاجة إلى تحديد نوع التسوية. تستنتج واجهة برمجة التطبيقات Data Manager API كيفية معالجة الطلب استنادًا إلى transactionId والحقول التي تقدّمها.
لمزيد من المعلومات حول إرسال طلبات الاستيعاب، اطّلِع على مقالة إرسال الأحداث.
الحقول المتاحة
يسرد الجدول التالي الحقول التي يمكنك تعديلها وكيفية تطبيق التعديلات:
| الحقل | السلوك |
|---|---|
conversionValue، currency |
تمت الكتابة فوقها تحلّ القيمة الجديدة محلّ القيمة المسجّلة. |
userData |
تتم إضافة بيانات المستخدمين إذا لم يتضمّن الحدث الأصلي أي بيانات مستخدم، وإلا سيتم تجاهله. |
جميع الحقول الأخرى، مثل adIdentifiers.gclid |
تم تجاهلها |
قيم الإحالات الناجحة
أرسِل conversionValue وcurrency جديدَين لإعادة صياغة قيمة إحالة ناجحة تم تسجيلها. تُلغي القيمة الجديدة القيمة المسجّلة سابقًا في إعداد التقارير وتقديم عروض الأسعار، بدون زيادة عدد الإحالات الناجحة.
بيانات المستخدمين
في ما يلي كيفية تعامل "إعلانات Google" مع userData، مثل عنوان البريد الإلكتروني أو رقم الهاتف:
تكملة البيانات في حال عدم توفّرها: إذا تم تسجيل الحدث الأصلي بدون بيانات المستخدم، يرفق التعديل بيانات المستخدم لتحسين تحديد المصدر.
يتم تجاهلها في حال توفّرها: إذا كانت علامة تتبُّع من Google أو عملية تحميل سابقة قد سجّلت بيانات المستخدِم، سيتم تجاهل بيانات المستخدِم الجديدة. لا يتم استبدال بيانات المستخدم الحالية أو إلحاقها.
الحقول الأخرى
لا يمكن تعديل المعرّفات والبيانات الوصفية الأخرى غير قيمة الإحالة الناجحة والعملة وبيانات المستخدم، مثل adIdentifiers.gclid، للأحداث المطابِقة. يتجاهل "إعلانات Google" هذه الحقول ويحتفظ بالقيم المسجّلة مع الحدث الأصلي.
الأحداث غير المطابِقة
إذا لم يتطابق transactionId مع حدث حالي، سيتم التعامل مع الطلب على أنّه عملية تحميل إحالة ناجحة جديدة بدلاً من تعديل.
تحاول "إعلانات Google" تحديد مصدر الإحالة الناجحة الجديدة على أنّه نقرة على إعلان باستخدام المعرّفات التي قدّمتها، مثل adIdentifiers.gclid أو userData.