العناصر الاختيارية لـ "حملة الأداء الأفضل"

أهداف الإحالات الناجحة

عند إنشاء "حملة أداء أفضل"، يتمّ تلقائيًا إنشاء سلسلة من أهداف الإحالات الناجحة التي تتطابق مع CustomerConversionGoal الأهداف في الحساب. يمكنك تخصيصها تحديدًا لكلّ حملة من "حملات الأداء الأفضل" من خلال تعديلها.

ولإجراء ذلك، عليك أولاً استرجاع قائمة بجميع أهداف الإحالات الناجحة للعملاء.

const searchResults = AdsApp.search(
  `SELECT
     customer_conversion_goal.category,
     customer_conversion_goal.origin
   FROM customer_conversion_goal`
);

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

قبل تشغيل هذا الرمز، عليك استرجاع رقم تعريف الحملة الخاص بحملة الأداء الأفضل.

ننصحك بإعداد أهداف الإحالات الناجحة في معاملة منفصلة عن بقية عملية إنشاء الحملة. تتطلب السمة CampaignConversionGoalOperation ضبط partialFailure للطلب على false. إذا كنت تريد تشغيل هذا الرمز في المعاملة نفسها التي تنشئ فيها الحملة لأول مرة، يجب ضبط مجموعة العمليات بالكامل على إيقاف حالة الفشل الجزئي. يوضّح هذا الرمز النموذجي كيفية إجراء هذه العملية في معاملة منفصلة.

operations = [];
while (searchResults.hasNext()) {
  const row = searchResults.next();
  const conversionGoal = row.customerConversionGoal;

  operations.push({
    "campaignConversionGoalOperation": {
      "update": {
        "resourceName": `customers/${customerId}/campaignConversionGoals/${campaignId}~${conversionGoal.category}~${conversionGoal.origin}`,
        // Insert your logic here to determine whether you want this particular
        // campaign conversion goal to be biddable or not.
        // This code will just default everything to being biddable, but that
        // is not necessarily best for your use case.
        "biddable": true
      },
      "updateMask": "biddable"
    }
  });
}

AdsApp.mutateAll(operations, {partialFailure: false});

استهداف الحملة

بالنسبة إلى استهداف الحملات في "حملات الأداء الأفضل"، احرص على الاطّلاع على دليل واجهة برمجة التطبيقات للحصول على قائمة كاملة بأنواع المعايير المسموح بها.

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

يمكنك إنشاء هذه المعايير مع الحملة نفسها كجزء من عبارة الاستدعاء نفسها إلى mutateAll، ويفترض مثال الرمز هذا أنّ هذه هي الطريقة التي تُنشِئ بها الرمز.

operations.push({
  "campaignCriterionOperation": {
    "create": {
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "negative": false,
      "location": {
        // 1023191 represents New York City
        "geoTargetConstant": "geoTargetConstants/1023191"
      }
    }
  }
});

إشارات مجموعة مواد العرض

يمكنك الاطّلاع على إشارات مجموعات مواد العرض حول وثائق واجهة برمجة التطبيقات قبل البدء. يتم إعداد هذه المجموعات من خلال ربط مجموعة مواد عرض بمعيار AudienceInfo أو SearchThemeInfo حالي. إذا كنت تريد استخدام شريحة جمهور بدلاً من ذلك، حدِّد الحقل audience بدلاً من الحقل searchTheme باستخدام اسم مورد الجمهور.

operations.push({
  "assetGroupSignalOperation": {
    "create": {
      "assetGroup": assetGroupOperation.assetGroupOperation.create.resourceName,
      "searchTheme": {
        "text": "mars cruise"
      }
    }
  }
});