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

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

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

מבוא

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

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

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

• רשימת קהלים לרימרקטינג.
• יוצרים קהל חדש לרימרקטינג.
• עדכון קהל קיים לרימרקטינג.

הערה: הקהלים לרימרקטינג יישארו ריקים וייתכן שהקמפיינים לרימרקטינג לא יפעלו אם לא תפעילו את התג כדי לאסוף את הנתונים המתאימים. כדי להתחיל, צריך להפעיל את תכונות הפרסום בהגדרות הנכס ב-Google Analytics.

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

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

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

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

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

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

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. מידע נוסף זמין במאמר קהלים מבוססי מצב. פרטים נוספים זמינים בדוגמה שבדוגמה.

הערה: אפשר להגדיר audienceDefinition או stateBasedAudienceDefinition ולהגדיר את audienceType לערך המתאים. קיימת גם מגבלה של 2,000 קהלים לרימרקטינג. יש להפעיל שיקול דעת בעת יצירת קהלים לרימרקטינג.

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

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

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

הערה: אחרי שיוצרים קהל, לא ניתן לשנות את ה-audienceType שלו. במילים אחרות, אם לקהל היה ערך של audienceDefinition, אי אפשר לקרוא לעדכון עם ערך של stateBasedAudienceDefinition. למידע נוסף ראו את המאמר קהלים מבוססי מצב. פרטים נוספים זמינים בדוגמה שבדוגמה.