تجربة

تُخصِّص التجربة الجديدة من "إعلانات شبكة البحث 360" أرقام تعريف جديدة لحسابات المستخدِمين والحملات والمجموعات الإعلانية والكلمات الرئيسية (المعايير) والإعلانات. هناك تغييران إضافيان في السلوك لهذه المعرّفات:

  • في التجربة الجديدة من "إعلانات شبكة البحث 360"، يتم تخصيص رقم تعريفي فريد للعميل على مستوى العالم للحسابات الإدارية وحسابات المدراء الفرعيين وحسابات العملاء، وتُعرف رسميًا باسم حسابات الوكالات والمعلِنين وحسابات محرّكات البحث، على التوالي.

  • لم تعُد التجربة الجديدة من "إعلانات شبكة البحث 360" تحدّد معرّفات فريدة للكلمات الرئيسية والإعلانات.

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

عند استخدام رقم تعريف جديد لخدمة "إعلانات شبكة البحث 360" في طلبك، سيستخدم الرد أيضًا أرقام تعريف التجربة الجديدة من "إعلانات شبكة البحث 360".

إدراج الإحالات الناجحة

هناك نقطة نهاية جديدة لطلب القائمة باستخدام رقم تعريف "إعلانات شبكة البحث 360" الجديد. يجب تقديم الرقم التعريفي للعميل الخاص بحساب العميل. ولا يزال بإمكانك أيضًا تحديد رقم تعريف الحملة ورقم تعريف المجموعة الإعلانية لإدراجهما في مَعلمات طلب البحث. ولا تزال النماذج endDate وrowCount وstartDate وstartRow مطلوبة.

طلب HTTP

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

إدراج/تعديل إحالة ناجحة

نتيح الطلب التالي باستخدام رقم تعريف التجربة الجديدة من "إعلانات شبكة البحث 360":

  • ربط الإحالة الناجحة بكلمة رئيسية وإعلان
  • تحديد مصدر الإحالة الناجحة لكلمة رئيسية فقط
  • تعديل الإحالة الناجحة باستخدام criterionId (رقم تعريف الكلمة الرئيسية) المحدّد للإحالة الناجحة

لا تزال نقاط النهاية كما هي. يجب توفير رقم تعريف التجربة الجديدة من "إعلانات شبكة البحث 360" في كل مورد إحالة ناجحة: بدلاً من إعداد agencyId وadvertiserId وengineAccountId، يجب تقديم customerId واستخدام رقم تعريف "إعلانات شبكة البحث 360" الجديد في campaignId وadGroupId وcriterionId وadId عند الضرورة.

في ما يلي مثال على طلب لكيفية استخدام رقم تعريف التجربة الجديدة من "إعلانات شبكة البحث 360" لإسناد إحالة ناجحة إلى كلمة رئيسية.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}
    

تحديد مدى التوفّر

يمكنك أيضًا استخدام رقم تعريف التجربة الجديدة من "إعلانات شبكة البحث 360" Conversion.updateAvailability() . يجب استخدام رقم تعريفي للعميل خاص بحساب مدير فرعي. يُرجى الاطّلاع على المثال أدناه:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}