- Ressource: InsertionOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Méthodes
Ressource: InsertionOrder
Un seul ordre d'insertion
Représentation JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de l'ordre d'insertion. |
advertiserId |
Uniquement en sortie. Identifiant unique de l'annonceur auquel appartient l'ordre d'insertion. |
campaignId |
Obligatoire. Immuable. ID unique de la campagne à laquelle appartient l'ordre d'insertion. |
insertionOrderId |
Uniquement en sortie. ID unique de l'ordre d'insertion. Attribué par le système. |
displayName |
Obligatoire. Nom à afficher de l'ordre d'insertion. Il doit être encodé au format UTF-8 et ne doit pas dépasser 240 octets. |
insertionOrderType |
Type d'ordre d'insertion. Si ce champ n'est pas spécifié lors de la création, la valeur par défaut est |
entityStatus |
Obligatoire. Détermine si l'ordre d'insertion peut dépenser son budget et définir des enchères sur l'inventaire.
|
updateTime |
Uniquement en sortie. Code temporel de la dernière mise à jour de l'ordre d'insertion. Attribué par le système. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
partnerCosts[] |
Coûts partenaires associés à l'ordre d'insertion. Si ce champ n'est pas renseigné ou est vide dans la méthode |
pacing |
Obligatoire. Paramètre de vitesse de dépense du budget de l'ordre d'insertion. |
frequencyCap |
Obligatoire. Paramètre de limitation de la fréquence d'exposition de l'ordre d'insertion. |
integrationDetails |
Informations supplémentaires sur l'intégration de l'ordre d'insertion. |
performanceGoal |
Obligatoire. Objectif de performances de l'ordre d'insertion. |
budget |
Obligatoire. Paramètres de répartition du budget de l'ordre d'insertion. |
bidStrategy |
Stratégie d'enchères de l'ordre d'insertion. Par défaut, |
reservationType |
Uniquement en sortie. Type de réservation de l'ordre d'insertion. |
billableOutcome |
Immuable. Résultat facturable de l'ordre d'insertion. Les achats en fonction du résultat sont obsolètes. |
InsertionOrderType
Types possibles d'un ordre d'insertion.
Le type d'ordre d'insertion détermine les paramètres et les options applicables (par exemple, le format des annonces ou les options de ciblage).
Enums | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Le type d'ordre d'insertion n'est pas spécifié ou est inconnu. |
RTB |
Enchères en temps réel |
OVER_THE_TOP |
Service de distribution par contournement |
InsertionOrderBudget
Paramètres qui contrôlent la manière dont le budget de l'ordre d'insertion est alloué.
Représentation JSON |
---|
{ "budgetUnit": enum ( |
Champs | |
---|---|
budgetUnit |
Obligatoire. Immuable. L'unité budgétaire indique si le budget est basé sur une devise ou sur des impressions. |
automationType |
Type d'automatisation utilisé pour gérer l'enchère et le budget de l'ordre d'insertion. Si ce champ n'est pas spécifié lors de la création, la valeur par défaut est |
budgetSegments[] |
Obligatoire. Liste des segments de budget. Utilisez un segment de budget pour spécifier un budget spécifique pour une période donnée d'exécution d'un ordre d'insertion. |
InsertionOrderAutomationType
Options possibles pour automatiser l'enchère et le budget de l'ordre d'insertion
Enums | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
L'option d'automatisation de l'ordre d'insertion n'est pas spécifiée ou est inconnue dans cette version. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Répartition automatique du budget Autorisez le système à transférer automatiquement le budget vers les éléments de campagne propriétaires afin d'optimiser les performances définies par performanceGoal . Aucune automatisation des paramètres d'enchères. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Aucune automatisation des enchères ou du budget au niveau de l'ordre d'insertion. L'enchère et le budget doivent être configurés manuellement au niveau de l'élément de campagne. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Autorisez le système à ajuster automatiquement les enchères et à transférer le budget aux éléments de campagne propriétaires afin d'optimiser les performances définies par performanceGoal . |
InsertionOrderBudgetSegment
Paramètres qui contrôlent le budget d'un seul segment de budget.
Représentation JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Champs | |
---|---|
budgetAmountMicros |
Obligatoire. Montant du budget que l'ordre d'insertion dépensera pour le |
description |
Description du segment de budget. Elle permet de saisir les informations de bon de commande pour chaque segment de budget et d'imprimer ces informations sur les factures. Le fichier doit être encodé au format UTF-8. |
dateRange |
Obligatoire. Paramètres de dates de début et de fin du segment de budget. Elles sont résolues en fonction du fuseau horaire de l'annonceur parent.
|
campaignBudgetId |
|
BillableOutcome
Résultats facturables possibles pour un ordre d'insertion.
Enums | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Résultat facturable non spécifié. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Paiement par impression. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Paiement par clic. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Payez par vue active. |
Méthodes |
|
---|---|
|
Crée un ordre d'insertion. |
|
Supprime un ordre d'insertion. |
|
Récupère un ordre d'insertion. |
|
Répertorie les ordres d'insertion d'un annonceur. |
|
Répertorie les options de ciblage attribuées à un ordre d'insertion pour tous les types de ciblage. |
|
Met à jour un ordre d'insertion existant. |