Создайте позицию в запросе на генерацию спроса.

Элементы списка Demand Gen показывают группы объявлений и объявления в различных форматах на наиболее эффективных платформах Google, включая YouTube, Discover, Gmail и контекстно-медийную сеть Google. Элементы списка Demand Gen, как и другие типы элементов списка, управляются с помощью ресурсов LineItem и работают на основе установленного бюджета, стратегии назначения ставок и таргетинга. Также существуют настройки, специфичные для элементов списка Demand Gen, доступные в поле demandGenSettings .

В позициях, генерируемых в рамках стратегии спроса, имеются дочерние ресурсы, называемые группами объявлений. Группы объявлений обеспечивают дополнительный уровень управления для каждой отдельной позиции.

Choose configurations

Перед созданием позиции запроса на генерацию спроса, ознакомьтесь с соответствующими настройками и определитесь с ними.

For Demand Gen line items:

  • lineItemType должен быть установлен в LINE_ITEM_TYPE_DEMAND_GEN .
  • bidStrategy необходимо задать с помощью поля demandGenBid объекта BiddingStrategy .
  • budget должен быть установлен на фиксированную сумму на уровне позиции заказа и не может быть унаследован от родительского заказа на добавление.
  • demandGenSettings используется для настройки параметров, специфичных для позиций генерации спроса. Поле geoLanguageTargetingEnabled объекта DemandGenSettings определяет, устанавливается ли таргетинг по местоположению и языку на уровне позиции или для отдельных групп объявлений. Это поле нельзя изменить после создания позиции. Установите значение поля в true , если вы предпочитаете настраивать этот таргетинг на уровне позиции.
  • creativeIds задавать не следует. Ресурсы назначаются и настраиваются напрямую в ресурсах AdGroupAd .

Следующие поля являются обязательными для позиций в системе генерации спроса и функционируют так же, как и в других типах позиций:

Ресурс LineItem также имеет множество необязательных полей, которые можно задать. Для получения дополнительной информации ознакомьтесь с справочной документацией .

Create a line item

Вот как создать позицию в запросе на генерацию спроса со следующими настройками:

  • An inherited flight and a budget of $100.
  • Модель получения дохода от партнеров составляет 0,1% от общей стоимости размещения рекламы.
  • Стратегия назначения ставок, оптимизированная для достижения средней стоимости конверсии в 10 долларов.
  • Параметр "Предпочтение отдается назначению таргетинга по местоположению и языку непосредственно группам объявлений в рамках отдельной позиции объявления".

Python

# Provide the ID of the parent advertiser.
advertiser_id = advertiser-id

# Provide the ID of the parent insertion order.
insertion_order_id = insertion-order-id

# Provide the display name of the line item.
display_name = display-video

# Provide the Floodlight activity ID to use for conversion tracking.
floodlight_activity_id = floodlight-activity-id

# Provide whether the line item will serve EU political ads.
contains_eu_political_ads = contains-eu-political-ads

# Create a line item object with example values.
line_item_obj = {
    "insertionOrderId": insertion_order_id,
    "displayName": display_name,
    "lineItemType": "LINE_ITEM_TYPE_DEMAND_GEN",
    "entityStatus": "ENTITY_STATUS_DRAFT",
    "flight": {"flightDateType": "LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED"},
    "budget": {
        "budgetAllocationType": "LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED",
        "maxAmount": 100000000
    },
    "pacing": {
        "pacingPeriod": "PACING_PERIOD_FLIGHT",
        "pacingType": "PACING_TYPE_EVEN",
        "dailyMaxMicros": 10000,
    },
    "partnerRevenueModel": {
        "markupType": (
            "PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP"
        ),
        "markupAmount": 100,
    },
    "bidStrategy": {
        "demandGenBid": {
            "type": "DEMAND_GEN_BIDDING_STRATEGY_TYPE_TARGET_CPA",
            "value": "10000000"
        }
    },
    "conversionCounting": {
        "postViewCountPercentageMillis": "100000",
        "floodlightActivityConfigs": [
            {
                "floodlightActivityId": floodlight_activity_id,
                "postClickLookbackWindowDays": 90,
                "postViewLookbackWindowDays": 90
            }
        ]
    },
    "containsEuPoliticalAds": contains_eu_political_ads,
    "demandGenSettings": {
        "geoLanguageTargetingEnabled": False
    }
}

# Build and execute request.
response = (
    service.advertisers()
    .lineItems()
    .create(advertiserId=advertiser_id, body=line_item_obj)
    .execute()
)

# Display the new line item.
print(f"Demand Gen line Item {response['name']} was created.")