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