تحميل إلى قوائم المستخدمين

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يمكنك استخدام أداة التحميل المجمّع الموضّحة في ما يلي لتحميل معرّفات إعلانات مختلفة إلى قوائم مستخدمي Google للاستهداف. يمكنك أيضًا تحميل قوائم مستخدمين مثل القوائم الصفقات المضمونة آليًا.

أداة التحميل المجمّع

ويمكن استخدام قوائم مستخدمي Google في الاستهداف، بينما يسمح المشترون المعتمَدون للمشترين بتعديل قوائم المستخدمين هذه من خلال طلبات HTTPS POST. ويجب توفير أرقام تعريف الإعلانات وقوائم المستخدمين ونوع التعديل (إضافة أو حذف). والحد الأقصى لحجم هذا الطلب هو 100 كيلوبايت، ويكون عنوان URL للطلب على النحو التالي:

https://cm.g.doubleclick.net/upload?nid=GoogleNetworkId

GoogleNetworkId هي معرّف معتمد للمشترين، ويمكن استرداده من خلال الحقل الموارد الخاصة بحسابات واجهة برمجة التطبيقات للمشتري، cookieMatchingNid.

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

يدعم الشراة المعتمَدون تحميل المعرّفات التالية إلى خوادم Google:

كما هو موضّح في الحقلين enum وmessage التاليين في cookie-bulk-upload-proto.txt.

مثال: إضافة معرّفات المعلِنين (IDFA) إلى قائمة المستخدمين

لإضافة معرّفات المعلِنين (IDFA) إلى قائمة مستخدمين برقم التعريف 123، أنشئ المخزن المؤقت للبروتوكول UpdateUsersDataRequest التالي:

UpdateUsersDataRequest {
  ops {
    user_id: "2024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "3024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "4024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "5024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
}

بعد ذلك، أرسِل طلب "HTTPS POST" مع المخزن المؤقت لبروتوكول UpdateUsersDataRequest كحمولة أساسية إلى "الشراة المعتمَدون". إذا تم إرسال الطلب بنجاح، ستتلقى الرد التالي:

UpdateUsersDataResponse {
  status = NO_ERROR
}

وفي حال لم يتم تنفيذ الطلب بنجاح، ستتلقّى الرد التالي:

UpdateUsersDataRequest {
  ops {
    user_id: "2024D65F-EBBD-11FF-23AB-823FC255913A"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
  ops {
    user_id: "INVALID_FORMAT"
    user_list_id: 123
    time_added_to_user_list: 2132132132
  }
}

إذا كان أول user_id صالحًا ولكن الثاني غير صالح، ستتلقى ردًا مثل ما يلي:

UpdateUsersDataResponse {
{
  status: PARTIAL_SUCCESS
  errors: {
    user_id     : "INVALID_FORMAT"
    error_code  : BAD_COOKIE
    time_added_to_user_list: 2132132132
  }
}