استخدِم طريقة 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.