دليل المطوّر لشرائح جمهور تجديد النشاط التسويقي

يوضِّح هذا المستند كيفية استخدام Management API لإدارة شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google".

مقدمة

تسمح لك واجهة برمجة تطبيقات الإدارة بـ create وget وdelete وlist وupdate وpatch شريحة جمهور تجديد نشاط تسويقي لموقع على "إحصاءات Google". لمعرفة المزيد من المعلومات عن آلية عمل شرائح جمهور تجديد النشاط التسويقي، يُرجى الاطّلاع على مقالة لمحة عن شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google" في مركز المساعدة.

حالات الاستخدام

يتيح مورد جمهور تجديد النشاط التسويقي الحصول على وحذف وقائمة وتصحيح وتحديث، لكن حالات الاستخدام الرئيسية هي:

سرد شرائح جمهور تجديد النشاط التسويقي

لإدراج جميع شرائح جمهور تجديد النشاط التسويقي لأحد المواقع:

  1. استخدِم Management API أو Account Explorer لاسترداد بيانات accountId وwebPropertyId.
  2. نفِّذ طريقة list لمورد شرائح جمهور تجديد النشاط التسويقي.

اطّلع على مرجع واجهة برمجة التطبيقات للحصول على تفاصيل عن طريقة list لمورد جمهور تجديد النشاط التسويقي.

إنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي

لإنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي لأحد المواقع:

  1. استخدِم Management API أو Account Explorer لاسترداد accountId وwebPropertyId.
  2. استخدِم واجهة برمجة تطبيقات الإدارة أو مستكشف الحساب لاسترداد رقم تعريف الملف الشخصي (الملف الشخصي) للموقع linkedViews [].
  3. استخدِم مجموعة روابط "إعلانات Google" لاسترداد رقم تعريف حساب "إعلانات Google" للسمة linkedAdAccounts.linkedAccountId.
    • تقتصر السمة linkedAdAccounts[] حاليًا على linkedForeignAccount واحدة فقط.
    • ويمكن ضبط سمة linkedAdAccounts[].type على ADWORDS_LINKS أو DBM_LINKS أو MCC_LINKS أو OPTIMIZE.
  4. استخدِم مجموعة الشرائح لخيارات ضبط السمة segment في includeConditions. وفي حال إنشاء شريحة جمهور مستندة إلى الحالة، عليك اتّخاذ الإجراء نفسه مع excludeConditions. راجع أيضًا مرجع الشرائح لتعريف شريحة.
    • يمكن أن يحتوي includeConditions اختياريًا على قيم للسمتَين membershipDurationDays وdaysToLookBack.
    • يمكن ضبط excludeConditions.exclusionDuration اختياريًا على PERMANENT.
  5. نفِّذ طريقة insert لمورد جمهور تجديد النشاط التسويقي.

تسمح لك واجهة برمجة التطبيقات بإنشاء نوعَين من شرائح الجمهور: SIMPLE وSTATE_BASED. بالنسبة إلى SIMPLE من شرائح الجمهور، تحتاج فقط إلى إنشاء audienceDefinition مع segment موجبة، بدون عامل التشغيل NOT (الحرف !). إذا كنت تريد تضمين شرط استثناء، عليك تحديد statebasedDefinition. لمزيد من المعلومات، راجِع شرائح الجمهور المستندة إلى الولاية. راجع المثال المرجعي للاطّلاع على التفاصيل.

تعديل شريحة جمهور حالية لتجديد النشاط التسويقي

لتعديل شريحة جمهور حالية لتجديد النشاط التسويقي لأحد المواقع:

  1. إذا كان لديك رقم تعريف جمهور تجديد النشاط التسويقي، يمكنك الاتصال به get، وبخلاف ذلك، يمكنك استدعاء list واختيار الجمهور الذي تريد تعديله.
  2. عدِّل أيًّا من الحقول القابلة للكتابة واستدعِ update تمرير عنصر الجمهور المعدّل.