דיווח על יעדים של קמפיינים וקבוצות מודעות

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מספק גמישות משופרת ליצירה של דוחות בהתאמה אישית ולשילוב הנתונים באפליקציות הדיווח ותהליכים. מידע נוסף על המעבר לממשק החדש של Search Ads 360 ועל השימוש בו API.

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

יש סוגים של יעדים שאפשר להחיל רק על קמפיינים ואילו אחרות יכולות לחול רק על קבוצות מודעות. כדי לראות אילו יעדים זמינים בכל רמה, לעיין במסמכי התיעוד עבור campaignTarget ו-adGroupTarget דוחות.

אתם יכולים לבקש דוחות שבהם מוצגים מדדי ביצועים לסוגים ספציפיים של יעדים. עבור לדוגמה, אם מפרסם מטרגט קמפיין למיקומים גיאוגרפיים, צריך לכלול את עמודה אחת (locationTargetName) ב campaignTarget בקשה. כשמאחזרים את הדוח שנוצר, אפשר לראות את ביצועי הקמפיין לכל מיקום מטורגט.

יעדים שליליים

יעדים שליליים מונעים את הצגת המודעות כשחיפושים תואמים לקריטריונים ספציפיים. בדומה ליעדים, סוגים מסוימים של יעדים שליליים אפשר להחיל רק על קמפיינים ואילו אחרות יכולות לחול רק על קבוצות מודעות. צפייה negativeCampaignTarget ו-negativeAdGroupTarget לקבלת פרטים.

אפשר לבקש דוחות שבהם יוצגו הקריטריונים שלפיהם יעדים שליליים משתמשים כדי להחריג מודעות. עבור למשל, אם מפרסם משתמש ביעדים שליליים כדי למנוע מקמפיין להציג מודעות מיקומים גיאוגרפיים ספציפיים, אפשר לכלול את העמודה locationTargetName negativeCampaignTarget בקשה. כשמאחזרים את הדוח שנוצר, אפשר לראות את רשימת המיקומים לא נכלל בקמפיין.

דוגמאות לבקשות

הנה דוגמאות לבקשות לסוגים שונים של יעדים:

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

דיווח על מיקומים גיאוגרפיים לטירגוט בקמפיין

הדוגמה הבאה בקשה אסינכרונית מחזירה את מספר הקליקים, החשיפות ונתונים אחרים עבור מיקומים גיאוגרפיים לטירגוט (מדווח על מיקומים גיאוגרפיים לטירגוט זמינים רק בקמפיינים ב-Google Ads). ב-Search Ads 360 יש תמיכה בכמה סוגים של מיקומים גיאוגרפיים לטירגוט, כמו מיקומים גיאוגרפיים לטירגוט, יעדי קירבה, וגם יעדי רדיוס לתוספי מיקום של Google Ads, והדוחות של מיקומים גיאוגרפיים לטירגוט מכילים נתונים על כל הסוגים של המיקומים הגיאוגרפיים לטירגוט ייושמו בהיקף הדוח.

דוגמה לבקשה

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

דוח לדוגמה

הנה דוגמה לדוח campaignTarget. בדוח מוצגים הביצועים של יעד של מיקום גיאוגרפי שמציין את "US", יעד קירבה שמציין " 100.0 miles מסביב (37.4220041,-122.0862462)", ויעד נוסף של מיקום גיאוגרפי שמציין מיקוד בארה"ב (90210):

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

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

הדוגמה הבאה בקשה אסינכרונית מחזירה את מספר הקליקים, החשיפות ונתונים אחרים עבור כל יעדי הרימרקטינג שהוגדרו לקבוצות של מודעות בקמפיין Google Ads ספציפי.

דוגמה לבקשה

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

דוח לדוגמה

הנה דוגמה לדוח adGroupTarget. הדוח מראה כי את קבוצות המודעות בקטע "אביזרים". מגדירים יעדים לרימרקטינג. מדדי ביצועים עבור כל יעד רימרקטינג נכלל גם:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

יעדים של מודעות דינמיות לכל הקבוצות של המודעות בחשבון

יעד של מודעה דינמית מגדיר את הדפים באתר שאתם רוצים לפרסם. עם מודעות דינמיות לרשת החיפוש. (יעדים של מודעות דינמיות זמינים רק בחשבונות מנוע חיפוש ב-Google Ads, והם תמיד נוצרים בקבוצות מודעות ספציפיות). Google משתמשת באינדקס החיפוש כדי לקבוע מתי החיפוש של הלקוחות רלוונטי לכל הדפים שתואמים ליעדי המודעות הדינמיות. אם בחיפוש רלוונטית, Google מציגה מודעה דינמית לרשת החיפוש שהגדרתם באותה קבוצת מודעות כמו את היעדים.

הדוגמה הבאה בקשה אסינכרונית מחזירה את מספר הקליקים, החשיפות ונתונים אחרים עבור כל יעדי המודעות הדינמיות שהוגדרו לקבוצות של מודעות בחשבון מנוע חיפוש.

דוגמה לבקשה

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

דוח לדוגמה

הנה דוגמה לדוח adGroupTarget. הדוח מראה קבוצת המודעות ב-Google Stores מגדיר יעד של מודעה דינמית. מדדי ביצועים עבור היעד נכלל גם הוא:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

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

הדוגמה הבאה בקשה אסינכרונית מחזירה את המיקומים שהוחרגו מהקמפיינים בחשבון מנוע חיפוש (הדיווח מופעל על מיקומים גיאוגרפיים שליליים לטירגוט זמינים רק בקמפיינים ב-Google Ads). מיקומים גיאוגרפיים שליליים לטירגוט להשתמש רק במיקומים גיאוגרפיים לטירגוט בתור קריטריונים (הם לא יכולים לציין יעדי קירבה או יעדים ברדיוס). לכן הדוחות של מיקומים גיאוגרפיים שליליים מכילים רק את רשימת המיקומים הגיאוגרפיים לא נכללים בקמפיינים שנכללים בהיקף הדוח.

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

דוגמה לבקשה

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

דוח לדוגמה

הנה דוגמה לדוח negativeCampaignTarget. הדוח מראה "הפתיחה הגדולה – נברסקה" לא כולל את מדינת מיין, "אירועי פתיחה גדולה – מערב" הקמפיין אינו כולל את מדינת קליפורניה:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA