تعيين رقم التعريف لتجربة "إعلانات شبكة البحث 360" الجديدة

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

تختلف مساحة التعريفات في التجربة الجديدة من "إعلانات شبكة البحث 360" عن التجربة السابقة منها. للحصول على تعيين الأرقام التعريفية بين التجربتَين السابقة والجديدة من "إعلانات شبكة البحث 360"، أرسِل طلبًا باستخدام Reports.getIdMappingFile(). يتضمن الاستجابة تعيينات أرقام التعريف لمعظم الكيانات لمعلن محدّد. اطّلِع على الأسباب الشائعة لعدم توفّر الكيانات للتعرّف على مزيد من المعلومات عن سبب حذف عنصر من ملف الربط.

في ما يلي مثال على الملف الذي تم إرجاعه (بتنسيق CSV مُشفَّر بترميز UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

يتضمّن ملف CSV 3 أعمدة:

  • Entity Type: نوع العنصر لهذا الصف.

  • Legacy IDs: سلسلة JSON لمسار العنصر الكامل في التجربة السابقة من "إعلانات شبكة البحث 360"

  • New IDs: سلسلة JSON لمسار العنصر الكامل في التجربة الجديدة من "إعلانات شبكة البحث 360"

يعرض الجدول أدناه قائمة بالكيانات المتوافقة وأمثلة على عمليات ربط أرقام التعريف:

نوع الكيان الوصف المعرّفات القديمة أرقام تعريف جديدة
العميل تعيين الأرقام التعريفية لما يلي: لا تتوفّر عمليات ربط للمدراء والوكالات. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
الحملة تعيين أرقام التعريف للحملة 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP تعيين أرقام التعريف adGroup 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
المعيار ربط الأرقام التعريفية للمعايير على مستوى المجموعة الإعلانية: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
أندورا تعيين رقم التعريف للإعلان. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION ربط رقم التعريف للمعايير على مستوى الحملة: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP تعيين أرقام التعريف لمجموعة الحملات 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET تعيين رقم التعريف لهدف الأداء لمجموعة الحملات 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE تعيين أرقام التعريف لجدول الخلاصة 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM تعيين أرقام التعريف لعنصر feedItem 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

الأسباب الشائعة لعدم توفّر الكيانات

على الرغم من أنّ ملف الربط الخاص بالمعلِن سيحتوي على معظم كياناته، لا تزال هناك بعض الحالات التي لن تتوفّر فيها الكيانات. إليك بعض الأسباب الأكثر شيوعًا:

  • يتم تعديل كل ملف ربط كل 3 أيام. إذا تم تنزيل ملفّ ربط على الفور بعد إنشاء عنصر جديد، من المحتمل ألا يكون العنصر مضمّنًا في ملفّ الربط. وسيتم على الأرجح إدراجه بعد الانتظار لمدة تصل إلى 3 أيام.
  • تتم إزالة الحساب الذي ينتمي إليه الكيان. لا نتيح ربط الأرقام التعريفية في هذه الحالة.

تنزيل التقرير

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

تفرد رقم تعريف العنصر

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

رقم تعريف العنصر نطاق التفرد هل هي فريدة عالميًا؟
معرِّف الميزانية عالمي نعم
رقم تعريف الحملة عالمي نعم
معرف المجموعة الإعلانية عالمي نعم
الرقم التعريفي للإعلان المجموعة الإعلانية رقمَا (AdGroupId، AdId) هما رقمان فريدان على مستوى العالم.
رقم تعريف معيار المجموعة الإعلانية المجموعة الإعلانية رقمَا (AdGroupId، CriterionId) هما رقمان فريدان على مستوى العالم.
رقم تعريف معيار الحملة الحملة رقمَا (CampaignId، CriterionId) هما رقمان فريدان على مستوى العالم.
معلومات الإعلان الإضافية الحملة رقمَا (CampaignId، AdExtensionId) هما رقمان فريدان على مستوى العالم.
الرقم التعريفي للخلاصة عالمي نعم
الرقم التعريفي لعنصر الخلاصة عالمي نعم
رقم تعريف سمة الخلاصة الخلاصة لا
رقم تعريف تعيين الخلاصة عالمي نعم
الرقم التعريفي للتصنيف عالمي نعم
رقم تعريف قائمة المستخدمين عالمي نعم