במסמך הזה מוסבר איך משתמשים ב-Management API כדי לנהל קהלים לרימרקטינג ב-Google Analytics.
מבוא
ממשק ה-API לניהול מאפשר לך create
, get
, delete
, list
, update
ו-patch
קהלים לרימרקטינג עבור נכס ב-Google Analytics. כדי לקבל מידע נוסף על אופן הפעולה של קהלים לרימרקטינג, מומלץ לעיין במאמר מידע על קהלים לרימרקטינג ב-Analytics במרכז העזרה.
תרחישים לדוגמה
המשאב 'קהל לרימרקטינג' תומך בקבלה, במחיקה, ברשימה, בתיקון ובעדכון, אבל התרחישים העיקריים לדוגמה הם:
הצגת רשימה של קהלים לרימרקטינג
כדי להציג רשימה של כל הקהלים לרימרקטינג בנכס מסוים:
- מאחזרים את
accountId
ו-webPropertyId
באמצעות Management API או Account Explorer. - מפעילים את השיטה
list
של משאב הקהלים לרימרקטינג.
עיין בחומרי העזר ל-API לקבלת פרטים על השיטה list
עבור המשאב קהל לרימרקטינג.
יצירת קהל חדש לרימרקטינג
כדי ליצור קהל חדש לרימרקטינג בנכס:
- משתמשים ב-Management API או ב-Account Explorer כדי לאחזר את
accountId
ואתwebPropertyId
. - משתמשים ב-Management API או ב-Account Explorer כדי לאחזר את מזהה התצוגה המפורטת (הפרופיל) של הנכס
linkedViews []
. - אפשר להשתמש באוסף קישורים ל-Google Ads כדי לאחזר מספר חשבון Google Ads עבור
linkedAdAccounts.linkedAccountId
.- הנכס
linkedAdAccounts[]
מוגבל כרגע ל-linkedForeignAccount
אחד בלבד. - אפשר להגדיר את
linkedAdAccounts[].type
ל-ADWORDS_LINKS
, ל-DBM_LINKS
, ל-MCC_LINKS
או ל-OPTIMIZE
.
- הנכס
- באוסף פלחים יש אפשרויות להגדרת המאפיין
segment
שלincludeConditions
. אם יוצרים קהל מבוסס-מצב, צריך לעשות זאת עבורexcludeConditions
. בנוסף, אפשר לעיין בחומר העזר בנושא פלחים כדי להגדיר פלח.- ל-
includeConditions
יכולים להיות ערכים עבורmembershipDurationDays
ו-daysToLookBack
- אפשר גם להגדיר את
excludeConditions.exclusionDuration
לערךPERMANENT
.
- ל-
- מפעילים את השיטה
insert
של המשאב 'קהל לרימרקטינג'.
ה-API מאפשר ליצור שני סוגי קהלים: SIMPLE
ו-STATE_BASED
. עבור קהלים עם SIMPLE
צריך ליצור את audienceDefinition
רק עם segment
חיובי, ללא אופרטור NOT (התו !
). אם רוצים לכלול תנאי להחרגה, צריך להגדיר statebasedDefinition
. מידע נוסף זמין במאמר קהלים מבוססי מצב. פרטים נוספים זמינים בדוגמה הבאה.
עדכון קהל קיים לרימרקטינג
כדי לעדכן קהל קיים לרימרקטינג בנכס:
- אם כבר הגדרתם את מזהה הקהל לרימרקטינג, תוכלו להתקשר אל
get
. לחלופין, אתם יכולים להתקשר אלlist
ולבחור את הקהל שרוצים לעדכן. - מעדכנים כל אחד מהשדות שניתנים לכתיבה וקוראים ל-
update
העברה של אובייקט הקהל המעודכן.