يوضِّح هذا المستند كيفية استخدام Management API لإدارة شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google".
مقدمة
تسمح لك Management API بشرائح جمهور تجديد النشاط التسويقي create
وget
وdelete
وlist
وupdate
وpatch
لموقع على "إحصاءات Google". لمعرفة المزيد من المعلومات عن آلية عمل شرائح جمهور تجديد النشاط التسويقي، يمكنك الاطّلاع على مقالة لمحة عن شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google" في مركز المساعدة.
حالات الاستخدام
يتيح مورد جمهور تجديد النشاط التسويقي إمكانية الحصول على وحذف وإدراج وتصحيح وتحديث، ولكن حالات الاستخدام الرئيسية هي:
- إدراج شرائح جمهور تجديد النشاط التسويقي.
- إنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي:
- تعديل شريحة جمهور حالية لتجديد النشاط التسويقي:
إدراج جماهير تجديد النشاط التسويقي
لإدراج جميع شرائح جمهور تجديد النشاط التسويقي لأحد المواقع:
- استخدِم Management API أو Account Explorer لاسترداد بيانات
accountId
وwebPropertyId
. - نفِّذ طريقة
list
لمورد شرائح جمهور تجديد النشاط التسويقي.
اطّلِع على مرجع واجهة برمجة التطبيقات لمعرفة تفاصيل عن طريقة list
في ما يتعلق بمورد جمهور تجديد النشاط التسويقي.
إنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي
لإنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي لأحد المواقع:
- استخدِم واجهة برمجة تطبيقات الإدارة أو مستكشف الحساب لاسترداد
accountId
وwebPropertyId
. - استخدِم واجهة برمجة تطبيقات الإدارة أو مستكشف الحساب لاسترداد رقم تعريف الملف الشخصي (الملف الشخصي) للموقع
linkedViews []
. - استخدِم مجموعة روابط "إعلانات Google" لاسترداد رقم تعريف حساب "إعلانات Google" من أجل
linkedAdAccounts.linkedAccountId
.- تقتصر السمة
linkedAdAccounts[]
حاليًا علىlinkedForeignAccount
واحدة فقط. - ويمكن ضبط السمة
linkedAdAccounts[].type
علىADWORDS_LINKS
أوDBM_LINKS
أوMCC_LINKS
أوOPTIMIZE
.
- تقتصر السمة
- استخدِم مجموعة الشرائح لخيارات ضبط السمة
segment
فيincludeConditions
، وإذا أنشأت شريحة جمهور مستندة إلى الحالة، عليك تنفيذ الإجراء نفسه معexcludeConditions
. ويمكنك أيضًا الاطّلاع على مرجع الشرائح لتعريف شريحة.- يمكن أن يحتوي الحقل "
includeConditions
" على قيمتَين للسمتَينmembershipDurationDays
وdaysToLookBack
اختياريًا. - ويمكن ضبط
excludeConditions.exclusionDuration
بشكل اختياري علىPERMANENT
.
- يمكن أن يحتوي الحقل "
- نفِّذ طريقة
insert
لمورد جمهور تجديد النشاط التسويقي.
تسمح لك واجهة برمجة التطبيقات بإنشاء نوعَين من شرائح الجمهور: SIMPLE
وSTATE_BASED
. بالنسبة إلى شرائح جمهور SIMPLE
، تحتاج فقط إلى إنشاء audienceDefinition
مع segment
إيجابي، بدون عامل التشغيل NOT (الحرف !
). إذا أردت تضمين شرط استثناء، عليك تحديد statebasedDefinition
. اطّلِع على شرائح الجمهور المستندة إلى الولاية لمزيد من المعلومات. اطّلِع على المثال المرجعي لمعرفة التفاصيل.
تعديل شريحة جمهور حالية لتجديد النشاط التسويقي
لتعديل شريحة جمهور حالية لتجديد النشاط التسويقي لأحد المواقع:
- إذا كان لديك رقم تعريف جمهور تجديد النشاط التسويقي، يمكنك الاتصال به
get
، وإلّا يمكنك استدعاءlist
واختيار الجمهور الذي تريد تعديله. - عدِّل أيًّا من الحقول القابلة للكتابة واستدعِ
update
ليتم تمرير عنصر الجمهور المعدّل.