Validation de l'identité de l'annonceur

Pour offrir un écosystème publicitaire fiable et sûr aux utilisateurs et pour respecter les nouvelles réglementations, Google demande désormais aux annonceurs de suivre un ou plusieurs programmes de validation.

Si vous devez suivre un programme de validation, une date limite peut être définie. Si le délai est dépassé sans que la validation soit terminée, votre compte risque d'être mis en veille.

Vous pouvez également vous soumettre à une validation proactive sans y être obligé. Le IdentityVerificationService propose des méthodes permettant d'effectuer les opérations suivantes:

• Récupérez l'état de la procédure de validation pour un compte client, y compris les délais
• Lancer une procédure de validation

Récupérer l'état de validation

Pour récupérer l'état de la procédure de validation de l'identité de l'annonceur pour un compte client, appelez la méthode GetIdentityVerification:

This example is not yet available in Java; you can take a look at the other languages.
    

private static IdentityVerification GetIdentityVerification(
        GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V16.IdentityVerificationService);

    try {
        GetIdentityVerificationResponse response =
            identityVerificationService.GetIdentityVerification(
                new GetIdentityVerificationRequest()
                {
                    CustomerId = customerId.ToString()
                }
            );

            if (response.IdentityVerification.Count == 0)
            {
                return null;
            }

            IdentityVerification identityVerification = response.IdentityVerification[0];
            string deadline =
                identityVerification.IdentityVerificationRequirement.VerificationCompletionDeadlineTime;
             IdentityVerificationProgress identityVerificationProgress =
                identityVerification.VerificationProgress;
            Console.WriteLine($"Account {customerId} has a verification completion " +
                $"deadline of {deadline} and status " +
                $"{identityVerificationProgress.ProgramStatus} for advertiser identity " +
                "verification.");

            return identityVerification;
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }


}
VerifyAdvertiserIdentity.cs
      

This example is not yet available in PHP; you can take a look at the other languages.
    

This example is not yet available in Python; you can take a look at the other languages.
    

def get_identity_verification(client, customer_id)
  response = client.service.identity_verification.get_identity_verification(
    customer_id: customer_id
  )

  return nil if response.nil? || response.identity_verification.empty?

  identity_verification = response.identity_verification.first
  deadline = identity_verification.
    identity_verification_requirement.
    verification_completion_deadline_time
  progress = identity_verification.verification_progress
  puts "Account #{customer_id} has a verification completion deadline " \
    "of #{deadline} and status #{progress.program_status} for advertiser " \
    "identity verification."

  identity_verification
end
verify_advertiser_identity.rb
      

sub get_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $response = $api_client->IdentityVerificationService()->get({
    customerId => $customer_id
  });

  if (!defined $response->{identityVerification}) {
    printf "Account %s does not require advertiser identity verification.",
      $customer_id;
    return;
  }

  my $identity_verification = $response->{identityVerification}[0];
  my $deadline = $identity_verification->{identityVerificationRequirement}
    {verificationCompletionDeadlineTime};
  my $identity_verification_progress =
    $identity_verification->{verificationProgress};

  printf "Account %s has a verification completion deadline of %s and status " .
    "%s for advertiser identity verification.", $customer_id, $deadline,
    $identity_verification_progress->{programStatus};
  return $identity_verification;
}
verify_advertiser_identity.pl
      

Si le compte client est inscrit au programme obligatoire de validation de l'identité de l'annonceur, le service renvoie une réponse non vide contenant une liste d'objets IdentityVerification. Une réponse vide indique que le compte client n'est pas tenu de suivre la procédure de validation de l'identité de l'annonceur.

Depuis la version 16, l'API Google Ads n'est compatible qu'avec le programme ADVERTISER_IDENTITY_VERIFICATION. Il s'agit donc du seul élément de la liste.

Un objet IdentityVerification contient les propriétés suivantes:

• Une IdentityVerificationRequirement décrivant les délais de début et de fin de la procédure de validation

• Un élément IdentityVerificationProgress décrivant l'état actuel du processus de validation: il peut également inclure l'URL de l'action permettant à l'utilisateur de terminer le processus de validation.

Lancer la validation

Si un compte client est inscrit au programme obligatoire de validation de l'identité de l'annonceur, et que GetIdentityVerification a renvoyé une réponse non vide indiquant une date limite pour terminer le processus de validation, vous pouvez démarrer une session de validation en appelant StartIdentityVerification:

This example is not yet available in Java; you can take a look at the other languages.
    

private static void StartIdentityVerification(GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V16.IdentityVerificationService);

    StartIdentityVerificationRequest request = new StartIdentityVerificationRequest()
    {
        CustomerId = customerId.ToString(),
        VerificationProgram = IdentityVerificationProgram.AdvertiserIdentityVerification
    };

    try {
        identityVerificationService.StartIdentityVerification(request);
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
VerifyAdvertiserIdentity.cs
      

This example is not yet available in PHP; you can take a look at the other languages.
    

This example is not yet available in Python; you can take a look at the other languages.
    

def start_identity_verification(client, customer_id)
  client.service.identity_verification.start_identity_verification(
    customer_id: customer_id,
    verification_program: :ADVERTISER_IDENTITY_VERIFICATION,
  )
end
verify_advertiser_identity.rb
      

sub start_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $request =
    Google::Ads::GoogleAds::V16::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

  $api_client->AdvertiserIdentityVerificationService()
    ->start_identity_verification($request);
}
verify_advertiser_identity.pl
      

Cette opération ne fonctionne que si aucune autre session de validation n'est en cours. Une fois que vous avez démarré une session de validation, les appels suivants à GetIdentityVerification renvoient l'URL d'action permettant à l'utilisateur de terminer le processus de validation, ainsi que le délai d'expiration de cette URL.

Une fois le délai d'expiration écoulé, vous pouvez rappeler StartIdentityVerification pour démarrer une nouvelle session de validation.