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

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

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

מבוא

באמצעות Management API אפשר create, get, delete, list, update ו-patch קהלים לרימרקטינג בנכס Google Analytics. מידע נוסף על אופן הפעולה של קהלים לרימרקטינג זמין במאמר מידע על קהלים לרימרקטינג ב-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 Links כדי לאחזר מספר חשבון 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. מידע נוסף זמין במאמר קהלים מבוססי-מצב. בדוגמה תוכלו למצוא פרטים נוספים.