إعداد تقرير عن أهداف الحملة والمجموعة الإعلانية

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن توفر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات إعداد التقارير والعمليات. مزيد من المعلومات عن نقل البيانات إلى التجربة الجديدة من "إعلانات شبكة البحث 360" واستخدامها API.

الاستهدافات هي معايير لعرض الإعلانات استنادًا إلى الموقع الجغرافي والخصائص الديمغرافية الخصائص الأخرى لطلب البحث. على سبيل المثال، يمكن للمعلن استهداف إعلانات الحملة لتظهر فقط في نيويورك وبوسطن وشيكاغو. أو يمكن للمعلن زيادة عروض أسعار عمليات البحث التي يجريها أفراد شريحة جمهور معيّنة من الجمهور، ما يؤدي إلى زيادة احتمال أن الإعلان سيظهر للجمهور.

يمكن تطبيق بعض أنواع الاستهدافات على الحملات فقط بينما يمكن تطبيق البعض الآخر على المجموعات الإعلانية فقط لمعرفة الاستهدافات المتاحة في كل مستوى، يمكنك الرجوع إلى وثائق campaignTarget وadGroupTarget التقارير.

يمكنك طلب تقارير تعرض مقاييس الأداء لأنواع محدّدة من الأهداف. بالنسبة على سبيل المثال، إذا استهدف أحد المعلنين مواقع جغرافية بحملة معيّنة، فعليك تضمين عمود "locationTargetName" في campaignTarget طلبك. عند استرجاع التقرير الذي تم إنشاؤه، يمكنك الاطّلاع على مستوى أداء الحملة في كل موقع جغرافي مستهدف.

أهداف سلبية

تمنع الأهداف السلبية ظهور الإعلانات عند مطابقة عمليات البحث لمعايير محدّدة. على غرار الاستهدافات، يمكن تطبيق بعض أنواع الاستهدافات السلبية على الحملات فقط. بينما يمكن تطبيق البعض الآخر على المجموعات الإعلانية فقط عرض negativeCampaignTarget وnegativeAdGroupTarget لمزيد من التفاصيل.

يمكنك طلب التقارير للاطّلاع على المعايير التي تستخدمها الاستهدافات السلبية لاستبعاد الإعلانات. بالنسبة على سبيل المثال، إذا استخدم أحد المعلنين أهدافًا سلبية لمنع الحملة من عرض إعلانات في مواقع جغرافية محددة، ضمِّن العمود locationTargetName في negativeCampaignTarget طلبك. عند استرداد التقرير الذي تم إنشاؤه، يمكنك الاطّلاع على قائمة المواقع الجغرافية استبعادهم من الحملة.

أمثلة على الطلبات

في ما يلي أمثلة على طلبات لأنواع مختلفة من الاستهدافات:

إعداد تقرير عن المواقع الجغرافية المستهدفة في إحدى الحملات

المثال التالي طلب غير متزامن عدد النقرات ومرات الظهور وبيانات أخرى للمواقع الجغرافية المستهدفة (إعداد تقارير عن لا تتوفر المواقع الجغرافية المستهدفة إلا للحملات على "إعلانات Google"). تتوافق "إعلانات شبكة البحث 360" مع بضعة أنواع من المواقع الجغرافية المستهدفة، مثل المواقع الجغرافية المستهدفة الأهداف القريبة استهدافات المواقع الجغرافية المحدّدة لإضافات المواقع الجغرافية على "إعلانات Google" وتقارير المواقع الجغرافية المستهدفة بيانات لجميع أنواع المواقع الجغرافية المستهدفة التي تطبيقها في نطاق التقرير.

مثال على الطلب

{
  "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 ميلاً حول (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".

مثال على الطلب

{
  "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" ويتم إنشاؤها دائمًا في مجموعات إعلانية محددة). يستخدم محرّك بحث 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" على تحديد استهداف إعلان ديناميكي. مقاييس الأداء في يتم أيضًا تضمين الهدف:

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"). المواقع الجغرافية المستهدفة السلبية استخدام الاستهدافات الجغرافية للمواقع الجغرافية فقط معايير (لا يمكنها تحديد أهداف التقارب) أو استهدافات النطاقات الجغرافية). لذلك، تحتوي تقارير المواقع الجغرافية السلبية على قائمة بالمواقع الجغرافية التي مستبعدة من الحملات ضمن نطاق التقرير.

تجدر الإشارة إلى أنّ طلب تقرير استهداف سلبي لا يحتاج إلى تحديد نطاق زمني. سلبي الإعدادات الحالية في التقارير دائمًا. على سبيل المثال، من الممكن طلب تقرير يُظهر الاستهدافات السلبية التي كانت مُستخدَمة خلال الربع الأخير.

مثال على الطلب

{
  "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