המדריך למפתחים בנושא קהלים לרימרקטינג

במסמך הזה מוסבר איך משתמשים ב-Management API כדי לנהל קהלים לרימרקטינג ב-Google Analytics.

מבוא

ממשק ה-API לניהול מאפשר לך create, get, delete, list, update ו-patch קהלים לרימרקטינג עבור נכס ב-Google Analytics. כדי לקבל מידע נוסף על אופן הפעולה של קהלים לרימרקטינג, מומלץ לעיין במאמר מידע על קהלים לרימרקטינג ב-Analytics במרכז העזרה.

תרחישים לדוגמה

המשאב 'קהל לרימרקטינג' תומך בקבלה, במחיקה, ברשימה, בתיקון ובעדכון, אבל התרחישים העיקריים לדוגמה הם:

הצגת רשימה של קהלים לרימרקטינג

כדי להציג רשימה של כל הקהלים לרימרקטינג בנכס מסוים:

  1. מאחזרים את accountId ו-webPropertyId באמצעות Management API או Account Explorer.
  2. מפעילים את השיטה list של משאב הקהלים לרימרקטינג.

עיין בחומרי העזר ל-API לקבלת פרטים על השיטה list עבור המשאב קהל לרימרקטינג.

יצירת קהל חדש לרימרקטינג

כדי ליצור קהל חדש לרימרקטינג בנכס:

  1. משתמשים ב-Management API או ב-Account Explorer כדי לאחזר את accountId ואת webPropertyId.
  2. משתמשים ב-Management API או ב-Account Explorer כדי לאחזר את מזהה התצוגה המפורטת (הפרופיל) של הנכס linkedViews [].
  3. אפשר להשתמש באוסף קישורים ל-Google Ads כדי לאחזר מספר חשבון Google Ads עבור 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 של המשאב 'קהל לרימרקטינג'.

ה-API מאפשר ליצור שני סוגי קהלים: SIMPLE ו-STATE_BASED. עבור קהלים עם SIMPLE צריך ליצור את audienceDefinition רק עם segment חיובי, ללא אופרטור NOT (התו !). אם רוצים לכלול תנאי להחרגה, צריך להגדיר statebasedDefinition. מידע נוסף זמין במאמר קהלים מבוססי מצב. פרטים נוספים זמינים בדוגמה הבאה.

עדכון קהל קיים לרימרקטינג

כדי לעדכן קהל קיים לרימרקטינג בנכס:

  1. אם כבר הגדרתם את מזהה הקהל לרימרקטינג, תוכלו להתקשר אל get. לחלופין, אתם יכולים להתקשר אל list ולבחור את הקהל שרוצים לעדכן.
  2. מעדכנים כל אחד מהשדות שניתנים לכתיבה וקוראים ל-update העברה של אובייקט הקהל המעודכן.