تحميل مجمع

تتيح لك نصوص "إعلانات Google" البرمجية إجراء عمليات من التغييرات إلى حسابك من خلال تحميل البيانات بتنسيق CSV. يمكنك تحميل البيانات من ملف CSV من Google. Drive أو جدول بيانات Google أو جدول بيانات Microsoft Excel أو إنشاء مجموعة طلب تحميل في النص البرمجي وقت التشغيل يشرح هذا الدليل طريقة استخدام هذه البيانات مميزة في البرامج النصية لديك.

الاستخدام

باستخدام عمليات التحميل المجمّعة، يمكنك إجراء أنواع معيّنة من التغييرات التي من شأنها غير مدعومة بشكل مباشر بنصوص "إعلانات Google" البرمجية، مثل إدارة الحملات أو تحميل الإحالات الناجحة بلا إنترنت

إنشاء عملية تحميل مجمّع من Google Drive

إنّ أبسط طريقة لاستخدام ميزة التحميل المجمّع هي تحميل ملف CSV في Google Drive، وتحميل هذا الملف إلى "إعلانات Google" باستخدام نصوص "إعلانات Google" البرمجية:

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

يؤدي هذا إلى إنشاء إدخال معاينة تحميل مجمّع في حسابك ضمن الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل:

انقر على الرابط معاينة لعرض التغييرات.

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

بعد التأكّد من أنّ النص البرمجي يعمل بشكل صحيح، يمكنك تخطّي مرحلة المعاينة وتطبيق التغييرات مباشرةً من النص البرمجي. ويمكن إجراء ذلك من خلال استدعاء الأسلوب apply() لمثيل التحميل المجمّع بدلاً من الأسلوب preview() .

إنشاء عملية تحميل مجمّعة من البداية

يمكنك إنشاء مهمة تحميل مجمّع من البداية باتّباع الخطوات التالية:

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

ضبط الوحدة النقدية

بشكل تلقائي، يتمّ تفسير المبالغ المالية في عمليات التحميل المجمَّعة على أنّها القيمة الفعلية ومبلغ العملة. إذا كنت تفضّل استخدام الميكرو، يمكنك ضبط الخيار moneyInMicros على true عند إنشاء وظيفة التحميل (على سبيل المثال، سيتم إدخال 2.34 يورو على النحو التالي: 2340000).

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

ضبط لغة الملف

يتم تفسير محتوى ملف CSV تلقائيًا باللغة الإنجليزية (الولايات المتحدة) (en_US). يمكنك تحديد لغة مختلفة باستخدام الخيار fileLocale، كما هو موضّح أدناه:

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

عند تحديد لغة، يمكنك تقديم عناوين الأعمدة إما بلغة en_US أو بلغة تحدّدها في السمة fileLocale.

تعيين المنطقة الزمنية

بشكل افتراضي، يتم تفسير إدخالات الوقت في الملف بتنسيق America/Los_Angeles. يمكنك تحديد منطقة زمنية مختلفة باستخدام الخيار timeZone. تحديد الوقت منطقة في قاعدة بيانات TZ .

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

يمكن أن يكون ضبط منطقة زمنية مفيدًا عند تحميل الإحالات الناجحة بلا إنترنت.

نماذج جداول البيانات للتحميل المجمّع

إنّ أسهل طريقة للحصول على نموذج جدول بيانات للتحميل المجمّع هي من خلال واجهة مستخدم "إعلانات Google"

• سجِّل الدخول إلى حسابك على "إعلانات Google".
• انتقِل إلى الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل.
• انقر على الزر + لبدء عملية تحميل جديدة.
• بعد ذلك، يظهر قسم يحتوي على مجموعة متنوعة من النماذج للاختيار من بينها.

يمكنك أيضًا تنزيل العديد من النماذج المختلفة من مركز المساعدة .