- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- CallConversion
- CallConversionResult
- جرِّبه الآن
معالجة الإحالات الناجحة عبر الاتصال الهاتفي.
قائمة الأخطاء الملموسة: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
طلب HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل الذي يُجري عملية التحميل |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"conversions": [
{
object ( |
الحقول | |
---|---|
conversions[] |
مطلوبة. الإحالات الناجحة التي يتم تحميلها. |
partialFailure |
مطلوبة. في حال الصواب، سيتم تنفيذ عمليات ناجحة وعرض العمليات غير الصالحة أخطاء. وفي حال كانت القيمة خاطئة، سيتم تنفيذ جميع العمليات في معاملة واحدة فقط إذا كانت جميعها صالحة. يجب ضبط هذه السياسة دائمًا على "صحيح". يمكنك الانتقال إلى https://developers.google.com/google-ads/api/docs/best-practices/partial-failures للحصول على مزيد من المعلومات حول الفشل الجزئي. |
validateOnly |
إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج. |
نص الاستجابة
رسالة الرد لـ "ConversionUploadService.UploadCallConversions
".
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "partialFailureError": { object ( |
الحقول | |
---|---|
partialFailureError |
الأخطاء التي تتعلّق بحالات تعذُّر الإحالات الناجحة في وضع الفشل الجزئي. يتم عرضه عند حدوث جميع الأخطاء داخل الإحالات الناجحة. وفي حال حدوث أي أخطاء خارج الإحالات الناجحة (على سبيل المثال، أخطاء المصادقة)، نعرض خطأ على مستوى استدعاء إجراء عن بُعد (RPC). يمكنك الانتقال إلى https://developers.google.com/google-ads/api/docs/best-practices/partial-failures للحصول على مزيد من المعلومات حول الفشل الجزئي. |
results[] |
يُرسَل مقابل الإحالات الناجحة التي تمت معالجتها بنجاح. سيكون Proto فارغًا للصفوف التي تلقّت خطأ. لا يتم عرض النتائج عندما تكون trueOnly صحيحة. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
CallConversion
إحالة ناجحة عبر الاتصال الهاتفي.
تمثيل JSON |
---|
{ "customVariables": [ { object ( |
الحقول | |
---|---|
customVariables[] |
المتغيّرات المخصّصة المرتبطة بهذه الإحالة الناجحة. |
consent |
إعداد الموافقة للحدث |
callerId |
رقم المتصل الذي تم إجراء هذه المكالمة منه. من المتوقع أن يكون معرف المتصل بالتنسيق E.164 مع علامة "+" السابقة، على سبيل المثال، " +16502531234". |
callStartDateTime |
تاريخ وقت المكالمة يجب تحديد المنطقة الزمنية. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00". |
conversionAction |
اسم المورد لإجراء الإحالة الناجحة المرتبط بهذه الإحالة الناجحة. ملاحظة: على الرغم من أنّ اسم المورد هذا يتألف من رقم تعريف عميل ومعرّف إجراء إحالة ناجحة، ستتجاهل عملية التحقّق الرقم التعريفي للعميل وستستخدم رقم تعريف إجراء الإحالة الناجحة كمعرّف إجراء الإحالة الناجحة الوحيد. |
conversionDateTime |
تاريخ وقت حدوث الإحالة الناجحة. يجب أن يقع بعد وقت المكالمة. يجب تحديد المنطقة الزمنية. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00". |
conversionValue |
قيمة الإحالة الناجحة للمعلِن. |
currencyCode |
العملة المرتبطة بقيمة الإحالة الناجحة. هذا هو رمز العملة المكوّن من 3 أحرف وفقًا لمعيار ISO 4217. على سبيل المثال: SAR أو EUR. |
CallConversionResult
تحديد معلومات عملية تحميل إحالة ناجحة للمكالمات التي تمت معالجتها بنجاح
تمثيل JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
الحقول | |
---|---|
callerId |
رقم المتصل الذي تم إجراء هذه المكالمة منه. من المتوقع أن يكون معرف المتصل بتنسيق E.164 مع علامة "+" السابقة. |
callStartDateTime |
تاريخ وقت المكالمة التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00". |
conversionAction |
اسم المورد لإجراء الإحالة الناجحة المرتبط بهذه الإحالة الناجحة. |
conversionDateTime |
تاريخ وقت حدوث الإحالة الناجحة. التنسيق هو "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00". |