تحميل مجمع

تتيح لك نصوص "إعلانات 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".
• انتقِل إلى الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل.
• انقر على الزر + لبدء عملية تحميل جديدة.
• سيظهر قسم يتضمّن مجموعة متنوعة من النماذج للاختيار من بينها.

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