כל הבקשות אל AudienceInsightsService כפופות להגבלת קצב של יצירת בקשות. אפשר לשלוח פחות בקשות ביום ל-generateAudienceCompositionInsights ול-generateSuggestedTargetingInsights מאשר לשיטות אחרות של מדדי קהלים. פרטים נוספים זמינים במאמר מכסות ל-API.
AudienceInsightsService מאפשר לכם לשלב את נתוני מדדי הקהלים של Google בכלי התכנון שלכם. הנתונים עוזרים לסוכנויות מדיה ול-Media Planners להבין טוב יותר את קהל היעד שלהם, כולל נתונים דמוגרפיים, תחומי עניין והתנהגות אונליין.
מדדי קהלים מספקים סקירה כללית איכותית שעוזרת לכם להסיק מסקנות על קהל, קטגוריה, נושא או מותג. ניתוח התנהגויות של משתמשים שקשורות לנושאים שונים מאפשר לכם להשתמש במדדי הקהלים האלה כדי לקבל עוד מידע על ההקשרים שהצרכנים עושים ועל התפיסות שלהם, ולזהות פלחים חדשים של קהל היעד.
ה-API תומך בשלושה תרחישי שימוש עיקריים:
- לחדד ולגלות קהלים: להבין את תחומי העניין וההתנהגויות הייחודיים של הצרכנים כדי לזהות קהלים חדשים למותג, לפתח פרסונות של קהלים ולחדד את האסטרטגיות לפילוח קהלים.
- תכנון קמפיינים: אתם יכולים להשתמש בנתונים כדי ליצור קהלי יעד ב-YouTube, להעריך את פוטנציאל החשיפה של קהלי היעד ולמדוד את החפיפה בין פלחים של קהל היעד כדי למקסם את פוטנציאל החשיפה של הקמפיין.
- לפתח מסרים של קריאייטיב: התאימו את המסרים של הקריאייטיב לקהל היעד על סמך הנושאים ותחומי העניין שהם מתעניינים בהם הכי הרבה.
דרישות סף
כדי לעמוד בדרישות של AudienceInsightsService, השותפים צריכים לעמוד בתנאים הבאים:
- כבר יש לכם גישה ל-Insights Finder או שאתם עומדים בדרישות לקבלת גישה.
- יש לכם כלי תכנון או ממשק משתמש שמשלב את ה-API.
- משתמשים ב-API למטרות של תכנון מדיה או לתרחישים רלוונטיים אחרים.
- מבצעים הערכה מקדימה.
- לעמוד בדרישות לגבי השימוש בנתונים ולעבור ביקורות נתונים תקופתיות.
- מאשרים את התנאים וההגבלות של Google Ads API ואת מדיניות השימוש בנתונים שקשורה אליהם.
למידע נוסף, אפשר לפנות לנציג Google.
התאריכים שבהם אפשר לקבל תובנות לגבי הרשימה
תהליך עבודה אופייני מתחיל בבדיקה של החודשים הקלנדריים וחלונות התאריכים שזמינים לניתוח. ה-method listInsightsEligibleDates מחזירה את ListInsightsEligibleDatesResponse, שהשדה data_months שלו מפרט את החודשים (בפורמט YYYY-MM) שבהם נתוני מדדי הקהלים זמינים.
השדה last_thirty_days בתשובה מכיל את טווח התאריכים המדויק שבו generateAudienceCompositionInsights משתמש כשלא מגדירים את data_month בבקשה.
הצגת מאפיינים של מדדי קהלים
לפני ששולחים שאילתות לגבי מדדים של חפיפה או הרכב קהל, צריך למצוא מזהי מאפיינים תקינים באמצעות listAudienceInsightsAttributes. השיטה הזו מחזירה ListAudienceInsightsAttributesResponse שמכיל את המאפיינים הזמינים של המאפיינים המבוקשים.
לדוגמה, אם המאפיין AFFINITY_USER_INTEREST נבחר בבקשה, השיטה מחזירה קהלים נתמכים עם תחום עניין משותף, כמו "חובבי ספורט" או "אוהבי מוזיקה". מאפיינים נתמכים אחרים של תחומי עניין של משתמשים כוללים את IN_MARKET_USER_INTEREST ו-LIFE_EVENT_USER_INTEREST. אפשר להגדיר כמה מאפיינים בבקשה אחת. רשימה מלאה של המאפיינים הנתמכים מופיעה בחומר העזר בנושא שדות dimensions.
כשמחפשים ישויות (נושאים) ב-Knowledge Graph באמצעות המאפיין KNOWLEDGE_GRAPH, צריך לספק שאילתת מחרוזת בשדה query_text (לדוגמה, "football and the World Cup").
אפשר גם להוסיף knowledge_graph_entity_search_options כדי להתאים אישית את החיפוש לפי נושא:
- סינון לפי יכולות: אפשר להשתמש ב-
search_filterכדי לצמצם את הישויות שאוחזרו רק לאלה שתומכות ביכולות ספציפיות. לדוגמה, כדי לסנן לפי נושאים שנתמכים כמאפייני יוצרים, צריך להזיןCREATOR_ATTRIBUTEבשדהentity_capability_filters. אפשר לספק כמה יכולות, והן משולבות באמצעות לוגיקתOR. - אחזור כל מאפייני היוצר: מגדירים את
get_all_creator_attributesלערךtrueכדי לאחזר את כל הישויות הזמינות ב-Knowledge Graph שמתויגות כמאפייני יוצר. כשמשתמשים באפשרות הזו, צריך לבחור את המאפייןKNOWLEDGE_GRAPH, השדהquery_textצריך להיות ריק ואי אפשר לשלב את האפשרות הזו עםsearch_filter.
אפשר להשתמש במאפיינים שמוחזרים על ידי שיטת הגילוי הזו כקלט לשיטות אחרות של AudienceInsightsService.
כל אובייקט AudienceInsightsAttributeMetadata ב-ListAudienceInsightsAttributesResponse מספק ייצוג מובנה של מאפיין קהל, לצד מאפיינים תיאוריים ומדדי התעניינות.
הוא כולל את ההגדרה הראשית של המאפיין, השם המוצג, סוג המאפיין ופוטנציאל החשיפה המשוער. הגדרות השדות מפורטות בחומרי העזר של AudienceInsightsAttributeMetadata.
יצירת הגדרת קהל
השיטה generateAudienceDefinition מתרגמת תיאור טקסט חופשי של קהל להצעות מובנות למאפייני קהל, שאפשר להעביר לשיטות תובנות במורד הזרם.
יצירת תובנות לגבי הצעות לטירגוט
ה-method generateSuggestedTargetingInsights מחזירה אוסף של תובנות טירגוט (כמו פלחים של קהל היעד שאפשר לטרגט) שרלוונטיות לקהל המבוקש.
אפשר לציין את הקהל המבוקש בתור InsightsAudienceDefinition מובנה או בתור תיאור טקסט ב-InsightsAudienceDescription.
השדה generateAudienceCompositionInsights מחזיר תובנות לגבי פלחים של מאפיינים ספציפיים, והשדה generateSuggestedTargetingInsights מחזיר הצעות מקובצות לפלחי קהל ב-Google Ads שאפשר לטרגט. השיטה הזו עוזרת לענות על שאלות כמו "תן לי הצעות לקהלים שאפשר לטרגט, שכוללים אבות בשנות ה-30 לחייהם שאוהבים לדוג".
יצירת מדדים להצעות טירגוט
השיטה generateTargetingSuggestionMetrics מחזירה את הערך GenerateTargetingSuggestionMetricsResponse, שמכיל את נתח המשתמשים ב-YouTube שאפשר להגיע אליו בכל הגדרת קהל שביקשתם ב-GenerateTargetingSuggestionMetricsRequest.
השיטה הזו עוזרת לענות על שאלות כמו "כמה גברים בני 18 ומעלה שמתעניינים בקמפינג בארצות הברית אפשר להגיע אליהם ב-YouTube?"
יצירת תובנות לגבי הרכב הקהל
ה-method generateAudienceCompositionInsights מחזירה את GenerateAudienceCompositionInsightsResponse, שמכיל רשימה של מאפיינים שמייצגים את הקהל הרצוי, יחד עם מדדי אינדקס ונתח שמשווים את הנתח של כל מאפיין בקהל לאוכלוסיית בסיס.
צריך לציין מדינת יעד לקהל. רשימת המאפיינים הנתמכים לאחזור תובנות לגבי הרכב הקהל מתועדת בשדה dimensions של GenerateAudienceCompositionInsightsRequest.
השיטה הזו עוזרת לענות על שאלות כמו "מהן קבוצות העניין המובילות שקהל היעד שלי מתעניין בהן בהשוואה לאוכלוסייה הכללית, ועד כמה סביר שהם יתעניינו בקבוצות העניין האלה?"
יצירת תובנות לגבי חפיפה בין קהלים
ה-method generateAudienceOverlapInsights מחזירה GenerateAudienceOverlapInsightsResponse, שמכיל רשימה של מאפייני קהל עם אומדנים של החפיפה בין פוטנציאל החשיפה שלהם ב-YouTube לבין פוטנציאל החשיפה של מאפיין ראשי.
צריך לציין מדינת יעד ומאפיין ראשי. אפשר להשתמש בטווח גילאים, מגדר, פלחי קהל עם תחום עניין משותף ופלחים עם כוונת רכישה בתור מאפייני קהל.
השיטה הזו עוזרת לענות על שאלות כמו "מהו גודל הקהל המצטבר כשמטרגטים גם אוהדי ספורט וגם חובבי מוזיקה בארצות הברית?"
יצירת דוח Insights Finder
ה-method generateInsightsFinderReport יוצרת דוח שמור ב-Insights Finder על סמך הקלט שצוין ב-GenerateInsightsFinderReportRequest, ומחזירה GenerateInsightsFinderReportResponse שמכיל קישור עם גישה חיצונית לפתיחת הדוח בממשק המשתמש של Insights Finder.
Google Issue Tracker
אתם יכולים להשתמש ב-Google Issue Tracker כדי לשאול שאלות תמיכה, לדווח על באגים או להגיש בקשה להוספת תכונה. Google עוקבת אחרי הבקשות, מתעדפת אותן ומפרסמת עדכונים לגביהן ישירות ב-Issue Tracker. למידע נוסף, קראו את המאמר דיווח על בעיה ב-Google Issue Tracker.
יוצרים בעיה באמצעות אחת מהתבניות הבאות של Issue Tracker:
- שליחת שאלה כללית לתמיכה או שליחת משוב על מסמכי העזרה
- דיווח על באג טכני
- שליחת בקשה להוספת תכונה ל-API
מלאו את כל השדות בתבנית במידע מפורט כדי ש-Google תוכל לשחזר את הבקשה ולתעדף אותה. יכול להיות ש-Google תסגור דוחות חלקיים ותבקש מכם לשלוח דיווח חדש עם הפרטים החסרים.